@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-drafts.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 { createResourceUid } from '@aglyn/aglyn/app-utils/create-resource-uid'\nimport { uniqueDuplicateName } from '@aglyn/aglyn/app-utils/duplicate-resource'\nimport {\n  FORM_COMPONENT_ID,\n  normalizeFormSlug,\n  type FormFieldDecl,\n  type FormRouting,\n} from '@aglyn/aglyn/app-utils/forms'\nimport { nameSearchKey } from '@aglyn/aglyn/app-utils/name-search'\nimport {\n  checkDatasetQuota,\n  checkEntitlement,\n  checkQuota,\n  resolveEffectivePlan,\n  resolveOrgEntitlements,\n} from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  billableScreenIds,\n  normalizeScreenSlug,\n  reservedScreenRouteSegment,\n  SCREEN_ROOT_PATH,\n} from '@aglyn/aglyn/app-utils/screen-route'\nimport { decodeStoredNodes, encodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport type {\n  AglynOrgBilling,\n  OrgFeatureFlags,\n} from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport {\n  aiUnrestrictedPlanCapabilities,\n  type AiPlanCapabilities,\n  type AiPlanCreation,\n} from '../model/ai-plan-capabilities'\nimport type { AiJobAdmissionRefusal } from './ai-job-admission'\n\n/**\n * Where a generation job's layout, page template, form, reusable component\n * or page lands (AGL-2909, AGL-2913, AGL-2908, AGL-2907): a new draft, made\n * as the console's host resources route makes one.\n *\n * ── The document the create route makes ─────────────────────────────────\n *\n * `AI_DRAFT_FIELDS` is that route's allow-list for each kind, and a spec\n * reads the route's source to hold the two together. Nothing outside the\n * list is written except the route's own stamps: `createdAt`, `updatedAt`,\n * `createdBy`, a screen's `nameLower`, and a template's `source`, which is\n * `authored` — a template a member's job generated is theirs, never a starter\n * or a listing. A layout's or a screen's first version carries the keys the\n * versions route seeds one with. A form is the document the Forms page's\n * Create sends: its design canvas-shaped under `rootId` with the form node\n * bound to the form's id and captioned with its name, a slug read from that\n * name, and no version — the form's page mints the first one when someone\n * opens it. Where Create sends an empty `fields`, a generated form sends the\n * declaration read off its own design, so the two agree from the start. A\n * component carries its tree and the props it declares on its own document,\n * as Use template writes one, and gets its first version where every\n * component does: when a member opens it.\n *\n * ── Counted like a create ────────────────────────────────────────────────\n *\n * The band is met INSIDE the transaction that writes (AGL-2231), with the\n * route's arithmetic: every layout document counts against\n * `sharedLayoutsPerHost`; a template counts against `templatesPerHost` when it\n * records a source other than a platform starter — the route's `!=` query,\n * which never matches a document with no `source.type` at all; a screen counts\n * against `screensPerHost` by `billableScreenIds`, over the screens and the\n * host's routing map, which counts an unrouted screen too (AGL-1445); and a\n * form needs the plan to include the route's `entitlement` first, refused in\n * the route's own words, after which every form document counts against\n * `formsPerHost`. A reusable component counts against no allowance at all:\n * the route admits one on a plan with the `reusableComponents` entitlement\n * and refuses it otherwise, and so does the writer.\n *\n * ── Applied to nothing ───────────────────────────────────────────────────\n *\n * A layout renders only around a screen or layout that names it, or as the\n * built-in page layout the host document names; a template is inert until a\n * member uses it; a form renders only where a page places it; a component\n * renders only where an instance places it, and a new one has no instance;\n * and a screen serves nothing until the host's routing map names it, which is\n * what publishing writes (`publishScreenRoute`). So the writer touches the new\n * documents and nothing else — no host document, no routing map, no\n * collection, store setting, other layout or component — and never a\n * `publishedAt` or a publish schedule. What the job hands back is a link to\n * the draft, never a binding.\n *\n * ── One draft per recorded id ────────────────────────────────────────────\n *\n * The caller names the document id: the console resource id the job recorded\n * for the draft before its first write (`ai-job-draft-ids.ts`). A step run\n * again after its draft was written — a process cut off before the machine\n * recorded the step — reads the same id, finds that draft and reports it,\n * rather than writing a second.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\nexport type AiDraftKind = 'layout' | 'template' | 'form' | 'component' | 'screen'\n\n/** The draft kinds that keep their tree in versions, as the besigner opens them. */\nexport type AiVersionedDraftKind = Extract<AiDraftKind, 'layout' | 'screen'>\n\n/** The console host resources route's allow-list for each kind. */\nexport const AI_DRAFT_FIELDS: Readonly<Record<AiDraftKind, readonly string[]>> = {\n  layout: ['displayName', 'description', 'versionId'],\n  template: [\n    'kind',\n    'displayName',\n    'description',\n    'placeholders',\n    'nodes',\n    'rootId',\n    'props',\n    'slug',\n    'seo',\n  ],\n  form: [\n    'displayName',\n    'slug',\n    'fields',\n    'consentFieldName',\n    'routing',\n    'legacyMatch',\n    'rootId',\n    'nodes',\n  ],\n  component: ['displayName', 'description', 'rootId', 'nodes', 'props'],\n  // `kind` is on the route's list for the email composer; a page has none, and\n  // the writer never sends one.\n  screen: ['displayName', 'description', 'slug', 'seo', 'kind', 'versionId'],\n}\n\n/** The keys a layout's first version is seeded with, all on the versions route's list. */\nexport const AI_DRAFT_VERSION_FIELDS: readonly string[] = ['layoutId', 'hostId', 'displayName', 'nodes']\n\n/**\n * The keys a screen's first version is seeded with, all on the versions\n * route's list: the screen it belongs to, the site, the label, the tree, and\n * the layout it renders inside when the plan names one the site has.\n */\nexport const AI_DRAFT_SCREEN_VERSION_FIELDS: readonly string[] = [\n  'screenId',\n  'hostId',\n  'displayName',\n  'nodes',\n  'layoutId',\n]\n\n/** The label on a generated draft's first version, as on one Use template makes. */\nexport const AI_DRAFT_VERSION_NAME = 'Initial version'\n\n/** The route's refusal when the site's plan does not include the kind at all. */\nexport const AI_DRAFT_ENTITLEMENT_REFUSAL = 'This feature is not included in your plan — see Billing'\n\nexport interface AiDraftBand {\n  collection: 'layouts' | 'templates' | 'forms' | 'components' | 'screens'\n  /** The allowance the route counts the kind against, where it counts one. */\n  quotaKey?:\n    | 'sharedLayoutsPerHost'\n    | 'templatesPerHost'\n    | 'formsPerHost'\n    | 'screensPerHost'\n  /** The feature the plan must include before any document of the kind counts. */\n  entitlement?: keyof OrgFeatureFlags\n  /** The route's plural label, in the refusal it gives. */\n  label: string\n}\n\n/** Each kind's collection, counter, feature and label, as the create route declares them. */\nexport const AI_DRAFT_BANDS: Readonly<Record<AiDraftKind, AiDraftBand>> = {\n  layout: { collection: 'layouts', quotaKey: 'sharedLayoutsPerHost', label: 'shared layouts' },\n  template: { collection: 'templates', quotaKey: 'templatesPerHost', label: 'templates' },\n  form: {\n    collection: 'forms',\n    quotaKey: 'formsPerHost',\n    entitlement: 'reusableComponents',\n    label: 'forms',\n  },\n  component: {\n    collection: 'components',\n    entitlement: 'reusableComponents',\n    label: 'reusable components',\n  },\n  screen: { collection: 'screens', quotaKey: 'screensPerHost', label: 'screens' },\n}\n\ninterface SiblingRow {\n  id: string\n  name: string\n  slug: string\n  kind: unknown\n  sourceType: unknown\n  deletedAt: unknown\n  deleted: boolean\n}\n\n/** A host's routing map: screen id → the path it is published at. */\ntype RoutingMap = Record<string, unknown> | null | undefined\n\nfunction draftCollection(firestore: Firestore, hostId: string, kind: AiDraftKind) {\n  return firestore.collection('hosts').doc(hostId).collection(AI_DRAFT_BANDS[kind].collection)\n}\n\n/** The fields the band, the name, the address and a deletion are read from. */\nfunction siblingsOf(collection: FirebaseFirestore.CollectionReference) {\n  return collection.select('displayName', 'slug', 'kind', 'source.type', 'deletedAt')\n}\n\nfunction siblingRows(snapshot: FirebaseFirestore.QuerySnapshot): SiblingRow[] {\n  return snapshot.docs.map((doc) => ({\n    id: doc.id,\n    name: String(doc.get('displayName') ?? ''),\n    slug: String(doc.get('slug') ?? ''),\n    kind: doc.get('kind'),\n    sourceType: doc.get('source.type'),\n    deletedAt: doc.get('deletedAt'),\n    deleted: doc.get('deletedAt') != null,\n  }))\n}\n\nfunction subdomainOf(host: FirebaseFirestore.DocumentSnapshot): string | null {\n  const subdomain = host.get('subdomain')\n  return typeof subdomain === 'string' && subdomain ? subdomain : null\n}\n\n/**\n * The route's refusal when the site's plan does not include the kind, or\n * holds no more of it; `null` while it does. The feature is asked first, as\n * the route asks it before it counts.\n */\nexport function aiDraftBandRefusal(\n  kind: AiDraftKind,\n  rows: ReadonlyArray<Pick<SiblingRow, 'id' | 'kind' | 'sourceType' | 'deletedAt'>>,\n  org: Partial<AglynOrgBilling> | null,\n  routingMap?: RoutingMap,\n): string | null {\n  const band = AI_DRAFT_BANDS[kind]\n  if (band.entitlement && !checkEntitlement(org, band.entitlement)) {\n    return AI_DRAFT_ENTITLEMENT_REFUSAL\n  }\n  if (!band.quotaKey) return null\n  const used =\n    kind === 'template'\n      ? rows.filter((row) => row.sourceType !== undefined && row.sourceType !== 'starter').length\n      : kind === 'screen'\n        ? billableScreenIds(\n            rows.map((row) => ({ id: row.id, kind: row.kind, deletedAt: row.deletedAt })),\n            (routingMap ?? undefined) as never,\n          ).size\n        : rows.length\n  const quota = checkQuota(org, band.quotaKey, used)\n  return quota.allowed\n    ? null\n    : `Your plan includes ${quota.limit} ${band.label} — upgrade in Billing for more`\n}\n\n/** The draft kinds a plan's creations land as, whose band a plan is told about (AGL-3030). */\nconst AI_PLAN_DRAFT_KINDS = ['component', 'form', 'layout', 'template'] as const\n\ntype AiPlanDraftKind = (typeof AI_PLAN_DRAFT_KINDS)[number]\n\n/** Every draft kind's plural label made singular, for a band of one. */\nfunction bandLabel(label: string, count: number): string {\n  return count === 1 ? label.replace(/s$/, '') : label\n}\n\n/**\n * Whether the site may take `used + 1` of a kind, in the create route's\n * arithmetic: the feature first, then the allowance. `null` for a kind whose\n * allowance is unlimited or counts nothing, which needs no rows read.\n */\nfunction planCreation(\n  kind: AiPlanDraftKind,\n  org: Partial<AglynOrgBilling> | null,\n  rows: ReadonlyArray<Pick<SiblingRow, 'id' | 'kind' | 'sourceType' | 'deletedAt'>> | null,\n): AiPlanCreation {\n  const band = AI_DRAFT_BANDS[kind]\n  if (band.entitlement && !checkEntitlement(org, band.entitlement)) {\n    return {\n      allowed: false,\n      left: 0,\n      reason: `this workspace's plan does not include ${kind === 'form' ? 'saved forms' : band.label}`,\n    }\n  }\n  const limit = band.quotaKey ? resolveOrgEntitlements(org)[band.quotaKey] : Number.POSITIVE_INFINITY\n  if (!rows || !Number.isFinite(limit)) return { allowed: true, left: null, reason: null }\n  // The route's own arithmetic decides; the count beside it is what is left.\n  const refusal = aiDraftBandRefusal(kind, rows, org)\n  const used =\n    kind === 'template'\n      ? rows.filter((row) => row.sourceType !== undefined && row.sourceType !== 'starter').length\n      : rows.length\n  return refusal\n    ? {\n        allowed: false,\n        left: 0,\n        reason: `this site already holds the ${limit} ${bandLabel(band.label, limit)} its plan includes`,\n      }\n    : { allowed: true, left: Math.max(0, limit - used), reason: null }\n}\n\n/** Whether a kind's rows are counted at all on this plan: included, and under a finite allowance. */\nfunction countsRows(kind: AiPlanDraftKind, org: Partial<AglynOrgBilling> | null): boolean {\n  const band = AI_DRAFT_BANDS[kind]\n  if (!band.quotaKey) return false\n  if (band.entitlement && !checkEntitlement(org, band.entitlement)) return false\n  return Number.isFinite(resolveOrgEntitlements(org)[band.quotaKey])\n}\n\n/**\n * What a plan may create on this site (AGL-3030), from the workspace's plan\n * and the rows each counted kind already holds — pure, so the specs and the\n * eval harness hold the arithmetic without a Firestore. A kind whose rows\n * are not given is counted as having room, which is what an unlimited\n * allowance means.\n *\n * A theme change is a proposal a member applies, never a draft, so it counts\n * against nothing. A dataset is org data that no job writes; a plan may name\n * one only where the workspace's plan includes datasets at all. An email\n * design is written by the email plugin, whose own gate decides.\n *\n * A workspace on the Free plan spends the Free taste, a wall of monthly\n * credits, so its plan is held to the sections that wall pays for (AGL-3070).\n * The effective plan decides, as it decides the taste's own allowance: a\n * workspace whose subscription died is Free again.\n */\nexport function aiPlanCapabilitiesFrom(\n  org: Partial<AglynOrgBilling> | null,\n  rows: Partial<Record<AiPlanDraftKind, ReadonlyArray<Pick<SiblingRow, 'id' | 'kind' | 'sourceType' | 'deletedAt'>>>> = {},\n): AiPlanCapabilities {\n  const unrestricted = aiUnrestrictedPlanCapabilities()\n  const datasets = checkDatasetQuota(org, 0).limit > 0\n  return {\n    reusableComponents: checkEntitlement(org, 'reusableComponents'),\n    create: {\n      ...unrestricted.create,\n      component: planCreation('component', org, rows.component ?? null),\n      form: planCreation('form', org, rows.form ?? null),\n      layout: planCreation('layout', org, rows.layout ?? null),\n      template: planCreation('template', org, rows.template ?? null),\n      dataset: datasets\n        ? unrestricted.create.dataset\n        : { allowed: false, left: 0, reason: \"this workspace's plan does not include datasets\" },\n    },\n    ...(resolveEffectivePlan(org) === 'free' ? { freeTaste: true } : {}),\n  }\n}\n\n/**\n * What a plan may create on this site, read: the rows of each kind whose\n * allowance the workspace's plan counts, as the draft writer reads them, and\n * nothing for a kind the plan leaves out or leaves unlimited.\n */\nexport async function readAiPlanCapabilities(\n  firestore: Firestore,\n  input: { hostId: string; org: Partial<AglynOrgBilling> | null },\n): Promise<AiPlanCapabilities> {\n  const counted = AI_PLAN_DRAFT_KINDS.filter((kind) => countsRows(kind, input.org))\n  const snapshots = await Promise.all(\n    counted.map((kind) => siblingsOf(draftCollection(firestore, input.hostId, kind)).get()),\n  )\n  return aiPlanCapabilitiesFrom(\n    input.org,\n    Object.fromEntries(counted.map((kind, index) => [kind, siblingRows(snapshots[index])])),\n  )\n}\n\n/**\n * Whether the site can take one more draft of the kind: a read, for a door\n * that asks before it spends. The write asks again inside its transaction.\n */\nexport async function aiDraftAllowanceRefusal(\n  firestore: Firestore,\n  input: { kind: AiDraftKind; hostId: string; org: Partial<AglynOrgBilling> | null },\n): Promise<string | null> {\n  const [snapshot, host] = await Promise.all([\n    siblingsOf(draftCollection(firestore, input.hostId, input.kind)).get(),\n    input.kind === 'screen'\n      ? firestore.collection('hosts').doc(input.hostId).get()\n      : Promise.resolve(null),\n  ])\n  return aiDraftBandRefusal(\n    input.kind,\n    siblingRows(snapshot),\n    input.org,\n    host?.get('screens') as RoutingMap,\n  )\n}\n\n/**\n * A draft screen's one-segment address: the one asked for, else one from its\n * name, never a reserved segment, and never an address a live screen keeps\n * or the routing map already serves — so the member's publish at it later\n * takes nothing from a live page. The root is asked for only while no screen\n * holds it.\n */\nexport function aiDraftScreenSlug(\n  requested: string | null | undefined,\n  name: string,\n  rows: ReadonlyArray<Pick<SiblingRow, 'slug' | 'deleted'>>,\n  routingMap: RoutingMap,\n): string {\n  const taken = new Set<string>([\n    ...rows.filter((row) => !row.deleted && row.slug).map((row) => row.slug),\n    ...Object.values(routingMap ?? {}).filter((path): path is string => typeof path === 'string'),\n  ])\n  const usable = (value: string | undefined) =>\n    value && !reservedScreenRouteSegment(value) && !(value === SCREEN_ROOT_PATH && taken.has(value))\n      ? value\n      : undefined\n  const base = usable(normalizeScreenSlug(requested ?? undefined)) ?? usable(normalizeScreenSlug(name)) ?? 'page'\n  if (base === SCREEN_ROOT_PATH) return base\n  let slug = base\n  let attempt = 2\n  while (taken.has(slug)) slug = `${base}-${attempt++}`\n  return slug\n}\n\nexport interface AiDraftRecord {\n  id: string\n  /** A layout's or a screen's first version; `null` for every other kind, which the writer gives none. */\n  versionId: string | null\n  name: string\n  hostSubdomain: string | null\n  /** A screen's search listing as the draft holds it now; absent on other kinds. */\n  seo?: { title?: string; description?: string } | null\n  /** Whether a member deleted the draft since it was written. */\n  deleted?: boolean\n}\n\nfunction recordOf(\n  id: string,\n  draft: FirebaseFirestore.DocumentSnapshot,\n  host: FirebaseFirestore.DocumentSnapshot,\n): AiDraftRecord {\n  const versionId = draft.get('versionId')\n  const seo = draft.get('seo')\n  return {\n    id,\n    versionId: typeof versionId === 'string' && versionId ? versionId : null,\n    name: String(draft.get('displayName') ?? ''),\n    hostSubdomain: subdomainOf(host),\n    ...(seo && typeof seo === 'object' ? { seo: seo as AiDraftRecord['seo'] } : {}),\n    ...(draft.get('deletedAt') != null ? { deleted: true } : {}),\n  }\n}\n\n/** The draft a job already wrote under `id`, when a run of its step got that far. */\nexport async function readAiDraft(\n  firestore: Firestore,\n  input: { kind: AiDraftKind; hostId: string; id: string },\n): Promise<AiDraftRecord | null> {\n  const draft = await draftCollection(firestore, input.hostId, input.kind).doc(input.id).get()\n  if (!draft.exists) return null\n  return recordOf(input.id, draft, await firestore.collection('hosts').doc(input.hostId).get())\n}\n\n/** The tree a versioned draft's first version holds now, decoded; `null` when there is none. */\nexport async function readAiDraftNodes(\n  firestore: Firestore,\n  input: { kind: AiVersionedDraftKind; hostId: string; id: string },\n): Promise<{ versionId: string; nodes: NodesMap } | null> {\n  const draftRef = draftCollection(firestore, input.hostId, input.kind).doc(input.id)\n  const draft = await draftRef.get()\n  const versionId = draft.exists ? draft.get('versionId') : null\n  if (typeof versionId !== 'string' || !versionId) return null\n  const version = await draftRef.collection('versions').doc(versionId).get()\n  const nodes = version.exists ? decodeStoredNodes<NodesMap>(version.get('nodes')) : null\n  return nodes ? { versionId, nodes } : null\n}\n\nexport interface AiDraftInput {\n  kind: AiDraftKind\n  hostId: string\n  /** The draft's document id: the id the job recorded for this draft. */\n  id: string\n  /** Whose work the draft is: the job's creator, whose brief it built. */\n  uid: string\n  org: Partial<AglynOrgBilling> | null\n  /** The name asked for; a live sibling already called that gets a number. */\n  name: string\n  nodes: NodesMap\n  /** A page template's suggested address, or a screen's one-segment address. */\n  slug?: string | null\n  /** A form's declaration and the ids its design hangs from; required for a form. */\n  form?: AiFormDraftDeclaration\n  /** A component's root, which the node map holds; required for a component. */\n  rootId?: string\n  /** The properties a component declares, which its tree binds. */\n  props?: readonly ReusableComponentProp[]\n  /** A screen's layout, for its first version to render inside; a layout the site has. */\n  layoutId?: string | null\n  now: Date\n}\n\n/** What a form draft declares beside its design, read off that design. */\nexport interface AiFormDraftDeclaration {\n  /** The canvas root `nodes` is stored under, as the Forms page's Create stores it. */\n  rootId: string\n  /** The form node, which carries the form's id and is captioned with the draft's name. */\n  formNodeId: string\n  fields: FormFieldDecl[]\n  consentFieldName: string | null\n  routing: FormRouting | null\n}\n\nexport type AiDraftWrite =\n  | (AiDraftRecord & { ok: true; replayed: boolean })\n  | { ok: false; status: 403 | 404; error: string }\n\n/** Keep only the keys the create route admits for the kind. */\nfunction allowListed(kind: AiDraftKind, data: Record<string, unknown>): Record<string, unknown> {\n  const allowed = new Set(AI_DRAFT_FIELDS[kind])\n  return Object.fromEntries(\n    Object.entries(data).filter(([key, value]) => allowed.has(key) && value !== undefined),\n  )\n}\n\n/** The node map with its form node captioned with `name`, as Create captions a new form. */\nfunction withFormCaption(nodes: NodesMap, formNodeId: string, name: string): NodesMap {\n  const node = nodes[formNodeId]\n  if (!node || node.componentId !== FORM_COMPONENT_ID) return nodes\n  return { ...nodes, [formNodeId]: { ...node, props: { ...(node.props ?? {}), formName: name } } }\n}\n\n/**\n * Write one draft: the band met, the name made unique among the live\n * siblings, the node map stored as msgpack, all in one transaction. A\n * refusal is returned, never thrown; a Firestore failure propagates, so the\n * machine's retry applies.\n */\nexport async function writeAiDraft(firestore: Firestore, input: AiDraftInput): Promise<AiDraftWrite> {\n  const packed = encodeStoredNodes(input.nodes)\n  if (!packed) throw new Error('an AI draft needs a node map')\n  if (input.kind === 'form' && !input.form) throw new Error('an AI form draft needs its declaration')\n  if (input.kind === 'component' && !(input.rootId && input.nodes[input.rootId])) {\n    throw new Error('a component draft needs a root its node map holds')\n  }\n  const hostRef = firestore.collection('hosts').doc(input.hostId)\n  const collection = draftCollection(firestore, input.hostId, input.kind)\n  const draftRef = collection.doc(input.id)\n  return firestore.runTransaction(async (tx): Promise<AiDraftWrite> => {\n    // Every read before any write, which Firestore requires.\n    const [host, existing, siblings] = await Promise.all([\n      tx.get(hostRef),\n      tx.get(draftRef),\n      tx.get(siblingsOf(collection)),\n    ])\n    if (!host.exists) return { ok: false, status: 404, error: 'Unknown site' }\n    if (existing.exists) {\n      return { ok: true, replayed: true, ...recordOf(input.id, existing, host) }\n    }\n    const rows = siblingRows(siblings)\n    // Read, never written: the routing map decides which screens count.\n    const routingMap = host.get('screens') as RoutingMap\n    const refusal = aiDraftBandRefusal(input.kind, rows, input.org, routingMap)\n    if (refusal) return { ok: false, status: 403, error: refusal }\n    const name = uniqueDuplicateName(\n      input.name,\n      rows.filter((row) => !row.deleted).map((row) => row.name),\n    )\n    const stamps = { createdAt: input.now, updatedAt: input.now, createdBy: input.uid }\n    const nodes = Buffer.from(packed)\n    let versionId: string | null = null\n    if (input.kind === 'layout') {\n      versionId = createResourceUid()\n      tx.create(draftRef, { ...allowListed('layout', { displayName: name, versionId }), ...stamps })\n      tx.create(draftRef.collection('versions').doc(versionId), {\n        layoutId: input.id,\n        hostId: input.hostId,\n        displayName: AI_DRAFT_VERSION_NAME,\n        nodes,\n        ...stamps,\n      })\n    } else if (input.kind === 'screen') {\n      versionId = createResourceUid()\n      const slug = aiDraftScreenSlug(input.slug, name, rows, routingMap)\n      tx.create(draftRef, {\n        ...allowListed('screen', { displayName: name, slug, versionId }),\n        nameLower: nameSearchKey(name),\n        ...stamps,\n      })\n      tx.create(draftRef.collection('versions').doc(versionId), {\n        screenId: input.id,\n        hostId: input.hostId,\n        displayName: AI_DRAFT_VERSION_NAME,\n        nodes,\n        ...(input.layoutId ? { layoutId: input.layoutId } : {}),\n        ...stamps,\n      })\n    } else if (input.kind === 'template') {\n      tx.create(draftRef, {\n        ...allowListed('template', {\n          kind: 'page',\n          displayName: name,\n          nodes,\n          slug: input.slug || undefined,\n        }),\n        source: { type: 'authored' },\n        ...stamps,\n      })\n    } else if (input.kind === 'component') {\n      tx.create(draftRef, {\n        ...allowListed('component', {\n          displayName: name,\n          rootId: input.rootId,\n          nodes,\n          props: input.props?.length ? [...input.props] : undefined,\n        }),\n        ...stamps,\n      })\n    } else {\n      const form = input.form as AiFormDraftDeclaration\n      const captioned = encodeStoredNodes(withFormCaption(input.nodes, form.formNodeId, name)) ?? packed\n      tx.create(draftRef, {\n        ...allowListed('form', {\n          displayName: name,\n          slug: normalizeFormSlug(name) || input.id,\n          fields: form.fields,\n          consentFieldName: form.consentFieldName || undefined,\n          routing: form.routing ?? undefined,\n          rootId: form.rootId,\n          nodes: Buffer.from(captioned),\n        }),\n        ...stamps,\n      })\n    }\n    return {\n      ok: true,\n      replayed: false,\n      id: input.id,\n      versionId,\n      name,\n      hostSubdomain: subdomainOf(host),\n    }\n  })\n}\n\nexport type AiDraftNodesUpdate =\n  | { ok: true; changed: boolean }\n  | { ok: false; status: 404; error: string }\n\n/**\n * Change the tree of a versioned draft the job wrote, in one transaction:\n * read the first version as it is stored NOW — a member may have opened and\n * saved it — hand it to `update`, and store what comes back with a fresh\n * `updatedAt`, which is what the besigner's save guard compares. `update`\n * answering `null` changes nothing: a pass run again after its write.\n */\nexport async function updateAiDraftNodes(\n  firestore: Firestore,\n  input: {\n    kind: AiVersionedDraftKind\n    hostId: string\n    id: string\n    now: Date\n    update: (nodes: NodesMap) => NodesMap | null\n  },\n): Promise<AiDraftNodesUpdate> {\n  const draftRef = draftCollection(firestore, input.hostId, input.kind).doc(input.id)\n  return firestore.runTransaction(async (tx): Promise<AiDraftNodesUpdate> => {\n    const draft = await tx.get(draftRef)\n    const versionId = draft.exists && draft.get('deletedAt') == null ? draft.get('versionId') : null\n    if (typeof versionId !== 'string' || !versionId) {\n      return { ok: false, status: 404, error: 'The draft is no longer on the site' }\n    }\n    const versionRef = draftRef.collection('versions').doc(versionId)\n    const version = await tx.get(versionRef)\n    const nodes = version.exists ? decodeStoredNodes<NodesMap>(version.get('nodes')) : null\n    if (!nodes) return { ok: false, status: 404, error: 'The draft is no longer on the site' }\n    const next = input.update(nodes)\n    if (!next) return { ok: true, changed: false }\n    const packed = encodeStoredNodes(next)\n    if (!packed) throw new Error('an AI draft needs a node map')\n    tx.update(versionRef, { nodes: Buffer.from(packed), updatedAt: input.now })\n    return { ok: true, changed: true }\n  })\n}\n\n/**\n * Put a search title and description on a draft screen the job wrote, each\n * only where the draft has none: a value a member typed since is theirs.\n */\nexport async function writeAiDraftScreenSeo(\n  firestore: Firestore,\n  input: {\n    hostId: string\n    id: string\n    seo: { title?: string | null; description?: string | null }\n    now: Date\n  },\n): Promise<void> {\n  const ref = draftCollection(firestore, input.hostId, 'screen').doc(input.id)\n  await firestore.runTransaction(async (tx) => {\n    const screen = await tx.get(ref)\n    if (!screen.exists || screen.get('deletedAt') != null) return\n    const patch: Record<string, unknown> = {}\n    for (const key of ['title', 'description'] as const) {\n      const value = String(input.seo[key] ?? '').trim()\n      if (value && !String(screen.get(`seo.${key}`) ?? '').trim()) patch[`seo.${key}`] = value\n    }\n    if (Object.keys(patch).length) tx.update(ref, { ...patch, updatedAt: input.now })\n  })\n}\n\n/** The site's subdomain, which a console link names the site by. */\nexport async function aiSiteSubdomain(firestore: Firestore, hostId: string): Promise<string | null> {\n  return subdomainOf(await firestore.collection('hosts').doc(hostId).get())\n}\n\n/**\n * What a door says before a job that writes a draft of this kind exists: a\n * site is named, and it is the job's own org's; whatever the kind checks of\n * its own; then the allowance. `null` admits the job.\n */\nexport async function aiDraftAdmissionRefusal(\n  firestore: Firestore,\n  input: {\n    orgId: string\n    hostId: string | null\n    kind: AiDraftKind\n    /** What the refusal calls the job's output; the kind when absent. */\n    noun?: string\n    org: object | null\n    /** The kind's own check, asked once the site is known to be the org's. */\n    ownCheck?: (hostId: string) => Promise<AiJobAdmissionRefusal | null>\n  },\n): Promise<AiJobAdmissionRefusal | null> {\n  if (!input.hostId) {\n    return {\n      status: 400,\n      error: `Open the site the ${input.noun ?? input.kind} is for before starting the job`,\n    }\n  }\n  const owner = await resolveOrgIdForHost(input.hostId)\n  if (!owner || owner !== input.orgId) return { status: 404, error: 'Unknown site' }\n  const own = await input.ownCheck?.(input.hostId)\n  if (own) return own\n  const refusal = await aiDraftAllowanceRefusal(firestore, {\n    kind: input.kind,\n    hostId: input.hostId,\n    org: input.org as Partial<AglynOrgBilling> | null,\n  })\n  return refusal ? { status: 403, error: refusal } : null\n}\n"],"names":["createResourceUid","uniqueDuplicateName","FORM_COMPONENT_ID","normalizeFormSlug","nameSearchKey","checkDatasetQuota","checkEntitlement","checkQuota","resolveEffectivePlan","resolveOrgEntitlements","billableScreenIds","normalizeScreenSlug","reservedScreenRouteSegment","SCREEN_ROOT_PATH","decodeStoredNodes","encodeStoredNodes","resolveOrgIdForHost","aiUnrestrictedPlanCapabilities","AI_DRAFT_FIELDS","layout","template","form","component","screen","AI_DRAFT_VERSION_FIELDS","AI_DRAFT_SCREEN_VERSION_FIELDS","AI_DRAFT_VERSION_NAME","AI_DRAFT_ENTITLEMENT_REFUSAL","AI_DRAFT_BANDS","collection","quotaKey","label","entitlement","draftCollection","firestore","hostId","kind","doc","siblingsOf","select","siblingRows","snapshot","docs","map","id","name","String","get","slug","sourceType","deletedAt","deleted","subdomainOf","host","subdomain","aiDraftBandRefusal","rows","org","routingMap","band","used","filter","row","undefined","length","size","quota","allowed","limit","AI_PLAN_DRAFT_KINDS","bandLabel","count","replace","planCreation","left","reason","Number","POSITIVE_INFINITY","isFinite","refusal","Math","max","countsRows","aiPlanCapabilitiesFrom","unrestricted","datasets","reusableComponents","create","dataset","freeTaste","readAiPlanCapabilities","input","counted","snapshots","Promise","all","Object","fromEntries","index","aiDraftAllowanceRefusal","resolve","aiDraftScreenSlug","requested","usable","taken","Set","values","path","value","has","base","attempt","recordOf","draft","versionId","seo","hostSubdomain","readAiDraft","exists","readAiDraftNodes","draftRef","version","nodes","allowListed","data","entries","key","withFormCaption","formNodeId","node","componentId","props","formName","writeAiDraft","packed","Error","rootId","hostRef","runTransaction","tx","existing","siblings","ok","status","error","replayed","stamps","createdAt","now","updatedAt","createdBy","uid","Buffer","from","displayName","layoutId","nameLower","screenId","source","type","captioned","fields","consentFieldName","routing","updateAiDraftNodes","versionRef","next","update","changed","writeAiDraftScreenSeo","ref","patch","trim","keys","aiSiteSubdomain","aiDraftAdmissionRefusal","noun","owner","orgId","own","ownCheck"],"mappings":"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"}

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

@@ -0,0 +1,195 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginDraftRecord, PluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import type { AiJob, AiJobOutput, AiJobPlan } from '../model/ai-jobs.types';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+import { type AiStepKind } from '../providers/catalog';
+import { type AiValidatedGeneration, type AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiSystemBlock, AiTool } from '../runtime/ai-runtime';
+import { readSiteInventory } from '../runtime/site-inventory';
+import { type AiEmailProductBinding } from './ai-email-bindings';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiJobStepBudget } from './ai-job-budget';
+import { type AiPluginDraftWriterLookup } from './ai-job-plugin-drafts';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The email step (AGL-2912): the generation step of an `email` job, run once a
+ * member confirmed the job's plan, and the generation the campaign step
+ * drafts its email with.
+ *
+ * It builds ONE email design from the email palette — sections holding text,
+ * buttons, images, dividers, spacers and product blocks, never hand-written
+ * HTML, which is not on the email surface — through
+ * `runValidatedGeneration('email', …)`, so every building rule holds on the
+ * tree, rule 6's brand and rule 17's clip size included. Beside the design the
+ * answer carries three subject lines and three preheaders. The door's checks
+ * ride `extend`:
+ *
+ *  - every block sits in a section, every button links somewhere, and the
+ *    copy's only merge tokens are the recipient's own, in text;
+ *  - exactly as many product blocks as the job binds products;
+ *  - three different subject lines and preheaders, within their lengths and
+ *    free of merge tokens, which a subject line does not fill;
+ *  - and the design RENDERS: the email plugin's writer checks it through the
+ *    send path's own renderer, reached through the core's resource-drafts
+ *    seam, and a problem it names is a violation the model is re-asked with.
+ *
+ * What the model is sent is the brief, the email's name and kind, the
+ * confirmed plan and the site inventory, and how many product blocks to place.
+ * The products themselves are bound by id after it answers
+ * (`ai-email-bindings.ts`); a link to one of the site's pages is completed
+ * with the site's address token, which the send fills.
+ *
+ * The design lands through that same writer: a draft email screen, listed on
+ * the Emails page's templates, that no campaign sends until a member picks it.
+ * The job never sends, schedules or publishes anything.
+ *
+ * Like the other generation steps, it runs on the job beat, never at an inline
+ * door: it registers the least time its lookup rounds, its answer and its
+ * re-ask need (AGL-3035), and runs without extended thinking under a tighter
+ * answer ceiling than the doctrine's default for an email, lowered on a tier
+ * too slow to answer it inside that time.
+ */
+/** The resource the email plugin writes an email design under. */
+export declare const AI_EMAIL_DESIGN_RESOURCE = "emailDesign";
+/** The id the email plugin is registered under. */
+export declare const AI_EMAIL_PLUGIN_ID = "email";
+/** The longest answer an email may run to; the tree is held to the email budget either way. */
+export declare const AI_JOB_EMAIL_MAX_TOKENS: number;
+/**
+ * The time an email generation takes (AGL-3035, AGL-3036), for each step kind
+ * that runs one: its two inventory-lookup rounds, its answer and its re-ask at
+ * the kind's routing ceiling on the tier the kind is served from, fitted to
+ * what a beat can give a step. The email step registers the first, and the
+ * campaign step — whose email is this same generation — the second.
+ */
+export declare const AI_JOB_EMAIL_STEP_BUDGETS: Readonly<Record<AiEmailGenerationInput['step'], AiJobStepBudget>>;
+/** The least time one email step needs before it starts. */
+export declare const AI_JOB_EMAIL_STEP_MINIMUM_MS: number;
+/** How many subject lines, and how many preheaders, an email is written with. */
+export declare const AI_EMAIL_VARIANTS = 3;
+/** A subject line is a headline. */
+export declare const AI_EMAIL_SUBJECT_MAX_CHARS: 120;
+/** The longest preheader the campaign send route stores. */
+export declare const AI_EMAIL_PREHEADER_MAX_CHARS = 200;
+/** An email's name when neither the plan nor the job names one. */
+export declare const AI_JOB_EMAIL_DEFAULT_NAME = "New email";
+/** A job's failure when the site has no email design writer. */
+export declare const AI_EMAIL_UNAVAILABLE_COPY = "Email is not available on this site.";
+/** A job's failure when a design that passed every check could not be stored. */
+export declare const AI_EMAIL_SAVE_FAILURE_COPY = "The email was written but could not be saved. Try the job again.";
+/**
+ * The kinds of email a job may carry, as `inputs.emailType`, and how the
+ * prompt says each.
+ *
+ * A member picks one for an email of their own; a job the platform composes
+ * sets one for itself, which is what `reply` is for (AGL-2918, named by the
+ * site model's `AI_SITE_EMAIL_TYPE`). A scaffold's email answers one person
+ * who wrote in, and none of the five campaign kinds says that: the nearest,
+ * `welcome`, names a signup the site has not had, and a kind that
+ * misdescribes the email is worse than no kind at all, because this line is
+ * what the model reads first.
+ *
+ * Every label is the step's own words, so none of them may name a list, a
+ * recipient or the people an email is sent to — the same rule the step's
+ * instructions keep, held over the whole catalog by `ai-job-email-step.spec`.
+ */
+export declare const AI_EMAIL_TYPES: {
+    readonly welcome: "a welcome email for someone who just signed up";
+    readonly newsletter: "a newsletter";
+    readonly launch: "a launch announcement";
+    readonly abandonedCart: "a reminder about items left in a cart";
+    readonly eventReminder: "a reminder about an upcoming event";
+    readonly reply: "a reply to somebody who got in touch through the site";
+};
+export type AiEmailType = keyof typeof AI_EMAIL_TYPES;
+/** The merge tokens a generated email's copy may carry: the recipient's own, which each send fills. */
+export declare const AI_EMAIL_TEXT_MERGE_TOKENS: readonly string[];
+/** The token the send fills with the site's address, set in front of a link to one of its pages. */
+export declare const AI_EMAIL_SITE_URL_TOKEN = "{{site.url}}";
+/** The email step's own instructions, cached after the doctrine. */
+export declare const AI_JOB_EMAIL_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The doctrine's email tree tool, with the subject lines and preheaders beside the tree. */
+export declare const AI_JOB_EMAIL_TOOL: AiTool;
+/** How the prompt names the kind of email a member picked; `null` for none or an unknown one. */
+export declare function aiEmailTypeLabel(value: unknown): string | null;
+/** A name the member gave the job, on one line and bounded; empty when none. */
+export declare function aiJobInputName(job: Pick<AiJob, 'inputs'>): string;
+/** The email job as the generation's user turn. */
+export declare function aiJobEmailPrompt(job: Pick<AiJob, 'brief' | 'inputs'>, plan: AiJobPlan | null, heading: string | null, products: number): string;
+/** The subject lines and preheaders an answer carries. */
+export interface AiEmailCopy {
+    subjects: string[];
+    preheaders: string[];
+}
+export declare function parseAiEmailCopy(answer: Readonly<Record<string, unknown>>): AiEmailCopy;
+/** The copy's own rules: three different lines of each, within their lengths, with no merge token. */
+export declare function aiEmailCopyViolations(copy: AiEmailCopy): AiDoctrineViolation[];
+/** The design's own rules, on a tree the doctrine admitted. */
+export declare function aiEmailTreeViolations(tree: AiValidatedTree, products: number): AiDoctrineViolation[];
+/**
+ * The design as it is stored: a link to one of the site's pages completed with
+ * the site's address token, and each product block bound, in document order,
+ * to the next product the job binds.
+ */
+export declare function aiEmailDesignNodes(tree: Pick<AiValidatedTree, 'rootId' | 'nodes'>, productIds: readonly string[]): NodesMap;
+/** The content the email plugin's writer stores a design from. */
+export declare function aiEmailDesignContent(nodes: NodesMap, copy: AiEmailCopy): Record<string, unknown>;
+/** What the email plugin's renderer says about the design, as violations the model is re-asked with. */
+export declare function aiEmailRenderViolations(design: PluginResourceDraftWriter, hostId: string, nodes: NodesMap, copy: AiEmailCopy): AiDoctrineViolation[];
+export interface AiEmailGenerationInput {
+    job: AiJob;
+    step: Extract<AiStepKind, 'job.email' | 'job.campaign'>;
+    model: string;
+    /** The line naming what is built, such as `Email name: …`; `null` for none. */
+    heading: string | null;
+    plan: AiJobPlan | null;
+    inventory: AiSiteInventory | null;
+    hostId: string;
+    products: AiEmailProductBinding;
+    /** The email plugin's design writer, whose check the design must pass. */
+    design: PluginResourceDraftWriter;
+    signal?: AbortSignal;
+}
+export interface AiEmailGeneration {
+    result: AiValidatedGeneration<AiValidatedTree>;
+    /** The copy of the answer the doctrine kept; `null` unless it kept one. */
+    copy: AiEmailCopy | null;
+    /** The kept design as it is stored; `null` unless the doctrine kept one. */
+    nodes: NodesMap | null;
+}
+/** Generates one email under the doctrine, with the email's own checks riding `extend`. */
+export declare function generateAiEmail(input: AiEmailGenerationInput): Promise<AiEmailGeneration>;
+/** An email design as the job's output. */
+export declare function aiEmailDesignOutput(record: PluginDraftRecord, place: {
+    hostId: string;
+    hostSubdomain: string | null;
+}, note: string | null): AiJobOutput;
+/** An email job is admitted for a site of its org with email on and room for a design. */
+export declare const aiEmailJobAdmission: AiJobAdmission;
+export interface AiJobEmailStepDeps {
+    /** The inventory reader; specs hand in a fake. */
+    readInventory?: typeof readSiteInventory;
+    /** How a resource's draft writer is found; the core's registry otherwise. */
+    writerFor?: AiPluginDraftWriterLookup;
+}
+export declare function createAiJobEmailStep(deps?: AiJobEmailStepDeps): AiJobStepRunner;
+export declare const runAiJobEmailStep: AiJobStepRunner;
+/** Registers the email step and the check a email job passes before it is created or resumed. */
+export declare function registerAiEmailJob(): void;