@aglyn/plugins-ai 1.0.0-beta.238 → 1.0.0-beta.240

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-plan-step.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { aiSiteKindOfInputs } from '../model/ai-site-kinds'\nimport { createHash } from 'node:crypto'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport {\n  AI_BUILD_PLAN_TOOL,\n  aiBuildPlanToolFor,\n  isAiPlanNewRef,\n  type AiBuildPlan,\n} from '../model/ai-build-plan'\nimport type { AiJob, AiJobKind, AiJobPlan, AiJobReview, AiJobStatus } from '../model/ai-jobs.types'\nimport { readFreeAiCreditsLeft } from '../usage/free-ai-credits-left'\nimport {\n  AI_TEMPLATE_SUBJECT_DEFINITIONS,\n  aiTemplateShownTokens,\n  type AiTemplateSubject,\n} from '../model/ai-template-subjects'\nimport { AI_JOB_CREATE_KINDS, AI_JOB_CREATE_NOUNS } from '../model/ai-job-creations'\nimport { AI_PAGE_CREATE_KINDS, aiPagePlanShapeRefusal } from '../model/ai-page-job'\nimport {\n  AI_PLAN_COMPILED_REPEATS_SENTENCE,\n  AI_PLAN_NO_FORM_SENTENCE,\n  aiPlanCanPlaceForm,\n  aiPlanCapabilitiesForJob,\n  aiPlanCapabilityLines,\n  type AiPlanCapabilities,\n  type AiPlanJobScope,\n} from '../model/ai-plan-capabilities'\nimport type { AiSiteInventory } from '../model/ai-site-inventory'\nimport {\n  AI_FREE_SITE_WORST_CASE_CREDITS,\n  AI_SITE_CREATE_KINDS,\n  AI_SITE_FREE_PAGES,\n  AI_SITE_PLAN_MAX_TOKENS,\n  AI_SITE_HOME_BANDS,\n  aiFreeSiteSectionsWithin,\n  aiSiteFullPlanSentence,\n  aiSiteHomeMinSections,\n  aiSiteNameSentence,\n  aiSitePlanIsHome,\n  aiSitePlanShapeRefusal,\n  aiSiteBlogStandInViolations,\n  aiSiteThinHomeViolations,\n  AI_SITE_GALLERY_SENTENCE,\n  aiSiteEmptyGalleryViolations,\n} from '../model/ai-site-job'\nimport { aiSiteContentPart } from './ai-job-site-content'\nimport { aiLayoutIsShopPage, aiLayoutShopGridSection } from '../layout-language/ai-layout-listings'\nimport { aiStorefrontPlanScreens } from '../layout-language/ai-layout-storefront'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport { aiPlanFailureCopy, aiPlanRetryRefusal } from '../model/ai-job-failure-copy'\nimport { FREE_AI_TASTE_CREDITS_PER_MONTH } from '../plan-entitlements'\nimport { aiDoctrineSystemBlocks, runValidatedGeneration } from '../runtime/ai-doctrine'\nimport { AI_STEP_TIERS, aiCatalogEntry, aiDefaultModelFor } from '../providers/catalog'\nimport {\n  AI_FREE_PAGE_WORST_CASE_CREDITS,\n  aiPlanEmbedBriefViolations,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { assistCreditsFromUsd } from '../usage/assist-credits'\nimport { ASSIST_RETURNED_USD_FIELD, assistSpendAfterReturnsUsd } from '../usage/assist-credit-returns'\nimport { freeAccountUsageRef, freeAssistAccount, type AssistMeteredOrg } from '../usage/assist-free-taste'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport type { AiTool } from '../providers/contract'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { readAiSiteContext } from '../runtime/site-context'\nimport { aiInstructionsWithSiteContext, type AiSiteContextInput } from '../model/ai-site-context'\nimport {\n  AI_BUILD_CREATE_KINDS,\n  AI_BUILD_STRUCTURAL_OPS,\n  aiBuildPageLimit,\n  aiBuildPlanShapeRefusal,\n  type AiBuildOps,\n} from '../model/ai-build-job'\nimport { aiBuildOpLines, aiBuildOps } from './ai-build-capabilities'\nimport { aiJobAdmissionRefusal } from './ai-job-admission'\nimport { AI_CREDITS_CONFIRM_CODE } from '../model/ai-credit-estimate'\nimport { readAiPlanCapabilities } from './ai-job-drafts'\nimport {\n  AI_JOB_BRIEF_MAX_CHARS,\n  type AiJobStepOutcome,\n  type AiJobStepRunner,\n} from './ai-job-text-step'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiDoctrineReview, aiUnspentOutcome } from './ai-job-generation'\nimport { aiPlanWithDraftIds } from './ai-job-draft-ids'\nimport { AI_JOBS_COLLECTION, registerAiJobPlanStep } from './ai-jobs'\n\n/**\n * The plan step (AGL-2935): the first step of every job that builds site\n * structure. Before a node is generated, the model answers with a typed plan\n * — what the site already has that the job reuses, what it creates and why,\n * and the screens it builds from them — held to the doctrine's plan rules\n * against the site's inventory and re-asked once when it breaks one.\n *\n * A plan that passes is kept on the job, and the job stops for review: the\n * member reads what it will build before a credit is spent building it, and\n * confirms through the resume door. A plan that still breaks a rule on its\n * re-ask stops the job the same way, with the rules named. Either way the\n * step writes nothing itself; the machine records the plan, the spend and\n * the stop, as it records every step.\n *\n * ── Told what it may create, refused what it cannot build (AGL-3030) ─────\n *\n * Before it asks, the step reads what the job may create on its site: the\n * workspace's plan, the site's counts against its limits, and — for a kind\n * that builds only some plans — what the job builds itself. The user turn\n * states it, the plan rules refuse a creation outside it with the one re-ask,\n * and where the workspace keeps no reusable components they accept the page\n * built inline. A plan the confirm door would still refuse — the kind's own\n * admission, handed the plan, as the resume door hands it — is refused HERE,\n * before a member is shown a Confirm: the job fails with the door's sentence,\n * its plan is not kept, and it holds nothing.\n */\n\n/** The plan step's own instructions, cached after the doctrine. */\nexport const AI_JOB_PLAN_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text:\n      'You plan what a website builder job will build, before anything is built. You are given the kind of job and the brief from the person who owns the site. ' +\n      'Answer with submit_build_plan: what the site inventory already has that the job reuses, what it must create and why nothing listed will do, and each page it builds (the screens list) with its layout, template, slug, search title, search description and sections from top to bottom. ' +\n      'Refer to inventory records by id and to what the plan creates as new:<name>. Plan only what the brief asks for: a component, layout, template, form or email job plans no pages unless the brief asks for them, and a page job plans exactly one page.',\n  },\n]\n\n/**\n * The plan step's time (AGL-3026, AGL-3036): its two inventory-lookup rounds,\n * its answer and its re-ask at the routing table's ceiling for `job.plan`, on\n * the tier that step kind is served from, with the step's reads and writes,\n * at the rates `ai-job-budget.ts` assumes — fitted to what a beat can give a\n * step, so the served tier asks a little under the routing ceiling.\n */\nexport const AI_JOB_PLAN_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.plan'],\n  maxTokens: AI_ROUTING_TABLE['job.plan'].maxTokens,\n})\n\n/**\n * The least time a plan needs before it starts. Registered with the step, so\n * an inline door never starts a plan. A plan thinks before it answers and\n * routinely runs past an inline door's budget, and a provider call that\n * budget cuts off is still generated and billed upstream while the meter\n * records nothing. The beat starts a plan only with this much of its own\n * budget left, and a spec holds it inside that budget.\n */\nexport const AI_JOB_PLAN_STEP_MINIMUM_MS = AI_JOB_PLAN_STEP_BUDGET.minimumMs\n\n/**\n * The plan's answer ceiling on the model a job runs: the most whose worst\n * case fits the least time the step registered, and never more than the\n * routing table's. A model the catalog does not know is planned at the\n * slowest.\n */\nexport function aiJobPlanMaxTokens(model: string): number {\n  return AI_JOB_PLAN_STEP_BUDGET.maxTokens(model)\n}\n\n/** What the member reads while a plan waits for them. */\nexport const AI_JOB_PLAN_REVIEW_COPY =\n  'The plan is ready. Review what the job will reuse and create, then confirm it to build.'\n\n/**\n * The job as the plan step's user turn: its kind, its brief, its scalar\n * inputs and, where the job read them, what it may create on its site\n * (AGL-3030). Per workspace and per site, which is why they ride here and\n * never in a system block the platform's cache entry is keyed on.\n */\nexport function aiJobPlanPrompt(\n  job: Pick<AiJob, 'kind' | 'brief' | 'inputs'>,\n  capabilities: AiPlanCapabilities | null = null,\n  inventory: AiSiteInventory | null = null,\n  ops: AiBuildOps | null = null,\n): string {\n  const lines = [`Job kind: ${job.kind}`, `Brief: ${job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`]\n  for (const [key, value] of Object.entries(job.inputs ?? {})) {\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n      lines.push(`${key}: ${String(value)}`)\n    }\n  }\n  if (capabilities) lines.push(...aiPlanCapabilityLines(capabilities))\n  // A form is a saved form or none (AGL-3596): said where the site read has\n  // none to place and the job may create none.\n  if (capabilities && inventory && !aiPlanCanPlaceForm(inventory, capabilities)) {\n    lines.push(AI_PLAN_NO_FORM_SENTENCE)\n  }\n  lines.push(...aiPlanTemplateTokenLines(job))\n  lines.push(...aiPlanSiteLines(job, inventory, capabilities))\n  lines.push(...aiPlanBuildLines(job, capabilities, ops))\n  return lines.join('\\n')\n}\n\n/**\n * What a BUILD job's plan is told (AGL-3616): that one request becomes pages,\n * creations and items, how many pages it may hold, and the item operations\n * this site has with their arguments. On the job's own turn, never a cached\n * system block, because the operations are per site.\n */\nexport function aiPlanBuildLines(\n  job: Pick<AiJob, 'kind'>,\n  capabilities: AiPlanCapabilities | null,\n  ops: AiBuildOps | null,\n): string[] {\n  if (job.kind !== 'build') return []\n  const pages = aiBuildPageLimit(capabilities?.freeTaste === true)\n  return [\n    `This is a build from one request: plan each page it asks for in screens (at most ${pages}), each new layout, form, component or email design in create, and anything else in items. Plan only what the request asks for; reuse what the site has.`,\n    'A page section that shows a form or an item places it: put its new:<name> in that section\\'s uses. An item built after another lists it in dependsOn.',\n    // The layout language draws a section's repeated items (AGL-3660), so the\n    // doctrine's \"repeated items place a component\" is not asked of a build.\n    ...(capabilities?.repeatsCompiled ? [AI_PLAN_COMPILED_REPEATS_SENTENCE] : []),\n    ...(ops ? aiBuildOpLines(ops, AI_BUILD_STRUCTURAL_OPS) : []),\n  ]\n}\n\n/**\n * What a SITE job's plan is told beside the inventory (AGL-3594): the pages\n * the site already has and that their addresses are taken, which one — the\n * untouched starter home — a planned home page at `/` replaces, the Free page\n * cap and its guidance, and that a plan is an outline.\n *\n * A site job only. A new site is born with a published home page at `/`\n * (AGL-3497), and a plan that did not know it could replace it planned its own\n * home there and was refused for the clash on every new site. Kept off a page\n * job's turn, whose length the Free page's wall is proven at.\n */\nexport function aiPlanSiteLines(\n  job: Pick<AiJob, 'kind'> & Partial<Pick<AiJob, 'inputs'>>,\n  inventory: AiSiteInventory | null,\n  capabilities: AiPlanCapabilities | null,\n): string[] {\n  if (job.kind !== 'site') return []\n  const lines: string[] = []\n  // The business's own name, as the name to use (AGL-3596): the plan's search\n  // titles carry it, and an input line alone left the model free to coin one.\n  const name = job.inputs?.['businessName']\n  if (typeof name === 'string' && name.trim()) lines.push(aiSiteNameSentence(name.trim()))\n  const pages = (inventory?.screens ?? []).filter((screen) => !screen.template)\n  const starter = pages.find((screen) => screen.replaceable)\n  if (pages.length) {\n    lines.push('Pages the site already has; their addresses are taken unless a line says otherwise:')\n    for (const page of pages) {\n      lines.push(\n        page.replaceable\n          ? `- ${page.name} at ${page.slug}: the starter home page the site was created with. Plan this site's home page at / and it replaces this one.`\n          : `- ${page.name} at ${page.slug}`,\n      )\n    }\n    if (!starter && pages.some((page) => page.slug.trim() === '/' || page.slug.trim() === '')) {\n      lines.push(\"The home page at / is the owner's own and stays: give every page you plan another address.\")\n    }\n  }\n  const cap = capabilities?.freeSitePages\n  const home = aiSitePlanHomeRule(inventory, capabilities)\n  if (cap !== undefined) {\n    lines.push(\n      `This is a Free workspace: plan at most ${cap} ${cap === 1 ? 'page' : 'pages'} — the home page at / and the one page the brief most needs, such as services, booking or contact — and ${home.across} sections across them.${aiPlanCanPlaceForm(inventory, capabilities) ? ' Put the contact form on one of them.' : ''}`,\n    )\n  }\n  // A new site is a full website (AGL-3660): its home is planned as one, not\n  // left to a ceiling the outline is free to stay far under.\n  const plansHome = !pages.some((page) => !page.replaceable && aiSitePlanIsHome(page))\n  if (home.min > 0 && plansHome) {\n    // A store's home is a storefront (AGL-3676): its own parts, in its own order.\n    const bands = aiSiteKindOfInputs(job.inputs)?.id === 'store' ? AI_SITE_STORE_HOME_BANDS : AI_SITE_HOME_BANDS\n    lines.push(`The home page at / reads as a full website: at least ${home.min} sections — ${bands}.`)\n  }\n  // The sections are a budget to use (AGL-3660): a prod start of 2026-10-08\n  // read \"at most 8\" as leave to plan a home of two.\n  lines.push(aiSiteFullPlanSentence({ pages: cap ?? 1, across: home.across, min: plansHome ? home.min : 0 }))\n  // A paid blog's first posts are written at /blog and linked from the\n  // header (AGL-3660, AGL-3676), so the plan plans no page standing in for it.\n  if (aiSiteContentPart(job.inputs ?? null, capabilities?.freeTaste === true) === 'posts') {\n    lines.push(\n      \"This site's blog is written for it with its first posts at /blog, and the header links it. Plan no page that stands in for it (no Blog, Articles, Journal, Posts or Stories page); feature the posts in a section of the home page instead.\",\n    )\n  }\n  // A section that shows the work counts its pieces (AGL-3660): a planned\n  // gallery of no items let a page about the work show none.\n  lines.push(AI_SITE_GALLERY_SENTENCE)\n  // A section that asks for something places the form (AGL-3660): a live\n  // portfolio start planned a commissions inquiry beside the form it made\n  // for its Contact page, without placing it.\n  if (aiPlanCanPlaceForm(inventory, capabilities)) lines.push(AI_SITE_FORM_SENTENCE)\n  // The kind of site the person picked (AGL-3660): the pages it usually has.\n  const kind = aiSiteKindOfInputs(job.inputs)\n  if (kind) lines.push(`This is a ${kind.label.toLowerCase()} site. ${kind.pages}`)\n  // A store's Shop page IS its storefront (AGL-3676): the platform lists the\n  // real products there, so the plan names the section and draws no range.\n  if (kind?.id === 'store') lines.push(AI_SITE_STORE_SHOP_SENTENCE)\n  lines.push(\n    \"Keep the plan an outline: each page's title, address, a short search title and description, and its sections named in a few words. The build writes the copy.\",\n  )\n  return lines\n}\n\n/**\n * The sentence a site plan's turn states about a section that collects\n * answers (AGL-3660): it places the saved form by reference, and one form\n * may be placed on more than one page.\n */\nexport const AI_SITE_FORM_SENTENCE =\n  \"A section that asks visitors for something (contact, inquiry, commissions, booking, sign-up) places the form: put new:<the form's name> or the site's form id in its uses. One form may be placed on several pages.\"\n\n/**\n * What a site start's home page is held to (AGL-3660): its fewest sections,\n * and on the Free taste the sections the wall fits across the pages, which\n * the home's count is shared out of. The plan's turn and its re-ask read this\n * one figure, so the sentence the model is told is the check it is held to.\n */\nexport function aiSitePlanHomeRule(\n  inventory: AiSiteInventory | null,\n  capabilities: AiPlanCapabilities | null,\n): { min: number; across: number | null } {\n  const cap = capabilities?.freeSitePages\n  if (cap === undefined) return { min: aiSiteHomeMinSections({ pages: 1, across: null }), across: null }\n  // Dear: a guided start that places a form makes one (AGL-3596).\n  const across = aiFreeSiteSectionsWithin(\n    { layouts: (inventory?.layouts.length ?? 0) ? 0 : 1, pages: cap, forms: 1 },\n    FREE_AI_TASTE_CREDITS_PER_MONTH,\n  )\n  return { min: aiSiteHomeMinSections({ pages: cap, across }), across }\n}\n\n/**\n * A site plan's thin home, asked about on the FIRST answer only (AGL-3660).\n * The re-ask names the count; an answer that still plans a thinner home is\n * kept, since a home with four sections is a site and a stopped start is\n * none — the same trade a language page makes with its last answer's gaps.\n */\nexport function aiSiteThinHomeCheck(\n  rule: { min: number; across: number | null },\n): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteThinHomeViolations(plan, rule)\n  }\n}\n\n/** What a store's plan is told about its Shop page (AGL-3676). */\nexport const AI_SITE_STORE_SHOP_SENTENCE =\n  'Plan a Shop page at /shop: a short title section, then a section named \"Product grid\" second, where the platform lists the store\\'s real products with sort, filters, photos, prices and cart, then at most one or two short sections (care, shipping, gifting help). Never open it with a hero, and never plan the products themselves as cards of your own.'\n\n/** What a store's home is composed of (AGL-3676): a storefront's parts, in a storefront's order. */\nexport const AI_SITE_STORE_HOME_BANDS =\n  'a hero that sells first, then \"Bestsellers\" (the platform lists the real products), \"Shop by collection\" with 3 or 4 items, the brand story, why buy here with 3 or 4 items, \"Customer reviews\" (the platform shows the store\\'s real ones) and a \"Newsletter sign-up\" band last'\n\n/**\n * A store plan held to a storefront (AGL-3676, `ai-layout-storefront.ts`):\n * on a paid start its home gains the parts a shopper expects that the plan\n * left out — bestsellers, collections, reviews, a newsletter sign-up —\n * while the page has room; on any start its Shop page opens on its grid.\n * Settled, never re-asked: each part has one answer, and the Free wall's\n * home keeps the sections it planned.\n */\nexport function aiSiteStorefrontPlan<P extends Pick<AiBuildPlan, 'screens'>>(plan: P, options: { paid: boolean }): P {\n  const screens = aiStorefrontPlanScreens(plan.screens, {\n    paid: options.paid,\n    isShopPage: aiLayoutIsShopPage,\n    gridSection: aiLayoutShopGridSection,\n  })\n  return screens.every((screen, index) => screen === plan.screens[index]) ? plan : { ...plan, screens }\n}\n\n/** The code a store plan with no Shop page is re-asked under. */\nexport const AI_SITE_STORE_SHOP_CODE = 'plan-store-shop-page'\n\n/**\n * A store plan of two or more pages with no Shop page (AGL-3676): the page\n * the platform lists the catalog on is the one a shopper looks for. A\n * one-page Free taste lists its products on the home instead.\n */\nexport function aiSiteStoreShopPageViolations(\n  plan: Pick<AiBuildPlan, 'screens'>,\n): Array<{ rule: null; code: string; message: string; paths: string[] }> {\n  if (plan.screens.length < 2 || plan.screens.some((screen) => aiLayoutIsShopPage(screen))) return []\n  return [\n    {\n      rule: null,\n      code: AI_SITE_STORE_SHOP_CODE,\n      message:\n        'This store has no Shop page. Plan one at /shop, its second section named \"Product grid\": the platform lists the real products there.',\n      paths: ['screens'],\n    },\n  ]\n}\n\n/** A store plan's missing Shop page, asked about on the FIRST answer only, like a thin home. */\nexport function aiSiteStoreShopCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteStoreShopPageViolations(plan)\n  }\n}\n\n/**\n * A site plan's section that shows the work without its pieces (AGL-3660),\n * asked about on the FIRST answer only, like a thin home: the re-ask names\n * the section, and an answer that keeps it thin is kept.\n */\nexport function aiSiteEmptyGalleryCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteEmptyGalleryViolations(plan)\n  }\n}\n\n/**\n * A site plan's page standing in for the blog its start writes (AGL-3660),\n * asked about on the FIRST answer only, like a thin home: the re-ask names\n * the page, and an answer that keeps it is kept — the posts then take the\n * next address the page leaves free, and the header links them all the same.\n */\nexport function aiSiteBlogStandInCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteBlogStandInViolations(plan)\n  }\n}\n\n/**\n * What a TEMPLATE job's plan is told its creation's `fields` are (AGL-3143\n * §11): the subject's binding tokens, listed so the planner promises only\n * what the page can fill and the build can be held to it\n * (`aiPlanTemplateTokenViolations`).\n *\n * ⛔ It rides the job's own turn and NOT the `fields` description in the plan\n * tool, which every kind's request caches. Written there it read better and\n * cost 40 tokens of the shared prefix — 2,980 to 3,020 — which is one credit\n * of the Free page's 300-credit wall, taking the room it keeps for a re-asked\n * section from 45 credits to 44 and breaking `ai-job-free-page.spec.ts`. A\n * page job must not pay for a sentence about templates.\n *\n * The list is the tokens a reader sees, never the whole catalog (AGL-3143\n * §16). Offered a slug and the publish timestamp, a live plan promised them,\n * and its build kept the promise the only way a slug can be kept: it printed\n * \"entry slug: {{entry.slug}}\" on every article.\n */\nexport function aiPlanTemplateTokenLines(job: Pick<AiJob, 'kind' | 'inputs'>): string[] {\n  if (job.kind !== 'template') return []\n  const subject = (job.inputs ?? {})['subject']\n  const definition =\n    typeof subject === 'string'\n      ? AI_TEMPLATE_SUBJECT_DEFINITIONS[subject as AiTemplateSubject]\n      : undefined\n  if (!definition) return []\n  return [\n    `The template's fields are the binding tokens its page shows a reader, each one of: ${aiTemplateShownTokens(\n      definition,\n    ).join(', ')}. A link or picture token is shown by the link or picture holding it. Promise only what the page fills.`,\n  ]\n}\n\n/** A kind that builds only some plans: the creations it makes, and the shapes it refuses. */\nexport interface AiJobPlanScope extends AiPlanJobScope {\n  /** Why a job of the kind cannot build a plan of this shape; `null` when it can. Pure. */\n  shapeRefusal: (plan: AiBuildPlan, options?: { freeTaste?: boolean }) => string | null\n}\n\n/**\n * The kinds whose confirm door builds only some plans (AGL-3030). A page job\n * builds one screen and a scaffold four to eight; each builds only the\n * creations its list names. A template, layout, component, form or email job\n * builds its own record and what that record places (AGL-3143 §15,\n * `AI_JOB_CREATE_KINDS`), and holds no plan to a shape.\n */\nexport const AI_JOB_PLAN_SCOPES: Readonly<Partial<Record<AiJobKind, AiJobPlanScope>>> = {\n  page: { noun: 'a page job', creates: AI_PAGE_CREATE_KINDS, shapeRefusal: aiPagePlanShapeRefusal },\n  // A build from one request (AGL-3616): its operations are judged against\n  // the site's registry by the step, which reads it (`aiBuildPlanViolations`).\n  build: {\n    noun: 'a build',\n    creates: AI_BUILD_CREATE_KINDS,\n    shapeRefusal: (plan, options) => aiBuildPlanShapeRefusal(plan, { freeTaste: options?.freeTaste }),\n  },\n  site: { noun: 'a site scaffold', creates: AI_SITE_CREATE_KINDS, shapeRefusal: aiSitePlanShapeRefusal },\n  ...Object.fromEntries(\n    Object.entries(AI_JOB_CREATE_KINDS).map(([kind, creates]) => [\n      kind,\n      { noun: AI_JOB_CREATE_NOUNS[kind as AiJobKind] as string, creates, shapeRefusal: () => null },\n    ]),\n  ),\n}\n\n/**\n * What the plan step holds beyond the doctrine's plan rules, as the\n * violations the plan's one re-ask names: the players the plan lists against\n * the brief it answers (AGL-3433), which only this step reads beside the plan,\n * and a kind's shape refusal.\n */\nfunction planViolations(\n  scope: AiJobPlanScope | null,\n  brief: string,\n  freeTaste = false,\n  ops: AiBuildOps | null = null,\n  home: { min: number; across: number | null } | null = null,\n  blog = false,\n  site = false,\n  store = false,\n): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  const thinHome = home && home.min > 0 ? aiSiteThinHomeCheck(home) : null\n  const storeShop = store ? aiSiteStoreShopCheck() : null\n  const blogStandIn = blog ? aiSiteBlogStandInCheck() : null\n  const emptyGallery = site ? aiSiteEmptyGalleryCheck() : null\n  return (plan) => {\n    // A build's plan is held to the operations this site has (AGL-3616):\n    // an unknown op, arguments its schema refuses, a cycle or a reference\n    // nothing makes are re-asked once like every other plan rule.\n    const message = ops\n      ? aiBuildPlanShapeRefusal(plan, { freeTaste, ops })\n      : (scope?.shapeRefusal(plan, { freeTaste }) ?? null)\n    return [\n      ...aiPlanEmbedBriefViolations(plan, brief),\n      ...(message ? [{ rule: null, code: 'plan-job-shape', message }] : []),\n      ...(thinHome ? thinHome(plan) : []),\n      ...(blogStandIn ? blogStandIn(plan) : []),\n      ...(emptyGallery ? emptyGallery(plan) : []),\n      ...(storeShop ? storeShop(plan) : []),\n    ]\n  }\n}\n\n/**\n * The inventory names of every id the plan references, so the proposal reads\n * \"the Services layout\" rather than an id — kept on the plan because the\n * inventory is not read again when the member opens it.\n */\nexport function aiPlanLabels(\n  plan: AiBuildPlan,\n  inventory: AiSiteInventory | null,\n): Record<string, string> {\n  const names = new Map<string, string>()\n  for (const rows of [\n    inventory?.components,\n    inventory?.layouts,\n    inventory?.templates,\n    inventory?.forms,\n    inventory?.datasets,\n    inventory?.collections,\n    inventory?.screens,\n  ]) {\n    for (const row of rows ?? []) names.set(row.id, row.name)\n  }\n  const refs = [\n    ...plan.reuse.map((entry) => entry.id),\n    ...plan.create.map((entry) => entry.duplicateOf),\n    ...plan.screens.flatMap((screen) => [\n      screen.layout,\n      screen.template,\n      screen.duplicateOf,\n      ...screen.sections.flatMap((section) => section.uses),\n    ]),\n  ]\n  const labels: Record<string, string> = {}\n  for (const ref of refs) {\n    if (!ref || isAiPlanNewRef(ref)) continue\n    const name = names.get(ref)\n    if (name) labels[ref] = name\n  }\n  return labels\n}\n\n/* ------------------------------------------------------------------------ *\n * Reusing an identical brief's plan\n * ------------------------------------------------------------------------ */\n\n/**\n * How long a plan may be reused for (AGL-2937).\n *\n * The window is what makes reuse safe rather than merely cheap. The key\n * already covers everything the request said — the brief, the inputs, the\n * model and the prompt as rendered, site inventory included — so a plan is\n * reused only when nothing the model was shown has changed. What the key\n * cannot see is the world outside the request: a page published, a component\n * renamed after the inventory was read, a member who meant something\n * different the second time. Fifteen minutes is short enough that the answer\n * is still the one the site would give, and long enough to cover what reuse\n * is actually for — the same brief run twice in a sitting, a job resubmitted\n * after a refused reservation, two members starting the same work.\n */\nexport const AI_PLAN_REUSE_WINDOW_MS = 15 * 60 * 1_000\n\n/** Jobs one lookup reads. More than one can share a key; the newest plan wins. */\nexport const AI_PLAN_REUSE_CANDIDATES = 5\n\n/** A job whose plan might be reused, as the finder reports it. */\nexport interface AiJobPlanCandidate {\n  jobId: string\n  status: AiJobStatus\n  plan: AiJobPlan\n}\n\n/**\n * The digest a plan is reused by: the whole request, never the answer.\n *\n * It hashes what the model was asked and what it was shown — the job's kind\n * and site, the user turn (which carries the trimmed brief and every scalar\n * input), the model that would answer, every rendered system block including\n * the site inventory, and the tool's schema. Two requests that hash the same\n * would have been sent the same bytes to the same model, so the second can\n * keep the first's answer.\n *\n * The version tag is the escape hatch: anything that changes what a key\n * MEANS, rather than what it covers, bumps it and strands every old key\n * harmlessly, since a key nothing matches simply asks the model.\n */\nexport function aiJobPlanKey(input: {\n  job: Pick<AiJob, 'kind' | 'hostId'>\n  prompt: string\n  model: string\n  system: readonly AiSystemBlock[]\n  /** The plan tool the request offers (AGL-3433); the plain one when absent. */\n  tool?: AiTool\n}): string {\n  const digest = createHash('sha256')\n  for (const part of [\n    'plan.v1',\n    input.job.kind,\n    input.job.hostId ?? '',\n    input.model,\n    input.prompt,\n    ...input.system.map((block) => block.text),\n    JSON.stringify(input.tool ?? AI_BUILD_PLAN_TOOL),\n  ]) {\n    // Length-prefixed, so two different splits of the same characters cannot\n    // collide by running into one another.\n    digest.update(`${part.length}:${part}\\u0000`)\n  }\n  return digest.digest('hex')\n}\n\n/** A job that could not have produced a reusable plan, whatever its key says. */\nconst UNREUSABLE: readonly AiJobStatus[] = ['canceled', 'failed']\n\nfunction planMillis(plan: AiJobPlan): number | null {\n  const at = plan.proposedAt as unknown\n  if (at instanceof Date) return at.getTime()\n  if (at && typeof (at as { toMillis?: unknown }).toMillis === 'function') {\n    return (at as { toMillis(): number }).toMillis()\n  }\n  return null\n}\n\n/**\n * The newest plan worth reusing out of what the finder returned: another\n * job's, still proposed or already confirmed, on a job that was neither\n * canceled nor failed, proposed inside the window.\n *\n * A canceled or failed job is excluded even though its plan may be perfectly\n * good: those are the jobs a member walked away from, and handing their plan\n * to the next one would make a rejected answer look like a fresh one.\n */\nexport function aiReusablePlan(\n  candidates: readonly AiJobPlanCandidate[],\n  context: { jobId: string; now: Date },\n): AiJobPlanCandidate | null {\n  const floor = context.now.getTime() - AI_PLAN_REUSE_WINDOW_MS\n  let best: AiJobPlanCandidate | null = null\n  let bestAt = -1\n  for (const candidate of candidates) {\n    if (candidate.jobId === context.jobId) continue\n    if (UNREUSABLE.includes(candidate.status)) continue\n    if (candidate.plan.status !== 'proposed' && candidate.plan.status !== 'confirmed') continue\n    const at = planMillis(candidate.plan)\n    if (at === null || at < floor || at > context.now.getTime()) continue\n    if (at > bestAt) {\n      best = candidate\n      bestAt = at\n    }\n  }\n  return best\n}\n\nexport type AiJobPlanFinder = (\n  orgId: string,\n  key: string,\n  firestore?: FirebaseFirestore.Firestore,\n) => Promise<AiJobPlanCandidate[]>\n\n/**\n * The finder the step uses in production: an equality on `plan.key` inside\n * the org's own jobs.\n *\n * One equality on one field, with no ordering beside it, so Firestore's\n * automatic single-field index answers it and no composite index is deployed.\n * The window and the statuses are applied in memory instead, which is what\n * keeps it that way.\n */\nexport const findAiJobsByPlanKey: AiJobPlanFinder = async (orgId, key, firestore) => {\n  if (!firestore) return []\n  const snapshot = await firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(AI_JOBS_COLLECTION)\n    .where('plan.key', '==', key)\n    .limit(AI_PLAN_REUSE_CANDIDATES)\n    .get()\n  return snapshot.docs.flatMap((doc) => {\n    const data = doc.data() as { status?: AiJobStatus; plan?: AiJobPlan | null }\n    return data.plan\n      ? [{ jobId: doc.id, status: data.status ?? 'queued', plan: data.plan }]\n      : []\n  })\n}\n\n/** What a job may create on its site, read for the plan step; `null` for no site. */\nexport type AiPlanCapabilitiesReader = (input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n}) => Promise<AiPlanCapabilities | null>\n\n/** The reader the step uses in production: the draft bands' own arithmetic, for the job's site. */\nexport const readAiJobPlanCapabilities: AiPlanCapabilitiesReader = async ({ job, org, firestore }) =>\n  job.hostId ? readAiPlanCapabilities(firestore, { hostId: job.hostId, org }) : null\n\nexport interface AiJobPlanStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The reuse lookup; specs hand in a fake, and `null` turns reuse off. */\n  findPlansByKey?: AiJobPlanFinder | null\n  /** What the job may create on its site (AGL-3030); specs and the eval recorder hand in their own. */\n  readCapabilities?: AiPlanCapabilitiesReader\n  /** The kind's admission, asked of a plan before it is kept; the registry's otherwise. */\n  admissionRefusal?: typeof aiJobAdmissionRefusal\n  /** A build's operations on its site (AGL-3616); the registry and its gates otherwise. */\n  readOps?: AiBuildOpsReader\n  /**\n   * The site's business profile, status and remembered preferences\n   * (AGL-3661); specs and the eval recorder hand in their own, and `null`\n   * turns it off.\n   */\n  readSiteContext?: AiSiteContextReader | null\n  /**\n   * What a Free workspace has left (AGL-3722), read when a build's plan is\n   * kept so its card can say whether it fits; `null` turns it off.\n   */\n  readFreeCredits?: typeof readFreeAiCreditsLeft | null\n}\n\n/** What a job's site context is read with (AGL-3661). */\nexport type AiSiteContextReader = (input: {\n  job: AiJob\n  firestore: FirebaseFirestore.Firestore\n}) => Promise<AiSiteContextInput | null>\n\n/** The reader the step uses in production: fail-soft, org-scoped, `null` for a job with no site. */\nexport const readAiJobSiteContext: AiSiteContextReader = ({ job, firestore }) =>\n  readAiSiteContext(firestore, { orgId: job.orgId, hostId: job.hostId })\n\n/** What a build may plan on its site (AGL-3616). */\nexport type AiBuildOpsReader = (input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n  freeTaste: boolean\n}) => Promise<AiBuildOps>\n\n/** The reader the step uses in production: the registry, gated for the job's site. */\nexport const readAiBuildOps: AiBuildOpsReader = async ({ job, org, firestore, freeTaste }) => {\n  const host = job.hostId\n    ? (((await firestore.collection('hosts').doc(job.hostId).get()).data() ?? null) as Record<string, unknown> | null)\n    : null\n  return aiBuildOps({ orgId: job.orgId, hostId: job.hostId ?? null, org, host, freeTaste })\n}\n\n/**\n * A build plan's items with what each can cost (AGL-3616), from its\n * capability, recorded as the plan is kept so the console's estimate and the\n * confirm door read one figure without the registry.\n */\nexport function aiPlanWithItemCredits<T extends AiBuildPlan>(ops: AiBuildOps | null, plan: T): T {\n  if (!ops || !plan.items?.length) return plan\n  return {\n    ...plan,\n    items: plan.items.map((item) => {\n      const capability = ops.get(item.op)\n      return capability ? { ...item, credits: Math.max(0, Math.floor(capability.estimateCredits(item.args))) } : item\n    }),\n  }\n}\n\nexport function createAiJobPlanStep(deps: AiJobPlanStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const findPlansByKey =\n    deps.findPlansByKey === undefined ? findAiJobsByPlanKey : deps.findPlansByKey\n  const readCapabilities = deps.readCapabilities ?? readAiJobPlanCapabilities\n  const admissionRefusal = deps.admissionRefusal ?? aiJobAdmissionRefusal\n  const readOps = deps.readOps ?? readAiBuildOps\n  const readContext = deps.readSiteContext === undefined ? readAiJobSiteContext : deps.readSiteContext\n  const readFreeCredits = deps.readFreeCredits === undefined ? readFreeAiCreditsLeft : deps.readFreeCredits\n  return async ({ job, now, signal, firestore, modelFor, org: orgDocument }) => {\n    const org = (orgDocument ?? null) as Partial<AglynOrgBilling> | null\n    const [inventory, workspace, siteContext] = await Promise.all([\n      job.hostId ? readInventory(job.orgId, job.hostId, { firestore }) : Promise.resolve(null),\n      readCapabilities({ job, org, firestore }),\n      job.hostId && readContext ? readContext({ job, firestore }) : Promise.resolve(null),\n    ])\n    // The site's profile, status and memory (AGL-3661), as a per-site cached\n    // block after the plan rules. The inventory block already lists what the\n    // site holds, so the context carries no index of its own here.\n    const instructions = aiInstructionsWithSiteContext(AI_JOB_PLAN_INSTRUCTIONS, siteContext)\n    const scope = AI_JOB_PLAN_SCOPES[job.kind] ?? null\n    const capabilities = aiSitePlanCapabilities(\n      job,\n      workspace ? aiPlanCapabilitiesForJob(workspace, scope) : null,\n    )\n    const freeTaste = capabilities?.freeTaste === true\n    // A build's operations, as this site has them (AGL-3616).\n    const ops = job.kind === 'build' ? await readOps({ job, org, firestore, freeTaste }) : null\n    const site = job.kind === 'site'\n    // A kept plan waits for its confirmation; a Free build's card is told what\n    // is left, so it says before Confirm whether the build fits (AGL-3722).\n    // Net of what THIS plan just spent: the machine meters the step after it\n    // returns, so the meters read here do not hold it yet, and a card told\n    // the figure from before the plan (101) offered Confirm to a person with\n    // 48 left, who met the prompt only after pressing it (2026-10-10).\n    const planReview = async (spentUsd = 0): Promise<AiJobReview> => {\n      const review: AiJobReview = { reason: 'plan', message: AI_JOB_PLAN_REVIEW_COPY, findings: [] }\n      if (job.kind !== 'build' || !freeTaste || !readFreeCredits) return review\n      const credits = await readFreeCredits(firestore, { orgId: job.orgId, org, now, pendingUsd: spentUsd })\n      return credits ? { ...review, freeCredits: credits } : review\n    }\n    // The model switch's answer for this job (AGL-2942): the creator's pick\n    // where the plan, the org restriction and the allotment allowlists allow\n    // it, and Auto held to those same lists otherwise. Without a resolver the\n    // doctrine asks the routing table itself. A Free site plans on its\n    // provider's fast tier (AGL-3594), unless the creator picked a model.\n    const model = aiSitePlanModel(job, modelFor?.('job.plan'), freeTaste)\n    const route = AI_ROUTING_TABLE['job.plan']\n    const prompt = aiJobPlanPrompt(job, capabilities, inventory, ops)\n\n    /**\n     * The confirm door's answer for this plan, asked before the plan is kept\n     * (AGL-3030): the kind's own admission, handed the plan as the resume\n     * door hands it. A refusal fails the job with the door's sentence; a door\n     * that could not answer keeps the plan, since the resume door asks again\n     * before anything is built.\n     *\n     * Two answers are about the month's Free credits, not the plan (AGL-3722):\n     * - the 409 credits prompt KEEPS the plan. The card is told what is left\n     *   (`planReview`) and offers Build what fits / the home page first /\n     *   Upgrade, and the confirm door asks with the person's choice. Failing\n     *   here instead failed every Free build past its p90 before the card\n     *   could offer them — and paged staff with `ai.jobFailed`, as at\n     *   2026-10-09 16:38Z (600 credits estimated, 164 left).\n     * - the 429 \"nothing left\" still fails the job with its sentence, but as\n     *   the customer's limit, which raises no staff alert.\n     */\n    const refusalOnKeep = async (plan: AiJobPlan, outcome: AiJobStepOutcome): Promise<AiJobStepOutcome | null> => {\n      let refusal: Awaited<ReturnType<typeof aiJobAdmissionRefusal>> = null\n      try {\n        refusal = await admissionRefusal(job.kind, {\n          firestore,\n          orgId: job.orgId,\n          hostId: job.hostId ?? null,\n          inputs: job.inputs ?? {},\n          org,\n          plan,\n          uid: job.createdBy,\n        })\n      } catch (error) {\n        console.error('ai plan admission failed', { orgId: job.orgId, jobId: job.$id, error })\n      }\n      if (!refusal || refusal.code === AI_CREDITS_CONFIRM_CODE) return null\n      return {\n        ...outcome,\n        failure: refusal.error,\n        ...(refusal.status === 429 ? { customerLimit: true } : {}),\n      }\n    }\n\n    // Reuse before asking (AGL-2937). The key covers the whole request, so a\n    // hit is a request that would have been sent the same bytes to the same\n    // model; the window covers what the key cannot see. A reused plan spends\n    // nothing, so the machine's spent-nothing branch releases the reservation\n    // and meters no credit, and the job still stops for the member to confirm\n    // — this job's plan is proposed to this member, whatever the last one did\n    // with theirs.\n    const resolved = model ?? aiModelForStep('job.plan')\n    // A brief that asks for a video is offered the plan's list of players\n    // (AGL-3433), and a job that may bind a dataset a record template on\n    // each screen (AGL-3475).\n    const tool = aiBuildPlanToolFor(job.brief, {\n      records: Boolean(inventory?.datasets.length) || capabilities?.create.dataset.allowed === true,\n      items: job.kind === 'build',\n    })\n    const key = aiJobPlanKey({\n      job,\n      prompt,\n      model: resolved,\n      system: aiDoctrineSystemBlocks(inventory, { instructions }),\n      tool,\n    })\n    const reused = findPlansByKey\n      ? aiReusablePlan(await findPlansByKey(job.orgId, key, firestore), {\n          jobId: job.$id,\n          now,\n        })\n      : null\n    if (reused) {\n      // The reused plan's draft ids name the other job's drafts; this job's are its own.\n      const plan: AiJobPlan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, {\n        ...reused.plan,\n        status: 'proposed',\n        labels: aiPlanLabels(reused.plan, inventory),\n        proposedAt: now as unknown as AiJobPlan['proposedAt'],\n        confirmedAt: null,\n        confirmedBy: null,\n        key,\n        reusedFrom: reused.jobId,\n      }))\n      const unspent = aiUnspentOutcome(resolved)\n      return (\n        (await refusalOnKeep(plan, unspent)) ?? {\n          ...unspent,\n          plan,\n          review: await planReview(),\n        }\n      )\n    }\n\n    const result = await runValidatedGeneration('plan', {\n      step: 'job.plan',\n      ...(model ? { model } : {}),\n      instructions,\n      inventory,\n      messages: [{ role: 'user', content: prompt }],\n      tool,\n      // The routing ceiling, lowered on a tier too slow to look records up,\n      // answer and ask again inside the least time the step registered; a\n      // scaffold's outline is held to its own, far lower ceiling (AGL-3594).\n      maxTokens: aiSitePlanMaxTokens(job, resolved, freeTaste),\n      // A scaffold plans an outline without thinking (AGL-3594): the thinking\n      // was nearly all of the 13,491 tokens a Free site's plan spent.\n      ...(site ? { thinking: 'off' as const } : route.thinking ? { thinking: route.thinking } : {}),\n      ...(route.effort ? { effort: route.effort } : {}),\n      ...(signal ? { signal } : {}),\n      capabilities,\n      extend: planViolations(\n        scope,\n        job.brief,\n        freeTaste,\n        ops,\n        site ? aiSitePlanHomeRule(inventory, capabilities) : null,\n        site && aiSiteContentPart(job.inputs ?? null, freeTaste) === 'posts',\n        site,\n        site && aiSiteKindOfInputs(job.inputs)?.id === 'store',\n      ),\n    })\n    const spent: AiJobStepOutcome = {\n      outputs: [],\n      usage: result.usage,\n      estCostUsd: result.estCostUsd,\n      model: result.model,\n      stopReason: result.stopReason,\n      ...(result.effort ? { effort: result.effort } : {}),\n    }\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') {\n      // Refused by our own checks, after the one re-ask (AGL-3594): the member\n      // reads a sentence and an action, staff the rules; the machine gives the\n      // credits back (`uncredited`), and on the Free taste Try again says when\n      // it cannot work. Whether the give-back was made is the job's to say\n      // (`refundedCredits`), so this sentence does not promise it.\n      const review = aiDoctrineReview(result)\n      const retryRefusal = freeTaste\n        ? await aiFreePlanRetryRefusal({ job, org, firestore, now, site })\n        : null\n      return {\n        ...spent,\n        uncredited: true,\n        review: {\n          ...review,\n          message: aiPlanFailureCopy({\n            kind: job.kind,\n            codes: result.violations.map((violation) => violation.code),\n            refunded: false,\n          }),\n          detail: review.detail ?? review.message,\n          ...(retryRefusal ? { retryRefusal } : {}),\n        },\n      }\n    }\n    // A store's plan is a storefront's (AGL-3676): settled before it is kept and priced.\n    const answered = site && aiSiteKindOfInputs(job.inputs)?.id === 'store' ? aiSiteStorefrontPlan(result.value, { paid: !freeTaste }) : result.value\n    // Each draft the plan decides is named as the plan is kept, before anything is built (AGL-3079).\n    const plan: AiJobPlan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, {\n      ...answered,\n      status: 'proposed',\n      labels: aiPlanLabels(answered, inventory),\n      // A Date the Admin SDK stores as a timestamp, like every instant the machine writes.\n      proposedAt: now as unknown as AiJobPlan['proposedAt'],\n      confirmedAt: null,\n      confirmedBy: null,\n      key,\n    }))\n    return (\n      (await refusalOnKeep(plan, spent)) ?? {\n        ...spent,\n        plan,\n        review: await planReview(result.estCostUsd),\n      }\n    )\n  }\n}\n\n/**\n * A site job's capabilities (AGL-3594, AGL-3660): it changes no theme in its\n * plan — every scaffold designs its look first, in a unit of its own — and on\n * the Free taste its plan holds at most the pages the member asked for within\n * the Free band, which the Free wall then holds it to.\n *\n * A build's pages are written in the layout language (`aiBuildUnitJob`), whose\n * compiler draws a section's repeated items itself, so its plan is not asked\n * for a component for them (`repeatsCompiled`, AGL-3616). It still may plan\n * one, and a section two pages share is still one. Every other job's\n * capabilities pass through.\n */\nexport function aiSitePlanCapabilities(\n  job: Pick<AiJob, 'kind' | 'inputs'>,\n  capabilities: AiPlanCapabilities | null,\n): AiPlanCapabilities | null {\n  if (job.kind === 'build' && capabilities) return { ...capabilities, repeatsCompiled: true }\n  if (job.kind !== 'site' || !capabilities) return capabilities\n  const create = {\n    ...capabilities.create,\n    'theme-change': {\n      allowed: false,\n      left: null,\n      reason: 'a site start designs its own look before its pages',\n    },\n    // A site start builds its look, one layout and one form, never a\n    // component (`AI_SITE_CREATE_KINDS`), so a paid workspace's plan draws\n    // repeated items in their sections, as a Free one's does. Held to rule 1\n    // instead, every paid plan was refused: for the component it left out,\n    // or, re-asked, for the one it could not build (AGL-3660).\n    component: {\n      allowed: false,\n      left: null,\n      reason: 'a site start draws its repeated items in their sections',\n    },\n  }\n  const site = { ...capabilities, reusableComponents: false, create }\n  if (!capabilities.freeTaste) return site\n  const asked = Number((job.inputs ?? {})['pages'])\n  const pages =\n    Number.isInteger(asked) && asked >= AI_SITE_FREE_PAGES.min\n      ? Math.min(asked, AI_SITE_FREE_PAGES.max)\n      : AI_SITE_FREE_PAGES.max\n  return { ...site, freeSitePages: pages }\n}\n\n/**\n * The model a plan runs on (AGL-3594): the resolved one, except a Free site\n * plans on its provider's fast tier — an outline the plan rules hold and\n * re-ask, at a fifth of the balanced tier's output rate. A model the creator\n * picked by name stays theirs.\n */\nexport function aiSitePlanModel(\n  job: Pick<AiJob, 'kind' | 'model'>,\n  resolved: string | undefined,\n  freeTaste: boolean,\n): string | undefined {\n  if (job.kind !== 'site' || !freeTaste) return resolved\n  const picked = typeof job.model === 'string' ? job.model.trim() : ''\n  if (picked && picked !== 'auto') return resolved\n  const entry = aiCatalogEntry(resolved ?? aiModelForStep('job.plan'))\n  return (entry ? aiDefaultModelFor(entry.provider, 'fast') : undefined) ?? resolved\n}\n\n/** The plan's answer ceiling: the step's own, and a scaffold's outline ceiling under it (AGL-3594). */\nexport function aiSitePlanMaxTokens(\n  job: Pick<AiJob, 'kind'>,\n  model: string,\n  freeTaste: boolean,\n): number {\n  const ceiling = aiJobPlanMaxTokens(model)\n  if (job.kind !== 'site') return ceiling\n  return Math.min(ceiling, freeTaste ? AI_SITE_PLAN_MAX_TOKENS.free : AI_SITE_PLAN_MAX_TOKENS.paid)\n}\n\n/**\n * Why trying a Free plan again cannot work this month, or `null` (AGL-3594):\n * the owner's Free allowance left, read off the account month the meter\n * writes net of give-backs, against what a plan of this kind costs at its\n * worst. Read before this step is metered, and the machine gives a refused\n * plan's credits back, so the figure read is the figure left. A read that fails\n * leaves the button on: the reservation still refuses at the wall.\n */\nasync function aiFreePlanRetryRefusal(input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n  now: Date\n  site: boolean\n}): Promise<string | null> {\n  const account = freeAssistAccount(input.org as AssistMeteredOrg | null)\n  if (!account?.accountUid) return null\n  try {\n    // The meter's month key, `YYYY-MM` in UTC (`assistUsageMonth`).\n    const month = input.now.toISOString().slice(0, 7)\n    const snapshot = await freeAccountUsageRef(input.firestore, account.accountUid, month).get()\n    const spent = assistCreditsFromUsd(\n      assistSpendAfterReturnsUsd(snapshot.get('estCostUsd'), snapshot.get(ASSIST_RETURNED_USD_FIELD)),\n    )\n    return aiPlanRetryRefusal({\n      creditsLeft: FREE_AI_TASTE_CREDITS_PER_MONTH - spent,\n      planCredits: input.site ? AI_FREE_SITE_WORST_CASE_CREDITS.plan : AI_FREE_PAGE_WORST_CASE_CREDITS.plan,\n    })\n  } catch (error) {\n    console.error('ai plan retry allowance read failed', { orgId: input.job.orgId, jobId: input.job.$id, error })\n    return null\n  }\n}\n\nexport const runAiJobPlanStep = createAiJobPlanStep()\n\n/**\n * Registers the plan step every planned kind runs first, with the least time\n * a plan needs; the plugin's console surface calls it.\n */\nexport function registerAiJobPlan(): void {\n  registerAiJobPlanStep(runAiJobPlanStep, { minimumMs: AI_JOB_PLAN_STEP_MINIMUM_MS })\n}\n"],"names":["aiSiteKindOfInputs","createHash","AI_BUILD_PLAN_TOOL","aiBuildPlanToolFor","isAiPlanNewRef","readFreeAiCreditsLeft","AI_TEMPLATE_SUBJECT_DEFINITIONS","aiTemplateShownTokens","AI_JOB_CREATE_KINDS","AI_JOB_CREATE_NOUNS","AI_PAGE_CREATE_KINDS","aiPagePlanShapeRefusal","AI_PLAN_COMPILED_REPEATS_SENTENCE","AI_PLAN_NO_FORM_SENTENCE","aiPlanCanPlaceForm","aiPlanCapabilitiesForJob","aiPlanCapabilityLines","AI_FREE_SITE_WORST_CASE_CREDITS","AI_SITE_CREATE_KINDS","AI_SITE_FREE_PAGES","AI_SITE_PLAN_MAX_TOKENS","AI_SITE_HOME_BANDS","aiFreeSiteSectionsWithin","aiSiteFullPlanSentence","aiSiteHomeMinSections","aiSiteNameSentence","aiSitePlanIsHome","aiSitePlanShapeRefusal","aiSiteBlogStandInViolations","aiSiteThinHomeViolations","AI_SITE_GALLERY_SENTENCE","aiSiteEmptyGalleryViolations","aiSiteContentPart","aiLayoutIsShopPage","aiLayoutShopGridSection","aiStorefrontPlanScreens","AI_GENERATION_MAX_ATTEMPTS","aiPlanFailureCopy","aiPlanRetryRefusal","FREE_AI_TASTE_CREDITS_PER_MONTH","aiDoctrineSystemBlocks","runValidatedGeneration","AI_STEP_TIERS","aiCatalogEntry","aiDefaultModelFor","AI_FREE_PAGE_WORST_CASE_CREDITS","aiPlanEmbedBriefViolations","assistCreditsFromUsd","ASSIST_RETURNED_USD_FIELD","assistSpendAfterReturnsUsd","freeAccountUsageRef","freeAssistAccount","AI_ROUTING_TABLE","aiModelForStep","readSiteInventory","readAiSiteContext","aiInstructionsWithSiteContext","AI_BUILD_CREATE_KINDS","AI_BUILD_STRUCTURAL_OPS","aiBuildPageLimit","aiBuildPlanShapeRefusal","aiBuildOpLines","aiBuildOps","aiJobAdmissionRefusal","AI_CREDITS_CONFIRM_CODE","readAiPlanCapabilities","AI_JOB_BRIEF_MAX_CHARS","aiJobStepBudget","aiDoctrineReview","aiUnspentOutcome","aiPlanWithDraftIds","AI_JOBS_COLLECTION","registerAiJobPlanStep","AI_JOB_PLAN_INSTRUCTIONS","text","AI_JOB_PLAN_STEP_BUDGET","tier","maxTokens","AI_JOB_PLAN_STEP_MINIMUM_MS","minimumMs","aiJobPlanMaxTokens","model","AI_JOB_PLAN_REVIEW_COPY","aiJobPlanPrompt","job","capabilities","inventory","ops","lines","kind","brief","slice","key","value","Object","entries","inputs","push","String","aiPlanTemplateTokenLines","aiPlanSiteLines","aiPlanBuildLines","join","pages","freeTaste","repeatsCompiled","name","trim","screens","filter","screen","template","starter","find","replaceable","length","page","slug","some","cap","freeSitePages","home","aiSitePlanHomeRule","undefined","across","plansHome","min","bands","id","AI_SITE_STORE_HOME_BANDS","AI_SITE_FORM_SENTENCE","label","toLowerCase","AI_SITE_STORE_SHOP_SENTENCE","layouts","forms","aiSiteThinHomeCheck","rule","answers","plan","aiSiteStorefrontPlan","options","paid","isShopPage","gridSection","every","index","AI_SITE_STORE_SHOP_CODE","aiSiteStoreShopPageViolations","code","message","paths","aiSiteStoreShopCheck","aiSiteEmptyGalleryCheck","aiSiteBlogStandInCheck","subject","definition","AI_JOB_PLAN_SCOPES","noun","creates","shapeRefusal","build","site","fromEntries","map","planViolations","scope","blog","store","thinHome","storeShop","blogStandIn","emptyGallery","aiPlanLabels","names","Map","rows","components","templates","datasets","collections","row","set","refs","reuse","entry","create","duplicateOf","flatMap","layout","sections","section","uses","labels","ref","get","AI_PLAN_REUSE_WINDOW_MS","AI_PLAN_REUSE_CANDIDATES","aiJobPlanKey","input","digest","part","hostId","prompt","system","block","JSON","stringify","tool","update","UNREUSABLE","planMillis","at","proposedAt","Date","getTime","toMillis","aiReusablePlan","candidates","context","floor","now","best","bestAt","candidate","jobId","includes","status","findAiJobsByPlanKey","orgId","firestore","snapshot","collection","doc","where","limit","docs","data","readAiJobPlanCapabilities","org","readAiJobSiteContext","readAiBuildOps","host","aiPlanWithItemCredits","items","item","capability","op","credits","Math","max","estimateCredits","args","createAiJobPlanStep","deps","readInventory","findPlansByKey","readCapabilities","admissionRefusal","readOps","readContext","readSiteContext","readFreeCredits","signal","modelFor","orgDocument","workspace","siteContext","Promise","all","resolve","instructions","aiSitePlanCapabilities","planReview","spentUsd","review","reason","findings","pendingUsd","freeCredits","aiSitePlanModel","route","refusalOnKeep","outcome","refusal","uid","createdBy","error","console","$id","failure","customerLimit","resolved","records","Boolean","dataset","allowed","reused","confirmedAt","confirmedBy","reusedFrom","unspent","result","step","messages","role","content","aiSitePlanMaxTokens","thinking","effort","extend","spent","outputs","usage","estCostUsd","stopReason","refused","retryRefusal","aiFreePlanRetryRefusal","uncredited","codes","violations","violation","refunded","detail","answered","left","component","reusableComponents","asked","Number","isInteger","picked","provider","ceiling","free","account","accountUid","month","toISOString","creditsLeft","planCredits","runAiJobPlanStep","registerAiJobPlan"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-plan-step.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { aiSiteKindOfInputs } from '../model/ai-site-kinds'\nimport { createHash } from 'node:crypto'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport {\n  AI_BUILD_PLAN_TOOL,\n  aiBuildPlanToolFor,\n  isAiPlanNewRef,\n  type AiBuildPlan,\n} from '../model/ai-build-plan'\nimport type { AiJob, AiJobKind, AiJobPlan, AiJobReview, AiJobStatus } from '../model/ai-jobs.types'\nimport { readFreeAiCreditsLeft } from '../usage/free-ai-credits-left'\nimport {\n  AI_TEMPLATE_SUBJECT_DEFINITIONS,\n  aiTemplateShownTokens,\n  type AiTemplateSubject,\n} from '../model/ai-template-subjects'\nimport { AI_JOB_CREATE_KINDS, AI_JOB_CREATE_NOUNS } from '../model/ai-job-creations'\nimport { AI_PAGE_CREATE_KINDS, aiPagePlanShapeRefusal } from '../model/ai-page-job'\nimport {\n  AI_PLAN_COMPILED_REPEATS_SENTENCE,\n  AI_PLAN_NO_FORM_SENTENCE,\n  aiPlanCanPlaceForm,\n  aiPlanCapabilitiesForJob,\n  aiPlanCapabilityLines,\n  type AiPlanCapabilities,\n  type AiPlanJobScope,\n} from '../model/ai-plan-capabilities'\nimport type { AiSiteInventory } from '../model/ai-site-inventory'\nimport { aiSitePlanDatasetCapability } from './ai-job-site-datasets'\nimport {\n  AI_FREE_SITE_WORST_CASE_CREDITS,\n  AI_SITE_CREATE_KINDS,\n  AI_SITE_FREE_PAGES,\n  AI_SITE_PLAN_MAX_TOKENS,\n  AI_SITE_HOME_BANDS,\n  aiFreeSiteSectionsWithin,\n  aiSiteFullPlanSentence,\n  aiSiteHomeMinSections,\n  aiSiteNameSentence,\n  aiSitePlanIsHome,\n  aiSitePlanShapeRefusal,\n  aiSiteBlogStandInViolations,\n  aiSiteThinHomeViolations,\n  AI_SITE_GALLERY_SENTENCE,\n  aiSiteEmptyGalleryViolations,\n  AI_SITE_DATASETS_MAX,\n} from '../model/ai-site-job'\nimport { aiSiteContentPart } from './ai-job-site-content'\nimport { aiLayoutIsShopPage, aiLayoutShopGridSection } from '../layout-language/ai-layout-listings'\nimport { aiStorefrontPlanScreens } from '../layout-language/ai-layout-storefront'\nimport { AI_GENERATION_MAX_ATTEMPTS } from '../runtime/ai-generation-bounds'\nimport { aiPlanFailureCopy, aiPlanRetryRefusal } from '../model/ai-job-failure-copy'\nimport { FREE_AI_TASTE_CREDITS_PER_MONTH } from '../plan-entitlements'\nimport { aiDoctrineSystemBlocks, runValidatedGeneration } from '../runtime/ai-doctrine'\nimport { AI_STEP_TIERS, aiCatalogEntry, aiDefaultModelFor } from '../providers/catalog'\nimport {\n  AI_FREE_PAGE_WORST_CASE_CREDITS,\n  aiPlanEmbedBriefViolations,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { assistCreditsFromUsd } from '../usage/assist-credits'\nimport { ASSIST_RETURNED_USD_FIELD, assistSpendAfterReturnsUsd } from '../usage/assist-credit-returns'\nimport { freeAccountUsageRef, freeAssistAccount, type AssistMeteredOrg } from '../usage/assist-free-taste'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport type { AiTool } from '../providers/contract'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { readAiSiteContext } from '../runtime/site-context'\nimport { aiInstructionsWithSiteContext, type AiSiteContextInput } from '../model/ai-site-context'\nimport {\n  AI_BUILD_CREATE_KINDS,\n  AI_BUILD_STRUCTURAL_OPS,\n  aiBuildPageLimit,\n  aiBuildPlanShapeRefusal,\n  type AiBuildOps,\n} from '../model/ai-build-job'\nimport { aiBuildOpLines, aiBuildOps } from './ai-build-capabilities'\nimport { aiJobAdmissionRefusal } from './ai-job-admission'\nimport { AI_CREDITS_CONFIRM_CODE } from '../model/ai-credit-estimate'\nimport { readAiPlanCapabilities } from './ai-job-drafts'\nimport {\n  AI_JOB_BRIEF_MAX_CHARS,\n  type AiJobStepOutcome,\n  type AiJobStepRunner,\n} from './ai-job-text-step'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiDoctrineReview, aiUnspentOutcome } from './ai-job-generation'\nimport { aiPlanWithDraftIds } from './ai-job-draft-ids'\nimport { AI_JOBS_COLLECTION, registerAiJobPlanStep } from './ai-jobs'\n\n/**\n * The plan step (AGL-2935): the first step of every job that builds site\n * structure. Before a node is generated, the model answers with a typed plan\n * — what the site already has that the job reuses, what it creates and why,\n * and the screens it builds from them — held to the doctrine's plan rules\n * against the site's inventory and re-asked once when it breaks one.\n *\n * A plan that passes is kept on the job, and the job stops for review: the\n * member reads what it will build before a credit is spent building it, and\n * confirms through the resume door. A plan that still breaks a rule on its\n * re-ask stops the job the same way, with the rules named. Either way the\n * step writes nothing itself; the machine records the plan, the spend and\n * the stop, as it records every step.\n *\n * ── Told what it may create, refused what it cannot build (AGL-3030) ─────\n *\n * Before it asks, the step reads what the job may create on its site: the\n * workspace's plan, the site's counts against its limits, and — for a kind\n * that builds only some plans — what the job builds itself. The user turn\n * states it, the plan rules refuse a creation outside it with the one re-ask,\n * and where the workspace keeps no reusable components they accept the page\n * built inline. A plan the confirm door would still refuse — the kind's own\n * admission, handed the plan, as the resume door hands it — is refused HERE,\n * before a member is shown a Confirm: the job fails with the door's sentence,\n * its plan is not kept, and it holds nothing.\n */\n\n/** The plan step's own instructions, cached after the doctrine. */\nexport const AI_JOB_PLAN_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text:\n      'You plan what a website builder job will build, before anything is built. You are given the kind of job and the brief from the person who owns the site. ' +\n      'Answer with submit_build_plan: what the site inventory already has that the job reuses, what it must create and why nothing listed will do, and each page it builds (the screens list) with its layout, template, slug, search title, search description and sections from top to bottom. ' +\n      'Refer to inventory records by id and to what the plan creates as new:<name>. Plan only what the brief asks for: a component, layout, template, form or email job plans no pages unless the brief asks for them, and a page job plans exactly one page.',\n  },\n]\n\n/**\n * The plan step's time (AGL-3026, AGL-3036): its two inventory-lookup rounds,\n * its answer and its re-ask at the routing table's ceiling for `job.plan`, on\n * the tier that step kind is served from, with the step's reads and writes,\n * at the rates `ai-job-budget.ts` assumes — fitted to what a beat can give a\n * step, so the served tier asks a little under the routing ceiling.\n */\nexport const AI_JOB_PLAN_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.plan'],\n  maxTokens: AI_ROUTING_TABLE['job.plan'].maxTokens,\n})\n\n/**\n * The least time a plan needs before it starts. Registered with the step, so\n * an inline door never starts a plan. A plan thinks before it answers and\n * routinely runs past an inline door's budget, and a provider call that\n * budget cuts off is still generated and billed upstream while the meter\n * records nothing. The beat starts a plan only with this much of its own\n * budget left, and a spec holds it inside that budget.\n */\nexport const AI_JOB_PLAN_STEP_MINIMUM_MS = AI_JOB_PLAN_STEP_BUDGET.minimumMs\n\n/**\n * The plan's answer ceiling on the model a job runs: the most whose worst\n * case fits the least time the step registered, and never more than the\n * routing table's. A model the catalog does not know is planned at the\n * slowest.\n */\nexport function aiJobPlanMaxTokens(model: string): number {\n  return AI_JOB_PLAN_STEP_BUDGET.maxTokens(model)\n}\n\n/** What the member reads while a plan waits for them. */\nexport const AI_JOB_PLAN_REVIEW_COPY =\n  'The plan is ready. Review what the job will reuse and create, then confirm it to build.'\n\n/**\n * The job as the plan step's user turn: its kind, its brief, its scalar\n * inputs and, where the job read them, what it may create on its site\n * (AGL-3030). Per workspace and per site, which is why they ride here and\n * never in a system block the platform's cache entry is keyed on.\n */\nexport function aiJobPlanPrompt(\n  job: Pick<AiJob, 'kind' | 'brief' | 'inputs'>,\n  capabilities: AiPlanCapabilities | null = null,\n  inventory: AiSiteInventory | null = null,\n  ops: AiBuildOps | null = null,\n): string {\n  const lines = [`Job kind: ${job.kind}`, `Brief: ${job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`]\n  for (const [key, value] of Object.entries(job.inputs ?? {})) {\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n      lines.push(`${key}: ${String(value)}`)\n    }\n  }\n  if (capabilities) lines.push(...aiPlanCapabilityLines(capabilities))\n  // A form is a saved form or none (AGL-3596): said where the site read has\n  // none to place and the job may create none.\n  if (capabilities && inventory && !aiPlanCanPlaceForm(inventory, capabilities)) {\n    lines.push(AI_PLAN_NO_FORM_SENTENCE)\n  }\n  lines.push(...aiPlanTemplateTokenLines(job))\n  lines.push(...aiPlanSiteLines(job, inventory, capabilities))\n  lines.push(...aiPlanBuildLines(job, capabilities, ops))\n  return lines.join('\\n')\n}\n\n/**\n * What a BUILD job's plan is told (AGL-3616): that one request becomes pages,\n * creations and items, how many pages it may hold, and the item operations\n * this site has with their arguments. On the job's own turn, never a cached\n * system block, because the operations are per site.\n */\nexport function aiPlanBuildLines(\n  job: Pick<AiJob, 'kind'>,\n  capabilities: AiPlanCapabilities | null,\n  ops: AiBuildOps | null,\n): string[] {\n  if (job.kind !== 'build') return []\n  const pages = aiBuildPageLimit(capabilities?.freeTaste === true)\n  return [\n    `This is a build from one request: plan each page it asks for in screens (at most ${pages}), each new layout, form, component or email design in create, and anything else in items. Plan only what the request asks for; reuse what the site has.`,\n    'A page section that shows a form or an item places it: put its new:<name> in that section\\'s uses. An item built after another lists it in dependsOn.',\n    // The layout language draws a section's repeated items (AGL-3660), so the\n    // doctrine's \"repeated items place a component\" is not asked of a build.\n    ...(capabilities?.repeatsCompiled ? [AI_PLAN_COMPILED_REPEATS_SENTENCE] : []),\n    ...(ops ? aiBuildOpLines(ops, AI_BUILD_STRUCTURAL_OPS) : []),\n  ]\n}\n\n/**\n * What a SITE job's plan is told beside the inventory (AGL-3594): the pages\n * the site already has and that their addresses are taken, which one — the\n * untouched starter home — a planned home page at `/` replaces, the Free page\n * cap and its guidance, and that a plan is an outline.\n *\n * A site job only. A new site is born with a published home page at `/`\n * (AGL-3497), and a plan that did not know it could replace it planned its own\n * home there and was refused for the clash on every new site. Kept off a page\n * job's turn, whose length the Free page's wall is proven at.\n */\nexport function aiPlanSiteLines(\n  job: Pick<AiJob, 'kind'> & Partial<Pick<AiJob, 'inputs'>>,\n  inventory: AiSiteInventory | null,\n  capabilities: AiPlanCapabilities | null,\n): string[] {\n  if (job.kind !== 'site') return []\n  const lines: string[] = []\n  // The business's own name, as the name to use (AGL-3596): the plan's search\n  // titles carry it, and an input line alone left the model free to coin one.\n  const name = job.inputs?.['businessName']\n  if (typeof name === 'string' && name.trim()) lines.push(aiSiteNameSentence(name.trim()))\n  const pages = (inventory?.screens ?? []).filter((screen) => !screen.template)\n  const starter = pages.find((screen) => screen.replaceable)\n  if (pages.length) {\n    lines.push('Pages the site already has; their addresses are taken unless a line says otherwise:')\n    for (const page of pages) {\n      lines.push(\n        page.replaceable\n          ? `- ${page.name} at ${page.slug}: the starter home page the site was created with. Plan this site's home page at / and it replaces this one.`\n          : `- ${page.name} at ${page.slug}`,\n      )\n    }\n    if (!starter && pages.some((page) => page.slug.trim() === '/' || page.slug.trim() === '')) {\n      lines.push(\"The home page at / is the owner's own and stays: give every page you plan another address.\")\n    }\n  }\n  const cap = capabilities?.freeSitePages\n  const home = aiSitePlanHomeRule(inventory, capabilities)\n  if (cap !== undefined) {\n    lines.push(\n      `This is a Free workspace: plan at most ${cap} ${cap === 1 ? 'page' : 'pages'} — the home page at / and the one page the brief most needs, such as services, booking or contact — and ${home.across} sections across them.${aiPlanCanPlaceForm(inventory, capabilities) ? ' Put the contact form on one of them.' : ''}`,\n    )\n  }\n  // A new site is a full website (AGL-3660): its home is planned as one, not\n  // left to a ceiling the outline is free to stay far under.\n  const plansHome = !pages.some((page) => !page.replaceable && aiSitePlanIsHome(page))\n  if (home.min > 0 && plansHome) {\n    // A store's home is a storefront (AGL-3676): its own parts, in its own order.\n    const bands = aiSiteKindOfInputs(job.inputs)?.id === 'store' ? AI_SITE_STORE_HOME_BANDS : AI_SITE_HOME_BANDS\n    lines.push(`The home page at / reads as a full website: at least ${home.min} sections — ${bands}.`)\n  }\n  // The sections are a budget to use (AGL-3660): a prod start of 2026-10-08\n  // read \"at most 8\" as leave to plan a home of two.\n  lines.push(aiSiteFullPlanSentence({ pages: cap ?? 1, across: home.across, min: plansHome ? home.min : 0 }))\n  // A paid blog's first posts are written at /blog and linked from the\n  // header (AGL-3660, AGL-3676), so the plan plans no page standing in for it.\n  if (aiSiteContentPart(job.inputs ?? null, capabilities?.freeTaste === true) === 'posts') {\n    lines.push(\n      \"This site's blog is written for it with its first posts at /blog, and the header links it. Plan no page that stands in for it (no Blog, Articles, Journal, Posts or Stories page); feature the posts in a section of the home page instead.\",\n    )\n  }\n  // A section that shows the work counts its pieces (AGL-3660): a planned\n  // gallery of no items let a page about the work show none.\n  lines.push(AI_SITE_GALLERY_SENTENCE)\n  // A section that asks for something places the form (AGL-3660): a live\n  // portfolio start planned a commissions inquiry beside the form it made\n  // for its Contact page, without placing it.\n  if (aiPlanCanPlaceForm(inventory, capabilities)) lines.push(AI_SITE_FORM_SENTENCE)\n  // Structured content is kept as a dataset where one may be made (AGL-3616).\n  if (capabilities?.create.dataset.allowed) {\n    lines.push(aiSiteDatasetSentence(Math.min(capabilities.datasetsMax ?? AI_SITE_DATASETS_MAX, capabilities.create.dataset.left ?? AI_SITE_DATASETS_MAX)))\n  }\n  // The kind of site the person picked (AGL-3660): the pages it usually has.\n  const kind = aiSiteKindOfInputs(job.inputs)\n  if (kind) lines.push(`This is a ${kind.label.toLowerCase()} site. ${kind.pages}`)\n  // A store's Shop page IS its storefront (AGL-3676): the platform lists the\n  // real products there, so the plan names the section and draws no range.\n  if (kind?.id === 'store') lines.push(AI_SITE_STORE_SHOP_SENTENCE)\n  lines.push(\n    \"Keep the plan an outline: each page's title, address, a short search title and description, and its sections named in a few words. The build writes the copy.\",\n  )\n  return lines\n}\n\n/**\n * The sentence a site plan's turn states about a section that collects\n * answers (AGL-3660): it places the saved form by reference, and one form\n * may be placed on more than one page.\n */\nexport const AI_SITE_FORM_SENTENCE =\n  \"A section that asks visitors for something (contact, inquiry, commissions, booking, sign-up) places the form: put new:<the form's name> or the site's form id in its uses. One form may be placed on several pages.\"\n\n/**\n * The sentence a site plan's turn states where it may create datasets, with\n * how many it may (the live eval of 2026-10-10 planned four past a cap of\n * three it was never told)\n * (AGL-3616): a list of like things is kept as one, named in the sections\n * that list it, and a page of its own per record is that dataset's record\n * template. Only where datasets may be made, so a Free plan's turn, whose\n * length its wall is proven at, is unchanged.\n */\nexport function aiSiteDatasetSentence(max: number): string {\n  return `Keep structured content as a dataset, at most ${max} ${max === 1 ? 'dataset' : 'datasets'}, and only for a list of 4 or more similar items: a menu, a team, services, portfolio pieces, events, questions and answers; never reviews or testimonials. Create the dataset, its fields the items' field names, and put new:<the dataset's name> in the uses of each section that lists them; the platform lists its records there. Where each item deserves a page of its own, plan one page as the dataset's record template. Anything else stays written on its page. ${AI_SITE_FORM_DATASET_SENTENCE}`\n}\n\n/**\n * What a paid site plan is told about a form that writes to a dataset\n * (AGL-3616, Zach 2026-10-10): only where the person would want each\n * submission kept as a record, the dataset created with the form's own\n * field names, and never listed, because its records are the people who\n * sent the form.\n */\nexport const AI_SITE_FORM_DATASET_SENTENCE =\n  \"Where each submission of the form should also be kept as a record (volunteer sign-ups, RSVPs, inquiries), the form writes to a dataset: create the dataset, its fields the form's field names, and set the form's writesTo to new:<the dataset's name>; that dataset counts toward the same limit and no section lists it. Otherwise writesTo is null.\"\n\n\n/**\n * What a site start's home page is held to (AGL-3660): its fewest sections,\n * and on the Free taste the sections the wall fits across the pages, which\n * the home's count is shared out of. The plan's turn and its re-ask read this\n * one figure, so the sentence the model is told is the check it is held to.\n */\nexport function aiSitePlanHomeRule(\n  inventory: AiSiteInventory | null,\n  capabilities: AiPlanCapabilities | null,\n): { min: number; across: number | null } {\n  const cap = capabilities?.freeSitePages\n  if (cap === undefined) return { min: aiSiteHomeMinSections({ pages: 1, across: null }), across: null }\n  // Dear: a guided start that places a form makes one (AGL-3596).\n  const across = aiFreeSiteSectionsWithin(\n    { layouts: (inventory?.layouts.length ?? 0) ? 0 : 1, pages: cap, forms: 1 },\n    FREE_AI_TASTE_CREDITS_PER_MONTH,\n  )\n  return { min: aiSiteHomeMinSections({ pages: cap, across }), across }\n}\n\n/**\n * A site plan's thin home, asked about on the FIRST answer only (AGL-3660).\n * The re-ask names the count; an answer that still plans a thinner home is\n * kept, since a home with four sections is a site and a stopped start is\n * none — the same trade a language page makes with its last answer's gaps.\n */\nexport function aiSiteThinHomeCheck(\n  rule: { min: number; across: number | null },\n): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteThinHomeViolations(plan, rule)\n  }\n}\n\n/** What a store's plan is told about its Shop page (AGL-3676). */\nexport const AI_SITE_STORE_SHOP_SENTENCE =\n  'Plan a Shop page at /shop: a short title section, then a section named \"Product grid\" second, where the platform lists the store\\'s real products with sort, filters, photos, prices and cart, then at most one or two short sections (care, shipping, gifting help). Never open it with a hero, and never plan the products themselves as cards of your own.'\n\n/** What a store's home is composed of (AGL-3676): a storefront's parts, in a storefront's order. */\nexport const AI_SITE_STORE_HOME_BANDS =\n  'a hero that sells first, then \"Bestsellers\" (the platform lists the real products), \"Shop by collection\" with 3 or 4 items, the brand story, why buy here with 3 or 4 items, \"Customer reviews\" (the platform shows the store\\'s real ones) and a \"Newsletter sign-up\" band last'\n\n/**\n * A store plan held to a storefront (AGL-3676, `ai-layout-storefront.ts`):\n * on a paid start its home gains the parts a shopper expects that the plan\n * left out — bestsellers, collections, reviews, a newsletter sign-up —\n * while the page has room; on any start its Shop page opens on its grid.\n * Settled, never re-asked: each part has one answer, and the Free wall's\n * home keeps the sections it planned.\n */\nexport function aiSiteStorefrontPlan<P extends Pick<AiBuildPlan, 'screens'>>(plan: P, options: { paid: boolean }): P {\n  const screens = aiStorefrontPlanScreens(plan.screens, {\n    paid: options.paid,\n    isShopPage: aiLayoutIsShopPage,\n    gridSection: aiLayoutShopGridSection,\n  })\n  return screens.every((screen, index) => screen === plan.screens[index]) ? plan : { ...plan, screens }\n}\n\n/** The code a store plan with no Shop page is re-asked under. */\nexport const AI_SITE_STORE_SHOP_CODE = 'plan-store-shop-page'\n\n/**\n * A store plan of two or more pages with no Shop page (AGL-3676): the page\n * the platform lists the catalog on is the one a shopper looks for. A\n * one-page Free taste lists its products on the home instead.\n */\nexport function aiSiteStoreShopPageViolations(\n  plan: Pick<AiBuildPlan, 'screens'>,\n): Array<{ rule: null; code: string; message: string; paths: string[] }> {\n  if (plan.screens.length < 2 || plan.screens.some((screen) => aiLayoutIsShopPage(screen))) return []\n  return [\n    {\n      rule: null,\n      code: AI_SITE_STORE_SHOP_CODE,\n      message:\n        'This store has no Shop page. Plan one at /shop, its second section named \"Product grid\": the platform lists the real products there.',\n      paths: ['screens'],\n    },\n  ]\n}\n\n/** A store plan's missing Shop page, asked about on the FIRST answer only, like a thin home. */\nexport function aiSiteStoreShopCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteStoreShopPageViolations(plan)\n  }\n}\n\n/**\n * A site plan's section that shows the work without its pieces (AGL-3660),\n * asked about on the FIRST answer only, like a thin home: the re-ask names\n * the section, and an answer that keeps it thin is kept.\n */\nexport function aiSiteEmptyGalleryCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteEmptyGalleryViolations(plan)\n  }\n}\n\n/**\n * A site plan's page standing in for the blog its start writes (AGL-3660),\n * asked about on the FIRST answer only, like a thin home: the re-ask names\n * the page, and an answer that keeps it is kept — the posts then take the\n * next address the page leaves free, and the header links them all the same.\n */\nexport function aiSiteBlogStandInCheck(): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  let answers = 0\n  return (plan) => {\n    answers += 1\n    if (answers >= AI_GENERATION_MAX_ATTEMPTS) return []\n    return aiSiteBlogStandInViolations(plan)\n  }\n}\n\n/**\n * What a TEMPLATE job's plan is told its creation's `fields` are (AGL-3143\n * §11): the subject's binding tokens, listed so the planner promises only\n * what the page can fill and the build can be held to it\n * (`aiPlanTemplateTokenViolations`).\n *\n * ⛔ It rides the job's own turn and NOT the `fields` description in the plan\n * tool, which every kind's request caches. Written there it read better and\n * cost 40 tokens of the shared prefix — 2,980 to 3,020 — which is one credit\n * of the Free page's 300-credit wall, taking the room it keeps for a re-asked\n * section from 45 credits to 44 and breaking `ai-job-free-page.spec.ts`. A\n * page job must not pay for a sentence about templates.\n *\n * The list is the tokens a reader sees, never the whole catalog (AGL-3143\n * §16). Offered a slug and the publish timestamp, a live plan promised them,\n * and its build kept the promise the only way a slug can be kept: it printed\n * \"entry slug: {{entry.slug}}\" on every article.\n */\nexport function aiPlanTemplateTokenLines(job: Pick<AiJob, 'kind' | 'inputs'>): string[] {\n  if (job.kind !== 'template') return []\n  const subject = (job.inputs ?? {})['subject']\n  const definition =\n    typeof subject === 'string'\n      ? AI_TEMPLATE_SUBJECT_DEFINITIONS[subject as AiTemplateSubject]\n      : undefined\n  if (!definition) return []\n  return [\n    `The template's fields are the binding tokens its page shows a reader, each one of: ${aiTemplateShownTokens(\n      definition,\n    ).join(', ')}. A link or picture token is shown by the link or picture holding it. Promise only what the page fills.`,\n  ]\n}\n\n/** A kind that builds only some plans: the creations it makes, and the shapes it refuses. */\nexport interface AiJobPlanScope extends AiPlanJobScope {\n  /** Why a job of the kind cannot build a plan of this shape; `null` when it can. Pure. */\n  shapeRefusal: (plan: AiBuildPlan, options?: { freeTaste?: boolean }) => string | null\n}\n\n/**\n * The kinds whose confirm door builds only some plans (AGL-3030). A page job\n * builds one screen and a scaffold four to eight; each builds only the\n * creations its list names. A template, layout, component, form or email job\n * builds its own record and what that record places (AGL-3143 §15,\n * `AI_JOB_CREATE_KINDS`), and holds no plan to a shape.\n */\nexport const AI_JOB_PLAN_SCOPES: Readonly<Partial<Record<AiJobKind, AiJobPlanScope>>> = {\n  page: { noun: 'a page job', creates: AI_PAGE_CREATE_KINDS, shapeRefusal: aiPagePlanShapeRefusal },\n  // A build from one request (AGL-3616): its operations are judged against\n  // the site's registry by the step, which reads it (`aiBuildPlanViolations`).\n  build: {\n    noun: 'a build',\n    creates: AI_BUILD_CREATE_KINDS,\n    shapeRefusal: (plan, options) => aiBuildPlanShapeRefusal(plan, { freeTaste: options?.freeTaste }),\n  },\n  site: { noun: 'a site scaffold', creates: AI_SITE_CREATE_KINDS, shapeRefusal: aiSitePlanShapeRefusal },\n  ...Object.fromEntries(\n    Object.entries(AI_JOB_CREATE_KINDS).map(([kind, creates]) => [\n      kind,\n      { noun: AI_JOB_CREATE_NOUNS[kind as AiJobKind] as string, creates, shapeRefusal: () => null },\n    ]),\n  ),\n}\n\n/**\n * What the plan step holds beyond the doctrine's plan rules, as the\n * violations the plan's one re-ask names: the players the plan lists against\n * the brief it answers (AGL-3433), which only this step reads beside the plan,\n * and a kind's shape refusal.\n */\nfunction planViolations(\n  scope: AiJobPlanScope | null,\n  brief: string,\n  freeTaste = false,\n  ops: AiBuildOps | null = null,\n  home: { min: number; across: number | null } | null = null,\n  blog = false,\n  site = false,\n  store = false,\n): (plan: AiBuildPlan) => AiDoctrineViolation[] {\n  const thinHome = home && home.min > 0 ? aiSiteThinHomeCheck(home) : null\n  const storeShop = store ? aiSiteStoreShopCheck() : null\n  const blogStandIn = blog ? aiSiteBlogStandInCheck() : null\n  const emptyGallery = site ? aiSiteEmptyGalleryCheck() : null\n  return (plan) => {\n    // A build's plan is held to the operations this site has (AGL-3616):\n    // an unknown op, arguments its schema refuses, a cycle or a reference\n    // nothing makes are re-asked once like every other plan rule.\n    const message = ops\n      ? aiBuildPlanShapeRefusal(plan, { freeTaste, ops })\n      : (scope?.shapeRefusal(plan, { freeTaste }) ?? null)\n    return [\n      ...aiPlanEmbedBriefViolations(plan, brief),\n      ...(message ? [{ rule: null, code: 'plan-job-shape', message }] : []),\n      ...(thinHome ? thinHome(plan) : []),\n      ...(blogStandIn ? blogStandIn(plan) : []),\n      ...(emptyGallery ? emptyGallery(plan) : []),\n      ...(storeShop ? storeShop(plan) : []),\n    ]\n  }\n}\n\n/**\n * The inventory names of every id the plan references, so the proposal reads\n * \"the Services layout\" rather than an id — kept on the plan because the\n * inventory is not read again when the member opens it.\n */\nexport function aiPlanLabels(\n  plan: AiBuildPlan,\n  inventory: AiSiteInventory | null,\n): Record<string, string> {\n  const names = new Map<string, string>()\n  for (const rows of [\n    inventory?.components,\n    inventory?.layouts,\n    inventory?.templates,\n    inventory?.forms,\n    inventory?.datasets,\n    inventory?.collections,\n    inventory?.screens,\n  ]) {\n    for (const row of rows ?? []) names.set(row.id, row.name)\n  }\n  const refs = [\n    ...plan.reuse.map((entry) => entry.id),\n    ...plan.create.map((entry) => entry.duplicateOf),\n    ...plan.screens.flatMap((screen) => [\n      screen.layout,\n      screen.template,\n      screen.duplicateOf,\n      ...screen.sections.flatMap((section) => section.uses),\n    ]),\n  ]\n  const labels: Record<string, string> = {}\n  for (const ref of refs) {\n    if (!ref || isAiPlanNewRef(ref)) continue\n    const name = names.get(ref)\n    if (name) labels[ref] = name\n  }\n  return labels\n}\n\n/* ------------------------------------------------------------------------ *\n * Reusing an identical brief's plan\n * ------------------------------------------------------------------------ */\n\n/**\n * How long a plan may be reused for (AGL-2937).\n *\n * The window is what makes reuse safe rather than merely cheap. The key\n * already covers everything the request said — the brief, the inputs, the\n * model and the prompt as rendered, site inventory included — so a plan is\n * reused only when nothing the model was shown has changed. What the key\n * cannot see is the world outside the request: a page published, a component\n * renamed after the inventory was read, a member who meant something\n * different the second time. Fifteen minutes is short enough that the answer\n * is still the one the site would give, and long enough to cover what reuse\n * is actually for — the same brief run twice in a sitting, a job resubmitted\n * after a refused reservation, two members starting the same work.\n */\nexport const AI_PLAN_REUSE_WINDOW_MS = 15 * 60 * 1_000\n\n/** Jobs one lookup reads. More than one can share a key; the newest plan wins. */\nexport const AI_PLAN_REUSE_CANDIDATES = 5\n\n/** A job whose plan might be reused, as the finder reports it. */\nexport interface AiJobPlanCandidate {\n  jobId: string\n  status: AiJobStatus\n  plan: AiJobPlan\n}\n\n/**\n * The digest a plan is reused by: the whole request, never the answer.\n *\n * It hashes what the model was asked and what it was shown — the job's kind\n * and site, the user turn (which carries the trimmed brief and every scalar\n * input), the model that would answer, every rendered system block including\n * the site inventory, and the tool's schema. Two requests that hash the same\n * would have been sent the same bytes to the same model, so the second can\n * keep the first's answer.\n *\n * The version tag is the escape hatch: anything that changes what a key\n * MEANS, rather than what it covers, bumps it and strands every old key\n * harmlessly, since a key nothing matches simply asks the model.\n */\nexport function aiJobPlanKey(input: {\n  job: Pick<AiJob, 'kind' | 'hostId'>\n  prompt: string\n  model: string\n  system: readonly AiSystemBlock[]\n  /** The plan tool the request offers (AGL-3433); the plain one when absent. */\n  tool?: AiTool\n}): string {\n  const digest = createHash('sha256')\n  for (const part of [\n    'plan.v1',\n    input.job.kind,\n    input.job.hostId ?? '',\n    input.model,\n    input.prompt,\n    ...input.system.map((block) => block.text),\n    JSON.stringify(input.tool ?? AI_BUILD_PLAN_TOOL),\n  ]) {\n    // Length-prefixed, so two different splits of the same characters cannot\n    // collide by running into one another.\n    digest.update(`${part.length}:${part}\\u0000`)\n  }\n  return digest.digest('hex')\n}\n\n/** A job that could not have produced a reusable plan, whatever its key says. */\nconst UNREUSABLE: readonly AiJobStatus[] = ['canceled', 'failed']\n\nfunction planMillis(plan: AiJobPlan): number | null {\n  const at = plan.proposedAt as unknown\n  if (at instanceof Date) return at.getTime()\n  if (at && typeof (at as { toMillis?: unknown }).toMillis === 'function') {\n    return (at as { toMillis(): number }).toMillis()\n  }\n  return null\n}\n\n/**\n * The newest plan worth reusing out of what the finder returned: another\n * job's, still proposed or already confirmed, on a job that was neither\n * canceled nor failed, proposed inside the window.\n *\n * A canceled or failed job is excluded even though its plan may be perfectly\n * good: those are the jobs a member walked away from, and handing their plan\n * to the next one would make a rejected answer look like a fresh one.\n */\nexport function aiReusablePlan(\n  candidates: readonly AiJobPlanCandidate[],\n  context: { jobId: string; now: Date },\n): AiJobPlanCandidate | null {\n  const floor = context.now.getTime() - AI_PLAN_REUSE_WINDOW_MS\n  let best: AiJobPlanCandidate | null = null\n  let bestAt = -1\n  for (const candidate of candidates) {\n    if (candidate.jobId === context.jobId) continue\n    if (UNREUSABLE.includes(candidate.status)) continue\n    if (candidate.plan.status !== 'proposed' && candidate.plan.status !== 'confirmed') continue\n    const at = planMillis(candidate.plan)\n    if (at === null || at < floor || at > context.now.getTime()) continue\n    if (at > bestAt) {\n      best = candidate\n      bestAt = at\n    }\n  }\n  return best\n}\n\nexport type AiJobPlanFinder = (\n  orgId: string,\n  key: string,\n  firestore?: FirebaseFirestore.Firestore,\n) => Promise<AiJobPlanCandidate[]>\n\n/**\n * The finder the step uses in production: an equality on `plan.key` inside\n * the org's own jobs.\n *\n * One equality on one field, with no ordering beside it, so Firestore's\n * automatic single-field index answers it and no composite index is deployed.\n * The window and the statuses are applied in memory instead, which is what\n * keeps it that way.\n */\nexport const findAiJobsByPlanKey: AiJobPlanFinder = async (orgId, key, firestore) => {\n  if (!firestore) return []\n  const snapshot = await firestore\n    .collection('orgs')\n    .doc(orgId)\n    .collection(AI_JOBS_COLLECTION)\n    .where('plan.key', '==', key)\n    .limit(AI_PLAN_REUSE_CANDIDATES)\n    .get()\n  return snapshot.docs.flatMap((doc) => {\n    const data = doc.data() as { status?: AiJobStatus; plan?: AiJobPlan | null }\n    return data.plan\n      ? [{ jobId: doc.id, status: data.status ?? 'queued', plan: data.plan }]\n      : []\n  })\n}\n\n/** What a job may create on its site, read for the plan step; `null` for no site. */\nexport type AiPlanCapabilitiesReader = (input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n}) => Promise<AiPlanCapabilities | null>\n\n/** The reader the step uses in production: the draft bands' own arithmetic, for the job's site. */\nexport const readAiJobPlanCapabilities: AiPlanCapabilitiesReader = async ({ job, org, firestore }) => {\n  if (!job.hostId) return null\n  const capabilities = await readAiPlanCapabilities(firestore, { hostId: job.hostId, org })\n  // A site start creates datasets only where the data plugin runs and its\n  // writer admits this member now (AGL-3616), and at most a start's few.\n  return job.kind === 'site'\n    ? aiSitePlanDatasetCapability(capabilities, { firestore, org, now: new Date(), job })\n    : capabilities\n}\n\nexport interface AiJobPlanStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The reuse lookup; specs hand in a fake, and `null` turns reuse off. */\n  findPlansByKey?: AiJobPlanFinder | null\n  /** What the job may create on its site (AGL-3030); specs and the eval recorder hand in their own. */\n  readCapabilities?: AiPlanCapabilitiesReader\n  /** The kind's admission, asked of a plan before it is kept; the registry's otherwise. */\n  admissionRefusal?: typeof aiJobAdmissionRefusal\n  /** A build's operations on its site (AGL-3616); the registry and its gates otherwise. */\n  readOps?: AiBuildOpsReader\n  /**\n   * The site's business profile, status and remembered preferences\n   * (AGL-3661); specs and the eval recorder hand in their own, and `null`\n   * turns it off.\n   */\n  readSiteContext?: AiSiteContextReader | null\n  /**\n   * What a Free workspace has left (AGL-3722), read when a build's plan is\n   * kept so its card can say whether it fits; `null` turns it off.\n   */\n  readFreeCredits?: typeof readFreeAiCreditsLeft | null\n}\n\n/** What a job's site context is read with (AGL-3661). */\nexport type AiSiteContextReader = (input: {\n  job: AiJob\n  firestore: FirebaseFirestore.Firestore\n}) => Promise<AiSiteContextInput | null>\n\n/** The reader the step uses in production: fail-soft, org-scoped, `null` for a job with no site. */\nexport const readAiJobSiteContext: AiSiteContextReader = ({ job, firestore }) =>\n  readAiSiteContext(firestore, { orgId: job.orgId, hostId: job.hostId })\n\n/** What a build may plan on its site (AGL-3616). */\nexport type AiBuildOpsReader = (input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n  freeTaste: boolean\n}) => Promise<AiBuildOps>\n\n/** The reader the step uses in production: the registry, gated for the job's site. */\nexport const readAiBuildOps: AiBuildOpsReader = async ({ job, org, firestore, freeTaste }) => {\n  const host = job.hostId\n    ? (((await firestore.collection('hosts').doc(job.hostId).get()).data() ?? null) as Record<string, unknown> | null)\n    : null\n  return aiBuildOps({ orgId: job.orgId, hostId: job.hostId ?? null, org, host, freeTaste })\n}\n\n/**\n * A build plan's items with what each can cost (AGL-3616), from its\n * capability, recorded as the plan is kept so the console's estimate and the\n * confirm door read one figure without the registry.\n */\nexport function aiPlanWithItemCredits<T extends AiBuildPlan>(ops: AiBuildOps | null, plan: T): T {\n  if (!ops || !plan.items?.length) return plan\n  return {\n    ...plan,\n    items: plan.items.map((item) => {\n      const capability = ops.get(item.op)\n      return capability ? { ...item, credits: Math.max(0, Math.floor(capability.estimateCredits(item.args))) } : item\n    }),\n  }\n}\n\nexport function createAiJobPlanStep(deps: AiJobPlanStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const findPlansByKey =\n    deps.findPlansByKey === undefined ? findAiJobsByPlanKey : deps.findPlansByKey\n  const readCapabilities = deps.readCapabilities ?? readAiJobPlanCapabilities\n  const admissionRefusal = deps.admissionRefusal ?? aiJobAdmissionRefusal\n  const readOps = deps.readOps ?? readAiBuildOps\n  const readContext = deps.readSiteContext === undefined ? readAiJobSiteContext : deps.readSiteContext\n  const readFreeCredits = deps.readFreeCredits === undefined ? readFreeAiCreditsLeft : deps.readFreeCredits\n  return async ({ job, now, signal, firestore, modelFor, org: orgDocument }) => {\n    const org = (orgDocument ?? null) as Partial<AglynOrgBilling> | null\n    const [inventory, workspace, siteContext] = await Promise.all([\n      job.hostId ? readInventory(job.orgId, job.hostId, { firestore }) : Promise.resolve(null),\n      readCapabilities({ job, org, firestore }),\n      job.hostId && readContext ? readContext({ job, firestore }) : Promise.resolve(null),\n    ])\n    // The site's profile, status and memory (AGL-3661), as a per-site cached\n    // block after the plan rules. The inventory block already lists what the\n    // site holds, so the context carries no index of its own here.\n    const instructions = aiInstructionsWithSiteContext(AI_JOB_PLAN_INSTRUCTIONS, siteContext)\n    const scope = AI_JOB_PLAN_SCOPES[job.kind] ?? null\n    const capabilities = aiSitePlanCapabilities(\n      job,\n      workspace ? aiPlanCapabilitiesForJob(workspace, scope) : null,\n    )\n    const freeTaste = capabilities?.freeTaste === true\n    // A build's operations, as this site has them (AGL-3616).\n    const ops = job.kind === 'build' ? await readOps({ job, org, firestore, freeTaste }) : null\n    const site = job.kind === 'site'\n    // A kept plan waits for its confirmation; a Free build's card is told what\n    // is left, so it says before Confirm whether the build fits (AGL-3722).\n    // Net of what THIS plan just spent: the machine meters the step after it\n    // returns, so the meters read here do not hold it yet, and a card told\n    // the figure from before the plan (101) offered Confirm to a person with\n    // 48 left, who met the prompt only after pressing it (2026-10-10).\n    const planReview = async (spentUsd = 0): Promise<AiJobReview> => {\n      const review: AiJobReview = { reason: 'plan', message: AI_JOB_PLAN_REVIEW_COPY, findings: [] }\n      if (job.kind !== 'build' || !freeTaste || !readFreeCredits) return review\n      const credits = await readFreeCredits(firestore, { orgId: job.orgId, org, now, pendingUsd: spentUsd })\n      return credits ? { ...review, freeCredits: credits } : review\n    }\n    // The model switch's answer for this job (AGL-2942): the creator's pick\n    // where the plan, the org restriction and the allotment allowlists allow\n    // it, and Auto held to those same lists otherwise. Without a resolver the\n    // doctrine asks the routing table itself. A Free site plans on its\n    // provider's fast tier (AGL-3594), unless the creator picked a model.\n    const model = aiSitePlanModel(job, modelFor?.('job.plan'), freeTaste)\n    const route = AI_ROUTING_TABLE['job.plan']\n    const prompt = aiJobPlanPrompt(job, capabilities, inventory, ops)\n\n    /**\n     * The confirm door's answer for this plan, asked before the plan is kept\n     * (AGL-3030): the kind's own admission, handed the plan as the resume\n     * door hands it. A refusal fails the job with the door's sentence; a door\n     * that could not answer keeps the plan, since the resume door asks again\n     * before anything is built.\n     *\n     * Two answers are about the month's Free credits, not the plan (AGL-3722):\n     * - the 409 credits prompt KEEPS the plan. The card is told what is left\n     *   (`planReview`) and offers Build what fits / the home page first /\n     *   Upgrade, and the confirm door asks with the person's choice. Failing\n     *   here instead failed every Free build past its p90 before the card\n     *   could offer them — and paged staff with `ai.jobFailed`, as at\n     *   2026-10-09 16:38Z (600 credits estimated, 164 left).\n     * - the 429 \"nothing left\" still fails the job with its sentence, but as\n     *   the customer's limit, which raises no staff alert.\n     */\n    const refusalOnKeep = async (plan: AiJobPlan, outcome: AiJobStepOutcome): Promise<AiJobStepOutcome | null> => {\n      let refusal: Awaited<ReturnType<typeof aiJobAdmissionRefusal>> = null\n      try {\n        refusal = await admissionRefusal(job.kind, {\n          firestore,\n          orgId: job.orgId,\n          hostId: job.hostId ?? null,\n          inputs: job.inputs ?? {},\n          org,\n          plan,\n          uid: job.createdBy,\n        })\n      } catch (error) {\n        console.error('ai plan admission failed', { orgId: job.orgId, jobId: job.$id, error })\n      }\n      if (!refusal || refusal.code === AI_CREDITS_CONFIRM_CODE) return null\n      return {\n        ...outcome,\n        failure: refusal.error,\n        ...(refusal.status === 429 ? { customerLimit: true } : {}),\n      }\n    }\n\n    // Reuse before asking (AGL-2937). The key covers the whole request, so a\n    // hit is a request that would have been sent the same bytes to the same\n    // model; the window covers what the key cannot see. A reused plan spends\n    // nothing, so the machine's spent-nothing branch releases the reservation\n    // and meters no credit, and the job still stops for the member to confirm\n    // — this job's plan is proposed to this member, whatever the last one did\n    // with theirs.\n    const resolved = model ?? aiModelForStep('job.plan')\n    // A brief that asks for a video is offered the plan's list of players\n    // (AGL-3433), and a job that may bind a dataset a record template on\n    // each screen (AGL-3475).\n    const tool = aiBuildPlanToolFor(job.brief, {\n      records: Boolean(inventory?.datasets.length) || capabilities?.create.dataset.allowed === true,\n      items: job.kind === 'build',\n    })\n    const key = aiJobPlanKey({\n      job,\n      prompt,\n      model: resolved,\n      system: aiDoctrineSystemBlocks(inventory, { instructions }),\n      tool,\n    })\n    const reused = findPlansByKey\n      ? aiReusablePlan(await findPlansByKey(job.orgId, key, firestore), {\n          jobId: job.$id,\n          now,\n        })\n      : null\n    if (reused) {\n      // The reused plan's draft ids name the other job's drafts; this job's are its own.\n      const plan: AiJobPlan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, {\n        ...reused.plan,\n        status: 'proposed',\n        labels: aiPlanLabels(reused.plan, inventory),\n        proposedAt: now as unknown as AiJobPlan['proposedAt'],\n        confirmedAt: null,\n        confirmedBy: null,\n        key,\n        reusedFrom: reused.jobId,\n      }))\n      const unspent = aiUnspentOutcome(resolved)\n      return (\n        (await refusalOnKeep(plan, unspent)) ?? {\n          ...unspent,\n          plan,\n          review: await planReview(),\n        }\n      )\n    }\n\n    const result = await runValidatedGeneration('plan', {\n      step: 'job.plan',\n      ...(model ? { model } : {}),\n      instructions,\n      inventory,\n      messages: [{ role: 'user', content: prompt }],\n      tool,\n      // The routing ceiling, lowered on a tier too slow to look records up,\n      // answer and ask again inside the least time the step registered; a\n      // scaffold's outline is held to its own, far lower ceiling (AGL-3594).\n      maxTokens: aiSitePlanMaxTokens(job, resolved, freeTaste),\n      // A scaffold plans an outline without thinking (AGL-3594): the thinking\n      // was nearly all of the 13,491 tokens a Free site's plan spent.\n      ...(site ? { thinking: 'off' as const } : route.thinking ? { thinking: route.thinking } : {}),\n      ...(route.effort ? { effort: route.effort } : {}),\n      ...(signal ? { signal } : {}),\n      capabilities,\n      extend: planViolations(\n        scope,\n        job.brief,\n        freeTaste,\n        ops,\n        site ? aiSitePlanHomeRule(inventory, capabilities) : null,\n        site && aiSiteContentPart(job.inputs ?? null, freeTaste) === 'posts',\n        site,\n        site && aiSiteKindOfInputs(job.inputs)?.id === 'store',\n      ),\n    })\n    const spent: AiJobStepOutcome = {\n      outputs: [],\n      usage: result.usage,\n      estCostUsd: result.estCostUsd,\n      model: result.model,\n      stopReason: result.stopReason,\n      ...(result.effort ? { effort: result.effort } : {}),\n    }\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') {\n      // Refused by our own checks, after the one re-ask (AGL-3594): the member\n      // reads a sentence and an action, staff the rules; the machine gives the\n      // credits back (`uncredited`), and on the Free taste Try again says when\n      // it cannot work. Whether the give-back was made is the job's to say\n      // (`refundedCredits`), so this sentence does not promise it.\n      const review = aiDoctrineReview(result)\n      const retryRefusal = freeTaste\n        ? await aiFreePlanRetryRefusal({ job, org, firestore, now, site })\n        : null\n      return {\n        ...spent,\n        uncredited: true,\n        review: {\n          ...review,\n          message: aiPlanFailureCopy({\n            kind: job.kind,\n            codes: result.violations.map((violation) => violation.code),\n            refunded: false,\n          }),\n          detail: review.detail ?? review.message,\n          ...(retryRefusal ? { retryRefusal } : {}),\n        },\n      }\n    }\n    // A store's plan is a storefront's (AGL-3676): settled before it is kept and priced.\n    const answered = site && aiSiteKindOfInputs(job.inputs)?.id === 'store' ? aiSiteStorefrontPlan(result.value, { paid: !freeTaste }) : result.value\n    // Each draft the plan decides is named as the plan is kept, before anything is built (AGL-3079).\n    const plan: AiJobPlan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, {\n      ...answered,\n      status: 'proposed',\n      labels: aiPlanLabels(answered, inventory),\n      // A Date the Admin SDK stores as a timestamp, like every instant the machine writes.\n      proposedAt: now as unknown as AiJobPlan['proposedAt'],\n      confirmedAt: null,\n      confirmedBy: null,\n      key,\n    }))\n    return (\n      (await refusalOnKeep(plan, spent)) ?? {\n        ...spent,\n        plan,\n        review: await planReview(result.estCostUsd),\n      }\n    )\n  }\n}\n\n/**\n * A site job's capabilities (AGL-3594, AGL-3660): it changes no theme in its\n * plan — every scaffold designs its look first, in a unit of its own — and on\n * the Free taste its plan holds at most the pages the member asked for within\n * the Free band, which the Free wall then holds it to.\n *\n * A build's pages are written in the layout language (`aiBuildUnitJob`), whose\n * compiler draws a section's repeated items itself, so its plan is not asked\n * for a component for them (`repeatsCompiled`, AGL-3616). It still may plan\n * one, and a section two pages share is still one. Every other job's\n * capabilities pass through.\n */\nexport function aiSitePlanCapabilities(\n  job: Pick<AiJob, 'kind' | 'inputs'>,\n  capabilities: AiPlanCapabilities | null,\n): AiPlanCapabilities | null {\n  if (job.kind === 'build' && capabilities) return { ...capabilities, repeatsCompiled: true }\n  if (job.kind !== 'site' || !capabilities) return capabilities\n  const create = {\n    ...capabilities.create,\n    'theme-change': {\n      allowed: false,\n      left: null,\n      reason: 'a site start designs its own look before its pages',\n    },\n    // A site start builds its look, one layout and one form, never a\n    // component (`AI_SITE_CREATE_KINDS`), so a paid workspace's plan draws\n    // repeated items in their sections, as a Free one's does. Held to rule 1\n    // instead, every paid plan was refused: for the component it left out,\n    // or, re-asked, for the one it could not build (AGL-3660).\n    component: {\n      allowed: false,\n      left: null,\n      reason: 'a site start draws its repeated items in their sections',\n    },\n  }\n  // At most a start's few datasets, settled in code where a plan names more (AGL-3616).\n  const site = { ...capabilities, reusableComponents: false, create, datasetsMax: AI_SITE_DATASETS_MAX }\n  if (!capabilities.freeTaste) return site\n  const asked = Number((job.inputs ?? {})['pages'])\n  const pages =\n    Number.isInteger(asked) && asked >= AI_SITE_FREE_PAGES.min\n      ? Math.min(asked, AI_SITE_FREE_PAGES.max)\n      : AI_SITE_FREE_PAGES.max\n  return { ...site, freeSitePages: pages }\n}\n\n/**\n * The model a plan runs on (AGL-3594): the resolved one, except a Free site\n * plans on its provider's fast tier — an outline the plan rules hold and\n * re-ask, at a fifth of the balanced tier's output rate. A model the creator\n * picked by name stays theirs.\n */\nexport function aiSitePlanModel(\n  job: Pick<AiJob, 'kind' | 'model'>,\n  resolved: string | undefined,\n  freeTaste: boolean,\n): string | undefined {\n  if (job.kind !== 'site' || !freeTaste) return resolved\n  const picked = typeof job.model === 'string' ? job.model.trim() : ''\n  if (picked && picked !== 'auto') return resolved\n  const entry = aiCatalogEntry(resolved ?? aiModelForStep('job.plan'))\n  return (entry ? aiDefaultModelFor(entry.provider, 'fast') : undefined) ?? resolved\n}\n\n/** The plan's answer ceiling: the step's own, and a scaffold's outline ceiling under it (AGL-3594). */\nexport function aiSitePlanMaxTokens(\n  job: Pick<AiJob, 'kind'>,\n  model: string,\n  freeTaste: boolean,\n): number {\n  const ceiling = aiJobPlanMaxTokens(model)\n  if (job.kind !== 'site') return ceiling\n  return Math.min(ceiling, freeTaste ? AI_SITE_PLAN_MAX_TOKENS.free : AI_SITE_PLAN_MAX_TOKENS.paid)\n}\n\n/**\n * Why trying a Free plan again cannot work this month, or `null` (AGL-3594):\n * the owner's Free allowance left, read off the account month the meter\n * writes net of give-backs, against what a plan of this kind costs at its\n * worst. Read before this step is metered, and the machine gives a refused\n * plan's credits back, so the figure read is the figure left. A read that fails\n * leaves the button on: the reservation still refuses at the wall.\n */\nasync function aiFreePlanRetryRefusal(input: {\n  job: AiJob\n  org: Partial<AglynOrgBilling> | null\n  firestore: FirebaseFirestore.Firestore\n  now: Date\n  site: boolean\n}): Promise<string | null> {\n  const account = freeAssistAccount(input.org as AssistMeteredOrg | null)\n  if (!account?.accountUid) return null\n  try {\n    // The meter's month key, `YYYY-MM` in UTC (`assistUsageMonth`).\n    const month = input.now.toISOString().slice(0, 7)\n    const snapshot = await freeAccountUsageRef(input.firestore, account.accountUid, month).get()\n    const spent = assistCreditsFromUsd(\n      assistSpendAfterReturnsUsd(snapshot.get('estCostUsd'), snapshot.get(ASSIST_RETURNED_USD_FIELD)),\n    )\n    return aiPlanRetryRefusal({\n      creditsLeft: FREE_AI_TASTE_CREDITS_PER_MONTH - spent,\n      planCredits: input.site ? AI_FREE_SITE_WORST_CASE_CREDITS.plan : AI_FREE_PAGE_WORST_CASE_CREDITS.plan,\n    })\n  } catch (error) {\n    console.error('ai plan retry allowance read failed', { orgId: input.job.orgId, jobId: input.job.$id, error })\n    return null\n  }\n}\n\nexport const runAiJobPlanStep = createAiJobPlanStep()\n\n/**\n * Registers the plan step every planned kind runs first, with the least time\n * a plan needs; the plugin's console surface calls it.\n */\nexport function registerAiJobPlan(): void {\n  registerAiJobPlanStep(runAiJobPlanStep, { minimumMs: AI_JOB_PLAN_STEP_MINIMUM_MS })\n}\n"],"names":["aiSiteKindOfInputs","createHash","AI_BUILD_PLAN_TOOL","aiBuildPlanToolFor","isAiPlanNewRef","readFreeAiCreditsLeft","AI_TEMPLATE_SUBJECT_DEFINITIONS","aiTemplateShownTokens","AI_JOB_CREATE_KINDS","AI_JOB_CREATE_NOUNS","AI_PAGE_CREATE_KINDS","aiPagePlanShapeRefusal","AI_PLAN_COMPILED_REPEATS_SENTENCE","AI_PLAN_NO_FORM_SENTENCE","aiPlanCanPlaceForm","aiPlanCapabilitiesForJob","aiPlanCapabilityLines","aiSitePlanDatasetCapability","AI_FREE_SITE_WORST_CASE_CREDITS","AI_SITE_CREATE_KINDS","AI_SITE_FREE_PAGES","AI_SITE_PLAN_MAX_TOKENS","AI_SITE_HOME_BANDS","aiFreeSiteSectionsWithin","aiSiteFullPlanSentence","aiSiteHomeMinSections","aiSiteNameSentence","aiSitePlanIsHome","aiSitePlanShapeRefusal","aiSiteBlogStandInViolations","aiSiteThinHomeViolations","AI_SITE_GALLERY_SENTENCE","aiSiteEmptyGalleryViolations","AI_SITE_DATASETS_MAX","aiSiteContentPart","aiLayoutIsShopPage","aiLayoutShopGridSection","aiStorefrontPlanScreens","AI_GENERATION_MAX_ATTEMPTS","aiPlanFailureCopy","aiPlanRetryRefusal","FREE_AI_TASTE_CREDITS_PER_MONTH","aiDoctrineSystemBlocks","runValidatedGeneration","AI_STEP_TIERS","aiCatalogEntry","aiDefaultModelFor","AI_FREE_PAGE_WORST_CASE_CREDITS","aiPlanEmbedBriefViolations","assistCreditsFromUsd","ASSIST_RETURNED_USD_FIELD","assistSpendAfterReturnsUsd","freeAccountUsageRef","freeAssistAccount","AI_ROUTING_TABLE","aiModelForStep","readSiteInventory","readAiSiteContext","aiInstructionsWithSiteContext","AI_BUILD_CREATE_KINDS","AI_BUILD_STRUCTURAL_OPS","aiBuildPageLimit","aiBuildPlanShapeRefusal","aiBuildOpLines","aiBuildOps","aiJobAdmissionRefusal","AI_CREDITS_CONFIRM_CODE","readAiPlanCapabilities","AI_JOB_BRIEF_MAX_CHARS","aiJobStepBudget","aiDoctrineReview","aiUnspentOutcome","aiPlanWithDraftIds","AI_JOBS_COLLECTION","registerAiJobPlanStep","AI_JOB_PLAN_INSTRUCTIONS","text","AI_JOB_PLAN_STEP_BUDGET","tier","maxTokens","AI_JOB_PLAN_STEP_MINIMUM_MS","minimumMs","aiJobPlanMaxTokens","model","AI_JOB_PLAN_REVIEW_COPY","aiJobPlanPrompt","job","capabilities","inventory","ops","lines","kind","brief","slice","key","value","Object","entries","inputs","push","String","aiPlanTemplateTokenLines","aiPlanSiteLines","aiPlanBuildLines","join","pages","freeTaste","repeatsCompiled","name","trim","screens","filter","screen","template","starter","find","replaceable","length","page","slug","some","cap","freeSitePages","home","aiSitePlanHomeRule","undefined","across","plansHome","min","bands","id","AI_SITE_STORE_HOME_BANDS","AI_SITE_FORM_SENTENCE","create","dataset","allowed","aiSiteDatasetSentence","Math","datasetsMax","left","label","toLowerCase","AI_SITE_STORE_SHOP_SENTENCE","max","AI_SITE_FORM_DATASET_SENTENCE","layouts","forms","aiSiteThinHomeCheck","rule","answers","plan","aiSiteStorefrontPlan","options","paid","isShopPage","gridSection","every","index","AI_SITE_STORE_SHOP_CODE","aiSiteStoreShopPageViolations","code","message","paths","aiSiteStoreShopCheck","aiSiteEmptyGalleryCheck","aiSiteBlogStandInCheck","subject","definition","AI_JOB_PLAN_SCOPES","noun","creates","shapeRefusal","build","site","fromEntries","map","planViolations","scope","blog","store","thinHome","storeShop","blogStandIn","emptyGallery","aiPlanLabels","names","Map","rows","components","templates","datasets","collections","row","set","refs","reuse","entry","duplicateOf","flatMap","layout","sections","section","uses","labels","ref","get","AI_PLAN_REUSE_WINDOW_MS","AI_PLAN_REUSE_CANDIDATES","aiJobPlanKey","input","digest","part","hostId","prompt","system","block","JSON","stringify","tool","update","UNREUSABLE","planMillis","at","proposedAt","Date","getTime","toMillis","aiReusablePlan","candidates","context","floor","now","best","bestAt","candidate","jobId","includes","status","findAiJobsByPlanKey","orgId","firestore","snapshot","collection","doc","where","limit","docs","data","readAiJobPlanCapabilities","org","readAiJobSiteContext","readAiBuildOps","host","aiPlanWithItemCredits","items","item","capability","op","credits","estimateCredits","args","createAiJobPlanStep","deps","readInventory","findPlansByKey","readCapabilities","admissionRefusal","readOps","readContext","readSiteContext","readFreeCredits","signal","modelFor","orgDocument","workspace","siteContext","Promise","all","resolve","instructions","aiSitePlanCapabilities","planReview","spentUsd","review","reason","findings","pendingUsd","freeCredits","aiSitePlanModel","route","refusalOnKeep","outcome","refusal","uid","createdBy","error","console","$id","failure","customerLimit","resolved","records","Boolean","reused","confirmedAt","confirmedBy","reusedFrom","unspent","result","step","messages","role","content","aiSitePlanMaxTokens","thinking","effort","extend","spent","outputs","usage","estCostUsd","stopReason","refused","retryRefusal","aiFreePlanRetryRefusal","uncredited","codes","violations","violation","refunded","detail","answered","component","reusableComponents","asked","Number","isInteger","picked","provider","ceiling","free","account","accountUid","month","toISOString","creditsLeft","planCredits","runAiJobPlanStep","registerAiJobPlan"],"mappings":"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"}

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

@@ -0,0 +1,183 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { pluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
+import { type AiBuildPlanCreate, type AiBuildPlanScreen } from '../model/ai-build-plan';
+import type { AiJob, AiJobOutput, AiJobPlan } from '../model/ai-jobs.types';
+import type { AiPlanCapabilities } from '../model/ai-plan-capabilities';
+import { generateAiDataset } from '../runtime/ai-dataset-generation';
+import { type AiLayoutListing, type AiLayoutListingField, type AiLayoutListingScreen } from '../layout-language/ai-layout-listings';
+import { aiPluginDraftAdmissionRefusal } from './ai-job-plugin-drafts';
+import type { AiJobStepContext, AiJobStepRunner } from './ai-job-text-step';
+/**
+ * A SITE START'S DATASETS (AGL-3616): "Aglyn AI can also use/create datasets
+ * too for whatever it needs" (Zach, 2026-10-10).
+ *
+ * A site whose content is a list of like things — a restaurant's menu, a
+ * studio's team, a contractor's services, a photographer's portfolio, an
+ * events list, its questions and answers — keeps it as a DATASET, the way the
+ * docs teach a person to: the owner edits one record and every page listing
+ * it follows. On a workspace that may create datasets, the site plan creates
+ * one for such content (`create`, kind `dataset`) and names it in the `uses`
+ * of each section that lists it. The scaffold then builds each dataset as a
+ * unit of its own, after the layout and before the form (which may write
+ * its submissions to one) and the pages:
+ *
+ *  - DESIGNED by the `submit_dataset` generation (`ai-dataset-generation.ts`):
+ *    the planned fields typed, at most a few more, and 3 to 12 records seeded
+ *    from the brief. Nothing anybody did not say: no review, testimonial,
+ *    rating, quote or person's name, no price the brief does not state.
+ *  - WRITTEN by the data plugin's `dataset` writer — this plugin never names
+ *    the datasets collection — with every rule the console's datasets route
+ *    has: the member's role and `data.manage`, `release_data_store`,
+ *    `dataStore` (Starter and up), `datasetsPerOrg` counted inside the create,
+ *    `recordsPerDataset` and the storage band.
+ *  - LISTED by the pages built after it: each section naming it repeats over
+ *    the dataset (`aiSiteDatasetListings`, a `records` listing the layout
+ *    compiler draws), and a page the plan made its record template binds its
+ *    fields by id and keeps the address field the writer added.
+ *
+ * Where datasets cannot be created — the Free taste, Starter's two used up,
+ * the data store not released — the plan is told so and creates none, so its
+ * sections write the items out. A dataset unit that fails or is refused
+ * leaves the pages that list it built without it (they say so), and its
+ * record page is not built.
+ */
+/** The most datasets one site start creates. */
+export { AI_SITE_DATASETS_MAX } from '../model/ai-site-job';
+/** The resource the data plugin's writer is registered under. */
+export declare const AI_SITE_DATASET_RESOURCE = "dataset";
+/** The input a dataset unit's own job carries what it needs in. */
+export declare const AI_SITE_DATASET_INPUT = "siteDataset";
+/** What a dataset unit's job is told beside its creation. */
+export interface AiSiteDatasetInput {
+    /** The sections that list it, by page: "Menu › Our dishes (12 items)". */
+    shownIn: string[];
+    /** Whether a page of the plan is its record template. */
+    recordPages: boolean;
+    /**
+     * The form of the plan that writes its submissions to it (AGL-3616), by
+     * name, with that form's planned fields; absent where no form does.
+     */
+    forForm?: {
+        name: string;
+        fields: string[];
+    };
+}
+/** What a dataset row says when its design could not be written: our failure, refunded. */
+export declare const AI_SITE_DATASET_NOT_WRITTEN_COPY = "This dataset could not be added this time.";
+/** The note a written dataset carries on the job's page. */
+export declare function aiSiteDatasetNote(records: number): string;
+/** The note a record template's row adds: the binding is the member's to save (rule 13). */
+export declare const AI_SITE_RECORD_PAGE_NOTE = "A page per record is drafted, not live: open Page Properties \u2192 Record pages to save it.";
+/** ASSUMED: what one dataset pass reads and writes beside its generation: the site, the writer's reads and its transaction. */
+export declare const AI_SITE_DATASET_WRITES_MS = 2000;
+/** One dataset's pass: its generation and re-ask at its ceiling, and its writes. */
+export declare const AI_SITE_DATASET_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The plan's datasets, in plan order, at most the most a start creates. */
+export declare function aiSitePlanDatasets(plan: Pick<AiJobPlan, 'create'>): AiBuildPlanCreate[];
+/** Where the plan lists a dataset, in words its design reads, whether a page is its record template, and the form that writes to it. */
+export declare function aiSiteDatasetInputOf(dataset: Pick<AiBuildPlanCreate, 'name'>, screens: readonly AiBuildPlanScreen[], create?: readonly AiBuildPlanCreate[]): AiSiteDatasetInput;
+/** Whether a plan screen is the record template of a dataset the plan creates, and which. */
+export declare function aiSiteRecordTemplateOf(screen: Pick<AiBuildPlanScreen, 'record'>): string | null;
+/** The most fields a form's dataset is designed with: the data plugin writer's own ceiling is higher. */
+export declare const AI_SITE_FORM_DATASET_FIELDS_MAX = 12;
+/** A planned field as a person reads it: `fullName` and `full_name` are "Full name". */
+export declare function aiSiteDatasetFieldName(planned: string): string;
+/**
+ * A dataset a form writes to, as the data plugin's writer takes it
+ * (AGL-3616): designed with no model, since its records are the
+ * submissions. Its fields are its planned ones — or, where the plan gave it
+ * none, the form's — each a person's words for it, text unless the plan
+ * typed it as `Name:type`, never required, so a submission that leaves one
+ * blank is still a record. It starts with no records. Pure.
+ */
+export declare function aiSiteFormDatasetContent(name: string, planned: readonly string[], form: {
+    fields: readonly string[];
+}): Record<string, unknown>;
+/** The note a form's dataset carries on the job's page. */
+export declare function aiSiteFormDatasetNote(form: string): string;
+export interface AiSiteDatasetRunnerDeps {
+    generate?: typeof generateAiDataset;
+    writerFor?: typeof pluginResourceDraftWriter;
+}
+/**
+ * The fields of a designed dataset that its records leave empty on most of
+ * them — every record, or more than half — by the id the data plugin gave
+ * each (AGL-3616). Its first field is the record's name and is never one. The
+ * live low-tide-hollow start (beta.239) seeded its tour dates with no venue,
+ * rightly inventing none, and its cards bound the venue as their eyebrow.
+ */
+export declare function aiDatasetSparseFields(dataset: {
+    fields: ReadonlyArray<{
+        name: string;
+    }>;
+    records: ReadonlyArray<ReadonlyArray<string | undefined>>;
+}, written: readonly AiLayoutListingField[]): string[];
+/**
+ * The dataset unit's runner, on the job the scaffold derived for it: the one
+ * creation its plan carries, designed by the model and written by the data
+ * plugin, under the creation's own id. A pass repeated after its write finds
+ * the dataset the writer wrote and reports it again, spending nothing.
+ */
+export declare function createAiSiteDatasetRunner(deps?: AiSiteDatasetRunnerDeps): AiJobStepRunner;
+export declare const runAiSiteDatasetUnit: AiJobStepRunner;
+/**
+ * Whether a dataset may be created for this member on this site, asked before
+ * its first pass so a refusal spends nothing; `null` admits. The data plugin
+ * must run here (on for the workspace and the site, past its release flag),
+ * and its writer says whether this member may make one now: the role, the
+ * plan, the flag, the allowance.
+ */
+export declare function aiSiteDatasetRefusal(context: Pick<AiJobStepContext, 'firestore' | 'org' | 'now'> & {
+    job: Pick<AiJob, 'orgId' | 'hostId' | 'createdBy'>;
+}, deps?: {
+    admission?: typeof aiPluginDraftAdmissionRefusal;
+    writerFor?: (resource: string) => ReturnType<typeof pluginResourceDraftWriter>;
+}): Promise<string | null>;
+/**
+ * A site plan's dataset capability on this workspace (AGL-3616): where the
+ * workspace's plan includes datasets, whether the data plugin runs here and
+ * this member may create one now, and how many a start may make. A clause the
+ * plan's turn completes is the reason where it may not.
+ */
+export declare function aiSitePlanDatasetCapability(capabilities: AiPlanCapabilities, context: Parameters<typeof aiSiteDatasetRefusal>[0], deps?: Parameters<typeof aiSiteDatasetRefusal>[1]): Promise<AiPlanCapabilities>;
+/**
+ * A `records` listing for each dataset that was made and that a section of the
+ * plan names (AGL-3616). Its fields, where none are given, are read off the
+ * site's inventory when the page is designed (`aiLayoutListingsWithDatasets`).
+ */
+export declare function aiDatasetListingsOf(datasets: ReadonlyArray<{
+    id: string;
+    name: string;
+    records?: string[];
+    fields?: AiLayoutListingField[];
+}>, screens: readonly AiLayoutListingScreen[]): AiLayoutListing[];
+/**
+ * The site's datasets a layout or a page unit is handed (AGL-3616), each a
+ * `records` listing with the sections of the plan's pages that name it, once
+ * its unit wrote it. A dataset not yet written, or one that failed, lists
+ * nowhere: the pages built without it write the items out.
+ */
+export declare function aiSiteDatasetListings(input: {
+    outputs: readonly AiJobOutput[];
+    datasets: ReadonlyArray<Pick<AiBuildPlanCreate, 'name'>>;
+    screens: readonly AiLayoutListingScreen[];
+    /** The ids each dataset's unit delivered, by plan name lowercased. */
+    delivered: ReadonlyMap<string, string>;
+}): AiLayoutListing[];
+/** What a page is told about the datasets built before it. */
+export declare function aiSiteDatasetBriefLines(outputs: readonly AiJobOutput[]): string[];