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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-build-step.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { resolveEffectivePlan } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport {\n  AI_BUILD_LIMITS,\n  AI_BUILD_PUBLISH_INPUT,\n  aiArticle,\n  aiBuildCreditEstimate,\n  aiBuildDegradation,\n  aiBuildInitialLedger,\n  aiBuildItemDelivered,\n  aiBuildItemOpen,\n  aiBuildNextUnit,\n  aiBuildOrder,\n  aiBuildPlacedItemLines,\n  aiBuildPlanShapeRefusal,\n  aiBuildUnits,\n  type AiBuildOps,\n  type AiBuildUnit,\n} from '../model/ai-build-job'\nimport { isAiPlanNewRef, type AiBuildPlanCreateKind } from '../model/ai-build-plan'\nimport type {\n  AiJob,\n  AiJobItemFailure,\n  AiJobItemLedger,\n  AiJobKind,\n  AiJobOutput,\n  AiJobPlan,\n} from '../model/ai-jobs.types'\nimport { AI_SITE_MAX_SECTIONS } from '../model/ai-site-job'\nimport { FREE_AI_TASTE_CREDITS_PER_MONTH } from '../plan-entitlements'\nimport { aiModelForStep } from '../providers/routing'\nimport {\n  AI_BUILD_UNIT_EMPTY_COPY,\n  aiBuildBuiltRefs,\n  aiUnitErrorRetryable,\n  aiUnitFailure,\n  aiUnitSpend,\n} from './ai-build-unit-outcome'\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 { aiBuildOps, type AiBuildOpsContext } from './ai-build-capabilities'\nimport {\n  aiJobAdmissionRefusal,\n  registerAiJobAdmission,\n  type AiJobAdmission,\n  type AiJobAdmissionContext,\n} from './ai-job-admission'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { readAiDraftNodes } from './ai-job-drafts'\nimport { aiConfirmedPlan, aiUnspentOutcome } from './ai-job-generation'\nimport { AI_JOB_PAGE_STEP_MINIMUM_MS } from './ai-job-page-budget'\nimport {\n  aiPluginDraftAdmissionRefusal,\n  aiPluginDraftWriter,\n  type AiPluginDraftWriterLookup,\n} from './ai-job-plugin-drafts'\nimport { aiSitePageWritten, aiSiteResolvedRef } from './ai-job-site-step'\nimport {\n  AI_JOB_BRIEF_MAX_CHARS,\n  type AiJobItemOutcome,\n  type AiJobStepOutcome,\n  type AiJobStepRunner,\n} from './ai-job-text-step'\nimport { aiJobPublishesBuild, aiPublishGuidedSite } from './ai-site-publish'\nimport {\n  AI_PLANNED_JOB_KINDS,\n  aiJobStepRunMinimumMs,\n  aiJobStepRunnerFor,\n  registerAiJobStep,\n  registerAiJobStepPasses,\n} from './ai-jobs'\n\n/**\n * The build step (AGL-3616): the generation step of a `build` job, run once\n * the member confirmed the plan their request produced.\n *\n * Like the site scaffold it generalizes, it builds nothing itself and asks no\n * model of its own. Each pass takes the next unit in dependency order and\n * hands it to what builds that kind of thing — a page, layout, form,\n * component, email design or template to this plugin's own step, under a job\n * derived for the unit; another plugin's resource to that plugin's writer on\n * the resource-draft seam, with the content the owner's capability derives\n * from the item's arguments. One unit, one pass, one recorded spend.\n *\n * ── Settled item by item ────────────────────────────────────────────────\n *\n * Where a unit stands is read from the job's ITEM LEDGER, never from counting\n * outputs: the machine writes each pass's row in the transaction that\n * records its spend (`recordStep`). A unit that fails is a FAILED ROW, not a\n * failed job: the pass reports it, the machine gives back that item's spend\n * where the failure was ours, and the next pass builds the next unit. What\n * depended on it is built without it, or skipped where it cannot stand\n * without it (`aiBuildDegradation`). The machine ends the job when nothing is\n * left: `done` when anything was delivered, `failed` — its planning given\n * back too — when nothing was.\n *\n * ── Drafts, unless asked and confirmed ───────────────────────────────────\n *\n * Every unit writes the draft its own kind writes, which nothing publishes.\n * Only a build whose request asked to publish AND whose member ticked the\n * plan card's box puts its built pages live, once, on its last pass, through\n * the guided start's publish.\n */\n\n/** What a build answers with no confirmed plan to build. */\nexport const AI_BUILD_NO_PLAN_COPY = 'This build has no confirmed plan to build.'\n\n/** What a unit says when nothing on this site builds its operation any more. */\nexport const aiBuildUnavailableCopy = (noun: string): string =>\n  `Not built: ${aiArticle(noun)} cannot be made on this site right now.`\n\n\n/** What a page that was reported built but holds none of its plan says. */\nexport const AI_BUILD_PAGE_NOT_WRITTEN_COPY = 'The page was not written from its plan.'\n\n\n/**\n * The most passes a build's step may take: every unit at a page's worst — its\n * sections and its listing — so a runner that never finishes is still\n * bounded while the largest plan is not. Try again starts the count over.\n */\nexport const AI_BUILD_MAX_PASSES = AI_BUILD_LIMITS.units * (AI_SITE_MAX_SECTIONS + 1)\n\n/** The job kind a creation of the build is built by. */\nconst CREATION_JOB_KINDS: Partial<Record<AiBuildPlanCreateKind, AiJobKind>> = {\n  layout: 'layout',\n  form: 'form',\n  component: 'component',\n  email: 'email',\n}\n\n/** The job kind a unit is built by, where an AI runner builds it. */\nexport function aiBuildUnitJobKind(unit: AiBuildUnit, ops: AiBuildOps): AiJobKind | null {\n  if (unit.screen) return 'page'\n  if (unit.creation) return CREATION_JOB_KINDS[unit.creation.kind] ?? null\n  const runnerKind = ops.get(unit.op)?.runnerKind\n  return runnerKind ? (runnerKind as AiJobKind) : null\n}\n\n/** The id a unit's job, and so its draft, is named by. */\nexport function aiBuildUnitJobId(job: Pick<AiJob, '$id'>, unit: AiBuildUnit): string {\n  return unit.creation?.id ?? unit.screen?.id ?? unit.item?.id ?? `${job.$id}-${unit.slot}`\n}\n\n/**\n * The job a unit is built under (generalizing `aiSiteUnitJob`): this job's\n * org, site, creator and model; the kind that builds the unit; a plan\n * narrowed to the unit, its `new:` references resolved to what was built and\n * the failed ones left out; and a brief that says what the unit is, what it\n * is built without, and which blocks its sections place.\n */\nexport function aiBuildUnitJob(\n  job: AiJob,\n  unit: AiBuildUnit,\n  context: {\n    kind: AiJobKind\n    units: readonly AiBuildUnit[]\n    ledger: readonly AiJobItemLedger[]\n    ops: AiBuildOps\n    briefLines?: readonly string[]\n  },\n): AiJob {\n  const plan = job.plan as AiJobPlan\n  const built = aiBuildBuiltRefs(context.units, context.ledger, job.outputs ?? [])\n  const labels = { ...(plan.labels ?? {}) }\n  for (const entry of built.values()) labels[entry.id] = entry.label\n  const brief = [job.brief.trim()]\n  const unitPlan: AiJobPlan = { ...plan, labels, reuse: [...plan.reuse], create: [], screens: [] }\n  delete unitPlan.items\n  const placedByScreens = new Set(plan.screens.flatMap((screen) => screen.sections.flatMap((section) => section.uses)))\n  if (unit.creation) {\n    unitPlan.reuse = plan.reuse.filter((entry) => !placedByScreens.has(entry.id))\n    unitPlan.create = [{ ...unit.creation, duplicateOf: aiSiteResolvedRef(unit.creation.duplicateOf, built) }]\n    brief.push(`Build the ${unit.creation.kind} “${unit.creation.name}”: ${unit.creation.why}`)\n  }\n  if (unit.screen) {\n    const screen = unit.screen\n    for (const entry of built.values()) {\n      unitPlan.reuse.push({ kind: entry.kind, id: entry.id, purpose: `the ${entry.kind} this request built` })\n    }\n    let builtLayout: string | null = null\n    for (const entry of built.values()) if (entry.kind === 'layout') builtLayout = builtLayout ?? entry.id\n    unitPlan.screens = [\n      {\n        ...screen,\n        // A page whose layout failed renders inside the site's own: the page\n        // step falls back to it when the plan names none.\n        layout: aiSiteResolvedRef(screen.layout, built) ?? (isAiPlanNewRef(screen.layout) ? builtLayout : null),\n        template: aiSiteResolvedRef(screen.template, built),\n        duplicateOf: aiSiteResolvedRef(screen.duplicateOf, built),\n        record: screen.record\n          ? { ...screen.record, dataset: aiSiteResolvedRef(screen.record.dataset, built) ?? screen.record.dataset }\n          : null,\n        sections: screen.sections.map((section) => ({\n          ...section,\n          uses: section.uses\n            .map((ref) => aiSiteResolvedRef(ref, built))\n            .filter((ref): ref is string => !!ref),\n        })),\n      },\n    ]\n    brief.push(`Build the page “${screen.title}”, at ${screen.slug}.`)\n    brief.push(...aiBuildPlacedItemLines(unit, { units: context.units, ledger: context.ledger, ops: context.ops }))\n  }\n  const item = unit.item\n  if (item) {\n    const noun = context.ops.get(item.op)?.noun ?? item.op\n    brief.push(`Build the ${noun} “${item.name}”${item.why ? `: ${item.why}` : '.'}`)\n    // A planned kind's step builds the plan's first creation of its kind.\n    unitPlan.create = AI_PLANNED_JOB_KINDS.includes(context.kind)\n      ? [{ kind: context.kind as AiBuildPlanCreateKind, name: item.name, why: item.why, duplicateOf: null, fields: [], ...(item.id ? { id: item.id } : {}) }]\n      : []\n  }\n  brief.push(...(context.briefLines ?? []))\n  const inputs: Record<string, unknown> = {\n    ...job.inputs,\n    ...(item?.args ?? {}),\n    originJobId: aiOriginJobId(job),\n  }\n  delete inputs[AI_BUILD_PUBLISH_INPUT]\n  return {\n    ...job,\n    $id: aiBuildUnitJobId(job, unit),\n    kind: context.kind,\n    steps: [],\n    outputs: [],\n    items: null,\n    plan: item && !AI_PLANNED_JOB_KINDS.includes(context.kind) ? null : unitPlan,\n    inputs,\n    brief: brief.join('\\n').slice(0, AI_JOB_BRIEF_MAX_CHARS),\n  }\n}\n\n/** The unit's failure, for its row: ours or not, why, in customer-safe words. */\nfunction failed(\n  slot: string,\n  failure: AiJobItemFailure,\n  extra: Partial<AiJobItemOutcome> = {},\n): AiJobItemOutcome {\n  return { slot, status: 'failed', failure, ...extra }\n}\n\nexport interface AiJobBuildStepDeps {\n  /** The runner registry; specs hand in fakes. */\n  runnerFor?: typeof aiJobStepRunnerFor\n  /** The draft writer registry; specs hand in fakes. */\n  writerFor?: AiPluginDraftWriterLookup\n  /** The operations this site may use; the registry and its gates otherwise. */\n  opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>\n  /** A runner kind's own admission, asked before its item runs; the registry's otherwise. */\n  admissionFor?: typeof aiJobAdmissionRefusal\n  /** Another plugin's admission for its writer; the seam's otherwise. */\n  pluginAdmission?: typeof aiPluginDraftAdmissionRefusal\n  /** The draft reader a built page is checked through. */\n  readNodes?: typeof readAiDraftNodes\n  /** The publish a build asked for and confirmed. */\n  publish?: typeof aiPublishGuidedSite\n}\n\n/** Whether a build's workspace spends the Free taste. */\nexport function aiBuildFreeTaste(org: object | null | undefined): boolean {\n  return Boolean(org) && resolveEffectivePlan(org as never) === 'free'\n}\n\n/** The site document a gate reads, or `null`. */\nasync function readHost(firestore: FirebaseFirestore.Firestore, hostId: string | null) {\n  if (!hostId) return null\n  return ((await firestore.collection('hosts').doc(hostId).get()).data() ?? null) as Record<string, unknown> | null\n}\n\nexport function createAiJobBuildStep(deps: AiJobBuildStepDeps = {}): AiJobStepRunner {\n  const runnerFor = deps.runnerFor ?? aiJobStepRunnerFor\n  const writerFor = deps.writerFor ?? aiPluginDraftWriter\n  const opsFor = deps.opsFor ?? ((context) => aiBuildOps(context))\n  const admissionFor = deps.admissionFor ?? aiJobAdmissionRefusal\n  const pluginAdmission = deps.pluginAdmission ?? aiPluginDraftAdmissionRefusal\n  const readNodes = deps.readNodes ?? readAiDraftNodes\n  const publish = deps.publish ?? aiPublishGuidedSite\n\n  return async (context): Promise<AiJobStepOutcome> => {\n    const { job, firestore } = context\n    const model = context.modelFor?.('job.plan') ?? aiModelForStep('job.plan')\n    const plan = aiConfirmedPlan(job)\n    if (!plan) return { ...aiUnspentOutcome(model), failure: AI_BUILD_NO_PLAN_COPY }\n    const org = (context.org ?? null) as Partial<AglynOrgBilling> | null\n    const units = aiBuildUnits(plan)\n    const ordered = aiBuildOrder(units) ?? units\n    const starting = !job.items?.length\n    const ledger = starting ? aiBuildInitialLedger(units) : (job.items as AiJobItemLedger[])\n    const init = starting ? { items: ledger } : {}\n    const unit = aiBuildNextUnit(ordered, ledger)\n    const rows = new Map(ledger.map((row) => [row.slot, row]))\n    const host = await readHost(firestore, job.hostId ?? null)\n    const ops = await opsFor({\n      orgId: job.orgId,\n      hostId: job.hostId ?? null,\n      org,\n      host,\n      freeTaste: aiBuildFreeTaste(org),\n    })\n\n    /** Whether units other than this one are still to build. */\n    const othersOpen = (slot: string) =>\n      ordered.some((one) => one.slot !== slot && aiBuildItemOpen(rows.get(one.slot) ?? { status: 'pending' }))\n\n    /** The build's last pass puts its pages live, where it was asked and confirmed. */\n    const finish = async (outcome: AiJobStepOutcome, extraPages: readonly AiJobOutput[] = []): Promise<AiJobStepOutcome> => {\n      if (!aiJobPublishesBuild(job) || job.sitePublish || !job.hostId) return outcome\n      const pageIds = new Set(\n        units\n          .filter((one) => one.screen && aiBuildItemDelivered(rows.get(one.slot) ?? { status: 'pending' }))\n          .flatMap((one) => rows.get(one.slot)?.outputs ?? []),\n      )\n      const pages = [\n        ...(job.outputs ?? []).filter((output) => output.resource === 'screen' && pageIds.has(output.id)),\n        ...extraPages,\n      ]\n      if (!pages.length) return outcome\n      const sitePublish = await publish(firestore, { job, outputs: pages, now: context.now }).catch((error: unknown) => {\n        console.error('ai build publish threw', { orgId: job.orgId, jobId: job.$id, error })\n        return null\n      })\n      return sitePublish ? { ...outcome, sitePublish } : outcome\n    }\n\n    if (!unit) return finish({ ...aiUnspentOutcome(model), ...init })\n\n    const settle = (item: AiJobItemOutcome, spent: AiJobStepOutcome = aiUnspentOutcome(model)): AiJobStepOutcome => ({\n      ...spent,\n      ...init,\n      item,\n      ...(item.status === 'running' || othersOpen(unit.slot) ? { continue: true } : {}),\n    })\n\n    // What its dependencies came to.\n    const degradation = aiBuildDegradation(unit, { units, ledger, ops })\n    if (degradation.skip) {\n      return settle({ slot: unit.slot, status: 'skipped', note: degradation.skip, degradedBy: degradation.degradedBy })\n    }\n    const capability = ops.get(unit.op)\n    const noun = capability?.noun ?? unit.op\n    if (!capability) return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n    const degraded = degradation.degradedBy.length > 0\n    const note = degradation.notes.length ? degradation.notes.join(' ') : null\n\n    // Another plugin's resource: its writer, with the content its capability derives.\n    if (capability.draftResource) {\n      const item = unit.item\n      const writer = writerFor(capability.draftResource)\n      if (!item || !writer || !job.hostId) {\n        return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n      }\n      const admission: AiJobAdmissionContext = {\n        firestore,\n        orgId: job.orgId,\n        hostId: job.hostId,\n        inputs: {},\n        org,\n        uid: job.createdBy,\n      }\n      const refusal = await pluginAdmission(admission, {\n        kind: 'build',\n        drafts: [{ resource: capability.draftResource, label: capability.noun }],\n        writerFor,\n      })\n      if (refusal) return settle({ slot: unit.slot, status: 'skipped', note: `Not built: ${refusal.error}` })\n      const dependencies: Record<string, { op: string; id: string }> = {}\n      for (const slot of unit.deps) {\n        const dep = units.find((one) => one.slot === slot)\n        const row = rows.get(slot)\n        if (!dep || !row || !aiBuildItemDelivered(row) || !row.outputs.length) continue\n        dependencies[`new:${dep.label}`] = { op: dep.op, id: row.outputs[0] }\n      }\n      const content = capability.draftContent?.({ name: item.name, args: item.args }, { hostId: job.hostId, dependencies }) ?? item.args\n      const checked = writer.check(content, { hostId: job.hostId })\n      if (checked.ok === false) {\n        return settle(\n          failed(unit.slot, { ours: true, reason: 'step-failure', message: checked.problems[0] ?? AI_BUILD_UNIT_EMPTY_COPY }),\n        )\n      }\n      const id = aiBuildUnitJobId(job, unit)\n      const written = await writer.write({\n        orgId: job.orgId,\n        hostId: job.hostId,\n        uid: job.createdBy,\n        org,\n        now: context.now,\n        id,\n        name: item.name,\n        content,\n      })\n      if (written.ok === false) {\n        return settle(failed(unit.slot, { ours: false, reason: 'review', message: written.error }))\n      }\n      const output: AiJobOutput = {\n        resource: 'draft',\n        id: written.id,\n        versionId: written.versionId,\n        hostId: job.hostId,\n        label: written.name,\n        draftResource: capability.draftResource,\n        note: `A draft, in ${capability.where}.`,\n      }\n      return settle(\n        {\n          slot: unit.slot,\n          status: degraded ? 'degraded' : 'succeeded',\n          outputs: [written.id],\n          note,\n          ...(degraded ? { degradedBy: degradation.degradedBy } : {}),\n        },\n        { ...aiUnspentOutcome(model), outputs: [output] },\n      )\n    }\n\n    // This plugin's own runner, under a job derived for the unit.\n    const kind = aiBuildUnitJobKind(unit, ops)\n    const runner = kind ? runnerFor(kind) : null\n    if (!kind || !runner) return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n    const derived = aiBuildUnitJob(job, unit, { kind, units, ledger, ops, briefLines: degradation.briefLines })\n    // An item's kind is asked its own admission first (a campaign's plan,\n    // a template's subject), once, before its first pass.\n    if (unit.item && rows.get(unit.slot)?.status !== 'running') {\n      const refusal = await admissionFor(kind, {\n        firestore,\n        orgId: job.orgId,\n        hostId: job.hostId ?? null,\n        inputs: derived.inputs,\n        org,\n        uid: job.createdBy,\n      }).catch((error: unknown) => {\n        console.error('ai build item admission failed', { orgId: job.orgId, jobId: job.$id, slot: unit.slot, error })\n        return { status: 403 as const, error: AI_BUILD_UNIT_EMPTY_COPY }\n      })\n      if (refusal) return settle({ slot: unit.slot, status: 'skipped', note: `Not built: ${refusal.error}` })\n    }\n\n    let outcome: AiJobStepOutcome\n    try {\n      outcome = await runner({ ...context, job: derived })\n    } catch (error) {\n      // A provider that will answer later is the machine's to retry; anything\n      // else is this item's failure, and the build goes on.\n      if (aiUnitErrorRetryable(error)) throw error\n      console.error('ai build unit threw', { orgId: job.orgId, jobId: job.$id, slot: unit.slot, error })\n      return settle(failed(unit.slot, { ours: true, reason: 'provider', message: AI_BUILD_UNIT_EMPTY_COPY }))\n    }\n    const spent = aiUnitSpend(outcome)\n    const ids = outcome.outputs.map((output) => output.id)\n    const stopped = aiUnitFailure(unit.slot, outcome)\n    if (stopped) return settle(stopped, spent)\n    // A page counts as built only when its plan's sections are in it (AGL-3596).\n    if (unit.screen && job.hostId) {\n      const page = outcome.outputs.find((output) => output.resource === 'screen')\n      const written =\n        page !== undefined &&\n        (await aiSitePageWritten(\n          firestore,\n          { hostId: job.hostId, unitJobId: derived.$id, screen: unit.screen, draftId: page.id },\n          readNodes,\n        ))\n      if (!written) {\n        return settle(\n          failed(unit.slot, { ours: true, reason: 'step-failure', message: AI_BUILD_PAGE_NOT_WRITTEN_COPY }),\n          { ...spent, outputs: outcome.outputs.filter((output) => output.resource !== 'screen') },\n        )\n      }\n    }\n    const done = settle(\n      {\n        slot: unit.slot,\n        status: degraded ? 'degraded' : 'succeeded',\n        outputs: ids,\n        note,\n        ...(degraded ? { degradedBy: degradation.degradedBy } : {}),\n      },\n      spent,\n    )\n    if (done.continue) return done\n    // The last unit: what was built goes live where it was asked and confirmed.\n    rows.set(unit.slot, { ...(rows.get(unit.slot) as AiJobItemLedger), status: degraded ? 'degraded' : 'succeeded', outputs: ids })\n    return finish(done, unit.screen ? outcome.outputs.filter((output) => output.resource === 'screen') : [])\n  }\n}\n\nexport const runAiJobBuildStep = createAiJobBuildStep()\n\n/**\n * The least time a build's next pass needs: what the step that builds its\n * next unit registers for the job derived for it; a page pass's when the\n * next unit is another plugin's draft, which asks no model.\n */\nexport function aiBuildJobRunMinimumMs(job: AiJob): number {\n  const plan = aiConfirmedPlan(job)\n  if (!plan) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  const units = aiBuildUnits(plan)\n  const ordered = aiBuildOrder(units) ?? units\n  const ledger = job.items?.length ? job.items : aiBuildInitialLedger(units)\n  const unit = aiBuildNextUnit(ordered, ledger)\n  if (!unit) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  const kind: AiJobKind | null = unit.screen\n    ? 'page'\n    : unit.creation\n      ? (CREATION_JOB_KINDS[unit.creation.kind] ?? null)\n      : (AI_BUILD_ITEM_RUNNER_KINDS[unit.op] ?? null)\n  if (!kind) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  return aiJobStepRunMinimumMs(aiBuildUnitJob(job, unit, { kind, units, ledger, ops: new Map() }))\n}\n\n/** The runner kinds this plugin's own item operations use, for the time a pass needs without the registry. */\nconst AI_BUILD_ITEM_RUNNER_KINDS: Readonly<Record<string, AiJobKind>> = {\n  template: 'template',\n  campaign: 'campaign',\n  workflow: 'workflow',\n}\n\n/**\n * Why a Free build cannot be confirmed: its estimate is more than the owner's\n * Free allowance has left this month. Read off the account month the meter\n * writes, net of give-backs; a read that fails admits, since the reservation\n * still refuses at the wall.\n */\nexport async function aiBuildFreeBalanceRefusal(input: {\n  firestore: FirebaseFirestore.Firestore\n  org: object | null\n  estimate: number\n  now: Date\n}): Promise<string | null> {\n  const account = freeAssistAccount(input.org as AssistMeteredOrg | null)\n  if (!account?.accountUid) return null\n  try {\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    const left = Math.max(0, FREE_AI_TASTE_CREDITS_PER_MONTH - spent)\n    return input.estimate > left\n      ? `This plan is estimated at ${input.estimate} credits, and your Free AI credits have ${left} left this month. Ask for less, or upgrade for more.`\n      : null\n  } catch (error) {\n    console.error('ai build free balance read failed', { error })\n    return null\n  }\n}\n\nexport interface AiBuildAdmissionDeps {\n  opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>\n  freeBalanceRefusal?: typeof aiBuildFreeBalanceRefusal\n  ownerOf?: typeof resolveOrgIdForHost\n  now?: () => Date\n}\n\n/**\n * A build is admitted for a site of the job's own org where a page can be\n * built; and confirmed only for a plan it can build here — its shape, its\n * operations as this site has them, and on the Free taste an estimate the\n * month's Free credits still cover.\n */\nexport function createAiBuildJobAdmission(deps: AiBuildAdmissionDeps = {}): AiJobAdmission {\n  const opsFor = deps.opsFor ?? ((context) => aiBuildOps(context))\n  const freeBalanceRefusal = deps.freeBalanceRefusal ?? aiBuildFreeBalanceRefusal\n  const ownerOf = deps.ownerOf ?? resolveOrgIdForHost\n  return async (context) => {\n    if (!context.hostId) return { status: 400, error: 'Open the site to build on before asking Assist to build' }\n    const owner = await ownerOf(context.hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    if (!aiJobStepRunnerFor('page')) return { status: 400, error: 'Building from a request is not available yet.' }\n    const plan = context.plan\n    if (!plan) return null\n    const org = context.org as Partial<AglynOrgBilling> | null\n    const freeTaste = aiBuildFreeTaste(org)\n    const host = await readHost(context.firestore, context.hostId)\n    const ops = await opsFor({ orgId: context.orgId, hostId: context.hostId, org, host, freeTaste })\n    const shape = aiBuildPlanShapeRefusal(plan, { freeTaste, ops })\n    if (shape) return { status: 400, error: shape }\n    if (freeTaste) {\n      const refusal = await freeBalanceRefusal({\n        firestore: context.firestore,\n        org,\n        estimate: aiBuildCreditEstimate(plan, { ops }),\n        now: deps.now?.() ?? new Date(),\n      })\n      if (refusal) return { status: 403, error: refusal }\n    }\n    return null\n  }\n}\n\nexport const aiBuildJobAdmission = createAiBuildJobAdmission()\n\n/**\n * Registers the build with the least time a pass needs, the time its next\n * pass needs, the passes its largest plan may take, and its admission.\n */\nexport function registerAiBuildJob(): void {\n  registerAiJobStep('build', runAiJobBuildStep, {\n    minimumMs: AI_JOB_PAGE_STEP_MINIMUM_MS,\n    minimumMsFor: aiBuildJobRunMinimumMs,\n  })\n  registerAiJobStepPasses('build', AI_BUILD_MAX_PASSES)\n  registerAiJobAdmission('build', aiBuildJobAdmission)\n}\n"],"names":["resolveEffectivePlan","resolveOrgIdForHost","AI_BUILD_LIMITS","AI_BUILD_PUBLISH_INPUT","aiArticle","aiBuildCreditEstimate","aiBuildDegradation","aiBuildInitialLedger","aiBuildItemDelivered","aiBuildItemOpen","aiBuildNextUnit","aiBuildOrder","aiBuildPlacedItemLines","aiBuildPlanShapeRefusal","aiBuildUnits","isAiPlanNewRef","AI_SITE_MAX_SECTIONS","FREE_AI_TASTE_CREDITS_PER_MONTH","aiModelForStep","AI_BUILD_UNIT_EMPTY_COPY","aiBuildBuiltRefs","aiUnitErrorRetryable","aiUnitFailure","aiUnitSpend","assistCreditsFromUsd","ASSIST_RETURNED_USD_FIELD","assistSpendAfterReturnsUsd","freeAccountUsageRef","freeAssistAccount","aiBuildOps","aiJobAdmissionRefusal","registerAiJobAdmission","aiOriginJobId","readAiDraftNodes","aiConfirmedPlan","aiUnspentOutcome","AI_JOB_PAGE_STEP_MINIMUM_MS","aiPluginDraftAdmissionRefusal","aiPluginDraftWriter","aiSitePageWritten","aiSiteResolvedRef","AI_JOB_BRIEF_MAX_CHARS","aiJobPublishesBuild","aiPublishGuidedSite","AI_PLANNED_JOB_KINDS","aiJobStepRunMinimumMs","aiJobStepRunnerFor","registerAiJobStep","registerAiJobStepPasses","AI_BUILD_NO_PLAN_COPY","aiBuildUnavailableCopy","noun","AI_BUILD_PAGE_NOT_WRITTEN_COPY","AI_BUILD_MAX_PASSES","units","CREATION_JOB_KINDS","layout","form","component","email","aiBuildUnitJobKind","unit","ops","screen","creation","kind","runnerKind","get","op","aiBuildUnitJobId","job","id","item","$id","slot","aiBuildUnitJob","context","plan","built","ledger","outputs","labels","entry","values","label","brief","trim","unitPlan","reuse","create","screens","items","placedByScreens","Set","flatMap","sections","section","uses","filter","has","duplicateOf","push","name","why","purpose","builtLayout","template","record","dataset","map","ref","title","slug","includes","fields","briefLines","inputs","args","originJobId","steps","join","slice","failed","failure","extra","status","aiBuildFreeTaste","org","Boolean","readHost","firestore","hostId","collection","doc","data","createAiJobBuildStep","deps","runnerFor","writerFor","opsFor","admissionFor","pluginAdmission","readNodes","publish","rows","model","modelFor","ordered","starting","length","init","Map","row","host","orgId","freeTaste","othersOpen","some","one","finish","outcome","extraPages","sitePublish","pageIds","pages","output","resource","now","catch","error","console","jobId","settle","spent","continue","degradation","skip","note","degradedBy","capability","degraded","notes","draftResource","writer","admission","uid","createdBy","refusal","drafts","dependencies","dep","find","content","draftContent","checked","check","ok","ours","reason","message","problems","written","write","versionId","where","runner","derived","ids","stopped","page","undefined","unitJobId","draftId","done","set","runAiJobBuildStep","aiBuildJobRunMinimumMs","AI_BUILD_ITEM_RUNNER_KINDS","campaign","workflow","aiBuildFreeBalanceRefusal","input","account","accountUid","month","toISOString","snapshot","left","Math","max","estimate","createAiBuildJobAdmission","freeBalanceRefusal","ownerOf","owner","shape","Date","aiBuildJobAdmission","registerAiBuildJob","minimumMs","minimumMsFor"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-build-step.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { resolveEffectivePlan } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport {\n  AI_BUILD_LIMITS,\n  AI_BUILD_PUBLISH_INPUT,\n  aiArticle,\n  aiBuildCreditEstimate,\n  aiBuildDegradation,\n  aiBuildInitialLedger,\n  aiBuildItemDelivered,\n  aiBuildItemOpen,\n  aiBuildNextUnit,\n  aiBuildOrder,\n  aiBuildPlacedItemLines,\n  aiBuildPlanShapeRefusal,\n  aiBuildUnits,\n  type AiBuildOps,\n  type AiBuildUnit,\n} from '../model/ai-build-job'\nimport { isAiPlanNewRef, type AiBuildPlanCreateKind } from '../model/ai-build-plan'\nimport type {\n  AiJob,\n  AiJobItemFailure,\n  AiJobItemLedger,\n  AiJobKind,\n  AiJobOutput,\n  AiJobPlan,\n} from '../model/ai-jobs.types'\nimport { AI_SITE_MAX_SECTIONS } from '../model/ai-site-job'\nimport { FREE_AI_TASTE_CREDITS_PER_MONTH } from '../plan-entitlements'\nimport { aiModelForStep } from '../providers/routing'\nimport {\n  AI_BUILD_UNIT_EMPTY_COPY,\n  aiBuildBuiltRefs,\n  aiUnitErrorRetryable,\n  aiUnitFailure,\n  aiUnitSpend,\n} from './ai-build-unit-outcome'\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 { aiBuildOps, type AiBuildOpsContext } from './ai-build-capabilities'\nimport {\n  aiJobAdmissionRefusal,\n  registerAiJobAdmission,\n  type AiJobAdmission,\n  type AiJobAdmissionContext,\n} from './ai-job-admission'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { readAiDraftNodes } from './ai-job-drafts'\nimport { aiConfirmedPlan, aiUnspentOutcome } from './ai-job-generation'\nimport { AI_JOB_PAGE_STEP_MINIMUM_MS } from './ai-job-page-budget'\nimport {\n  aiPluginDraftAdmissionRefusal,\n  aiPluginDraftWriter,\n  type AiPluginDraftWriterLookup,\n} from './ai-job-plugin-drafts'\nimport { aiSitePageWritten, aiSiteResolvedRef } from './ai-job-site-step'\nimport { AI_LAYOUT_SITE_PAGES_INPUT, aiLayoutSitePagesOfPlan } from './ai-job-layout-site-pages'\nimport { AI_LAYOUT_FORM_PAGE_INPUT, AI_LAYOUT_LANGUAGE_INPUT, aiLayoutFormPageOfPlan } from './ai-job-page-language'\nimport {\n  AI_JOB_BRIEF_MAX_CHARS,\n  type AiJobItemOutcome,\n  type AiJobStepOutcome,\n  type AiJobStepRunner,\n} from './ai-job-text-step'\nimport { aiJobPublishesBuild, aiPublishGuidedSite } from './ai-site-publish'\nimport {\n  AI_PLANNED_JOB_KINDS,\n  aiJobStepRunMinimumMs,\n  aiJobStepRunnerFor,\n  registerAiJobStep,\n  registerAiJobStepPasses,\n} from './ai-jobs'\n\n/**\n * The build step (AGL-3616): the generation step of a `build` job, run once\n * the member confirmed the plan their request produced.\n *\n * Like the site scaffold it generalizes, it builds nothing itself and asks no\n * model of its own. Each pass takes the next unit in dependency order and\n * hands it to what builds that kind of thing — a page, layout, form,\n * component, email design or template to this plugin's own step, under a job\n * derived for the unit; another plugin's resource to that plugin's writer on\n * the resource-draft seam, with the content the owner's capability derives\n * from the item's arguments. One unit, one pass, one recorded spend.\n *\n * ── Settled item by item ────────────────────────────────────────────────\n *\n * Where a unit stands is read from the job's ITEM LEDGER, never from counting\n * outputs: the machine writes each pass's row in the transaction that\n * records its spend (`recordStep`). A unit that fails is a FAILED ROW, not a\n * failed job: the pass reports it, the machine gives back that item's spend\n * where the failure was ours, and the next pass builds the next unit. What\n * depended on it is built without it, or skipped where it cannot stand\n * without it (`aiBuildDegradation`). The machine ends the job when nothing is\n * left: `done` when anything was delivered, `failed` — its planning given\n * back too — when nothing was.\n *\n * ── Drafts, unless asked and confirmed ───────────────────────────────────\n *\n * Every unit writes the draft its own kind writes, which nothing publishes.\n * Only a build whose request asked to publish AND whose member ticked the\n * plan card's box puts its built pages live, once, on its last pass, through\n * the guided start's publish.\n */\n\n/** What a build answers with no confirmed plan to build. */\nexport const AI_BUILD_NO_PLAN_COPY = 'This build has no confirmed plan to build.'\n\n/** What a unit says when nothing on this site builds its operation any more. */\nexport const aiBuildUnavailableCopy = (noun: string): string =>\n  `Not built: ${aiArticle(noun)} cannot be made on this site right now.`\n\n\n/** What a page that was reported built but holds none of its plan says. */\nexport const AI_BUILD_PAGE_NOT_WRITTEN_COPY = 'The page was not written from its plan.'\n\n\n/**\n * The most passes a build's step may take: every unit at a page's worst — its\n * sections and its listing — so a runner that never finishes is still\n * bounded while the largest plan is not. Try again starts the count over.\n */\nexport const AI_BUILD_MAX_PASSES = AI_BUILD_LIMITS.units * (AI_SITE_MAX_SECTIONS + 1)\n\n/** The job kind a creation of the build is built by. */\nconst CREATION_JOB_KINDS: Partial<Record<AiBuildPlanCreateKind, AiJobKind>> = {\n  layout: 'layout',\n  form: 'form',\n  component: 'component',\n  email: 'email',\n}\n\n/** The job kind a unit is built by, where an AI runner builds it. */\nexport function aiBuildUnitJobKind(unit: AiBuildUnit, ops: AiBuildOps): AiJobKind | null {\n  if (unit.screen) return 'page'\n  if (unit.creation) return CREATION_JOB_KINDS[unit.creation.kind] ?? null\n  const runnerKind = ops.get(unit.op)?.runnerKind\n  return runnerKind ? (runnerKind as AiJobKind) : null\n}\n\n/** The id a unit's job, and so its draft, is named by. */\nexport function aiBuildUnitJobId(job: Pick<AiJob, '$id'>, unit: AiBuildUnit): string {\n  return unit.creation?.id ?? unit.screen?.id ?? unit.item?.id ?? `${job.$id}-${unit.slot}`\n}\n\n/**\n * The job a unit is built under (generalizing `aiSiteUnitJob`): this job's\n * org, site, creator and model; the kind that builds the unit; a plan\n * narrowed to the unit, its `new:` references resolved to what was built and\n * the failed ones left out; and a brief that says what the unit is, what it\n * is built without, and which blocks its sections place.\n */\nexport function aiBuildUnitJob(\n  job: AiJob,\n  unit: AiBuildUnit,\n  context: {\n    kind: AiJobKind\n    units: readonly AiBuildUnit[]\n    ledger: readonly AiJobItemLedger[]\n    ops: AiBuildOps\n    briefLines?: readonly string[]\n  },\n): AiJob {\n  const plan = job.plan as AiJobPlan\n  const built = aiBuildBuiltRefs(context.units, context.ledger, job.outputs ?? [])\n  const labels = { ...(plan.labels ?? {}) }\n  for (const entry of built.values()) labels[entry.id] = entry.label\n  const brief = [job.brief.trim()]\n  const unitPlan: AiJobPlan = { ...plan, labels, reuse: [...plan.reuse], create: [], screens: [] }\n  delete unitPlan.items\n  const placedByScreens = new Set(plan.screens.flatMap((screen) => screen.sections.flatMap((section) => section.uses)))\n  if (unit.creation) {\n    unitPlan.reuse = plan.reuse.filter((entry) => !placedByScreens.has(entry.id))\n    unitPlan.create = [{ ...unit.creation, duplicateOf: aiSiteResolvedRef(unit.creation.duplicateOf, built) }]\n    brief.push(`Build the ${unit.creation.kind} “${unit.creation.name}”: ${unit.creation.why}`)\n  }\n  if (unit.screen) {\n    const screen = unit.screen\n    for (const entry of built.values()) {\n      unitPlan.reuse.push({ kind: entry.kind, id: entry.id, purpose: `the ${entry.kind} this request built` })\n    }\n    let builtLayout: string | null = null\n    for (const entry of built.values()) if (entry.kind === 'layout') builtLayout = builtLayout ?? entry.id\n    unitPlan.screens = [\n      {\n        ...screen,\n        // A page whose layout failed renders inside the site's own: the page\n        // step falls back to it when the plan names none.\n        layout: aiSiteResolvedRef(screen.layout, built) ?? (isAiPlanNewRef(screen.layout) ? builtLayout : null),\n        template: aiSiteResolvedRef(screen.template, built),\n        duplicateOf: aiSiteResolvedRef(screen.duplicateOf, built),\n        record: screen.record\n          ? { ...screen.record, dataset: aiSiteResolvedRef(screen.record.dataset, built) ?? screen.record.dataset }\n          : null,\n        sections: screen.sections.map((section) => ({\n          ...section,\n          uses: section.uses\n            .map((ref) => aiSiteResolvedRef(ref, built))\n            .filter((ref): ref is string => !!ref),\n        })),\n      },\n    ]\n    brief.push(`Build the page “${screen.title}”, at ${screen.slug}.`)\n    brief.push(...aiBuildPlacedItemLines(unit, { units: context.units, ledger: context.ledger, ops: context.ops }))\n  }\n  const item = unit.item\n  if (item) {\n    const noun = context.ops.get(item.op)?.noun ?? item.op\n    brief.push(`Build the ${noun} “${item.name}”${item.why ? `: ${item.why}` : '.'}`)\n    // A planned kind's step builds the plan's first creation of its kind.\n    unitPlan.create = AI_PLANNED_JOB_KINDS.includes(context.kind)\n      ? [{ kind: context.kind as AiBuildPlanCreateKind, name: item.name, why: item.why, duplicateOf: null, fields: [], ...(item.id ? { id: item.id } : {}) }]\n      : []\n  }\n  brief.push(...(context.briefLines ?? []))\n  const inputs: Record<string, unknown> = {\n    ...job.inputs,\n    ...(item?.args ?? {}),\n    originJobId: aiOriginJobId(job),\n  }\n  delete inputs[AI_BUILD_PUBLISH_INPUT]\n  // A build's pages and layouts are designed in the layout language and\n  // compiled (AGL-3660), told the pages the build plans and where its form is.\n  if (context.kind === 'page' || context.kind === 'layout') {\n    inputs[AI_LAYOUT_LANGUAGE_INPUT] = true\n    const pages = aiLayoutSitePagesOfPlan(plan.screens)\n    if (pages.length) inputs[AI_LAYOUT_SITE_PAGES_INPUT] = pages\n    const formPage = aiLayoutFormPageOfPlan(plan)\n    if (formPage) inputs[AI_LAYOUT_FORM_PAGE_INPUT] = formPage\n  }\n  return {\n    ...job,\n    $id: aiBuildUnitJobId(job, unit),\n    kind: context.kind,\n    steps: [],\n    outputs: [],\n    items: null,\n    plan: item && !AI_PLANNED_JOB_KINDS.includes(context.kind) ? null : unitPlan,\n    inputs,\n    brief: brief.join('\\n').slice(0, AI_JOB_BRIEF_MAX_CHARS),\n  }\n}\n\n/** The unit's failure, for its row: ours or not, why, in customer-safe words. */\nfunction failed(\n  slot: string,\n  failure: AiJobItemFailure,\n  extra: Partial<AiJobItemOutcome> = {},\n): AiJobItemOutcome {\n  return { slot, status: 'failed', failure, ...extra }\n}\n\nexport interface AiJobBuildStepDeps {\n  /** The runner registry; specs hand in fakes. */\n  runnerFor?: typeof aiJobStepRunnerFor\n  /** The draft writer registry; specs hand in fakes. */\n  writerFor?: AiPluginDraftWriterLookup\n  /** The operations this site may use; the registry and its gates otherwise. */\n  opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>\n  /** A runner kind's own admission, asked before its item runs; the registry's otherwise. */\n  admissionFor?: typeof aiJobAdmissionRefusal\n  /** Another plugin's admission for its writer; the seam's otherwise. */\n  pluginAdmission?: typeof aiPluginDraftAdmissionRefusal\n  /** The draft reader a built page is checked through. */\n  readNodes?: typeof readAiDraftNodes\n  /** The publish a build asked for and confirmed. */\n  publish?: typeof aiPublishGuidedSite\n}\n\n/** Whether a build's workspace spends the Free taste. */\nexport function aiBuildFreeTaste(org: object | null | undefined): boolean {\n  return Boolean(org) && resolveEffectivePlan(org as never) === 'free'\n}\n\n/** The site document a gate reads, or `null`. */\nasync function readHost(firestore: FirebaseFirestore.Firestore, hostId: string | null) {\n  if (!hostId) return null\n  return ((await firestore.collection('hosts').doc(hostId).get()).data() ?? null) as Record<string, unknown> | null\n}\n\nexport function createAiJobBuildStep(deps: AiJobBuildStepDeps = {}): AiJobStepRunner {\n  const runnerFor = deps.runnerFor ?? aiJobStepRunnerFor\n  const writerFor = deps.writerFor ?? aiPluginDraftWriter\n  const opsFor = deps.opsFor ?? ((context) => aiBuildOps(context))\n  const admissionFor = deps.admissionFor ?? aiJobAdmissionRefusal\n  const pluginAdmission = deps.pluginAdmission ?? aiPluginDraftAdmissionRefusal\n  const readNodes = deps.readNodes ?? readAiDraftNodes\n  const publish = deps.publish ?? aiPublishGuidedSite\n\n  return async (context): Promise<AiJobStepOutcome> => {\n    const { job, firestore } = context\n    const model = context.modelFor?.('job.plan') ?? aiModelForStep('job.plan')\n    const plan = aiConfirmedPlan(job)\n    if (!plan) return { ...aiUnspentOutcome(model), failure: AI_BUILD_NO_PLAN_COPY }\n    const org = (context.org ?? null) as Partial<AglynOrgBilling> | null\n    const units = aiBuildUnits(plan)\n    const ordered = aiBuildOrder(units) ?? units\n    const starting = !job.items?.length\n    const ledger = starting ? aiBuildInitialLedger(units) : (job.items as AiJobItemLedger[])\n    const init = starting ? { items: ledger } : {}\n    const unit = aiBuildNextUnit(ordered, ledger)\n    const rows = new Map(ledger.map((row) => [row.slot, row]))\n    const host = await readHost(firestore, job.hostId ?? null)\n    const ops = await opsFor({\n      orgId: job.orgId,\n      hostId: job.hostId ?? null,\n      org,\n      host,\n      freeTaste: aiBuildFreeTaste(org),\n    })\n\n    /** Whether units other than this one are still to build. */\n    const othersOpen = (slot: string) =>\n      ordered.some((one) => one.slot !== slot && aiBuildItemOpen(rows.get(one.slot) ?? { status: 'pending' }))\n\n    /** The build's last pass puts its pages live, where it was asked and confirmed. */\n    const finish = async (outcome: AiJobStepOutcome, extraPages: readonly AiJobOutput[] = []): Promise<AiJobStepOutcome> => {\n      if (!aiJobPublishesBuild(job) || job.sitePublish || !job.hostId) return outcome\n      const pageIds = new Set(\n        units\n          .filter((one) => one.screen && aiBuildItemDelivered(rows.get(one.slot) ?? { status: 'pending' }))\n          .flatMap((one) => rows.get(one.slot)?.outputs ?? []),\n      )\n      const pages = [\n        ...(job.outputs ?? []).filter((output) => output.resource === 'screen' && pageIds.has(output.id)),\n        ...extraPages,\n      ]\n      if (!pages.length) return outcome\n      const sitePublish = await publish(firestore, { job, outputs: pages, now: context.now }).catch((error: unknown) => {\n        console.error('ai build publish threw', { orgId: job.orgId, jobId: job.$id, error })\n        return null\n      })\n      return sitePublish ? { ...outcome, sitePublish } : outcome\n    }\n\n    if (!unit) return finish({ ...aiUnspentOutcome(model), ...init })\n\n    const settle = (item: AiJobItemOutcome, spent: AiJobStepOutcome = aiUnspentOutcome(model)): AiJobStepOutcome => ({\n      ...spent,\n      ...init,\n      item,\n      ...(item.status === 'running' || othersOpen(unit.slot) ? { continue: true } : {}),\n    })\n\n    // What its dependencies came to.\n    const degradation = aiBuildDegradation(unit, { units, ledger, ops })\n    if (degradation.skip) {\n      return settle({ slot: unit.slot, status: 'skipped', note: degradation.skip, degradedBy: degradation.degradedBy })\n    }\n    const capability = ops.get(unit.op)\n    const noun = capability?.noun ?? unit.op\n    if (!capability) return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n    const degraded = degradation.degradedBy.length > 0\n    const note = degradation.notes.length ? degradation.notes.join(' ') : null\n\n    // Another plugin's resource: its writer, with the content its capability derives.\n    if (capability.draftResource) {\n      const item = unit.item\n      const writer = writerFor(capability.draftResource)\n      if (!item || !writer || !job.hostId) {\n        return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n      }\n      const admission: AiJobAdmissionContext = {\n        firestore,\n        orgId: job.orgId,\n        hostId: job.hostId,\n        inputs: {},\n        org,\n        uid: job.createdBy,\n      }\n      const refusal = await pluginAdmission(admission, {\n        kind: 'build',\n        drafts: [{ resource: capability.draftResource, label: capability.noun }],\n        writerFor,\n      })\n      if (refusal) return settle({ slot: unit.slot, status: 'skipped', note: `Not built: ${refusal.error}` })\n      const dependencies: Record<string, { op: string; id: string }> = {}\n      for (const slot of unit.deps) {\n        const dep = units.find((one) => one.slot === slot)\n        const row = rows.get(slot)\n        if (!dep || !row || !aiBuildItemDelivered(row) || !row.outputs.length) continue\n        dependencies[`new:${dep.label}`] = { op: dep.op, id: row.outputs[0] }\n      }\n      const content = capability.draftContent?.({ name: item.name, args: item.args }, { hostId: job.hostId, dependencies }) ?? item.args\n      const checked = writer.check(content, { hostId: job.hostId })\n      if (checked.ok === false) {\n        return settle(\n          failed(unit.slot, { ours: true, reason: 'step-failure', message: checked.problems[0] ?? AI_BUILD_UNIT_EMPTY_COPY }),\n        )\n      }\n      const id = aiBuildUnitJobId(job, unit)\n      const written = await writer.write({\n        orgId: job.orgId,\n        hostId: job.hostId,\n        uid: job.createdBy,\n        org,\n        now: context.now,\n        id,\n        name: item.name,\n        content,\n      })\n      if (written.ok === false) {\n        return settle(failed(unit.slot, { ours: false, reason: 'review', message: written.error }))\n      }\n      const output: AiJobOutput = {\n        resource: 'draft',\n        id: written.id,\n        versionId: written.versionId,\n        hostId: job.hostId,\n        label: written.name,\n        draftResource: capability.draftResource,\n        note: `A draft, in ${capability.where}.`,\n      }\n      return settle(\n        {\n          slot: unit.slot,\n          status: degraded ? 'degraded' : 'succeeded',\n          outputs: [written.id],\n          note,\n          ...(degraded ? { degradedBy: degradation.degradedBy } : {}),\n        },\n        { ...aiUnspentOutcome(model), outputs: [output] },\n      )\n    }\n\n    // This plugin's own runner, under a job derived for the unit.\n    const kind = aiBuildUnitJobKind(unit, ops)\n    const runner = kind ? runnerFor(kind) : null\n    if (!kind || !runner) return settle({ slot: unit.slot, status: 'skipped', note: aiBuildUnavailableCopy(noun) })\n    const derived = aiBuildUnitJob(job, unit, { kind, units, ledger, ops, briefLines: degradation.briefLines })\n    // An item's kind is asked its own admission first (a campaign's plan,\n    // a template's subject), once, before its first pass.\n    if (unit.item && rows.get(unit.slot)?.status !== 'running') {\n      const refusal = await admissionFor(kind, {\n        firestore,\n        orgId: job.orgId,\n        hostId: job.hostId ?? null,\n        inputs: derived.inputs,\n        org,\n        uid: job.createdBy,\n      }).catch((error: unknown) => {\n        console.error('ai build item admission failed', { orgId: job.orgId, jobId: job.$id, slot: unit.slot, error })\n        return { status: 403 as const, error: AI_BUILD_UNIT_EMPTY_COPY }\n      })\n      if (refusal) return settle({ slot: unit.slot, status: 'skipped', note: `Not built: ${refusal.error}` })\n    }\n\n    let outcome: AiJobStepOutcome\n    try {\n      outcome = await runner({ ...context, job: derived })\n    } catch (error) {\n      // A provider that will answer later is the machine's to retry; anything\n      // else is this item's failure, and the build goes on.\n      if (aiUnitErrorRetryable(error)) throw error\n      console.error('ai build unit threw', { orgId: job.orgId, jobId: job.$id, slot: unit.slot, error })\n      return settle(failed(unit.slot, { ours: true, reason: 'provider', message: AI_BUILD_UNIT_EMPTY_COPY }))\n    }\n    const spent = aiUnitSpend(outcome)\n    const ids = outcome.outputs.map((output) => output.id)\n    const stopped = aiUnitFailure(unit.slot, outcome)\n    if (stopped) return settle(stopped, spent)\n    // A page counts as built only when its plan's sections are in it (AGL-3596).\n    if (unit.screen && job.hostId) {\n      const page = outcome.outputs.find((output) => output.resource === 'screen')\n      const written =\n        page !== undefined &&\n        (await aiSitePageWritten(\n          firestore,\n          { hostId: job.hostId, unitJobId: derived.$id, screen: unit.screen, draftId: page.id },\n          readNodes,\n        ))\n      if (!written) {\n        return settle(\n          failed(unit.slot, { ours: true, reason: 'step-failure', message: AI_BUILD_PAGE_NOT_WRITTEN_COPY }),\n          { ...spent, outputs: outcome.outputs.filter((output) => output.resource !== 'screen') },\n        )\n      }\n    }\n    const done = settle(\n      {\n        slot: unit.slot,\n        status: degraded ? 'degraded' : 'succeeded',\n        outputs: ids,\n        note,\n        ...(degraded ? { degradedBy: degradation.degradedBy } : {}),\n      },\n      spent,\n    )\n    if (done.continue) return done\n    // The last unit: what was built goes live where it was asked and confirmed.\n    rows.set(unit.slot, { ...(rows.get(unit.slot) as AiJobItemLedger), status: degraded ? 'degraded' : 'succeeded', outputs: ids })\n    return finish(done, unit.screen ? outcome.outputs.filter((output) => output.resource === 'screen') : [])\n  }\n}\n\nexport const runAiJobBuildStep = createAiJobBuildStep()\n\n/**\n * The least time a build's next pass needs: what the step that builds its\n * next unit registers for the job derived for it; a page pass's when the\n * next unit is another plugin's draft, which asks no model.\n */\nexport function aiBuildJobRunMinimumMs(job: AiJob): number {\n  const plan = aiConfirmedPlan(job)\n  if (!plan) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  const units = aiBuildUnits(plan)\n  const ordered = aiBuildOrder(units) ?? units\n  const ledger = job.items?.length ? job.items : aiBuildInitialLedger(units)\n  const unit = aiBuildNextUnit(ordered, ledger)\n  if (!unit) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  const kind: AiJobKind | null = unit.screen\n    ? 'page'\n    : unit.creation\n      ? (CREATION_JOB_KINDS[unit.creation.kind] ?? null)\n      : (AI_BUILD_ITEM_RUNNER_KINDS[unit.op] ?? null)\n  if (!kind) return AI_JOB_PAGE_STEP_MINIMUM_MS\n  return aiJobStepRunMinimumMs(aiBuildUnitJob(job, unit, { kind, units, ledger, ops: new Map() }))\n}\n\n/** The runner kinds this plugin's own item operations use, for the time a pass needs without the registry. */\nconst AI_BUILD_ITEM_RUNNER_KINDS: Readonly<Record<string, AiJobKind>> = {\n  template: 'template',\n  campaign: 'campaign',\n  workflow: 'workflow',\n  function: 'logic',\n  edit: 'edit',\n}\n\n/**\n * Why a Free build cannot be confirmed: its estimate is more than the owner's\n * Free allowance has left this month. Read off the account month the meter\n * writes, net of give-backs; a read that fails admits, since the reservation\n * still refuses at the wall.\n */\nexport async function aiBuildFreeBalanceRefusal(input: {\n  firestore: FirebaseFirestore.Firestore\n  org: object | null\n  estimate: number\n  now: Date\n}): Promise<string | null> {\n  const account = freeAssistAccount(input.org as AssistMeteredOrg | null)\n  if (!account?.accountUid) return null\n  try {\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    const left = Math.max(0, FREE_AI_TASTE_CREDITS_PER_MONTH - spent)\n    return input.estimate > left\n      ? `This plan is estimated at ${input.estimate} credits, and your Free AI credits have ${left} left this month. Ask for less, or upgrade for more.`\n      : null\n  } catch (error) {\n    console.error('ai build free balance read failed', { error })\n    return null\n  }\n}\n\nexport interface AiBuildAdmissionDeps {\n  opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>\n  freeBalanceRefusal?: typeof aiBuildFreeBalanceRefusal\n  ownerOf?: typeof resolveOrgIdForHost\n  now?: () => Date\n}\n\n/**\n * A build is admitted for a site of the job's own org where a page can be\n * built; and confirmed only for a plan it can build here — its shape, its\n * operations as this site has them, and on the Free taste an estimate the\n * month's Free credits still cover.\n */\nexport function createAiBuildJobAdmission(deps: AiBuildAdmissionDeps = {}): AiJobAdmission {\n  const opsFor = deps.opsFor ?? ((context) => aiBuildOps(context))\n  const freeBalanceRefusal = deps.freeBalanceRefusal ?? aiBuildFreeBalanceRefusal\n  const ownerOf = deps.ownerOf ?? resolveOrgIdForHost\n  return async (context) => {\n    if (!context.hostId) return { status: 400, error: 'Open the site to build on before asking Assist to build' }\n    const owner = await ownerOf(context.hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    if (!aiJobStepRunnerFor('page')) return { status: 400, error: 'Building from a request is not available yet.' }\n    const plan = context.plan\n    if (!plan) return null\n    const org = context.org as Partial<AglynOrgBilling> | null\n    const freeTaste = aiBuildFreeTaste(org)\n    const host = await readHost(context.firestore, context.hostId)\n    const ops = await opsFor({ orgId: context.orgId, hostId: context.hostId, org, host, freeTaste })\n    const shape = aiBuildPlanShapeRefusal(plan, { freeTaste, ops })\n    if (shape) return { status: 400, error: shape }\n    if (freeTaste) {\n      const refusal = await freeBalanceRefusal({\n        firestore: context.firestore,\n        org,\n        estimate: aiBuildCreditEstimate(plan, { ops }),\n        now: deps.now?.() ?? new Date(),\n      })\n      if (refusal) return { status: 403, error: refusal }\n    }\n    return null\n  }\n}\n\nexport const aiBuildJobAdmission = createAiBuildJobAdmission()\n\n/**\n * Registers the build with the least time a pass needs, the time its next\n * pass needs, the passes its largest plan may take, and its admission.\n */\nexport function registerAiBuildJob(): void {\n  registerAiJobStep('build', runAiJobBuildStep, {\n    minimumMs: AI_JOB_PAGE_STEP_MINIMUM_MS,\n    minimumMsFor: aiBuildJobRunMinimumMs,\n  })\n  registerAiJobStepPasses('build', AI_BUILD_MAX_PASSES)\n  registerAiJobAdmission('build', aiBuildJobAdmission)\n}\n"],"names":["resolveEffectivePlan","resolveOrgIdForHost","AI_BUILD_LIMITS","AI_BUILD_PUBLISH_INPUT","aiArticle","aiBuildCreditEstimate","aiBuildDegradation","aiBuildInitialLedger","aiBuildItemDelivered","aiBuildItemOpen","aiBuildNextUnit","aiBuildOrder","aiBuildPlacedItemLines","aiBuildPlanShapeRefusal","aiBuildUnits","isAiPlanNewRef","AI_SITE_MAX_SECTIONS","FREE_AI_TASTE_CREDITS_PER_MONTH","aiModelForStep","AI_BUILD_UNIT_EMPTY_COPY","aiBuildBuiltRefs","aiUnitErrorRetryable","aiUnitFailure","aiUnitSpend","assistCreditsFromUsd","ASSIST_RETURNED_USD_FIELD","assistSpendAfterReturnsUsd","freeAccountUsageRef","freeAssistAccount","aiBuildOps","aiJobAdmissionRefusal","registerAiJobAdmission","aiOriginJobId","readAiDraftNodes","aiConfirmedPlan","aiUnspentOutcome","AI_JOB_PAGE_STEP_MINIMUM_MS","aiPluginDraftAdmissionRefusal","aiPluginDraftWriter","aiSitePageWritten","aiSiteResolvedRef","AI_LAYOUT_SITE_PAGES_INPUT","aiLayoutSitePagesOfPlan","AI_LAYOUT_FORM_PAGE_INPUT","AI_LAYOUT_LANGUAGE_INPUT","aiLayoutFormPageOfPlan","AI_JOB_BRIEF_MAX_CHARS","aiJobPublishesBuild","aiPublishGuidedSite","AI_PLANNED_JOB_KINDS","aiJobStepRunMinimumMs","aiJobStepRunnerFor","registerAiJobStep","registerAiJobStepPasses","AI_BUILD_NO_PLAN_COPY","aiBuildUnavailableCopy","noun","AI_BUILD_PAGE_NOT_WRITTEN_COPY","AI_BUILD_MAX_PASSES","units","CREATION_JOB_KINDS","layout","form","component","email","aiBuildUnitJobKind","unit","ops","screen","creation","kind","runnerKind","get","op","aiBuildUnitJobId","job","id","item","$id","slot","aiBuildUnitJob","context","plan","built","ledger","outputs","labels","entry","values","label","brief","trim","unitPlan","reuse","create","screens","items","placedByScreens","Set","flatMap","sections","section","uses","filter","has","duplicateOf","push","name","why","purpose","builtLayout","template","record","dataset","map","ref","title","slug","includes","fields","briefLines","inputs","args","originJobId","pages","length","formPage","steps","join","slice","failed","failure","extra","status","aiBuildFreeTaste","org","Boolean","readHost","firestore","hostId","collection","doc","data","createAiJobBuildStep","deps","runnerFor","writerFor","opsFor","admissionFor","pluginAdmission","readNodes","publish","rows","model","modelFor","ordered","starting","init","Map","row","host","orgId","freeTaste","othersOpen","some","one","finish","outcome","extraPages","sitePublish","pageIds","output","resource","now","catch","error","console","jobId","settle","spent","continue","degradation","skip","note","degradedBy","capability","degraded","notes","draftResource","writer","admission","uid","createdBy","refusal","drafts","dependencies","dep","find","content","draftContent","checked","check","ok","ours","reason","message","problems","written","write","versionId","where","runner","derived","ids","stopped","page","undefined","unitJobId","draftId","done","set","runAiJobBuildStep","aiBuildJobRunMinimumMs","AI_BUILD_ITEM_RUNNER_KINDS","campaign","workflow","function","edit","aiBuildFreeBalanceRefusal","input","account","accountUid","month","toISOString","snapshot","left","Math","max","estimate","createAiBuildJobAdmission","freeBalanceRefusal","ownerOf","owner","shape","Date","aiBuildJobAdmission","registerAiBuildJob","minimumMs","minimumMsFor"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,oBAAoB,QAAQ,2CAA0C;AAC/E,SAASC,mBAAmB,QAAQ,gDAA+C;AACnF,SACEC,eAAe,EACfC,sBAAsB,EACtBC,SAAS,EACTC,qBAAqB,EACrBC,kBAAkB,EAClBC,oBAAoB,EACpBC,oBAAoB,EACpBC,eAAe,EACfC,eAAe,EACfC,YAAY,EACZC,sBAAsB,EACtBC,uBAAuB,EACvBC,YAAY,QAGP,2BAAuB;AAC9B,SAASC,cAAc,QAAoC,4BAAwB;AASnF,SAASC,oBAAoB,QAAQ,0BAAsB;AAC3D,SAASC,+BAA+B,QAAQ,0BAAsB;AACtE,SAASC,cAAc,QAAQ,0BAAsB;AACrD,SACEC,wBAAwB,EACxBC,gBAAgB,EAChBC,oBAAoB,EACpBC,aAAa,EACbC,WAAW,QACN,6BAAyB;AAChC,SAASC,oBAAoB,QAAQ,6BAAyB;AAC9D,SAASC,yBAAyB,EAAEC,0BAA0B,QAAQ,oCAAgC;AACtG,SAASC,mBAAmB,EAAEC,iBAAiB,QAA+B,gCAA4B;AAC1G,SAASC,UAAU,QAAgC,6BAAyB;AAC5E,SACEC,qBAAqB,EACrBC,sBAAsB,QAGjB,wBAAoB;AAC3B,SAASC,aAAa,QAAQ,wBAAoB;AAClD,SAASC,gBAAgB,QAAQ,qBAAiB;AAClD,SAASC,eAAe,EAAEC,gBAAgB,QAAQ,yBAAqB;AACvE,SAASC,2BAA2B,QAAQ,0BAAsB;AAClE,SACEC,6BAA6B,EAC7BC,mBAAmB,QAEd,4BAAwB;AAC/B,SAASC,iBAAiB,EAAEC,iBAAiB,QAAQ,wBAAoB;AACzE,SAASC,0BAA0B,EAAEC,uBAAuB,QAAQ,gCAA4B;AAChG,SAASC,yBAAyB,EAAEC,wBAAwB,EAAEC,sBAAsB,QAAQ,4BAAwB;AACpH,SACEC,sBAAsB,QAIjB,wBAAoB;AAC3B,SAASC,mBAAmB,EAAEC,mBAAmB,QAAQ,uBAAmB;AAC5E,SACEC,oBAAoB,EACpBC,qBAAqB,EACrBC,kBAAkB,EAClBC,iBAAiB,EACjBC,uBAAuB,QAClB,eAAW;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BC,GAED,0DAA0D,GAC1D,OAAO,MAAMC,wBAAwB,6CAA4C;AAEjF,8EAA8E,GAC9E,OAAO,MAAMC,yBAAyB,CAACC,OACrC,CAAC,WAAW,EAAEpD,UAAUoD,MAAM,uCAAuC,CAAC,CAAA;AAGxE,yEAAyE,GACzE,OAAO,MAAMC,iCAAiC,0CAAyC;AAGvF;;;;CAIC,GACD,OAAO,MAAMC,sBAAsBxD,gBAAgByD,KAAK,GAAI3C,CAAAA,uBAAuB,CAAA,EAAE;AAErF,sDAAsD,GACtD,MAAM4C,qBAAwE;IAC5EC,QAAQ;IACRC,MAAM;IACNC,WAAW;IACXC,OAAO;AACT;AAEA,mEAAmE,GACnE,OAAO,SAASC,mBAAmBC,IAAiB,EAAEC,GAAe;QAEzCP;QACPO;IAFnB,IAAID,KAAKE,MAAM,EAAE,OAAO;IACxB,IAAIF,KAAKG,QAAQ,EAAE,QAAOT,yCAAAA,kBAAkB,CAACM,KAAKG,QAAQ,CAACC,IAAI,CAAC,YAAtCV,yCAA0C;IACpE,MAAMW,cAAaJ,WAAAA,IAAIK,GAAG,CAACN,KAAKO,EAAE,sBAAfN,SAAkBI,UAAU;IAC/C,OAAOA,aAAcA,aAA2B;AAClD;AAEA,wDAAwD,GACxD,OAAO,SAASG,iBAAiBC,GAAuB,EAAET,IAAiB;QAClEA,MAAAA;QAAAA,gBAAqBA,cAAmBA;IAA/C,QAAOA,QAAAA,kBAAAA,iBAAAA,KAAKG,QAAQ,qBAAbH,eAAeU,EAAE,qBAAIV,eAAAA,KAAKE,MAAM,qBAAXF,aAAaU,EAAE,YAApCV,SAAwCA,aAAAA,KAAKW,IAAI,qBAATX,WAAWU,EAAE,YAArDV,OAAyD,GAAGS,IAAIG,GAAG,CAAC,CAAC,EAAEZ,KAAKa,IAAI,EAAE;AAC3F;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,eACdL,GAAU,EACVT,IAAiB,EACjBe,OAMC;QAG6DN,cACzCO,cAiDND;IAnDf,MAAMC,OAAOP,IAAIO,IAAI;IACrB,MAAMC,QAAQ/D,iBAAiB6D,QAAQtB,KAAK,EAAEsB,QAAQG,MAAM,GAAET,eAAAA,IAAIU,OAAO,YAAXV,eAAe,EAAE;IAC/E,MAAMW,SAAS,cAAMJ,eAAAA,KAAKI,MAAM,YAAXJ,eAAe,CAAC;IACrC,KAAK,MAAMK,SAASJ,MAAMK,MAAM,GAAIF,MAAM,CAACC,MAAMX,EAAE,CAAC,GAAGW,MAAME,KAAK;IAClE,MAAMC,QAAQ;QAACf,IAAIe,KAAK,CAACC,IAAI;KAAG;IAChC,MAAMC,WAAsB,aAAKV;QAAMI;QAAQO,OAAO;eAAIX,KAAKW,KAAK;SAAC;QAAEC,QAAQ,EAAE;QAAEC,SAAS,EAAE;;IAC9F,OAAOH,SAASI,KAAK;IACrB,MAAMC,kBAAkB,IAAIC,IAAIhB,KAAKa,OAAO,CAACI,OAAO,CAAC,CAAC/B,SAAWA,OAAOgC,QAAQ,CAACD,OAAO,CAAC,CAACE,UAAYA,QAAQC,IAAI;IAClH,IAAIpC,KAAKG,QAAQ,EAAE;QACjBuB,SAASC,KAAK,GAAGX,KAAKW,KAAK,CAACU,MAAM,CAAC,CAAChB,QAAU,CAACU,gBAAgBO,GAAG,CAACjB,MAAMX,EAAE;QAC3EgB,SAASE,MAAM,GAAG;YAAC,aAAK5B,KAAKG,QAAQ;gBAAEoC,aAAajE,kBAAkB0B,KAAKG,QAAQ,CAACoC,WAAW,EAAEtB;;SAAS;QAC1GO,MAAMgB,IAAI,CAAC,CAAC,UAAU,EAAExC,KAAKG,QAAQ,CAACC,IAAI,CAAC,EAAE,EAAEJ,KAAKG,QAAQ,CAACsC,IAAI,CAAC,GAAG,EAAEzC,KAAKG,QAAQ,CAACuC,GAAG,EAAE;IAC5F;IACA,IAAI1C,KAAKE,MAAM,EAAE;YAYH5B,oBAIyBA;QAfrC,MAAM4B,SAASF,KAAKE,MAAM;QAC1B,KAAK,MAAMmB,SAASJ,MAAMK,MAAM,GAAI;YAClCI,SAASC,KAAK,CAACa,IAAI,CAAC;gBAAEpC,MAAMiB,MAAMjB,IAAI;gBAAEM,IAAIW,MAAMX,EAAE;gBAAEiC,SAAS,CAAC,IAAI,EAAEtB,MAAMjB,IAAI,CAAC,mBAAmB,CAAC;YAAC;QACxG;QACA,IAAIwC,cAA6B;QACjC,KAAK,MAAMvB,SAASJ,MAAMK,MAAM,GAAI,IAAID,MAAMjB,IAAI,KAAK,UAAUwC,cAAcA,sBAAAA,cAAevB,MAAMX,EAAE;QACtGgB,SAASG,OAAO,GAAG;YACjB,aACK3B;gBACH,qEAAqE;gBACrE,kDAAkD;gBAClDP,MAAM,GAAErB,qBAAAA,kBAAkB4B,OAAOP,MAAM,EAAEsB,kBAAjC3C,qBAA4CzB,eAAeqD,OAAOP,MAAM,IAAIiD,cAAc;gBAClGC,UAAUvE,kBAAkB4B,OAAO2C,QAAQ,EAAE5B;gBAC7CsB,aAAajE,kBAAkB4B,OAAOqC,WAAW,EAAEtB;gBACnD6B,QAAQ5C,OAAO4C,MAAM,GACjB,aAAK5C,OAAO4C,MAAM;oBAAEC,OAAO,GAAEzE,sBAAAA,kBAAkB4B,OAAO4C,MAAM,CAACC,OAAO,EAAE9B,kBAAzC3C,sBAAmD4B,OAAO4C,MAAM,CAACC,OAAO;qBACrG;gBACJb,UAAUhC,OAAOgC,QAAQ,CAACc,GAAG,CAAC,CAACb,UAAa,aACvCA;wBACHC,MAAMD,QAAQC,IAAI,CACfY,GAAG,CAAC,CAACC,MAAQ3E,kBAAkB2E,KAAKhC,QACpCoB,MAAM,CAAC,CAACY,MAAuB,CAAC,CAACA;;;SAGzC;QACDzB,MAAMgB,IAAI,CAAC,CAAC,gBAAgB,EAAEtC,OAAOgD,KAAK,CAAC,MAAM,EAAEhD,OAAOiD,IAAI,CAAC,CAAC,CAAC;QACjE3B,MAAMgB,IAAI,IAAI9F,uBAAuBsD,MAAM;YAAEP,OAAOsB,QAAQtB,KAAK;YAAEyB,QAAQH,QAAQG,MAAM;YAAEjB,KAAKc,QAAQd,GAAG;QAAC;IAC9G;IACA,MAAMU,OAAOX,KAAKW,IAAI;IACtB,IAAIA,MAAM;;YACKI;QAAb,MAAMzB,iBAAOyB,mBAAAA,QAAQd,GAAG,CAACK,GAAG,CAACK,KAAKJ,EAAE,sBAAvBQ,iBAA0BzB,IAAI,oBAAIqB,KAAKJ,EAAE;QACtDiB,MAAMgB,IAAI,CAAC,CAAC,UAAU,EAAElD,KAAK,EAAE,EAAEqB,KAAK8B,IAAI,CAAC,CAAC,EAAE9B,KAAK+B,GAAG,GAAG,CAAC,EAAE,EAAE/B,KAAK+B,GAAG,EAAE,GAAG,KAAK;QAChF,sEAAsE;QACtEhB,SAASE,MAAM,GAAG7C,qBAAqBqE,QAAQ,CAACrC,QAAQX,IAAI,IACxD;YAAC;gBAAEA,MAAMW,QAAQX,IAAI;gBAA2BqC,MAAM9B,KAAK8B,IAAI;gBAAEC,KAAK/B,KAAK+B,GAAG;gBAAEH,aAAa;gBAAMc,QAAQ,EAAE;eAAM1C,KAAKD,EAAE,GAAG;gBAAEA,IAAIC,KAAKD,EAAE;YAAC,IAAI,CAAC;SAAK,GACrJ,EAAE;IACR;IACAc,MAAMgB,IAAI,KAAKzB,sBAAAA,QAAQuC,UAAU,YAAlBvC,sBAAsB,EAAE;IACvC,MAAMwC,SAAkC,aACnC9C,IAAI8C,MAAM,UACT5C,wBAAAA,KAAM6C,IAAI,mBAAI,CAAC;QACnBC,aAAa3F,cAAc2C;;IAE7B,OAAO8C,MAAM,CAACtH,uBAAuB;IACrC,sEAAsE;IACtE,6EAA6E;IAC7E,IAAI8E,QAAQX,IAAI,KAAK,UAAUW,QAAQX,IAAI,KAAK,UAAU;QACxDmD,MAAM,CAAC7E,yBAAyB,GAAG;QACnC,MAAMgF,QAAQlF,wBAAwBwC,KAAKa,OAAO;QAClD,IAAI6B,MAAMC,MAAM,EAAEJ,MAAM,CAAChF,2BAA2B,GAAGmF;QACvD,MAAME,WAAWjF,uBAAuBqC;QACxC,IAAI4C,UAAUL,MAAM,CAAC9E,0BAA0B,GAAGmF;IACpD;IACA,OAAO,aACFnD;QACHG,KAAKJ,iBAAiBC,KAAKT;QAC3BI,MAAMW,QAAQX,IAAI;QAClByD,OAAO,EAAE;QACT1C,SAAS,EAAE;QACXW,OAAO;QACPd,MAAML,QAAQ,CAAC5B,qBAAqBqE,QAAQ,CAACrC,QAAQX,IAAI,IAAI,OAAOsB;QACpE6B;QACA/B,OAAOA,MAAMsC,IAAI,CAAC,MAAMC,KAAK,CAAC,GAAGnF;;AAErC;AAEA,+EAA+E,GAC/E,SAASoF,OACPnD,IAAY,EACZoD,OAAyB,EACzBC,QAAmC,CAAC,CAAC;IAErC,OAAO;QAAErD;QAAMsD,QAAQ;QAAUF;OAAYC;AAC/C;AAmBA,uDAAuD,GACvD,OAAO,SAASE,iBAAiBC,GAA8B;IAC7D,OAAOC,QAAQD,QAAQvI,qBAAqBuI,SAAkB;AAChE;AAEA,+CAA+C,GAC/C,eAAeE,SAASC,SAAsC,EAAEC,MAAqB;QAE3E;IADR,IAAI,CAACA,QAAQ,OAAO;IACpB,QAAQ,QAAA,AAAC,CAAA,MAAMD,UAAUE,UAAU,CAAC,SAASC,GAAG,CAACF,QAAQnE,GAAG,EAAC,EAAGsE,IAAI,cAA5D,QAAkE;AAC5E;AAEA,OAAO,SAASC,qBAAqBC,OAA2B,CAAC,CAAC;QAC9CA,iBACAA,iBACHA,cACMA,oBACGA,uBACNA,iBACFA;IANhB,MAAMC,aAAYD,kBAAAA,KAAKC,SAAS,YAAdD,kBAAkB7F;IACpC,MAAM+F,aAAYF,kBAAAA,KAAKE,SAAS,YAAdF,kBAAkB1G;IACpC,MAAM6G,UAASH,eAAAA,KAAKG,MAAM,YAAXH,eAAgB,CAAC/D,UAAYpD,WAAWoD;IACvD,MAAMmE,gBAAeJ,qBAAAA,KAAKI,YAAY,YAAjBJ,qBAAqBlH;IAC1C,MAAMuH,mBAAkBL,wBAAAA,KAAKK,eAAe,YAApBL,wBAAwB3G;IAChD,MAAMiH,aAAYN,kBAAAA,KAAKM,SAAS,YAAdN,kBAAkB/G;IACpC,MAAMsH,WAAUP,gBAAAA,KAAKO,OAAO,YAAZP,gBAAgBhG;IAEhC,OAAO,OAAOiC;kBAKCA,cAEGtE,eAMuBgE,aAG7BA;YARQA,YAuID6E;QA9IjB,MAAM,EAAE7E,GAAG,EAAE+D,SAAS,EAAE,GAAGzD;QAC3B,MAAMwE,gBAAQxE,QAAQyE,QAAQ,oBAAhBzE,QAAQyE,QAAQ,MAAhBzE,SAAmB,8BAAe/D,eAAe;QAC/D,MAAMgE,OAAOhD,gBAAgByC;QAC7B,IAAI,CAACO,MAAM,OAAO,aAAK/C,iBAAiBsH;YAAQtB,SAAS7E;;QACzD,MAAMiF,OAAOtD,eAAAA,QAAQsD,GAAG,YAAXtD,eAAe;QAC5B,MAAMtB,QAAQ7C,aAAaoE;QAC3B,MAAMyE,WAAUhJ,gBAAAA,aAAagD,kBAAbhD,gBAAuBgD;QACvC,MAAMiG,WAAW,GAACjF,aAAAA,IAAIqB,KAAK,qBAATrB,WAAWkD,MAAM;QACnC,MAAMzC,SAASwE,WAAWrJ,qBAAqBoD,SAAUgB,IAAIqB,KAAK;QAClE,MAAM6D,OAAOD,WAAW;YAAE5D,OAAOZ;QAAO,IAAI,CAAC;QAC7C,MAAMlB,OAAOxD,gBAAgBiJ,SAASvE;QACtC,MAAMoE,OAAO,IAAIM,IAAI1E,OAAO8B,GAAG,CAAC,CAAC6C,MAAQ;gBAACA,IAAIhF,IAAI;gBAAEgF;aAAI;QACxD,MAAMC,OAAO,MAAMvB,SAASC,YAAW/D,cAAAA,IAAIgE,MAAM,YAAVhE,cAAc;QACrD,MAAMR,MAAM,MAAMgF,OAAO;YACvBc,OAAOtF,IAAIsF,KAAK;YAChBtB,MAAM,GAAEhE,eAAAA,IAAIgE,MAAM,YAAVhE,eAAc;YACtB4D;YACAyB;YACAE,WAAW5B,iBAAiBC;QAC9B;QAEA,0DAA0D,GAC1D,MAAM4B,aAAa,CAACpF,OAClB4E,QAAQS,IAAI,CAAC,CAACC;oBAA6Cb;uBAArCa,IAAItF,IAAI,KAAKA,QAAQtE,iBAAgB+I,YAAAA,KAAKhF,GAAG,CAAC6F,IAAItF,IAAI,aAAjByE,YAAsB;oBAAEnB,QAAQ;gBAAU;;QAEvG,iFAAiF,GACjF,MAAMiC,SAAS,OAAOC,SAA2BC,aAAqC,EAAE;gBAQhF7F;YAPN,IAAI,CAAC5B,oBAAoB4B,QAAQA,IAAI8F,WAAW,IAAI,CAAC9F,IAAIgE,MAAM,EAAE,OAAO4B;YACxE,MAAMG,UAAU,IAAIxE,IAClBvC,MACG4C,MAAM,CAAC,CAAC8D;oBAA2Cb;uBAAnCa,IAAIjG,MAAM,IAAI5D,sBAAqBgJ,YAAAA,KAAKhF,GAAG,CAAC6F,IAAItF,IAAI,aAAjByE,YAAsB;oBAAEnB,QAAQ;gBAAU;eAC7FlC,OAAO,CAAC,CAACkE;;oBAAQb;gCAAAA,YAAAA,KAAKhF,GAAG,CAAC6F,IAAItF,IAAI,sBAAjByE,UAAoBnE,OAAO,mBAAI,EAAE;;YAEvD,MAAMuC,QAAQ;mBACT,EAACjD,eAAAA,IAAIU,OAAO,YAAXV,eAAe,EAAE,EAAE4B,MAAM,CAAC,CAACoE,SAAWA,OAAOC,QAAQ,KAAK,YAAYF,QAAQlE,GAAG,CAACmE,OAAO/F,EAAE;mBAC5F4F;aACJ;YACD,IAAI,CAAC5C,MAAMC,MAAM,EAAE,OAAO0C;YAC1B,MAAME,cAAc,MAAMlB,QAAQb,WAAW;gBAAE/D;gBAAKU,SAASuC;gBAAOiD,KAAK5F,QAAQ4F,GAAG;YAAC,GAAGC,KAAK,CAAC,CAACC;gBAC7FC,QAAQD,KAAK,CAAC,0BAA0B;oBAAEd,OAAOtF,IAAIsF,KAAK;oBAAEgB,OAAOtG,IAAIG,GAAG;oBAAEiG;gBAAM;gBAClF,OAAO;YACT;YACA,OAAON,cAAc,aAAKF;gBAASE;iBAAgBF;QACrD;QAEA,IAAI,CAACrG,MAAM,OAAOoG,OAAO,aAAKnI,iBAAiBsH,QAAWI;QAE1D,MAAMqB,SAAS,CAACrG,MAAwBsG,QAA0BhJ,iBAAiBsH,MAAM,GAAwB,aAC5G0B,OACAtB;gBACHhF;eACIA,KAAKwD,MAAM,KAAK,aAAa8B,WAAWjG,KAAKa,IAAI,IAAI;gBAAEqG,UAAU;YAAK,IAAI,CAAC;QAGjF,iCAAiC;QACjC,MAAMC,cAAc/K,mBAAmB4D,MAAM;YAAEP;YAAOyB;YAAQjB;QAAI;QAClE,IAAIkH,YAAYC,IAAI,EAAE;YACpB,OAAOJ,OAAO;gBAAEnG,MAAMb,KAAKa,IAAI;gBAAEsD,QAAQ;gBAAWkD,MAAMF,YAAYC,IAAI;gBAAEE,YAAYH,YAAYG,UAAU;YAAC;QACjH;QACA,MAAMC,aAAatH,IAAIK,GAAG,CAACN,KAAKO,EAAE;QAClC,MAAMjB,gBAAOiI,8BAAAA,WAAYjI,IAAI,oBAAIU,KAAKO,EAAE;QACxC,IAAI,CAACgH,YAAY,OAAOP,OAAO;YAAEnG,MAAMb,KAAKa,IAAI;YAAEsD,QAAQ;YAAWkD,MAAMhI,uBAAuBC;QAAM;QACxG,MAAMkI,WAAWL,YAAYG,UAAU,CAAC3D,MAAM,GAAG;QACjD,MAAM0D,OAAOF,YAAYM,KAAK,CAAC9D,MAAM,GAAGwD,YAAYM,KAAK,CAAC3D,IAAI,CAAC,OAAO;QAEtE,kFAAkF;QAClF,IAAIyD,WAAWG,aAAa,EAAE;;YAC5B,MAAM/G,OAAOX,KAAKW,IAAI;YACtB,MAAMgH,SAAS3C,UAAUuC,WAAWG,aAAa;YACjD,IAAI,CAAC/G,QAAQ,CAACgH,UAAU,CAAClH,IAAIgE,MAAM,EAAE;gBACnC,OAAOuC,OAAO;oBAAEnG,MAAMb,KAAKa,IAAI;oBAAEsD,QAAQ;oBAAWkD,MAAMhI,uBAAuBC;gBAAM;YACzF;YACA,MAAMsI,YAAmC;gBACvCpD;gBACAuB,OAAOtF,IAAIsF,KAAK;gBAChBtB,QAAQhE,IAAIgE,MAAM;gBAClBlB,QAAQ,CAAC;gBACTc;gBACAwD,KAAKpH,IAAIqH,SAAS;YACpB;YACA,MAAMC,UAAU,MAAM5C,gBAAgByC,WAAW;gBAC/CxH,MAAM;gBACN4H,QAAQ;oBAAC;wBAAEtB,UAAUa,WAAWG,aAAa;wBAAEnG,OAAOgG,WAAWjI,IAAI;oBAAC;iBAAE;gBACxE0F;YACF;YACA,IAAI+C,SAAS,OAAOf,OAAO;gBAAEnG,MAAMb,KAAKa,IAAI;gBAAEsD,QAAQ;gBAAWkD,MAAM,CAAC,WAAW,EAAEU,QAAQlB,KAAK,EAAE;YAAC;YACrG,MAAMoB,eAA2D,CAAC;YAClE,KAAK,MAAMpH,QAAQb,KAAK8E,IAAI,CAAE;gBAC5B,MAAMoD,MAAMzI,MAAM0I,IAAI,CAAC,CAAChC,MAAQA,IAAItF,IAAI,KAAKA;gBAC7C,MAAMgF,MAAMP,KAAKhF,GAAG,CAACO;gBACrB,IAAI,CAACqH,OAAO,CAACrC,OAAO,CAACvJ,qBAAqBuJ,QAAQ,CAACA,IAAI1E,OAAO,CAACwC,MAAM,EAAE;gBACvEsE,YAAY,CAAC,CAAC,IAAI,EAAEC,IAAI3G,KAAK,EAAE,CAAC,GAAG;oBAAEhB,IAAI2H,IAAI3H,EAAE;oBAAEG,IAAImF,IAAI1E,OAAO,CAAC,EAAE;gBAAC;YACtE;YACA,MAAMiH,mBAAUb,WAAWc,YAAY,oBAAvBd,WAAWc,YAAY,MAAvBd,YAA0B;gBAAE9E,MAAM9B,KAAK8B,IAAI;gBAAEe,MAAM7C,KAAK6C,IAAI;YAAC,GAAG;gBAAEiB,QAAQhE,IAAIgE,MAAM;gBAAEwD;YAAa,sBAAMtH,KAAK6C,IAAI;YAClI,MAAM8E,UAAUX,OAAOY,KAAK,CAACH,SAAS;gBAAE3D,QAAQhE,IAAIgE,MAAM;YAAC;YAC3D,IAAI6D,QAAQE,EAAE,KAAK,OAAO;oBAE2CF;gBADnE,OAAOtB,OACLhD,OAAOhE,KAAKa,IAAI,EAAE;oBAAE4H,MAAM;oBAAMC,QAAQ;oBAAgBC,OAAO,GAAEL,qBAAAA,QAAQM,QAAQ,CAAC,EAAE,YAAnBN,qBAAuBrL;gBAAyB;YAErH;YACA,MAAMyD,KAAKF,iBAAiBC,KAAKT;YACjC,MAAM6I,UAAU,MAAMlB,OAAOmB,KAAK,CAAC;gBACjC/C,OAAOtF,IAAIsF,KAAK;gBAChBtB,QAAQhE,IAAIgE,MAAM;gBAClBoD,KAAKpH,IAAIqH,SAAS;gBAClBzD;gBACAsC,KAAK5F,QAAQ4F,GAAG;gBAChBjG;gBACA+B,MAAM9B,KAAK8B,IAAI;gBACf2F;YACF;YACA,IAAIS,QAAQL,EAAE,KAAK,OAAO;gBACxB,OAAOxB,OAAOhD,OAAOhE,KAAKa,IAAI,EAAE;oBAAE4H,MAAM;oBAAOC,QAAQ;oBAAUC,SAASE,QAAQhC,KAAK;gBAAC;YAC1F;YACA,MAAMJ,SAAsB;gBAC1BC,UAAU;gBACVhG,IAAImI,QAAQnI,EAAE;gBACdqI,WAAWF,QAAQE,SAAS;gBAC5BtE,QAAQhE,IAAIgE,MAAM;gBAClBlD,OAAOsH,QAAQpG,IAAI;gBACnBiF,eAAeH,WAAWG,aAAa;gBACvCL,MAAM,CAAC,YAAY,EAAEE,WAAWyB,KAAK,CAAC,CAAC,CAAC;YAC1C;YACA,OAAOhC,OACL;gBACEnG,MAAMb,KAAKa,IAAI;gBACfsD,QAAQqD,WAAW,aAAa;gBAChCrG,SAAS;oBAAC0H,QAAQnI,EAAE;iBAAC;gBACrB2G;eACIG,WAAW;gBAAEF,YAAYH,YAAYG,UAAU;YAAC,IAAI,CAAC,IAE3D,aAAKrJ,iBAAiBsH;gBAAQpE,SAAS;oBAACsF;iBAAO;;QAEnD;QAEA,8DAA8D;QAC9D,MAAMrG,OAAOL,mBAAmBC,MAAMC;QACtC,MAAMgJ,SAAS7I,OAAO2E,UAAU3E,QAAQ;QACxC,IAAI,CAACA,QAAQ,CAAC6I,QAAQ,OAAOjC,OAAO;YAAEnG,MAAMb,KAAKa,IAAI;YAAEsD,QAAQ;YAAWkD,MAAMhI,uBAAuBC;QAAM;QAC7G,MAAM4J,UAAUpI,eAAeL,KAAKT,MAAM;YAAEI;YAAMX;YAAOyB;YAAQjB;YAAKqD,YAAY6D,YAAY7D,UAAU;QAAC;QACzG,sEAAsE;QACtE,sDAAsD;QACtD,IAAItD,KAAKW,IAAI,IAAI2E,EAAAA,YAAAA,KAAKhF,GAAG,CAACN,KAAKa,IAAI,sBAAlByE,UAAqBnB,MAAM,MAAK,WAAW;gBAIhD1D;YAHV,MAAMsH,UAAU,MAAM7C,aAAa9E,MAAM;gBACvCoE;gBACAuB,OAAOtF,IAAIsF,KAAK;gBAChBtB,MAAM,GAAEhE,eAAAA,IAAIgE,MAAM,YAAVhE,eAAc;gBACtB8C,QAAQ2F,QAAQ3F,MAAM;gBACtBc;gBACAwD,KAAKpH,IAAIqH,SAAS;YACpB,GAAGlB,KAAK,CAAC,CAACC;gBACRC,QAAQD,KAAK,CAAC,kCAAkC;oBAAEd,OAAOtF,IAAIsF,KAAK;oBAAEgB,OAAOtG,IAAIG,GAAG;oBAAEC,MAAMb,KAAKa,IAAI;oBAAEgG;gBAAM;gBAC3G,OAAO;oBAAE1C,QAAQ;oBAAc0C,OAAO5J;gBAAyB;YACjE;YACA,IAAI8K,SAAS,OAAOf,OAAO;gBAAEnG,MAAMb,KAAKa,IAAI;gBAAEsD,QAAQ;gBAAWkD,MAAM,CAAC,WAAW,EAAEU,QAAQlB,KAAK,EAAE;YAAC;QACvG;QAEA,IAAIR;QACJ,IAAI;YACFA,UAAU,MAAM4C,OAAO,aAAKlI;gBAASN,KAAKyI;;QAC5C,EAAE,OAAOrC,OAAO;YACd,wEAAwE;YACxE,sDAAsD;YACtD,IAAI1J,qBAAqB0J,QAAQ,MAAMA;YACvCC,QAAQD,KAAK,CAAC,uBAAuB;gBAAEd,OAAOtF,IAAIsF,KAAK;gBAAEgB,OAAOtG,IAAIG,GAAG;gBAAEC,MAAMb,KAAKa,IAAI;gBAAEgG;YAAM;YAChG,OAAOG,OAAOhD,OAAOhE,KAAKa,IAAI,EAAE;gBAAE4H,MAAM;gBAAMC,QAAQ;gBAAYC,SAAS1L;YAAyB;QACtG;QACA,MAAMgK,QAAQ5J,YAAYgJ;QAC1B,MAAM8C,MAAM9C,QAAQlF,OAAO,CAAC6B,GAAG,CAAC,CAACyD,SAAWA,OAAO/F,EAAE;QACrD,MAAM0I,UAAUhM,cAAc4C,KAAKa,IAAI,EAAEwF;QACzC,IAAI+C,SAAS,OAAOpC,OAAOoC,SAASnC;QACpC,6EAA6E;QAC7E,IAAIjH,KAAKE,MAAM,IAAIO,IAAIgE,MAAM,EAAE;YAC7B,MAAM4E,OAAOhD,QAAQlF,OAAO,CAACgH,IAAI,CAAC,CAAC1B,SAAWA,OAAOC,QAAQ,KAAK;YAClE,MAAMmC,UACJQ,SAASC,aACR,MAAMjL,kBACLmG,WACA;gBAAEC,QAAQhE,IAAIgE,MAAM;gBAAE8E,WAAWL,QAAQtI,GAAG;gBAAEV,QAAQF,KAAKE,MAAM;gBAAEsJ,SAASH,KAAK3I,EAAE;YAAC,GACpF0E;YAEJ,IAAI,CAACyD,SAAS;gBACZ,OAAO7B,OACLhD,OAAOhE,KAAKa,IAAI,EAAE;oBAAE4H,MAAM;oBAAMC,QAAQ;oBAAgBC,SAASpJ;gBAA+B,IAChG,aAAK0H;oBAAO9F,SAASkF,QAAQlF,OAAO,CAACkB,MAAM,CAAC,CAACoE,SAAWA,OAAOC,QAAQ,KAAK;;YAEhF;QACF;QACA,MAAM+C,OAAOzC,OACX;YACEnG,MAAMb,KAAKa,IAAI;YACfsD,QAAQqD,WAAW,aAAa;YAChCrG,SAASgI;YACT9B;WACIG,WAAW;YAAEF,YAAYH,YAAYG,UAAU;QAAC,IAAI,CAAC,IAE3DL;QAEF,IAAIwC,KAAKvC,QAAQ,EAAE,OAAOuC;QAC1B,4EAA4E;QAC5EnE,KAAKoE,GAAG,CAAC1J,KAAKa,IAAI,EAAE,aAAMyE,KAAKhF,GAAG,CAACN,KAAKa,IAAI;YAAuBsD,QAAQqD,WAAW,aAAa;YAAarG,SAASgI;;QACzH,OAAO/C,OAAOqD,MAAMzJ,KAAKE,MAAM,GAAGmG,QAAQlF,OAAO,CAACkB,MAAM,CAAC,CAACoE,SAAWA,OAAOC,QAAQ,KAAK,YAAY,EAAE;IACzG;AACF;AAEA,OAAO,MAAMiD,oBAAoB9E,uBAAsB;AAEvD;;;;CAIC,GACD,OAAO,SAAS+E,uBAAuBnJ,GAAU;QAI/BhE,eAOTiD,wCACAmK;QAPQpJ;IAJf,MAAMO,OAAOhD,gBAAgByC;IAC7B,IAAI,CAACO,MAAM,OAAO9C;IAClB,MAAMuB,QAAQ7C,aAAaoE;IAC3B,MAAMyE,WAAUhJ,gBAAAA,aAAagD,kBAAbhD,gBAAuBgD;IACvC,MAAMyB,SAAST,EAAAA,aAAAA,IAAIqB,KAAK,qBAATrB,WAAWkD,MAAM,IAAGlD,IAAIqB,KAAK,GAAGzF,qBAAqBoD;IACpE,MAAMO,OAAOxD,gBAAgBiJ,SAASvE;IACtC,IAAI,CAAClB,MAAM,OAAO9B;IAClB,MAAMkC,OAAyBJ,KAAKE,MAAM,GACtC,SACAF,KAAKG,QAAQ,IACVT,yCAAAA,kBAAkB,CAACM,KAAKG,QAAQ,CAACC,IAAI,CAAC,YAAtCV,yCAA0C,QAC1CmK,sCAAAA,0BAA0B,CAAC7J,KAAKO,EAAE,CAAC,YAAnCsJ,sCAAuC;IAC9C,IAAI,CAACzJ,MAAM,OAAOlC;IAClB,OAAOc,sBAAsB8B,eAAeL,KAAKT,MAAM;QAAEI;QAAMX;QAAOyB;QAAQjB,KAAK,IAAI2F;IAAM;AAC/F;AAEA,4GAA4G,GAC5G,MAAMiE,6BAAkE;IACtEhH,UAAU;IACViH,UAAU;IACVC,UAAU;IACVC,UAAU;IACVC,MAAM;AACR;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,0BAA0BC,KAK/C;IACC,MAAMC,UAAU1M,kBAAkByM,MAAM9F,GAAG;IAC3C,IAAI,EAAC+F,2BAAAA,QAASC,UAAU,GAAE,OAAO;IACjC,IAAI;QACF,MAAMC,QAAQH,MAAMxD,GAAG,CAAC4D,WAAW,GAAGxG,KAAK,CAAC,GAAG;QAC/C,MAAMyG,WAAW,MAAM/M,oBAAoB0M,MAAM3F,SAAS,EAAE4F,QAAQC,UAAU,EAAEC,OAAOhK,GAAG;QAC1F,MAAM2G,QAAQ3J,qBACZE,2BAA2BgN,SAASlK,GAAG,CAAC,eAAekK,SAASlK,GAAG,CAAC/C;QAEtE,MAAMkN,OAAOC,KAAKC,GAAG,CAAC,GAAG5N,kCAAkCkK;QAC3D,OAAOkD,MAAMS,QAAQ,GAAGH,OACpB,CAAC,0BAA0B,EAAEN,MAAMS,QAAQ,CAAC,wCAAwC,EAAEH,KAAK,oDAAoD,CAAC,GAChJ;IACN,EAAE,OAAO5D,OAAO;QACdC,QAAQD,KAAK,CAAC,qCAAqC;YAAEA;QAAM;QAC3D,OAAO;IACT;AACF;AASA;;;;;CAKC,GACD,OAAO,SAASgE,0BAA0B/F,OAA6B,CAAC,CAAC;QACxDA,cACYA,0BACXA;IAFhB,MAAMG,UAASH,eAAAA,KAAKG,MAAM,YAAXH,eAAgB,CAAC/D,UAAYpD,WAAWoD;IACvD,MAAM+J,sBAAqBhG,2BAAAA,KAAKgG,kBAAkB,YAAvBhG,2BAA2BoF;IACtD,MAAMa,WAAUjG,gBAAAA,KAAKiG,OAAO,YAAZjG,gBAAgB/I;IAChC,OAAO,OAAOgF;QACZ,IAAI,CAACA,QAAQ0D,MAAM,EAAE,OAAO;YAAEN,QAAQ;YAAK0C,OAAO;QAA0D;QAC5G,MAAMmE,QAAQ,MAAMD,QAAQhK,QAAQ0D,MAAM;QAC1C,IAAI,CAACuG,SAASA,UAAUjK,QAAQgF,KAAK,EAAE,OAAO;YAAE5B,QAAQ;YAAK0C,OAAO;QAAe;QACnF,IAAI,CAAC5H,mBAAmB,SAAS,OAAO;YAAEkF,QAAQ;YAAK0C,OAAO;QAAgD;QAC9G,MAAM7F,OAAOD,QAAQC,IAAI;QACzB,IAAI,CAACA,MAAM,OAAO;QAClB,MAAMqD,MAAMtD,QAAQsD,GAAG;QACvB,MAAM2B,YAAY5B,iBAAiBC;QACnC,MAAMyB,OAAO,MAAMvB,SAASxD,QAAQyD,SAAS,EAAEzD,QAAQ0D,MAAM;QAC7D,MAAMxE,MAAM,MAAMgF,OAAO;YAAEc,OAAOhF,QAAQgF,KAAK;YAAEtB,QAAQ1D,QAAQ0D,MAAM;YAAEJ;YAAKyB;YAAME;QAAU;QAC9F,MAAMiF,QAAQtO,wBAAwBqE,MAAM;YAAEgF;YAAW/F;QAAI;QAC7D,IAAIgL,OAAO,OAAO;YAAE9G,QAAQ;YAAK0C,OAAOoE;QAAM;QAC9C,IAAIjF,WAAW;;YACb,MAAM+B,UAAU,MAAM+C,mBAAmB;gBACvCtG,WAAWzD,QAAQyD,SAAS;gBAC5BH;gBACAuG,UAAUzO,sBAAsB6E,MAAM;oBAAEf;gBAAI;gBAC5C0G,GAAG,UAAE7B,KAAK6B,GAAG,oBAAR7B,KAAK6B,GAAG,MAAR7B,wBAAgB,IAAIoG;YAC3B;YACA,IAAInD,SAAS,OAAO;gBAAE5D,QAAQ;gBAAK0C,OAAOkB;YAAQ;QACpD;QACA,OAAO;IACT;AACF;AAEA,OAAO,MAAMoD,sBAAsBN,4BAA2B;AAE9D;;;CAGC,GACD,OAAO,SAASO;IACdlM,kBAAkB,SAASyK,mBAAmB;QAC5C0B,WAAWnN;QACXoN,cAAc1B;IAChB;IACAzK,wBAAwB,SAASK;IACjC3B,uBAAuB,SAASsN;AAClC"}

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

@@ -0,0 +1,225 @@
+/**
+ * @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 { SCREEN_SEO_TEXT_FIELDS } from '@aglyn/aglyn/app-utils/screen-seo-fields';
+import { CanvasManager } from '@aglyn/aglyn/canvas-manager/canvas-manager';
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations';
+import { type AiEditJobInputs, type AiEditPlacement, type AiEditTargetKind } from '../model/ai-edit-job';
+import type { AiJob, AiJobOutput } from '../model/ai-jobs.types';
+import { type AssistEditCanvasContext, type AssistEditOp, type AssistEditProposal, type AssistEditTarget } from '../model/assist-edit';
+import { type AiCustomGenerationInput } from '../runtime/ai-doctrine';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The `edit` step (AGL-3616): a change to a page or a layout the site already
+ * has, from a description, made on the server with no editor open.
+ *
+ * It is the Assist edit rung, run as a job. The model is shown the stored
+ * document as the rung's outline and proposes through the rung's own tool;
+ * its answer is held to the rung's closed world and palette validators
+ * (`checkAssistEditAnswer`) and re-asked once, naming what was left out; and
+ * what survives lands through the canvas's own guarded mutators
+ * (`applyAssistEdit`), on a `CanvasManager` built headless from the stored
+ * nodes, inside the transaction that writes it.
+ *
+ * ── Where the change lands, decided before anything is spent ────────────
+ *
+ * Never on a version a visitor sees. With version history, a NEW version
+ * beside the one it started from — a copy of that version's stored fields with
+ * the changed nodes — which becomes the page's current version only when the
+ * page is not published; a published page's current version, and a layout's,
+ * never move. Without it, in place, on a version no visitor reaches: an
+ * unpublished page's, or one that is not the current version and no schedule
+ * will publish. Anything else is refused as a plan limit, charged nothing.
+ *
+ * ── What a job cannot do that the editor can ────────────────────────────
+ *
+ * The rung's chat door never offers saving part of a page as a reusable
+ * component, and neither does this. A page's search title and description
+ * live on the page itself, not on a version, so they are written only for a
+ * page that is not published; on a published page they are left out, and the
+ * output's note says so, as it says every change it left out.
+ *
+ * ── One version per job ──────────────────────────────────────────────────
+ *
+ * The new version is named by the job's id — a build's unit is named by its
+ * plan item's id — so a run asked again finds what it wrote and spends
+ * nothing. A change made in place stamps the version with the job's id for
+ * the same reason.
+ */
+/** The longest the step may take reading the page and writing it. */
+export declare const AI_EDIT_READS_MS = 2000;
+/** The step's time: its answer and its re-ask at the `job.edit` ceiling, with its own reads. */
+export declare const AI_JOB_EDIT_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+export declare const AI_JOB_EDIT_STEP_MINIMUM_MS: number;
+export declare function aiJobEditModel(): string;
+/**
+ * The job's own rules, byte-identical on every request, ahead of the rung's
+ * protocol and catalog for the document's kind, which carries the breakpoint:
+ * both are the same for every site, so a kind's whole prefix caches once.
+ */
+export declare const AI_JOB_EDIT_RULES: AiSystemBlock;
+/** The system blocks for one kind of document. */
+export declare function aiJobEditInstructions(kind: AiEditTargetKind): AiSystemBlock[];
+/** What the change is asked from: the document's outline, then the request. */
+export declare function aiJobEditPrompt(input: {
+    brief: string;
+    context: AssistEditCanvasContext;
+}): string;
+/** The edit as the doctrine's loop runs it: the rung's tool, held to the rung's check. */
+export declare function aiJobEditGeneration(request: {
+    brief: string;
+    context: AssistEditCanvasContext;
+    target: AssistEditTarget;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AssistEditProposal>;
+/** A canvas over a stored node map, with the editor's own guarded mutators and no editor. */
+export declare function aiEditCanvas(nodes: NodesMap): CanvasManager;
+/**
+ * Lands a proposal on a stored node map, as the editor lands one on its open
+ * canvas: checked whole first, then one batch, all or nothing. The session is
+ * the version being written, which is never one a visitor sees; a page's
+ * search fields are captured into `seo` only where `seo` is given.
+ */
+export declare function aiApplyEditToNodes(nodes: NodesMap, proposal: AssistEditProposal, seo?: Partial<Record<(typeof SCREEN_SEO_TEXT_FIELDS)[number], string>>): {
+    ok: true;
+    nodes: NodesMap;
+} | {
+    ok: false;
+    reason: string;
+};
+type Firestore = FirebaseFirestore.Firestore;
+/** The page or layout an edit job changes, as it stands before anything is spent. */
+export interface AiEditTargetRead {
+    kind: AiEditTargetKind;
+    id: string;
+    name: string;
+    hostSubdomain: string | null;
+    /** The document's current version. */
+    pointerVersionId: string | null;
+    /** The version the change starts from. */
+    sourceVersionId: string;
+    nodes: NodesMap;
+    /** Whether visitors see the document's current version: a published page, a collection template, any layout. */
+    served: boolean;
+    /** The version a pending publish schedule will make current, if any. */
+    scheduledVersionId: string | null;
+    /** What this job already wrote, when a run of it got that far. */
+    written: {
+        versionId: string;
+        placement: AiEditPlacement;
+    } | null;
+}
+export interface AiEditTargetRefusal {
+    status: 400 | 404;
+    error: string;
+}
+/**
+ * The document an edit job changes, on the job's own site: the page or
+ * layout named, not deleted, not an email design, and the version it starts
+ * from with a document in it. A refusal names what is wrong.
+ */
+export declare function readAiEditTarget(firestore: Firestore, input: {
+    orgId: string;
+    hostId: string;
+    inputs: AiEditJobInputs;
+    /** The job's own version id, to find what a run of it wrote; `null` at the door, before there is one. */
+    jobId: string | null;
+}): Promise<AiEditTargetRead | AiEditTargetRefusal>;
+/**
+ * Where a change may land (see the module head), or `refused` when the only
+ * place is a version visitors see and the plan keeps no version history.
+ */
+export declare function aiEditPlacement(input: {
+    versioning: boolean;
+    served: boolean;
+    sourceIsPointer: boolean;
+    sourceScheduled: boolean;
+}): AiEditPlacement | 'refused';
+export interface AiEditWriteInput {
+    hostId: string;
+    kind: AiEditTargetKind;
+    id: string;
+    sourceVersionId: string;
+    /** The new version's id, which is the job's; also the stamp a change in place carries. */
+    jobVersionId: string;
+    versioning: boolean;
+    proposal: AssistEditProposal;
+    /** Whether the page's search fields may be written: a page no visitor reaches. */
+    writeSeo: boolean;
+    versionName: string;
+    uid: string;
+    /** The job the member started, stamped as `aiJobId` on a new version. */
+    aiJobId: string;
+    now: Date;
+}
+export type AiEditWrite = {
+    ok: true;
+    versionId: string;
+    placement: AiEditPlacement;
+    seoWritten: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The change written, in one transaction that reads the document as it is
+ * stored NOW — a member may have saved, published or changed plan's history
+ * since the read — decides where it lands again on that, and applies the
+ * proposal to the stored nodes through the canvas's guards. An element that
+ * changed since the model saw it refuses the whole change, as the editor does.
+ */
+export declare function writeAiEdit(firestore: Firestore, input: AiEditWriteInput): Promise<AiEditWrite>;
+export interface AiJobEditStepDeps {
+    readTarget?: typeof readAiEditTarget;
+    writeEdit?: typeof writeAiEdit;
+}
+/** What an edit wrote, as the job's output: a link into the Besigner on the version written. */
+export declare function aiEditOutput(read: Pick<AiEditTargetRead, 'kind' | 'id' | 'name' | 'hostSubdomain'>, hostId: string, written: {
+    versionId: string;
+    placement: AiEditPlacement;
+}, leftOut: readonly string[]): AiJobOutput;
+/** The new version's id: the job's own, which a build's unit takes from its plan item. */
+export declare function aiEditVersionId(job: Pick<AiJob, '$id'>): string;
+/**
+ * The ops a job may save, and why it left the rest out: never a component
+ * save, and a page's search fields only where no visitor reaches the page.
+ */
+export declare function aiEditJobOps(ops: readonly AssistEditOp[], options: {
+    seo: boolean;
+}): {
+    ops: AssistEditOp[];
+    leftOut: string[];
+};
+export declare function createAiJobEditStep(deps?: AiJobEditStepDeps): AiJobStepRunner;
+export declare const runAiJobEditStep: AiJobStepRunner;
+export interface AiEditJobAdmissionDeps {
+    readTarget?: typeof readAiEditTarget;
+    ownerOf?: typeof resolveOrgIdForHost;
+}
+/**
+ * An edit job is admitted for a page or layout of a site of its own org,
+ * and only where the change has somewhere to land that no visitor sees on
+ * this workspace's plan — refused in the plan's words before anything exists.
+ */
+export declare function createAiEditJobAdmission(deps?: AiEditJobAdmissionDeps): AiJobAdmission;
+export declare const aiEditJobAdmission: AiJobAdmission;
+/** Registers the edit step and the check an edit job passes before it is created or resumed. */
+export declare function registerAiEditJob(): void;
+export {};