@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-form-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 {\n  checkFormContract,\n  formFieldsCanYieldAnEmail,\n} from '@aglyn/aglyn/app-utils/form-contract'\nimport {\n  collectFormFieldNodeIds,\n  FORM_COMPONENT_ID,\n  FORM_FIELD_COMPONENT_ID,\n  FORM_ID_PROP,\n  formFieldDeclsFromNodes,\n  formNodeIdIn,\n  isMarketingConsentFieldName,\n  MARKETING_CONSENT_FORM_FIELD,\n  type FormDocument,\n  type FormFieldDecl,\n  type FormRouting,\n} from '@aglyn/aglyn/app-utils/forms'\nimport { decodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport { CANVAS_ROOT_ELEMENT_ID } from '@aglyn/aglyn/foundation/constants/canvas'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { NodeType, type NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan } from '../model/ai-jobs.types'\nimport { aiSiteSubmissions, aiSiteWords, type AiSiteSubmissions } from '../model/ai-site-job'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  aiDoctrineTreeTool,\n  runValidatedGeneration,\n  type AiValidatedTree,\n} from '../runtime/ai-doctrine'\nimport type { AiDoctrineTree, AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport { AI_PALETTE } from '../runtime/ai-palette.generated'\nimport type { AiSystemBlock, AiTool } from '../runtime/ai-runtime'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport { aiJobDraftId } from './ai-job-draft-ids'\nimport {\n  aiDraftAdmissionRefusal,\n  aiDraftAllowanceRefusal,\n  aiSiteSubdomain,\n  readAiDraft,\n  writeAiDraft,\n  type AiDraftRecord,\n} from './ai-job-drafts'\nimport {\n  aiBracketedFactsNote,\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiJobBriefLine,\n  aiLimitReview,\n  aiModelNodeIds,\n  aiPlanCreation,\n  aiPlanReferenceLines,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport type { AiJobStepRunner } from './ai-job-text-step'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The form step (AGL-2913): the generation step of a `form` job, run once a\n * member confirmed the job's plan.\n *\n * A form is two halves that must agree for its submissions to arrive: the\n * DESIGN a visitor fills in (`rootId`, `nodes`) and the DECLARATION the submit\n * route reads (`fields`, `consentFieldName`, `routing`). `checkFormContract`\n * is the rule that holds them together when a form is published. So the model\n * writes only the design, through `runValidatedGeneration('form', …)`, and\n * everything else is derived from it with the functions the publish paths\n * use:\n *\n *  - `fields` is `formFieldDeclsFromNodes` over the design;\n *  - a form that can yield an email address gets the platform's marketing\n *    consent field (`MARKETING_CONSENT_FORM_FIELD`, the Forms editor preset's own\n *    props) in place of any consent-like field the model drew, named as its\n *    `consentFieldName`;\n *  - `routing` is `{ lead: true }` when the answer proposes a lead, and\n *    nothing otherwise. The stored routing has no place for an email list,\n *    so a list proposal leaves the form on the Inbox and says, in the output's\n *    `note`, how to enroll the people who tick consent — naming a list only\n *    when the brief named one. The step reads no list, contact, CRM record or\n *    submission, and sends none.\n *\n * The design is then stamped the way the Forms page's Create stamps one — the\n * form node bound to the new form's id, a canvas root above it — and\n * `checkFormContract` runs on it through `extend`, beside the doctrine's own\n * checks, so a design the contract would refuse at publish is asked for again\n * with the violation named.\n *\n * The form lands as a new draft (`ai-job-drafts.ts`) that no page places and\n * nothing promotes. A plan that starts from a copy of a form the site has gets\n * that copy, through the platform's duplicate module, and nothing generated —\n * and because that path reaches no model, `extend` never runs on it, so the\n * step asks `checkFormContract` of the stored copy itself before it reports\n * one (AGL-3024). A copy still bound to the form it was copied from is a\n * failure, never an output.\n *\n * Like the other generation steps, it runs on the job beat, never at an inline\n * door: it registers the least time its lookup rounds, its answer and its\n * re-ask need (AGL-3035), and runs without extended thinking under the routing\n * table's ceiling for a form, which is the doctrine's own.\n */\n\n/**\n * The longest answer a form may run to: the routing table's `job.form`\n * ceiling, which holds the largest form the output budget admits\n * (`ai-job-form-step.spec.ts` measures it) and is the doctrine's ceiling for\n * the form kind.\n */\nexport const AI_JOB_FORM_MAX_TOKENS = AI_ROUTING_TABLE['job.form'].maxTokens\n\n/**\n * The form step's time (AGL-3035, AGL-3036): its two inventory-lookup rounds,\n * its answer and its re-ask at that ceiling on the tier `job.form` is served\n * from, fitted to what a beat can give a step.\n */\nexport const AI_JOB_FORM_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.form'],\n  maxTokens: AI_JOB_FORM_MAX_TOKENS,\n})\n\n/** The least time one form step needs before it starts. */\nexport const AI_JOB_FORM_STEP_MINIMUM_MS = AI_JOB_FORM_STEP_BUDGET.minimumMs\n\n/** A form's name when the plan names none. */\nexport const AI_JOB_FORM_DEFAULT_NAME = 'New form'\n\n/** Where a proposal routes a form's submissions. */\nexport const AI_FORM_ROUTING_KINDS = ['inbox', 'list', 'lead'] as const\n\nexport type AiFormRoutingKind = (typeof AI_FORM_ROUTING_KINDS)[number]\n\n/** The most things a note says the brief asked for and a form cannot collect. */\nexport const AI_FORM_CANNOT_COLLECT_MAX = 3\n\nconst CANNOT_COLLECT_MAX_CHARS = 60\nconst LIST_NAME_MAX_CHARS = 80\n\n/** The node id the platform's consent field takes in a generated design. */\nexport const AI_FORM_CONSENT_NODE_ID = 'marketingConsentField'\n\n/** The form step's own instructions, cached after the doctrine. */\nexport const AI_JOB_FORM_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one form for a website: the fields a visitor fills in and the button that sends them. Answer with submit_form: the whole form as one flat node map, how its submissions are routed, and what the brief asks for that a form cannot collect.',\n      'The root is one Form (form) holding its Form Fields (formField) in the order a visitor fills them in. Give the form a submitLabel and a successMessage in the site’s voice.',\n      'Every field has a fieldName that is unique in the form and says what it holds in camelCase, such as fullName, email, phone or roofType; a label a visitor reads; and required only when the form cannot do its job without it. Use fieldType email for an email address, textarea for a description, select or radio with options for one choice, checkbox with options for several, and rating for a score. Put each option on its own line and never put a comma inside an option, because a comma starts a new one.',\n      'A form collects text, choices and ratings only. When the brief asks for something else, such as a file or photo upload, a signature or a payment, leave it out and name it in cannotCollect.',\n      'Never draw a marketing consent, newsletter or subscribe checkbox: when the form asks for an email address, the platform adds its own.',\n      'routing.kind is inbox when submissions only need to be read, lead when each one is a sales lead to follow up, and list when the people who send it should join an email list. routing.list is the list’s name only when the brief names one, and null otherwise.',\n    ].join('\\n'),\n  },\n]\n\nconst TREE_TOOL = aiDoctrineTreeTool('form')\n\n/**\n * The doctrine's form tree tool, with the two things a design cannot say: the\n * routing it proposes and what the brief asked for that no field can collect.\n * Structured fields only, so the step writes every sentence a person reads.\n */\nexport const AI_JOB_FORM_TOOL: AiTool = {\n  name: TREE_TOOL.name,\n  description:\n    'Submit the form as one flat node map, how its submissions are routed, and what the brief asks for that a form cannot collect.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['tree', 'routing', 'cannotCollect'],\n    properties: {\n      tree: (TREE_TOOL.inputSchema['properties'] as Record<string, unknown>)['tree'],\n      routing: {\n        type: 'object',\n        additionalProperties: false,\n        required: ['kind', 'list'],\n        properties: {\n          kind: {\n            type: 'string',\n            enum: [...AI_FORM_ROUTING_KINDS],\n            description:\n              'inbox: submissions are read in the Inbox. lead: each submission with an email address is a sales lead. list: the people who send it should join an email list.',\n          },\n          list: {\n            anyOf: [{ type: 'string' }, { type: 'null' }],\n            description: 'The email list the brief names, as it names it; null when it names none.',\n          },\n        },\n      },\n      cannotCollect: {\n        type: 'array',\n        items: { type: 'string' },\n        description:\n          'What the brief asks the form to collect that its field types cannot, a few words each, such as \"photo upload\"; empty when there is nothing.',\n      },\n    },\n  },\n}\n\n/** The routing and the gaps an answer proposes, read defensively. */\nexport interface AiFormAnswer {\n  routing: { kind: AiFormRoutingKind; list: string | null }\n  cannotCollect: string[]\n}\n\n/**\n * What the person already decided about this form, where they were asked\n * (AGL-2918).\n *\n * Only the guided start asks, so only a scaffold's form unit carries one.\n * Whether a submission is a note to read or a lead to chase is a fact about\n * how a business runs, not something readable off a brief, so an answer here\n * BINDS the routing instead of joining the evidence the model weighs: a\n * person who said \"the Inbox\" and got a form filing leads would have been\n * asked a question for nothing.\n */\nexport interface AiFormDecisions {\n  /** Where submissions go; `null` where nobody was asked. */\n  submissions: AiSiteSubmissions | null\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction oneLine(value: string, max: number): string {\n  return value.replace(/\\s+/g, ' ').trim().slice(0, max).trim()\n}\n\n/**\n * An answer's routing and gaps: an unknown kind is the Inbox, and the rest is\n * trimmed and capped. Where the person was asked where submissions go, their\n * answer replaces the model's proposal — the whole of the difference a\n * question makes.\n */\nexport function parseAiFormAnswer(\n  answer: Record<string, unknown>,\n  decisions: AiFormDecisions = { submissions: null },\n): AiFormAnswer {\n  const routing = isRecord(answer['routing']) ? answer['routing'] : {}\n  const proposed = (AI_FORM_ROUTING_KINDS as readonly unknown[]).includes(routing['kind'])\n    ? (routing['kind'] as AiFormRoutingKind)\n    : 'inbox'\n  const kind: AiFormRoutingKind = decisions.submissions ?? proposed\n  const list = typeof routing['list'] === 'string' ? oneLine(routing['list'], LIST_NAME_MAX_CHARS) : ''\n  const seen = new Set<string>()\n  const cannotCollect: string[] = []\n  for (const entry of Array.isArray(answer['cannotCollect']) ? answer['cannotCollect'] : []) {\n    if (typeof entry !== 'string') continue\n    const text = oneLine(entry, CANNOT_COLLECT_MAX_CHARS)\n    if (!text || seen.has(text.toLowerCase())) continue\n    seen.add(text.toLowerCase())\n    cannotCollect.push(text)\n    if (cannotCollect.length === AI_FORM_CANNOT_COLLECT_MAX) break\n  }\n  return { routing: { kind, list: kind === 'list' && list ? list : null }, cannotCollect }\n}\n\n/** A generated form as its draft is written: the stamped design and what it declares. */\nexport interface AiFormDraft {\n  /** The design as the Forms page's Create stores one: a canvas root above the bound form. */\n  nodes: NodesMap\n  rootId: string\n  formNodeId: string\n  fields: FormFieldDecl[]\n  consentFieldName: string | null\n  routing: FormRouting | null\n  answer: AiFormAnswer\n}\n\n/**\n * The draft a validated design and its answer make: the form node bound to\n * `formId` and captioned `name`, no dataset binding, the platform's consent\n * field when the fields can yield an email address, the canvas root above,\n * and the declaration read off the result. Pure; the input tree is not\n * changed.\n */\nexport function aiFormDraft(\n  tree: Pick<AiValidatedTree, 'rootId' | 'nodes'>,\n  answer: Record<string, unknown>,\n  identity: { formId: string; name: string; decisions?: AiFormDecisions },\n): AiFormDraft {\n  const parsed = parseAiFormAnswer(answer, identity.decisions ?? { submissions: null })\n  const formNodeId = tree.rootId\n  const nodes: NodesMap = {}\n  for (const [id, node] of Object.entries(tree.nodes)) {\n    nodes[id] = {\n      ...node,\n      props: { ...(node.props ?? {}) },\n      nodes: Array.isArray(node.nodes) ? [...(node.nodes as string[])] : [],\n    }\n  }\n  const form = nodes[formNodeId]\n  let consentFieldName: string | null = null\n  if (form?.componentId === FORM_COMPONENT_ID) {\n    const props = form.props as Record<string, unknown>\n    // A dataset binding decides where every submission is also written; it\n    // stays the person's choice, made on the Form element.\n    delete props['datasetId']\n    delete props['datasetName']\n    props[FORM_ID_PROP] = identity.formId\n    props['formName'] = identity.name\n\n    for (const id of collectFormFieldNodeIds(nodes as never, formNodeId)) {\n      const fieldName = (nodes[id]?.props as Record<string, unknown> | undefined)?.['fieldName']\n      if (!isMarketingConsentFieldName(fieldName)) continue\n      const parent = nodes[String(nodes[id]?.parentId ?? '')]\n      if (parent && Array.isArray(parent.nodes)) {\n        parent.nodes = (parent.nodes as string[]).filter((child) => child !== id)\n      }\n      delete nodes[id]\n    }\n    if (formFieldsCanYieldAnEmail(formFieldDeclsFromNodes(nodes as never, formNodeId))) {\n      nodes[AI_FORM_CONSENT_NODE_ID] = {\n        $id: AI_FORM_CONSENT_NODE_ID,\n        type: NodeType.NODE,\n        componentId: FORM_FIELD_COMPONENT_ID,\n        pluginId: AI_PALETTE[FORM_FIELD_COMPONENT_ID]?.pluginId,\n        parentId: formNodeId,\n        nodes: [],\n        props: { ...MARKETING_CONSENT_FORM_FIELD },\n      } as NodesMap[string]\n      form.nodes = [...(form.nodes as string[]), AI_FORM_CONSENT_NODE_ID]\n      consentFieldName = MARKETING_CONSENT_FORM_FIELD.fieldName\n    }\n    form.parentId = CANVAS_ROOT_ELEMENT_ID\n  }\n  nodes[CANVAS_ROOT_ELEMENT_ID] = {\n    $id: CANVAS_ROOT_ELEMENT_ID,\n    componentId: 'div',\n    nodes: [formNodeId],\n  } as NodesMap[string]\n  return {\n    nodes,\n    rootId: CANVAS_ROOT_ELEMENT_ID,\n    formNodeId,\n    fields: formFieldDeclsFromNodes(nodes as never, formNodeId),\n    consentFieldName,\n    routing: parsed.routing.kind === 'lead' ? { lead: true } : null,\n    answer: parsed,\n  }\n}\n\n/**\n * What a draft would break once published, as building-rule violations\n * (rule 3: a form is built with its fields, validation, consent and routing\n * together): the form contract's findings, a form with no field, and a list\n * proposal on a form that asks for no email address. Offending nodes are\n * named by the ids the model wrote.\n */\nexport function aiFormDraftViolations(\n  draft: AiFormDraft,\n  formId: string,\n  sourceIds: Readonly<Record<string, string>>,\n): AiDoctrineViolation[] {\n  const violations: AiDoctrineViolation[] = checkFormContract({\n    form: {\n      ...(draft.routing ? { routing: draft.routing } : {}),\n      ...(draft.consentFieldName ? { consentFieldName: draft.consentFieldName } : {}),\n    },\n    formId,\n    nodes: draft.nodes as never,\n    formNodeId: draft.formNodeId,\n  }).map((violation) => ({\n    rule: 3 as const,\n    code: violation.code,\n    message: violation.message,\n    ...(violation.nodeId ? { nodeIds: aiModelNodeIds([violation.nodeId], sourceIds) } : {}),\n  }))\n  if (!draft.fields.length) {\n    violations.push({\n      rule: 3,\n      code: 'form-has-no-fields',\n      message:\n        'This form has no named fields, so a visitor has nothing to fill in. Draw the fields the brief asks for.',\n    })\n  }\n  if (draft.answer.routing.kind === 'list' && !formFieldsCanYieldAnEmail(draft.fields)) {\n    violations.push({\n      rule: 3,\n      code: 'list-routing-has-no-email-field',\n      message:\n        'This form proposes adding the people who send it to an email list, and it asks for no email address. Add an email field, or route its submissions to the Inbox.',\n      paths: ['routing.kind'],\n    })\n  }\n  return violations\n}\n\n/**\n * The door's check for `extend`, and the draft each admitted tree made: the\n * tree a generation returns is the object its last check saw, so the step\n * writes exactly the draft the contract passed.\n */\nexport function aiFormDraftCheck(identity: {\n  formId: string\n  name: string\n  decisions?: AiFormDecisions\n}): {\n  extend: (tree: AiValidatedTree, answer: Record<string, unknown>) => AiDoctrineViolation[]\n  draftFor: (tree: AiValidatedTree) => AiFormDraft | undefined\n} {\n  const drafts = new WeakMap<AiValidatedTree, AiFormDraft>()\n  return {\n    extend: (tree, answer) => {\n      const draft = aiFormDraft(tree, answer, identity)\n      drafts.set(tree, draft)\n      return aiFormDraftViolations(draft, identity.formId, tree.sourceIds)\n    },\n    draftFor: (tree) => drafts.get(tree),\n  }\n}\n\n/**\n * What a job says when the copy it asked for came back naming the form it\n * was copied FROM (AGL-3024). The contract's own sentence follows it and\n * names the consequence; this one names what to do about it.\n */\nexport const AI_FORM_COPY_UNBOUND_FAILURE =\n  'The copy of that form did not take on an identity of its own, so it is on ' +\n  'the site and not safe to collect with — delete it in Forms and try again.'\n\n/**\n * Whether the copy the platform just wrote is bound to ITSELF, asked of the\n * document rather than of the answer — `null` when it is, and the sentence a\n * person reads when it is not.\n *\n * ## Why a step that generated nothing still has something to check\n *\n * A \"creates X from a copy of Y\" plan reaches no model: the copy IS the\n * output, so there is no answer for the doctrine to refuse and `extend`\n * never runs. That left the one thing a copy can get wrong unasked. A form's\n * design names its own form inside itself, and a copy that kept the source's\n * name files every submission under the source — the console's form page\n * banners exactly this, and the job reported Done beside it.\n *\n * So the check is `checkFormContract`, the SAME function the console's\n * banner and the promotion route ask, run here on the stored copy. Not a\n * second predicate shaped like it: a copy this one passed and that one\n * refused would be a form the job called finished and the console called\n * broken, which is the state this exists to make impossible.\n *\n * Narrowed to `form-id-unbound`, and only that, because it is the one\n * violation duplication CAUSES. Every other code the contract can report —\n * an unnamed field, a consent field the design lost — the copy inherited\n * from a form the site already has and the member chose to copy; refusing\n * those would be refusing to copy a form they can already see.\n */\nexport async function aiFormCopyUnboundFailure(\n  firestore: FirebaseFirestore.Firestore,\n  copy: { hostId: string; formId: string },\n): Promise<string | null> {\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(copy.hostId)\n    .collection('forms')\n    .doc(copy.formId)\n    .get()\n  const form = (snapshot.data() ?? null) as Partial<FormDocument> | null\n  const nodes = decodeStoredNodes(form?.nodes)\n  const unbound = checkFormContract({\n    form,\n    formId: copy.formId,\n    nodes: nodes as never,\n    formNodeId: formNodeIdIn(nodes as never),\n  }).find((violation) => violation.code === 'form-id-unbound')\n  return unbound ? `${AI_FORM_COPY_UNBOUND_FAILURE} ${unbound.message}` : null\n}\n\nfunction listOf(items: readonly string[]): string {\n  return items.length < 2\n    ? items.join('')\n    : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`\n}\n\n/**\n * What the person decides next, in words the step writes itself: a lead\n * routing to keep or switch off, the list a proposal could not store, and what\n * the brief asked for that a form cannot collect. `null` when there is none.\n */\nexport function aiFormOutputNote(answer: AiFormAnswer): string | null {\n  const sentences: string[] = []\n  if (answer.routing.kind === 'lead') {\n    sentences.push(\n      'Each submission with an email address also files a lead in CRM → Leads; you can switch that off on the form’s page.',\n    )\n  }\n  if (answer.routing.kind === 'list') {\n    const list = answer.routing.list ? `your \"${answer.routing.list}\" list` : 'an email list'\n    sentences.push(\n      `Submissions arrive in the Inbox. To add the people who tick \"${MARKETING_CONSENT_FORM_FIELD.label}\" to ${list}, add an action on form submissions in Automation that enrolls them.`,\n    )\n  }\n  if (answer.cannotCollect.length) {\n    sentences.push(\n      `Forms cannot collect ${listOf(answer.cannotCollect)} yet, so this form leaves ${\n        answer.cannotCollect.length === 1 ? 'it' : 'them'\n      } out.`,\n    )\n  }\n  return sentences.length ? sentences.join(' ') : null\n}\n\n/**\n * The form job as the generation's user turn: the name, who fills the form\n * in, the brief, and the confirmed plan.\n *\n * Who the form is for (AGL-2918) is the answer a contact form's FIELDS turn\n * on — a trades business asks where the work is, a practice asks what the\n * appointment is about — and it is not something a brief about a whole site\n * says in a place the form can find. It rides here, in the turn, because it\n * is one site's own words.\n *\n * Where submissions go rides here too, and it is NOT a hint: the step binds\n * the routing to it whatever the model answers. It is stated so the model\n * does not spend its answer proposing something that will be replaced, and\n * so a form told its submissions are leads asks for the address that makes\n * one.\n */\nexport function aiJobFormPrompt(\n  job: Pick<AiJob, 'brief'>,\n  plan: AiJobPlan | null,\n  name: string,\n  context: { audience?: string; submissions?: AiSiteSubmissions | null } = {},\n): string {\n  const audience = (context.audience ?? '').trim()\n  return [\n    `Form name: ${name}`,\n    audience ? `The people who fill it in: ${audience}` : '',\n    context.submissions ? `Where its submissions go: ${SUBMISSION_WORDS[context.submissions]}` : '',\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n  ]\n    .filter(Boolean)\n    .join('\\n')\n}\n\n/** What each decided routing is, said to the model the way the tool says it. */\nconst SUBMISSION_WORDS: Record<AiSiteSubmissions, string> = {\n  inbox: 'the Inbox, to be read — routing.kind is inbox',\n  lead: 'the Inbox, and each one with an email address is a sales lead — routing.kind is lead',\n}\n\n/** A form job is admitted for a site of the job's own org whose plan has forms, with a form to spare. */\nexport const aiFormJobAdmission: AiJobAdmission = (context) =>\n  aiDraftAdmissionRefusal(context.firestore, {\n    orgId: context.orgId,\n    hostId: context.hostId,\n    kind: 'form',\n    org: context.org,\n  })\n\nexport interface AiJobFormStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** The platform's duplicate module, for a plan that starts from a copy. */\n  duplicate?: typeof duplicateResource\n}\n\nexport function createAiJobFormStep(deps: AiJobFormStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a form job names no site, and its admission refuses one')\n    const output = (\n      draft: AiDraftRecord,\n      extra: { load?: AiLoadEstimate | null; note?: string | null } = {},\n    ): AiJobOutput => ({\n      resource: 'form',\n      id: draft.id,\n      versionId: draft.versionId,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(extra.load ? { load: extra.load } : {}),\n      ...(extra.note ? { note: extra.note } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.form') ?? aiModelForStep('job.form')\n\n    // A run cut off after its draft was written reports that draft, found by the id the job recorded.\n    const draftId = aiJobDraftId(job, 'form')\n    const written = await readAiDraft(firestore, { kind: 'form', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n    ])\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'form')\n    const name = creation?.name || AI_JOB_FORM_DEFAULT_NAME\n\n    // The plan starts from a copy of a form the site has (rule 15): the copy\n    // is the draft, and nothing is generated. A source gone since the plan\n    // was made is built from the brief instead.\n    if (creation?.duplicateOf && inventory.forms.some((form) => form.id === creation.duplicateOf)) {\n      const copy = await duplicate('form', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n      })\n      if (copy.ok) {\n        // The copy is the whole output, so the contract is asked of it here\n        // or nowhere: a copy still bound to its source is not a form this\n        // job may report as built (AGL-3024).\n        const unbound = await aiFormCopyUnboundFailure(firestore, { hostId, formId: copy.id })\n        if (unbound) return { ...aiUnspentOutcome(model), failure: unbound }\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: copy.versionId, name: copy.name, hostSubdomain })],\n        })\n      }\n      if (copy.ok === false && copy.status === 403) {\n        return aiUnspentOutcome(model, { review: aiLimitReview(copy.error) })\n      }\n    }\n\n    const allowance = await aiDraftAllowanceRefusal(firestore, { kind: 'form', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    // What the person answered about this form, where they were asked\n    // (AGL-2918): a scaffold's form unit carries the guided start's inputs.\n    const decisions: AiFormDecisions = { submissions: aiSiteSubmissions(job.inputs) }\n    const { audience } = aiSiteWords(job.inputs)\n    const check = aiFormDraftCheck({ formId: draftId, name, decisions })\n    const result = await runValidatedGeneration('form', {\n      step: 'job.form',\n      model,\n      instructions: AI_JOB_FORM_INSTRUCTIONS,\n      inventory,\n      messages: [\n        {\n          role: 'user',\n          content: aiJobFormPrompt(job, plan, name, {\n            audience,\n            submissions: decisions.submissions,\n          }),\n        },\n      ],\n      tool: AI_JOB_FORM_TOOL,\n      maxTokens: AI_JOB_FORM_STEP_BUDGET.maxTokens(model),\n      thinking: 'off',\n      extend: check.extend,\n      ...(signal ? { signal } : {}),\n    })\n    const spent = aiGenerationSpent(result)\n    if (result.status === 'refused') return { ...spent, refused: true }\n    if (result.status === 'needs_input') return { ...spent, review: aiDoctrineReview(result) }\n\n    const draft = check.draftFor(result.value)\n    if (!draft) throw new Error('a form the doctrine admitted has no draft from its check')\n    const write = await writeAiDraft(firestore, {\n      kind: 'form',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: draft.nodes,\n      form: {\n        rootId: draft.rootId,\n        formNodeId: draft.formNodeId,\n        fields: draft.fields,\n        consentFieldName: draft.consentFieldName,\n        routing: draft.routing,\n      },\n      now,\n    })\n    if (write.ok === false) {\n      if (write.status === 404) throw new Error(`site ${hostId} vanished while its form was generated`)\n      return { ...spent, review: aiLimitReview(write.error) }\n    }\n    // What the person decides next, then the facts the brief did not give (AGL-3056).\n    const note = [\n      aiFormOutputNote(draft.answer),\n      aiBracketedFactsNote({\n        tree: { rootId: result.value.rootId, nodes: result.value.nodes as unknown as AiDoctrineTree['nodes'] },\n        inventory,\n      }),\n    ]\n      .filter(Boolean)\n      .join(' ')\n    return {\n      ...spent,\n      outputs: [output(write, { load: result.value.load, note })],\n    }\n  }\n}\n\nexport const runAiJobFormStep = createAiJobFormStep()\n\n/** Registers the form step and the check a form job passes before it is created or resumed. */\nexport function registerAiFormJob(): void {\n  registerAiJobStep('form', runAiJobFormStep, { minimumMs: AI_JOB_FORM_STEP_MINIMUM_MS })\n  registerAiJobAdmission('form', aiFormJobAdmission)\n}\n"],"names":["checkFormContract","formFieldsCanYieldAnEmail","collectFormFieldNodeIds","FORM_COMPONENT_ID","FORM_FIELD_COMPONENT_ID","FORM_ID_PROP","formFieldDeclsFromNodes","formNodeIdIn","isMarketingConsentFieldName","MARKETING_CONSENT_FORM_FIELD","decodeStoredNodes","CANVAS_ROOT_ELEMENT_ID","NodeType","duplicateResource","aiSiteSubmissions","aiSiteWords","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","AI_PALETTE","readSiteInventory","registerAiJobAdmission","aiJobDraftId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","writeAiDraft","aiBracketedFactsNote","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlanCreation","aiPlanReferenceLines","aiUnspentOutcome","aiJobStepBudget","registerAiJobStep","AI_JOB_FORM_MAX_TOKENS","maxTokens","AI_JOB_FORM_STEP_BUDGET","tier","AI_JOB_FORM_STEP_MINIMUM_MS","minimumMs","AI_JOB_FORM_DEFAULT_NAME","AI_FORM_ROUTING_KINDS","AI_FORM_CANNOT_COLLECT_MAX","CANNOT_COLLECT_MAX_CHARS","LIST_NAME_MAX_CHARS","AI_FORM_CONSENT_NODE_ID","AI_JOB_FORM_INSTRUCTIONS","text","join","TREE_TOOL","AI_JOB_FORM_TOOL","name","description","strict","inputSchema","type","additionalProperties","required","properties","tree","routing","kind","enum","list","anyOf","cannotCollect","items","isRecord","value","Array","isArray","oneLine","max","replace","trim","slice","parseAiFormAnswer","answer","decisions","submissions","proposed","includes","seen","Set","entry","has","toLowerCase","add","push","length","aiFormDraft","identity","parsed","formNodeId","rootId","nodes","id","node","Object","entries","props","form","consentFieldName","componentId","formId","fieldName","parent","String","parentId","filter","child","$id","NODE","pluginId","fields","lead","aiFormDraftViolations","draft","sourceIds","violations","map","violation","rule","code","message","nodeId","nodeIds","paths","aiFormDraftCheck","drafts","WeakMap","extend","set","draftFor","get","AI_FORM_COPY_UNBOUND_FAILURE","aiFormCopyUnboundFailure","firestore","copy","snapshot","collection","doc","hostId","data","unbound","find","listOf","aiFormOutputNote","sentences","label","aiJobFormPrompt","job","plan","context","audience","SUBMISSION_WORDS","Boolean","inbox","aiFormJobAdmission","orgId","org","createAiJobFormStep","deps","readInventory","duplicate","now","signal","modelFor","orgSnapshot","Error","output","extra","resource","versionId","hostSubdomain","load","note","model","draftId","written","outputs","inventory","Promise","all","creation","duplicateOf","forms","some","sourceId","uid","createdBy","ok","failure","status","review","error","allowance","inputs","check","result","step","instructions","messages","role","content","tool","thinking","spent","refused","write","runAiJobFormStep","registerAiFormJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-generation.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @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 { AiBuildPlanCreate, AiBuildPlanCreateKind } from '../model/ai-build-plan';
+import type { AiJob, AiJobOutput, AiJobPlan, AiJobReview, AiJobReviewOutlineNode } from '../model/ai-jobs.types';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+import { type AiGenerationSpend, type AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineTree, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AssistTokenUsage } from '../usage/assist-usage';
+import { type AiJobStepOutcome } from './ai-job-text-step';
+/**
+ * What the generation steps share (AGL-2909): reading the plan a member
+ * confirmed, stating it to the model as references, and turning what a
+ * generation spent or refused into the outcome the machine records.
+ *
+ * A generation step runs after its job's plan step, once a member confirmed
+ * the plan, so the plan is part of what it executes: the records it reuses,
+ * and the creation it builds. The plan travels as references — ids, names,
+ * reasons — never as a document (AGL-2937).
+ */
+export declare const AI_JOB_ZERO_USAGE: AssistTokenUsage;
+/** The job's plan once a member confirmed it; `null` before that, or for a job that never planned. */
+export declare function aiConfirmedPlan(job: Pick<AiJob, 'plan'>): AiJobPlan | null;
+/** The creation of one kind the plan names; the first when it names several. */
+export declare function aiPlanCreation(plan: AiJobPlan | null, kind: AiBuildPlanCreateKind): AiBuildPlanCreate | null;
+/** The user turn's opening: the brief, cut at the ceiling every job step keeps. */
+export declare function aiJobBriefLine(job: Pick<AiJob, 'brief'>): string;
+/** The confirmed plan as reference lines; none when there is no confirmed plan. */
+export declare function aiPlanReferenceLines(plan: AiJobPlan | null): string[];
+/** The reusable components a tree places, by the id each instance names. */
+export declare function aiPlacedComponentIds(tree: Pick<AiValidatedTree, 'rootId' | 'nodes'>): Set<string>;
+/**
+ * Rule 7 on a generated tree: every component the confirmed plan reuses is
+ * placed. `noun` names what the tree builds, in the finding.
+ */
+export declare function aiPlanReuseViolations(inventory: AiSiteInventory | null, plan: AiJobPlan | null, placed: ReadonlySet<string>, noun: string): AiDoctrineViolation[];
+/** What a generation spent, as the step's outcome carries it for the meter. */
+export declare function aiGenerationSpent(spend: AiGenerationSpend): Pick<AiJobStepOutcome, 'outputs' | 'usage' | 'estCostUsd' | 'model' | 'stopReason'>;
+/** The most node ids, or plan paths, one finding keeps on its review (AGL-3078). */
+export declare const AI_JOB_REVIEW_REFS_MAX = 24;
+/** The longest node id or plan path a review keeps, in characters. */
+export declare const AI_JOB_REVIEW_REF_MAX_CHARS = 64;
+/** How far below a node a finding names its outline goes: the node, its children and theirs. */
+export declare const AI_JOB_REVIEW_OUTLINE_MAX_DEPTH = 2;
+/** The most nodes a review outlines, across all its findings. */
+export declare const AI_JOB_REVIEW_OUTLINE_MAX_NODES = 40;
+/** The most names an outlined node lists of its props, of its sx keys, or of its children. */
+export declare const AI_JOB_REVIEW_OUTLINE_MAX_NAMES = 16;
+/** The most bytes a review's outline takes as JSON, whatever the counts above allow. */
+export declare const AI_JOB_REVIEW_OUTLINE_MAX_BYTES = 4096;
+/**
+ * The parts of a refused answer its findings name, as a review keeps them
+ * (AGL-3078): each node a finding names by id, with the nodes below it to
+ * `AI_JOB_REVIEW_OUTLINE_MAX_DEPTH`, in document order and each once. A node
+ * keeps its id, its element, the names of its props and sx keys and its
+ * children's elements, and a Grid the values of its layout props as written;
+ * no copy, and no address, is kept. The outline stops at
+ * `AI_JOB_REVIEW_OUTLINE_MAX_NODES` nodes or `AI_JOB_REVIEW_OUTLINE_MAX_BYTES`
+ * bytes, whichever comes first. An answer that is no node map, and findings
+ * that name no node, outline nothing.
+ */
+export declare function aiDoctrineReviewOutline(answer: Record<string, unknown> | null | undefined, violations: readonly AiDoctrineViolation[]): AiJobReviewOutlineNode[];
+/**
+ * The review a generation stops its job for when the re-ask still broke a
+ * rule: the sentence a person reads, each finding with the nodes or plan
+ * entries it names, and an outline of those parts of the answer it was found
+ * in (AGL-3078), so why a job stopped can be read back from the job once the
+ * answer itself is gone.
+ */
+export declare function aiDoctrineReview(result: {
+    message: string;
+    violations: readonly AiDoctrineViolation[];
+    /** The refused answer, whose nodes the findings name by id; outlined, never kept. */
+    answer?: Record<string, unknown> | null;
+}): AiJobReview;
+/** The review a step stops its job for when the site cannot take the draft. */
+export declare function aiLimitReview(message: string): AiJobReview;
+/**
+ * An outcome that reached no model: a draft an earlier run already wrote, a
+ * copy the plan asked for, or a person asked before anything was spent.
+ */
+export declare function aiUnspentOutcome(model: string, rest?: {
+    outputs?: AiJobOutput[];
+    review?: AiJobReview;
+}): AiJobStepOutcome;
+/** Node ids as the MODEL wrote them, from the minted ids a check reads. */
+export declare function aiModelNodeIds(ids: readonly string[], sourceIds: Readonly<Record<string, string>>): string[];
+/**
+ * What a draft asks the member to fill in before it is published (AGL-3056),
+ * in the words the job's output note shows: the facts in square brackets its
+ * copy holds, which the brief did not give (rule 14), each once. A page's
+ * placed components show their own defaults wherever the page sets no value
+ * of its own, so a component whose defaults hold such facts is named once,
+ * however often the page places it. `copy` is what the draft shows beside its
+ * tree, such as a component's defaults. `null` when there is nothing to fill.
+ */
+export declare function aiBracketedFactsNote(input: {
+    tree: AiDoctrineTree;
+    inventory: AiSiteInventory | null;
+    copy?: readonly string[];
+}): string | null;

package/src/lib/jobs/ai-job-generation.js

@@ -0,0 +1,384 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { REUSABLE_INSTANCE_COMPONENT_ID, REUSABLE_INSTANCE_PROP_VALUES_KEY } from "@aglyn/aglyn/app-utils/reusable-component-keys";
+import { aiAnswerTree } from "../runtime/ai-doctrine.js";
+import { aiBracketedFacts, aiTreeCopy, walkTree } from "../runtime/ai-doctrine-validators.js";
+import { AI_INSTANCE_REF_PROP } from "../runtime/ai-node-tree.js";
+import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
+/**
+ * What the generation steps share (AGL-2909): reading the plan a member
+ * confirmed, stating it to the model as references, and turning what a
+ * generation spent or refused into the outcome the machine records.
+ *
+ * A generation step runs after its job's plan step, once a member confirmed
+ * the plan, so the plan is part of what it executes: the records it reuses,
+ * and the creation it builds. The plan travels as references — ids, names,
+ * reasons — never as a document (AGL-2937).
+ */ export const AI_JOB_ZERO_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0
+};
+/** The job's plan once a member confirmed it; `null` before that, or for a job that never planned. */ export function aiConfirmedPlan(job) {
+    var _job_plan;
+    return ((_job_plan = job.plan) == null ? void 0 : _job_plan.status) === 'confirmed' ? job.plan : null;
+}
+/** The creation of one kind the plan names; the first when it names several. */ export function aiPlanCreation(plan, kind) {
+    var _ref;
+    return (_ref = plan == null ? void 0 : plan.create.find((entry)=>entry.kind === kind)) != null ? _ref : null;
+}
+/** A plan reference as the model reads it: the id with the name it was planned under. */ function referenceOf(plan, ref) {
+    var _plan_labels;
+    const label = (_plan_labels = plan.labels) == null ? void 0 : _plan_labels[ref];
+    return label ? `${ref} ("${label}")` : ref;
+}
+/** The user turn's opening: the brief, cut at the ceiling every job step keeps. */ export function aiJobBriefLine(job) {
+    return `Brief: ${job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`;
+}
+/** The confirmed plan as reference lines; none when there is no confirmed plan. */ export function aiPlanReferenceLines(plan) {
+    if (!plan) return [];
+    const lines = [
+        'Confirmed plan:'
+    ];
+    for (const entry of plan.reuse){
+        lines.push(`- reuse the ${entry.kind} ${referenceOf(plan, entry.id)}: ${entry.purpose}`);
+    }
+    for (const entry of plan.create){
+        const from = entry.duplicateOf ? `, from a copy of ${referenceOf(plan, entry.duplicateOf)}` : '';
+        const fields = entry.fields.length ? ` Fields: ${entry.fields.join(', ')}.` : '';
+        lines.push(`- create the ${entry.kind} "${entry.name}"${from}: ${entry.why}${fields}`);
+    }
+    for (const screen of plan.screens){
+        const sections = screen.sections.map((section)=>section.name).join(', ');
+        lines.push(`- the screen "${screen.title}" at ${screen.slug}${sections ? `: ${sections}` : ''}`);
+    }
+    return lines.length > 1 ? lines : [];
+}
+/** The reusable components a tree places, by the id each instance names. */ export function aiPlacedComponentIds(tree) {
+    const placed = new Set();
+    const nodes = tree.nodes;
+    for (const { node } of walkTree({
+        rootId: tree.rootId,
+        nodes
+    })){
+        var _node_props;
+        const ref = (_node_props = node.props) == null ? void 0 : _node_props[AI_INSTANCE_REF_PROP];
+        if (node.componentId === REUSABLE_INSTANCE_COMPONENT_ID && typeof ref === 'string') {
+            placed.add(ref);
+        }
+    }
+    return placed;
+}
+/**
+ * Rule 7 on a generated tree: every component the confirmed plan reuses is
+ * placed. `noun` names what the tree builds, in the finding.
+ */ export function aiPlanReuseViolations(inventory, plan, placed, noun) {
+    var _ref, _ref1;
+    const names = new Map(((_ref = inventory == null ? void 0 : inventory.components) != null ? _ref : []).map((component)=>[
+            component.id,
+            component.name
+        ]));
+    const reused = [
+        ...new Set(((_ref1 = plan == null ? void 0 : plan.reuse) != null ? _ref1 : []).filter((entry)=>entry.kind === 'component').map((entry)=>entry.id))
+    ];
+    const missing = reused.filter((id)=>!placed.has(id));
+    if (!missing.length) return [];
+    const listed = missing.map((id)=>{
+        var _names_get;
+        return `"${(_names_get = names.get(id)) != null ? _names_get : id}"`;
+    }).join(', ');
+    return [
+        {
+            rule: 7,
+            code: 'plan-reuse-not-placed',
+            message: `The confirmed plan reuses ${listed}, and the ${noun} does not place ${missing.length === 1 ? 'it' : 'them'}. Place every component the plan reuses.`
+        }
+    ];
+}
+/** What a generation spent, as the step's outcome carries it for the meter. */ export function aiGenerationSpent(spend) {
+    return {
+        outputs: [],
+        usage: spend.usage,
+        estCostUsd: spend.estCostUsd,
+        model: spend.model,
+        stopReason: spend.stopReason
+    };
+}
+/** The most node ids, or plan paths, one finding keeps on its review (AGL-3078). */ export const AI_JOB_REVIEW_REFS_MAX = 24;
+/** The longest node id or plan path a review keeps, in characters. */ export const AI_JOB_REVIEW_REF_MAX_CHARS = 64;
+/** How far below a node a finding names its outline goes: the node, its children and theirs. */ export const AI_JOB_REVIEW_OUTLINE_MAX_DEPTH = 2;
+/** The most nodes a review outlines, across all its findings. */ export const AI_JOB_REVIEW_OUTLINE_MAX_NODES = 40;
+/** The most names an outlined node lists of its props, of its sx keys, or of its children. */ export const AI_JOB_REVIEW_OUTLINE_MAX_NAMES = 16;
+/** The most bytes a review's outline takes as JSON, whatever the counts above allow. */ export const AI_JOB_REVIEW_OUTLINE_MAX_BYTES = 4096;
+/** A Grid's layout props, whose written values an outline keeps. */ const AI_JOB_REVIEW_GRID_PROPS = [
+    'container',
+    'size',
+    'offset',
+    'direction',
+    'wrap',
+    'spacing',
+    'rowSpacing',
+    'columnSpacing',
+    'columns'
+];
+/** A node id or plan path a review keeps: no whitespace, slash or quote, so never copy or an address. */ const REVIEW_REF = /^[^\s/\\"'<>]+$/;
+/** An element id an outline names. */ const OUTLINE_ELEMENT = /^[\w.-]{1,64}$/;
+/** A prop or sx name an outline lists. */ const OUTLINE_NAME = /^[A-Za-z_$][\w$-]{0,39}$/;
+/** The longest layout value an outline keeps as written. */ const OUTLINE_VALUE_MAX_CHARS = 40;
+/**
+ * The words a Grid's layout is written in, besides numbers: breakpoints, span
+ * words, switch words, directions and wraps. Nothing else is kept, so no copy is.
+ */ const OUTLINE_LAYOUT_WORDS = new Set([
+    'xs',
+    'sm',
+    'md',
+    'lg',
+    'xl',
+    'auto',
+    'grow',
+    'true',
+    'false',
+    'yes',
+    'no',
+    'on',
+    'off',
+    'row',
+    'row-reverse',
+    'column',
+    'column-reverse',
+    'wrap',
+    'nowrap',
+    'wrap-reverse'
+]);
+/** A number a layout value is written in, with a CSS length unit where it has one. */ const OUTLINE_LAYOUT_NUMBER = /^[-+]?(?:\d+(?:\.\d+)?|\.\d+)(?:px|rem|em|%)?$/i;
+/** What stands between the words of a layout value, as in `xs:12 md:4` or `{ xs: 12, md: 4 }`. */ const OUTLINE_LAYOUT_SEPARATORS = /[\s,:;=/{}()[\]"']+/;
+/** A binding token, which a component's Grid may carry for a layout value. */ const OUTLINE_BINDING = /^\{\{\s*[\w.-]+\s*\}\}$/;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Whether text is a layout value: a binding token, or only layout words and numbers. */ function isLayoutText(value) {
+    if (value.length > OUTLINE_VALUE_MAX_CHARS) return false;
+    if (OUTLINE_BINDING.test(value.trim())) return true;
+    return value.split(OUTLINE_LAYOUT_SEPARATORS).every((word)=>word === '' || OUTLINE_LAYOUT_WORDS.has(word.toLowerCase()) || OUTLINE_LAYOUT_NUMBER.test(word));
+}
+/** An id or a path as a review keeps it: cut to its ceiling, and `?` for one it cannot show. */ function reviewRef(ref) {
+    const cut = ref.slice(0, AI_JOB_REVIEW_REF_MAX_CHARS);
+    return REVIEW_REF.test(cut) ? cut : '?';
+}
+function reviewRefs(refs) {
+    return refs.slice(0, AI_JOB_REVIEW_REFS_MAX).map(reviewRef);
+}
+/** A written layout value as an outline keeps it; text that is no layout value is kept as a marker. */ function outlineValue(value) {
+    if (value === null) return null;
+    if (typeof value === 'boolean') return value;
+    if (typeof value === 'number') return Number.isFinite(value) ? value : null;
+    if (typeof value === 'string') return isLayoutText(value) ? value : '<text>';
+    return Array.isArray(value) ? '<list>' : '<object>';
+}
+function childIdsOf(node) {
+    return Array.isArray(node['nodes']) ? node['nodes'].filter((child)=>typeof child === 'string') : [];
+}
+function elementOf(node) {
+    const componentId = isRecord(node) ? node['componentId'] : undefined;
+    return typeof componentId === 'string' && OUTLINE_ELEMENT.test(componentId) ? componentId : '?';
+}
+/** One node of an outline: where it sits, what it is and the names of what it sets, never a copy value. */ function outlineNodeOf(id, depth, node, nodes) {
+    const props = isRecord(node['props']) ? node['props'] : {};
+    const sx = isRecord(node['sx']) ? node['sx'] : isRecord(props['sx']) ? props['sx'] : {};
+    const names = (keys)=>keys.filter((key)=>OUTLINE_NAME.test(key)).slice(0, AI_JOB_REVIEW_OUTLINE_MAX_NAMES);
+    const componentId = elementOf(node);
+    const grid = componentId === 'muiGrid' ? Object.fromEntries(AI_JOB_REVIEW_GRID_PROPS.filter((name)=>props[name] !== undefined).map((name)=>[
+            name,
+            outlineValue(props[name])
+        ])) : {};
+    const sxNames = names(Object.keys(sx));
+    return _extends({
+        id: reviewRef(id),
+        depth,
+        componentId,
+        props: names(Object.keys(props).filter((key)=>key !== 'sx'))
+    }, sxNames.length ? {
+        sx: sxNames
+    } : {}, Object.keys(grid).length ? {
+        grid
+    } : {}, {
+        children: childIdsOf(node).filter((child)=>isRecord(nodes[child])).slice(0, AI_JOB_REVIEW_OUTLINE_MAX_NAMES).map((child)=>elementOf(nodes[child]))
+    });
+}
+/**
+ * The parts of a refused answer its findings name, as a review keeps them
+ * (AGL-3078): each node a finding names by id, with the nodes below it to
+ * `AI_JOB_REVIEW_OUTLINE_MAX_DEPTH`, in document order and each once. A node
+ * keeps its id, its element, the names of its props and sx keys and its
+ * children's elements, and a Grid the values of its layout props as written;
+ * no copy, and no address, is kept. The outline stops at
+ * `AI_JOB_REVIEW_OUTLINE_MAX_NODES` nodes or `AI_JOB_REVIEW_OUTLINE_MAX_BYTES`
+ * bytes, whichever comes first. An answer that is no node map, and findings
+ * that name no node, outline nothing.
+ */ export function aiDoctrineReviewOutline(answer, violations) {
+    const outline = [];
+    const tree = answer ? aiAnswerTree(answer) : null;
+    const nodes = isRecord(tree) && isRecord(tree['nodes']) ? tree['nodes'] : null;
+    if (!nodes) return outline;
+    const encoder = new TextEncoder();
+    const seen = new Set();
+    let bytes = 2;
+    // False once the outline is full, which ends the walk.
+    const add = (id, depth)=>{
+        const node = nodes[id];
+        if (seen.has(id) || !isRecord(node)) return true;
+        seen.add(id);
+        const entry = outlineNodeOf(id, depth, node, nodes);
+        const size = encoder.encode(JSON.stringify(entry)).length + 1;
+        if (outline.length === AI_JOB_REVIEW_OUTLINE_MAX_NODES || bytes + size > AI_JOB_REVIEW_OUTLINE_MAX_BYTES) {
+            return false;
+        }
+        outline.push(entry);
+        bytes += size;
+        return depth === AI_JOB_REVIEW_OUTLINE_MAX_DEPTH || childIdsOf(node).every((child)=>add(child, depth + 1));
+    };
+    const named = violations.flatMap((violation)=>{
+        var _violation_nodeIds;
+        return ((_violation_nodeIds = violation.nodeIds) != null ? _violation_nodeIds : []).slice(0, AI_JOB_REVIEW_REFS_MAX);
+    });
+    for (const id of new Set(named)){
+        if (!add(id, 0)) break;
+    }
+    return outline;
+}
+/**
+ * The review a generation stops its job for when the re-ask still broke a
+ * rule: the sentence a person reads, each finding with the nodes or plan
+ * entries it names, and an outline of those parts of the answer it was found
+ * in (AGL-3078), so why a job stopped can be read back from the job once the
+ * answer itself is gone.
+ */ export function aiDoctrineReview(result) {
+    const outline = aiDoctrineReviewOutline(result.answer, result.violations);
+    return _extends({
+        reason: 'doctrine',
+        message: result.message,
+        findings: result.violations.map(({ rule, code, message, nodeIds, paths })=>_extends({
+                rule,
+                code,
+                message
+            }, (nodeIds == null ? void 0 : nodeIds.length) ? {
+                nodeIds: reviewRefs(nodeIds)
+            } : {}, (paths == null ? void 0 : paths.length) ? {
+                paths: reviewRefs(paths)
+            } : {}))
+    }, outline.length ? {
+        outline
+    } : {});
+}
+/** The review a step stops its job for when the site cannot take the draft. */ export function aiLimitReview(message) {
+    return {
+        reason: 'limit',
+        message,
+        findings: []
+    };
+}
+/**
+ * An outcome that reached no model: a draft an earlier run already wrote, a
+ * copy the plan asked for, or a person asked before anything was spent.
+ */ export function aiUnspentOutcome(model, rest = {}) {
+    var _rest_outputs;
+    return _extends({
+        outputs: (_rest_outputs = rest.outputs) != null ? _rest_outputs : [],
+        usage: AI_JOB_ZERO_USAGE,
+        estCostUsd: 0,
+        model,
+        stopReason: null
+    }, rest.review ? {
+        review: rest.review
+    } : {});
+}
+/** Node ids as the MODEL wrote them, from the minted ids a check reads. */ export function aiModelNodeIds(ids, sourceIds) {
+    return ids.map((id)=>{
+        var _sourceIds_id;
+        return (_sourceIds_id = sourceIds[id]) != null ? _sourceIds_id : id;
+    });
+}
+/** The most facts a note names before it counts the rest. */ const AI_NOTE_MAX_FACTS = 8;
+/** Facts as a sentence lists them: "a, b and c", the ones past the cap counted. */ function factList(facts) {
+    const shown = facts.slice(0, AI_NOTE_MAX_FACTS);
+    const items = facts.length > shown.length ? [
+        ...shown,
+        `${facts.length - shown.length} more`
+    ] : shown;
+    return items.length <= 1 ? items.join('') : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`;
+}
+/**
+ * What a draft asks the member to fill in before it is published (AGL-3056),
+ * in the words the job's output note shows: the facts in square brackets its
+ * copy holds, which the brief did not give (rule 14), each once. A page's
+ * placed components show their own defaults wherever the page sets no value
+ * of its own, so a component whose defaults hold such facts is named once,
+ * however often the page places it. `copy` is what the draft shows beside its
+ * tree, such as a component's defaults. `null` when there is nothing to fill.
+ */ export function aiBracketedFactsNote(input) {
+    var _ref, _input_copy;
+    var _input_inventory;
+    const components = (_ref = (_input_inventory = input.inventory) == null ? void 0 : _input_inventory.components) != null ? _ref : [];
+    const componentProps = Object.fromEntries(components.map((component)=>[
+            component.id,
+            component.props
+        ]));
+    const facts = aiBracketedFacts([
+        ...aiTreeCopy(input.tree, {
+            componentProps
+        }).map((sample)=>sample.text),
+        ...(_input_copy = input.copy) != null ? _input_copy : []
+    ]);
+    const listed = new Set(facts.map((fact)=>fact.toLowerCase()));
+    const byComponent = new Map();
+    for (const { node } of walkTree(input.tree)){
+        var _byComponent_get;
+        var _node_props;
+        const component = components.find((row)=>{
+            var _node_props;
+            return row.id === ((_node_props = node.props) == null ? void 0 : _node_props[AI_INSTANCE_REF_PROP]);
+        });
+        if (node.componentId !== REUSABLE_INSTANCE_COMPONENT_ID || !(component == null ? void 0 : component.bracketedDefaults)) continue;
+        const values = (_node_props = node.props) == null ? void 0 : _node_props[REUSABLE_INSTANCE_PROP_VALUES_KEY];
+        const set = (name)=>{
+            const value = values && typeof values === 'object' ? values[name] : undefined;
+            return value !== undefined && value !== null && String(value).trim() !== '';
+        };
+        const shown = (_byComponent_get = byComponent.get(component.name)) != null ? _byComponent_get : [];
+        for (const [name, defaults] of Object.entries(component.bracketedDefaults)){
+            if (set(name)) continue;
+            for (const fact of defaults){
+                if (!listed.has(fact.toLowerCase()) && !shown.some((known)=>known.toLowerCase() === fact.toLowerCase())) {
+                    shown.push(fact);
+                }
+            }
+        }
+        if (shown.length) byComponent.set(component.name, shown);
+    }
+    const sentences = [
+        ...facts.length ? [
+            `Before you publish, replace the facts in square brackets, which the brief did not give: ${factList(facts)}.`
+        ] : [],
+        ...[
+            ...byComponent.entries()
+        ].map(([name, shown])=>`The "${name}" component on this page shows ${factList(shown)} until you replace ${shown.length === 1 ? 'it' : 'them'}.`)
+    ];
+    return sentences.length ? sentences.join(' ') : null;
+}
+
+//# sourceMappingURL=ai-job-generation.js.map