@aglyn/plugins-ai 1.0.0-beta.152 → 1.0.0-beta.154

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

@@ -17,7 +17,7 @@
 import { type FormFieldDecl, type FormRouting } from '@aglyn/aglyn/app-utils/forms';
 import { type NodesMap } from '@aglyn/aglyn/types/nodes';
 import { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource';
-import type { AiJob, AiJobPlan } from '../model/ai-jobs.types';
+import type { AiJob, AiJobPlan, AiJobReview } from '../model/ai-jobs.types';
 import { type AiSiteSubmissions } from '../model/ai-site-job';
 import { type AiValidatedTree } from '../runtime/ai-doctrine';
 import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
@@ -210,6 +210,27 @@ export declare function aiFormCopyUnboundFailure(firestore: FirebaseFirestore.Fi
     hostId: string;
     formId: string;
 }): Promise<string | null>;
+/**
+ * The fields the confirmed plan gives the form, against the form a COPY
+ * actually produced (AGL-3024); `null` when the copy keeps the plan, or when
+ * the plan promised no field to keep.
+ *
+ * The fourth kind to need this, after the layout, the page and the component.
+ * `aiFormCopyUnboundFailure` above already refuses the one violation
+ * duplication CAUSES; this refuses the one duplication HIDES — a plan reading
+ * "start from the consultation form and add a case-type question" getting the
+ * consultation form and nothing else, reported as built.
+ *
+ * A field the plan names is matched on its name alone: a copy that collects
+ * the answer under a different label is still collecting it, and this check
+ * has no way to tell a renamed field from a missing one without guessing.
+ */
+export declare function aiCopiedFormReview(firestore: FirebaseFirestore.Firestore, input: {
+    hostId: string;
+    formId: string;
+    name: string;
+    plan: AiJobPlan | null;
+}): Promise<AiJobReview | null>;
 /**
  * What the person decides next, in words the step writes itself: a lead
  * routing to keep or switch off, the list a proposal could not store, and what

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

@@ -388,6 +388,57 @@ function oneLine(value, max) {
     }).find((violation)=>violation.code === 'form-id-unbound');
     return unbound ? `${AI_FORM_COPY_UNBOUND_FAILURE} ${unbound.message}` : null;
 }
+/**
+ * The fields the confirmed plan gives the form, against the form a COPY
+ * actually produced (AGL-3024); `null` when the copy keeps the plan, or when
+ * the plan promised no field to keep.
+ *
+ * The fourth kind to need this, after the layout, the page and the component.
+ * `aiFormCopyUnboundFailure` above already refuses the one violation
+ * duplication CAUSES; this refuses the one duplication HIDES — a plan reading
+ * "start from the consultation form and add a case-type question" getting the
+ * consultation form and nothing else, reported as built.
+ *
+ * A field the plan names is matched on its name alone: a copy that collects
+ * the answer under a different label is still collecting it, and this check
+ * has no way to tell a renamed field from a missing one without guessing.
+ */ export async function aiCopiedFormReview(firestore, input) {
+    var _ref, _snapshot_get;
+    var _aiPlanCreation;
+    const promised = ((_ref = (_aiPlanCreation = aiPlanCreation(input.plan, 'form')) == null ? void 0 : _aiPlanCreation.fields) != null ? _ref : []).map((field)=>{
+        var _field_split_;
+        return (_field_split_ = field.split(':')[0]) == null ? void 0 : _field_split_.trim().toLowerCase();
+    }).filter((field)=>Boolean(field));
+    if (!promised.length) return null;
+    const snapshot = await firestore.collection('hosts').doc(input.hostId).collection('forms').doc(input.formId).get();
+    if (!snapshot.exists) {
+        return {
+            reason: 'doctrine',
+            message: `"${input.name}" was copied from the form the plan names, and this job could not read the copy back to check it collects what the plan gives it. Open the form and check it before you put it on a page.`,
+            findings: []
+        };
+    }
+    const fields = (_snapshot_get = snapshot.get('fields')) != null ? _snapshot_get : [];
+    const collected = new Set(fields.map((field)=>{
+        var _ref, _field_fieldName;
+        return field && typeof field === 'object' ? String((_ref = (_field_fieldName = field['fieldName']) != null ? _field_fieldName : field['name']) != null ? _ref : '') : '';
+    }).filter(Boolean).map((name)=>name.toLowerCase()));
+    const missing = promised.filter((name)=>!collected.has(name));
+    if (!missing.length) return null;
+    const one = missing.length === 1;
+    return aiDoctrineReview({
+        message: `"${input.name}" is a copy of the form the plan names, and a copy is all it is: the plan gives it ${one ? 'a field' : 'fields'} the copy does not collect.`,
+        violations: [
+            {
+                rule: null,
+                code: 'plan-fields-missing',
+                message: `The confirmed plan says this form collects ${missing.join(', ')}, and the copy collects ${collected.size ? [
+                    ...collected
+                ].join(', ') : 'nothing'}. Add ${one ? 'it' : 'each of them'}, or the copy is the form it was copied from.`
+            }
+        ]
+    });
+}
 function listOf(items) {
     return items.length < 2 ? items.join('') : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`;
 }
@@ -518,6 +569,18 @@ export function createAiJobFormStep(deps = {}) {
                     failure: unbound
                 });
                 const hostSubdomain = await aiSiteSubdomain(firestore, hostId);
+                // And the one duplication hides: what the plan promised of the copy,
+                // read back (AGL-3024). This branch generates nothing, so nothing
+                // else can answer for it.
+                const review = await aiCopiedFormReview(firestore, {
+                    hostId,
+                    formId: copy.id,
+                    name: copy.name,
+                    plan
+                });
+                if (review) return aiUnspentOutcome(model, {
+                    review
+                });
                 return aiUnspentOutcome(model, {
                     outputs: [
                         output({

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

@@ -1 +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        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\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","attemptKey","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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"}
+{"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, AiJobReview } 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\n/**\n * The fields the confirmed plan gives the form, against the form a COPY\n * actually produced (AGL-3024); `null` when the copy keeps the plan, or when\n * the plan promised no field to keep.\n *\n * The fourth kind to need this, after the layout, the page and the component.\n * `aiFormCopyUnboundFailure` above already refuses the one violation\n * duplication CAUSES; this refuses the one duplication HIDES — a plan reading\n * \"start from the consultation form and add a case-type question\" getting the\n * consultation form and nothing else, reported as built.\n *\n * A field the plan names is matched on its name alone: a copy that collects\n * the answer under a different label is still collecting it, and this check\n * has no way to tell a renamed field from a missing one without guessing.\n */\nexport async function aiCopiedFormReview(\n  firestore: FirebaseFirestore.Firestore,\n  input: { hostId: string; formId: string; name: string; plan: AiJobPlan | null },\n): Promise<AiJobReview | null> {\n  const promised = (aiPlanCreation(input.plan, 'form')?.fields ?? [])\n    .map((field) => field.split(':')[0]?.trim().toLowerCase())\n    .filter((field): field is string => Boolean(field))\n  if (!promised.length) return null\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(input.hostId)\n    .collection('forms')\n    .doc(input.formId)\n    .get()\n  if (!snapshot.exists) {\n    return {\n      reason: 'doctrine',\n      message: `\"${input.name}\" was copied from the form the plan names, and this job could not read the copy back to check it collects what the plan gives it. Open the form and check it before you put it on a page.`,\n      findings: [],\n    }\n  }\n  const fields = (snapshot.get('fields') ?? []) as unknown[]\n  const collected = new Set(\n    fields\n      .map((field) =>\n        field && typeof field === 'object'\n          ? String((field as Record<string, unknown>)['fieldName'] ?? (field as Record<string, unknown>)['name'] ?? '')\n          : '',\n      )\n      .filter(Boolean)\n      .map((name) => name.toLowerCase()),\n  )\n  const missing = promised.filter((name) => !collected.has(name))\n  if (!missing.length) return null\n  const one = missing.length === 1\n  return aiDoctrineReview({\n    message: `\"${input.name}\" is a copy of the form the plan names, and a copy is all it is: the plan gives it ${\n      one ? 'a field' : 'fields'\n    } the copy does not collect.`,\n    violations: [\n      {\n        rule: null,\n        code: 'plan-fields-missing',\n        message: `The confirmed plan says this form collects ${missing.join(', ')}, and the copy collects ${\n          collected.size ? [...collected].join(', ') : 'nothing'\n        }. Add ${one ? 'it' : 'each of them'}, or the copy is the form it was copied from.`,\n      },\n    ],\n  })\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        // The same claim the page step makes (AGL-3024): a copy core mints is\n        // written under core's own id, never `draftId`, so a step that runs\n        // again — a pass resumed, a run cut off after the copy — would mint a\n        // second. The job's recorded id makes core replay the one it made.\n        attemptKey: draftId,\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        // And the one duplication hides: what the plan promised of the copy,\n        // read back (AGL-3024). This branch generates nothing, so nothing\n        // else can answer for it.\n        const review = await aiCopiedFormReview(firestore, {\n          hostId,\n          formId: copy.id,\n          name: copy.name,\n          plan,\n        })\n        if (review) return aiUnspentOutcome(model, { review })\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","aiCopiedFormReview","input","promised","plan","field","split","Boolean","exists","reason","findings","collected","missing","one","size","listOf","aiFormOutputNote","sentences","label","aiJobFormPrompt","job","context","audience","SUBMISSION_WORDS","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","attemptKey","ok","failure","review","status","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-page-sections.d.ts

@@ -49,8 +49,10 @@ import type { AiSystemBlock } from '../runtime/ai-runtime';
  * copies before either validator reads the section (`ai-repeated-items.ts`).
  * Both then read the section as the page stores it, so the page's rules hold
  * on every copy exactly as on an item written out in full, and a finding on a
- * copy names the node the model wrote. Where the workspace keeps components,
- * an item written once is refused: it places instances.
+ * copy names the node the model wrote. Where the workspace keeps components
+ * the same shape is written around an instance (AGL-3024), so a section of
+ * many cards costs its structure once on every plan; an item that places no
+ * instance is still refused there.
  */
 /** The section root id a pass writes, from the job and the plan section's index. */
 export declare function aiPageSectionNodeId(jobId: string, index: number): string;
@@ -85,8 +87,25 @@ export declare const AI_PAGE_SECTION_INLINE_LINE = "This site keeps no saved for
 export declare const AI_PAGE_SECTION_REPEAT_LINE = "Write a repeated item once: put {{1}}, {{2}}\u2026 where its copies differ, and give its outermost node \"repeat\", one list of values a copy, in that order, as [[\"Title 1\", \"Text 1\"], [\"Title 2\", \"Text 2\"]].";
 /**
  * How a workspace that keeps reusable components writes a repeated item
- * (AGL-3143 §10): as one instance of a component the section already places,
- * repeated, rather than the item's subtree drawn once per copy.
+ * (AGL-3143 §10): the shape a Free section writes, around an instance of a
+ * component the section already places — the instance ONCE, `{{n}}` through
+ * the values it fills, and one list of values a copy — rather than the item's
+ * subtree drawn once per copy, or one instance node written per copy.
+ *
+ * Six cards written as six instance nodes spend their structure six times;
+ * written once they spend it once, which is the difference between a section
+ * that fits its ceiling and one that is cut off. A section stays ONE section
+ * either way: splitting it would give the page a second h2 for the same idea,
+ * which is not what the member asked for and not what its outline should say.
+ *
+ * ⛔ The repeated item is the GRID ITEM, not the instance. Measured live on
+ * 2026-09-22: told only to "place ONE instance … and give its outermost node
+ * repeat", the model made the instance itself the repeated node and hung it
+ * straight off the Grid container. The section fitted — the ceiling failure
+ * was gone — and the page was then refused by rule 12, which requires every
+ * child of a Grid container to be a sized Grid item (AGL-3055). The line has
+ * to name the wrapper, because "outermost node" reads as the instance when
+ * the instance is all the request mentions.
  *
  * It rides the request of a section whose plan line shows items AND names a
  * record to place, on the same terms the repeat line rides a Free one: a
@@ -105,14 +124,17 @@ export declare const AI_PAGE_SECTION_REPEAT_LINE = "Write a repeated item once:
  * past its ceiling, and was cut off; the re-ask then said to place an instance
  * "of a component the site has" without naming one, so it was cut off too, and
  * `AI_GENERATION_MAX_ATTEMPTS` ended the job with no page. A four-card grid on
- * the same site had fitted, which is why this went unseen.
+ * the same site had fitted, which is why this went unseen. Naming the shape
+ * was not enough on its own: `ai-repeated-items.ts` refused `repeat` outright
+ * on such a workspace, so the only shape the request could ask for was the
+ * expensive one.
  *
  * ⛔ This does NOT make the plan and the pass agree about what fits — a plan
  * may still promise more items than any ceiling can carry, and this line only
  * gives the pass its cheapest way to try. That bound belongs on the plan step
  * and is deliberately not taken here.
  */
-export declare const AI_PAGE_SECTION_INSTANCE_LINE = "Write a repeated item once: place one instance of the component this section places and repeat that instance, rather than drawing the item again for each copy.";
+export declare const AI_PAGE_SECTION_INSTANCE_LINE = "Write a repeated item once: put ONE instance of the component this section places inside ONE Grid item sized like \"xs:12 sm:6 md:4\", and repeat THAT GRID ITEM rather than the instance \u2014 every child of a Grid container is itself a Grid item. Put {{1}}, {{2}}\u2026 where the copies differ, and give the Grid item \"repeat\", one list of values a copy, in that order, as [[\"Title 1\", \"Text 1\"], [\"Title 2\", \"Text 2\"]].";
 /**
  * What a pass whose answer ran past its ceiling is told makes a section
  * smaller (AGL-3042): fewer elements, down to the budget the request gave,

package/src/lib/jobs/ai-job-page-sections.js

@@ -52,8 +52,10 @@ import { aiPlanItemCountViolations } from "./ai-job-plan-conformance.js";
  * copies before either validator reads the section (`ai-repeated-items.ts`).
  * Both then read the section as the page stores it, so the page's rules hold
  * on every copy exactly as on an item written out in full, and a finding on a
- * copy names the node the model wrote. Where the workspace keeps components,
- * an item written once is refused: it places instances.
+ * copy names the node the model wrote. Where the workspace keeps components
+ * the same shape is written around an instance (AGL-3024), so a section of
+ * many cards costs its structure once on every plan; an item that places no
+ * instance is still refused there.
  */ /** The section root id a pass writes, from the job and the plan section's index. */ export function aiPageSectionNodeId(jobId, index) {
     return `ai-${jobId.slice(0, 12)}-section-${index + 1}`;
 }
@@ -111,8 +113,25 @@ import { aiPlanItemCountViolations } from "./ai-job-plan-conformance.js";
  */ export const AI_PAGE_SECTION_REPEAT_LINE = `Write a repeated item once: ${AI_PAGE_SECTION_REPEAT_SHAPE}.`;
 /**
  * How a workspace that keeps reusable components writes a repeated item
- * (AGL-3143 §10): as one instance of a component the section already places,
- * repeated, rather than the item's subtree drawn once per copy.
+ * (AGL-3143 §10): the shape a Free section writes, around an instance of a
+ * component the section already places — the instance ONCE, `{{n}}` through
+ * the values it fills, and one list of values a copy — rather than the item's
+ * subtree drawn once per copy, or one instance node written per copy.
+ *
+ * Six cards written as six instance nodes spend their structure six times;
+ * written once they spend it once, which is the difference between a section
+ * that fits its ceiling and one that is cut off. A section stays ONE section
+ * either way: splitting it would give the page a second h2 for the same idea,
+ * which is not what the member asked for and not what its outline should say.
+ *
+ * ⛔ The repeated item is the GRID ITEM, not the instance. Measured live on
+ * 2026-09-22: told only to "place ONE instance … and give its outermost node
+ * repeat", the model made the instance itself the repeated node and hung it
+ * straight off the Grid container. The section fitted — the ceiling failure
+ * was gone — and the page was then refused by rule 12, which requires every
+ * child of a Grid container to be a sized Grid item (AGL-3055). The line has
+ * to name the wrapper, because "outermost node" reads as the instance when
+ * the instance is all the request mentions.
  *
  * It rides the request of a section whose plan line shows items AND names a
  * record to place, on the same terms the repeat line rides a Free one: a
@@ -131,13 +150,16 @@ import { aiPlanItemCountViolations } from "./ai-job-plan-conformance.js";
  * past its ceiling, and was cut off; the re-ask then said to place an instance
  * "of a component the site has" without naming one, so it was cut off too, and
  * `AI_GENERATION_MAX_ATTEMPTS` ended the job with no page. A four-card grid on
- * the same site had fitted, which is why this went unseen.
+ * the same site had fitted, which is why this went unseen. Naming the shape
+ * was not enough on its own: `ai-repeated-items.ts` refused `repeat` outright
+ * on such a workspace, so the only shape the request could ask for was the
+ * expensive one.
  *
  * ⛔ This does NOT make the plan and the pass agree about what fits — a plan
  * may still promise more items than any ceiling can carry, and this line only
  * gives the pass its cheapest way to try. That bound belongs on the plan step
  * and is deliberately not taken here.
- */ export const AI_PAGE_SECTION_INSTANCE_LINE = 'Write a repeated item once: place one instance of the component this section places and repeat that instance, rather than drawing the item again for each copy.';
+ */ export const AI_PAGE_SECTION_INSTANCE_LINE = `Write a repeated item once: put ONE instance of the component this section places inside ONE Grid item sized like "xs:12 sm:6 md:4", and repeat THAT GRID ITEM rather than the instance — every child of a Grid container is itself a Grid item. Put {{1}}, {{2}}… where the copies differ, and give the Grid item "${AI_REPEAT_KEY}", one list of values a copy, in that order, as [["Title 1", "Text 1"], ["Title 2", "Text 2"]].`;
 /**
  * What a pass whose answer ran past its ceiling is told makes a section
  * smaller (AGL-3042): fewer elements, down to the budget the request gave,
@@ -147,7 +169,7 @@ import { aiPlanItemCountViolations } from "./ai-job-plan-conformance.js";
  * whose plan line showed no items was never told it. It rides the re-ask,
  * never the first request, so a pass that fits sends no byte more.
  */ export function aiPageSectionSmaller(input) {
-    return input.reusableComponents === false ? `Make it smaller: use fewer elements, at most ${input.maxElements}; write shorter copy; and write a repeated item once instead of drawing it again: ${AI_PAGE_SECTION_REPEAT_SHAPE}.` : `Make it smaller: use fewer elements, at most ${input.maxElements}; write shorter copy; and place a repeated item as an instance of a component the site has instead of drawing it again.`;
+    return input.reusableComponents === false ? `Make it smaller: use fewer elements, at most ${input.maxElements}; write shorter copy; and write a repeated item once instead of drawing it again: ${AI_PAGE_SECTION_REPEAT_SHAPE}.` : `Make it smaller: use fewer elements, at most ${input.maxElements}; write shorter copy; and write a repeated item once instead of drawing it again: put ONE instance of a component the site has inside ONE Grid item sized like "xs:12 sm:6 md:4", and repeat that Grid item — ${AI_PAGE_SECTION_REPEAT_SHAPE}.`;
 }
 /** One pass's user turn: the page, the brief, the plan, this section and what is built above it. */ export function aiPageSectionPrompt(input) {
     const { job, plan, screen, index } = input;