@aglyn/plugins-ai 1.0.0-beta.143

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

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