@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,340 @@
+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 { checkQuota } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { aiModelForStep } from "../providers/routing.js";
+import { readSiteInventory } from "../runtime/site-inventory.js";
+import { aiCampaignAudienceNote, readAiListSendTime, resolveAiEmailProducts, suggestAiCampaignList } from "./ai-email-bindings.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { aiJobDraftId } from "./ai-job-draft-ids.js";
+import { aiSiteSubdomain } from "./ai-job-drafts.js";
+import { aiConfirmedPlan, aiDoctrineReview, aiGenerationSpent, aiLimitReview, aiUnspentOutcome } from "./ai-job-generation.js";
+import { AI_EMAIL_DESIGN_RESOURCE, AI_EMAIL_PLUGIN_ID, AI_EMAIL_SAVE_FAILURE_COPY, AI_JOB_EMAIL_STEP_BUDGETS, aiEmailDesignContent, aiEmailDesignOutput, aiJobInputName, generateAiEmail } from "./ai-job-email-step.js";
+import { aiPluginDraftAdmissionRefusal, aiPluginDraftWriter } from "./ai-job-plugin-drafts.js";
+import { registerAiJobStep } from "./ai-jobs.js";
+/**
+ * The campaign step (AGL-2912): one brief becomes an email design AND the
+ * draft campaign that would send it.
+ *
+ * A campaign is an unplanned kind — there is one thing to build and a plan
+ * over it would be a plan of one — so the job runs this step alone, and the
+ * design it writes is the email step's, generated through `generateAiEmail`
+ * so both kinds obey the same doctrine and the same email rules.
+ *
+ * ## Nothing is sent, and nothing is aimed
+ *
+ * The campaign is written `draft`, with no audience, no schedule and no
+ * sender: a draft campaign is not a queued one, the scheduled processor
+ * queries `status == 'scheduled'`, and the send route is the only thing that
+ * mails a campaign. Choosing WHO receives it stays a person's decision, so
+ * the model is never shown the org's lists, its contacts or what past sends
+ * did. Code reads the list the brief names and the send time that list's own
+ * history suggests, AFTER the answer, and both reach the person as the
+ * output's `note` — never the prompt.
+ *
+ * ## Where campaign email begins
+ *
+ * A site whose plan sends no campaign email can still generate email designs;
+ * the campaign is the part that needs somewhere to send. So the step gates on
+ * the same entitlement the composer and the send route read, and stops the
+ * job for a person rather than failing it. The refusal names no plan, because
+ * the billing page is the one place that does.
+ *
+ * ## Run again and it finds its drafts
+ *
+ * Each write is keyed by the id the job recorded for its draft when it was
+ * created, so a run cut off between them finds what it wrote: two drafts are
+ * reported, a design alone is drafted into a campaign from the copy the
+ * design already stores, and neither spends.
+ */ /** The id the marketing plugin is registered under. */ export const AI_CAMPAIGN_PLUGIN_ID = 'marketing';
+/** The resource the marketing plugin writes a draft campaign under. */ export const AI_CAMPAIGN_RESOURCE = 'campaign';
+/** A campaign's name when neither the job nor its subject lines give one. */ export const AI_JOB_CAMPAIGN_DEFAULT_NAME = 'New campaign';
+/** A job's failure when the site has no campaign writer. */ export const AI_CAMPAIGN_UNAVAILABLE_COPY = 'Campaigns are not available on this site.';
+/** A job's failure when a campaign whose email was written could not be drafted. */ export const AI_CAMPAIGN_SAVE_FAILURE_COPY = 'The email was written but the campaign could not be drafted. Try the job again.';
+/**
+ * What a person is told when their plan sends no campaign email. It names the
+ * page that sells the answer rather than a plan, so the one place plan names
+ * are written stays the one place they are read.
+ */ export const AI_CAMPAIGN_PLAN_REFUSAL = 'Campaign email is not included on this workspace’s plan. ' + 'Upgrade in Billing to send campaigns, or generate an email design on its own.';
+/** Whether this workspace may send campaign email at all: the composer's and the send route's check. */ export function aiCampaignPlanAllows(org) {
+    return checkQuota(org, 'emailSendsPerMonth', 0).allowed;
+}
+/** The campaign as the job's output, carrying what the person still decides. */ export function aiCampaignOutput(record, place, note) {
+    return _extends({
+        resource: 'campaign',
+        id: record.id,
+        versionId: null,
+        hostId: place.hostId,
+        hostSubdomain: place.hostSubdomain,
+        label: record.name
+    }, note ? {
+        note
+    } : {});
+}
+/** The subject lines and preheaders a written design already stores. */ export function aiCampaignCopyFromDesign(record) {
+    var _ref, _ref1;
+    var _record_facts, _record_facts1, _record_facts2, _record_facts3;
+    const lines = (value)=>Array.isArray(value) ? value.filter((entry)=>typeof entry === 'string') : [];
+    const subject = String((_ref = (_record_facts = record.facts) == null ? void 0 : _record_facts['subject']) != null ? _ref : '');
+    const preheader = String((_ref1 = (_record_facts1 = record.facts) == null ? void 0 : _record_facts1['preheader']) != null ? _ref1 : '');
+    const subjects = lines((_record_facts2 = record.facts) == null ? void 0 : _record_facts2['subjectVariants']);
+    const preheaders = lines((_record_facts3 = record.facts) == null ? void 0 : _record_facts3['preheaderVariants']);
+    return {
+        subjects: subjects.length ? subjects : subject ? [
+            subject
+        ] : [],
+        preheaders: preheaders.length ? preheaders : preheader ? [
+            preheader
+        ] : []
+    };
+}
+/** The campaign's content: the design it sends, and the copy the send fills its headers from. */ export function aiCampaignDraftContent(designId, copy) {
+    var _copy_subjects_, _copy_preheaders_;
+    return {
+        templateScreenId: designId,
+        subject: (_copy_subjects_ = copy.subjects[0]) != null ? _copy_subjects_ : '',
+        preheader: (_copy_preheaders_ = copy.preheaders[0]) != null ? _copy_preheaders_ : '',
+        subjectVariants: copy.subjects,
+        preheaderVariants: copy.preheaders
+    };
+}
+/** A campaign job's name: what the member asked for, else its strongest subject line. */ export function aiCampaignName(job, copy) {
+    return aiJobInputName(job) || copy.subjects[0] || AI_JOB_CAMPAIGN_DEFAULT_NAME;
+}
+/**
+ * A campaign job is admitted for a site of its org with email and marketing
+ * on, room for a design and a campaign, and a plan that sends campaign email.
+ */ export const aiCampaignJobAdmission = (context)=>aiPluginDraftAdmissionRefusal(context, {
+        kind: 'campaign',
+        drafts: [
+            {
+                resource: AI_EMAIL_DESIGN_RESOURCE,
+                pluginId: AI_EMAIL_PLUGIN_ID,
+                label: 'Email'
+            },
+            {
+                resource: AI_CAMPAIGN_RESOURCE,
+                pluginId: AI_CAMPAIGN_PLUGIN_ID,
+                label: 'Marketing'
+            }
+        ],
+        ownCheck: async ()=>aiCampaignPlanAllows(context.org) ? null : {
+                status: 403,
+                error: AI_CAMPAIGN_PLAN_REFUSAL
+            }
+    });
+/** Both drafts, or the refusal that stands in for a writer the site has not got. */ function writers(writerFor) {
+    const design = writerFor(AI_EMAIL_DESIGN_RESOURCE);
+    const campaign = writerFor(AI_CAMPAIGN_RESOURCE);
+    if (!design) return AI_CAMPAIGN_UNAVAILABLE_COPY;
+    if (!campaign) return AI_CAMPAIGN_UNAVAILABLE_COPY;
+    return {
+        design,
+        campaign
+    };
+}
+export function createAiJobCampaignStep(deps = {}) {
+    var _deps_readInventory, _deps_writerFor;
+    const readInventory = (_deps_readInventory = deps.readInventory) != null ? _deps_readInventory : readSiteInventory;
+    const writerFor = (_deps_writerFor = deps.writerFor) != null ? _deps_writerFor : aiPluginDraftWriter;
+    return async ({ job, now, signal, firestore, modelFor })=>{
+        var _ref, _orgSnapshot_data;
+        const hostId = job.hostId;
+        if (!hostId) throw new Error('a campaign job names no site, and its admission refuses one');
+        // The switch's answer for this job, else the routing table's (AGL-2942).
+        const model = (_ref = modelFor == null ? void 0 : modelFor('job.campaign')) != null ? _ref : aiModelForStep('job.campaign');
+        const found = writers(writerFor);
+        if (typeof found === 'string') return _extends({}, aiUnspentOutcome(model), {
+            failure: found
+        });
+        const { design, campaign } = found;
+        // What an earlier run of this same job already wrote, under the ids the job recorded.
+        const designId = aiJobDraftId(job, 'email');
+        const [writtenDesign, writtenCampaign, hostSubdomain] = await Promise.all([
+            design.read({
+                hostId,
+                id: designId
+            }),
+            campaign.read({
+                hostId,
+                id: aiJobDraftId(job, 'campaign')
+            }),
+            aiSiteSubdomain(firestore, hostId)
+        ]);
+        const place = {
+            hostId,
+            hostSubdomain
+        };
+        if (writtenDesign && writtenCampaign) {
+            return aiUnspentOutcome(model, {
+                outputs: [
+                    aiEmailDesignOutput(writtenDesign, place, null),
+                    aiCampaignOutput(writtenCampaign, place, null)
+                ]
+            });
+        }
+        const orgSnapshot = await firestore.collection('orgs').doc(job.orgId).get();
+        const org = (_orgSnapshot_data = orgSnapshot.data()) != null ? _orgSnapshot_data : null;
+        // Asked again here because a plan can change between admission and the run.
+        if (!aiCampaignPlanAllows(org)) {
+            return aiUnspentOutcome(model, {
+                review: aiLimitReview(AI_CAMPAIGN_PLAN_REFUSAL)
+            });
+        }
+        const context = {
+            orgId: job.orgId,
+            hostId,
+            uid: job.createdBy,
+            org,
+            now
+        };
+        // Who it is for and when to send it: read from the site, told to the
+        // person, and never sent to the model.
+        const list = await suggestAiCampaignList({
+            hostId,
+            brief: job.brief
+        });
+        const sendTime = list ? await readAiListSendTime(firestore, {
+            hostId,
+            listId: list.id
+        }) : null;
+        const note = aiCampaignAudienceNote(list, sendTime);
+        // A design an earlier run wrote is drafted into its campaign, unspent.
+        if (writtenDesign) {
+            return draftCampaign({
+                campaign,
+                context,
+                job,
+                copy: aiCampaignCopyFromDesign(writtenDesign),
+                designId: writtenDesign.id,
+                spent: aiUnspentOutcome(model),
+                outputs: [
+                    aiEmailDesignOutput(writtenDesign, place, null)
+                ],
+                place,
+                note
+            });
+        }
+        const [inventory, products] = await Promise.all([
+            readInventory(job.orgId, hostId, {
+                firestore
+            }),
+            resolveAiEmailProducts(firestore, {
+                hostId,
+                brief: job.brief,
+                inputs: job.inputs
+            })
+        ]);
+        const refusal = await design.refusal(context);
+        if (refusal) {
+            return refusal.status === 403 ? aiUnspentOutcome(model, {
+                review: aiLimitReview(refusal.error)
+            }) : _extends({}, aiUnspentOutcome(model), {
+                failure: refusal.error
+            });
+        }
+        const asked = aiJobInputName(job);
+        const generated = await generateAiEmail(_extends({
+            job,
+            step: 'job.campaign',
+            model,
+            heading: asked ? `Campaign name: ${asked}` : null,
+            plan: aiConfirmedPlan(job),
+            inventory,
+            hostId,
+            products,
+            design
+        }, signal ? {
+            signal
+        } : {}));
+        const { result } = generated;
+        const spent = aiGenerationSpent(result);
+        if (result.status === 'refused') return _extends({}, spent, {
+            refused: true
+        });
+        if (result.status === 'needs_input') return _extends({}, spent, {
+            review: aiDoctrineReview(result)
+        });
+        if (!generated.copy || !generated.nodes) return _extends({}, spent, {
+            failure: AI_EMAIL_SAVE_FAILURE_COPY
+        });
+        const { copy } = generated;
+        const name = aiCampaignName(job, copy);
+        const write = await design.write(_extends({}, context, {
+            id: designId,
+            name,
+            content: aiEmailDesignContent(generated.nodes, copy)
+        }));
+        if (write.ok === false) {
+            return write.status === 403 ? _extends({}, spent, {
+                review: aiLimitReview(write.error)
+            }) : _extends({}, spent, {
+                failure: AI_EMAIL_SAVE_FAILURE_COPY
+            });
+        }
+        return draftCampaign({
+            campaign,
+            context,
+            job,
+            copy,
+            designId: write.id,
+            spent,
+            outputs: [
+                aiEmailDesignOutput(write, place, null)
+            ],
+            place,
+            note
+        });
+    };
+}
+/**
+ * Drafts the campaign around a design that exists. A campaign that cannot be
+ * drafted reports NO outputs: the design on its own is not what the job was
+ * asked for, and a run that names it would read as finished.
+ */ async function draftCampaign(input) {
+    const write = await input.campaign.write(_extends({}, input.context, {
+        id: aiJobDraftId(input.job, 'campaign'),
+        name: aiCampaignName(input.job, input.copy),
+        content: aiCampaignDraftContent(input.designId, input.copy)
+    }));
+    if (write.ok === false) {
+        return write.status === 403 ? _extends({}, input.spent, {
+            review: aiLimitReview(write.error)
+        }) : _extends({}, input.spent, {
+            failure: AI_CAMPAIGN_SAVE_FAILURE_COPY
+        });
+    }
+    return _extends({}, input.spent, {
+        outputs: [
+            ...input.outputs,
+            aiCampaignOutput(write, input.place, input.note)
+        ]
+    });
+}
+export const runAiJobCampaignStep = createAiJobCampaignStep();
+/**
+ * The least time one campaign step needs before it starts (AGL-3035): the
+ * email generation it drafts the campaign's design with, on the campaign's own
+ * routing row. Writing the draft campaign asks no model.
+ */ export const AI_JOB_CAMPAIGN_STEP_MINIMUM_MS = AI_JOB_EMAIL_STEP_BUDGETS['job.campaign'].minimumMs;
+/** Registers the campaign step and the check a campaign job passes before it is created or resumed. */ export function registerAiCampaignJob() {
+    registerAiJobStep('campaign', runAiJobCampaignStep, {
+        minimumMs: AI_JOB_CAMPAIGN_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission('campaign', aiCampaignJobAdmission);
+}
+
+//# sourceMappingURL=ai-job-campaign-step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-campaign-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 { checkQuota } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type {\n  PluginDraftRecord,\n  PluginResourceDraftWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport { aiModelForStep } from '../providers/routing'\nimport { readSiteInventory } from '../runtime/site-inventory'\nimport {\n  aiCampaignAudienceNote,\n  readAiListSendTime,\n  resolveAiEmailProducts,\n  suggestAiCampaignList,\n} from './ai-email-bindings'\nimport { registerAiJobAdmission, type AiJobAdmission } from './ai-job-admission'\nimport { aiJobDraftId } from './ai-job-draft-ids'\nimport { aiSiteSubdomain } from './ai-job-drafts'\nimport {\n  aiConfirmedPlan,\n  aiDoctrineReview,\n  aiGenerationSpent,\n  aiLimitReview,\n  aiUnspentOutcome,\n} from './ai-job-generation'\nimport {\n  AI_EMAIL_DESIGN_RESOURCE,\n  AI_EMAIL_PLUGIN_ID,\n  AI_EMAIL_SAVE_FAILURE_COPY,\n  AI_JOB_EMAIL_STEP_BUDGETS,\n  aiEmailDesignContent,\n  aiEmailDesignOutput,\n  aiJobInputName,\n  generateAiEmail,\n  type AiEmailCopy,\n} from './ai-job-email-step'\nimport {\n  aiPluginDraftAdmissionRefusal,\n  aiPluginDraftWriter,\n  type AiPluginDraftWriterLookup,\n} from './ai-job-plugin-drafts'\nimport type { AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\n\n/**\n * The campaign step (AGL-2912): one brief becomes an email design AND the\n * draft campaign that would send it.\n *\n * A campaign is an unplanned kind — there is one thing to build and a plan\n * over it would be a plan of one — so the job runs this step alone, and the\n * design it writes is the email step's, generated through `generateAiEmail`\n * so both kinds obey the same doctrine and the same email rules.\n *\n * ## Nothing is sent, and nothing is aimed\n *\n * The campaign is written `draft`, with no audience, no schedule and no\n * sender: a draft campaign is not a queued one, the scheduled processor\n * queries `status == 'scheduled'`, and the send route is the only thing that\n * mails a campaign. Choosing WHO receives it stays a person's decision, so\n * the model is never shown the org's lists, its contacts or what past sends\n * did. Code reads the list the brief names and the send time that list's own\n * history suggests, AFTER the answer, and both reach the person as the\n * output's `note` — never the prompt.\n *\n * ## Where campaign email begins\n *\n * A site whose plan sends no campaign email can still generate email designs;\n * the campaign is the part that needs somewhere to send. So the step gates on\n * the same entitlement the composer and the send route read, and stops the\n * job for a person rather than failing it. The refusal names no plan, because\n * the billing page is the one place that does.\n *\n * ## Run again and it finds its drafts\n *\n * Each write is keyed by the id the job recorded for its draft when it was\n * created, so a run cut off between them finds what it wrote: two drafts are\n * reported, a design alone is drafted into a campaign from the copy the\n * design already stores, and neither spends.\n */\n\n/** The id the marketing plugin is registered under. */\nexport const AI_CAMPAIGN_PLUGIN_ID = 'marketing'\n\n/** The resource the marketing plugin writes a draft campaign under. */\nexport const AI_CAMPAIGN_RESOURCE = 'campaign'\n\n/** A campaign's name when neither the job nor its subject lines give one. */\nexport const AI_JOB_CAMPAIGN_DEFAULT_NAME = 'New campaign'\n\n/** A job's failure when the site has no campaign writer. */\nexport const AI_CAMPAIGN_UNAVAILABLE_COPY = 'Campaigns are not available on this site.'\n\n/** A job's failure when a campaign whose email was written could not be drafted. */\nexport const AI_CAMPAIGN_SAVE_FAILURE_COPY =\n  'The email was written but the campaign could not be drafted. Try the job again.'\n\n/**\n * What a person is told when their plan sends no campaign email. It names the\n * page that sells the answer rather than a plan, so the one place plan names\n * are written stays the one place they are read.\n */\nexport const AI_CAMPAIGN_PLAN_REFUSAL =\n  'Campaign email is not included on this workspace’s plan. ' +\n  'Upgrade in Billing to send campaigns, or generate an email design on its own.'\n\n/** Whether this workspace may send campaign email at all: the composer's and the send route's check. */\nexport function aiCampaignPlanAllows(org: object | null): boolean {\n  return checkQuota(org as Partial<AglynOrgBilling> | null, 'emailSendsPerMonth', 0).allowed\n}\n\n/** The campaign as the job's output, carrying what the person still decides. */\nexport function aiCampaignOutput(\n  record: PluginDraftRecord,\n  place: { hostId: string; hostSubdomain: string | null },\n  note: string | null,\n): AiJobOutput {\n  return {\n    resource: 'campaign',\n    id: record.id,\n    versionId: null,\n    hostId: place.hostId,\n    hostSubdomain: place.hostSubdomain,\n    label: record.name,\n    ...(note ? { note } : {}),\n  }\n}\n\n/** The subject lines and preheaders a written design already stores. */\nexport function aiCampaignCopyFromDesign(record: PluginDraftRecord): AiEmailCopy {\n  const lines = (value: unknown): string[] =>\n    Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : []\n  const subject = String(record.facts?.['subject'] ?? '')\n  const preheader = String(record.facts?.['preheader'] ?? '')\n  const subjects = lines(record.facts?.['subjectVariants'])\n  const preheaders = lines(record.facts?.['preheaderVariants'])\n  return {\n    subjects: subjects.length ? subjects : subject ? [subject] : [],\n    preheaders: preheaders.length ? preheaders : preheader ? [preheader] : [],\n  }\n}\n\n/** The campaign's content: the design it sends, and the copy the send fills its headers from. */\nexport function aiCampaignDraftContent(\n  designId: string,\n  copy: AiEmailCopy,\n): Record<string, unknown> {\n  return {\n    templateScreenId: designId,\n    subject: copy.subjects[0] ?? '',\n    preheader: copy.preheaders[0] ?? '',\n    subjectVariants: copy.subjects,\n    preheaderVariants: copy.preheaders,\n  }\n}\n\n/** A campaign job's name: what the member asked for, else its strongest subject line. */\nexport function aiCampaignName(job: Pick<AiJob, 'inputs'>, copy: AiEmailCopy): string {\n  return aiJobInputName(job) || copy.subjects[0] || AI_JOB_CAMPAIGN_DEFAULT_NAME\n}\n\n/**\n * A campaign job is admitted for a site of its org with email and marketing\n * on, room for a design and a campaign, and a plan that sends campaign email.\n */\nexport const aiCampaignJobAdmission: AiJobAdmission = (context) =>\n  aiPluginDraftAdmissionRefusal(context, {\n    kind: 'campaign',\n    drafts: [\n      { resource: AI_EMAIL_DESIGN_RESOURCE, pluginId: AI_EMAIL_PLUGIN_ID, label: 'Email' },\n      { resource: AI_CAMPAIGN_RESOURCE, pluginId: AI_CAMPAIGN_PLUGIN_ID, label: 'Marketing' },\n    ],\n    ownCheck: async () =>\n      aiCampaignPlanAllows(context.org)\n        ? null\n        : { status: 403, error: AI_CAMPAIGN_PLAN_REFUSAL },\n  })\n\nexport interface AiJobCampaignStepDeps {\n  /** The inventory reader; specs hand in a fake. */\n  readInventory?: typeof readSiteInventory\n  /** How a resource's draft writer is found; the core's registry otherwise. */\n  writerFor?: AiPluginDraftWriterLookup\n}\n\n/** Both drafts, or the refusal that stands in for a writer the site has not got. */\nfunction writers(\n  writerFor: AiPluginDraftWriterLookup,\n): { design: PluginResourceDraftWriter; campaign: PluginResourceDraftWriter } | string {\n  const design = writerFor(AI_EMAIL_DESIGN_RESOURCE)\n  const campaign = writerFor(AI_CAMPAIGN_RESOURCE)\n  if (!design) return AI_CAMPAIGN_UNAVAILABLE_COPY\n  if (!campaign) return AI_CAMPAIGN_UNAVAILABLE_COPY\n  return { design, campaign }\n}\n\nexport function createAiJobCampaignStep(deps: AiJobCampaignStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const writerFor = deps.writerFor ?? aiPluginDraftWriter\n  return async ({ job, now, signal, firestore, modelFor }): Promise<AiJobStepOutcome> => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a campaign job names no site, and its admission refuses one')\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.campaign') ?? aiModelForStep('job.campaign')\n    const found = writers(writerFor)\n    if (typeof found === 'string') return { ...aiUnspentOutcome(model), failure: found }\n    const { design, campaign } = found\n\n    // What an earlier run of this same job already wrote, under the ids the job recorded.\n    const designId = aiJobDraftId(job, 'email')\n    const [writtenDesign, writtenCampaign, hostSubdomain] = await Promise.all([\n      design.read({ hostId, id: designId }),\n      campaign.read({ hostId, id: aiJobDraftId(job, 'campaign') }),\n      aiSiteSubdomain(firestore, hostId),\n    ])\n    const place = { hostId, hostSubdomain }\n    if (writtenDesign && writtenCampaign) {\n      return aiUnspentOutcome(model, {\n        outputs: [\n          aiEmailDesignOutput(writtenDesign, place, null),\n          aiCampaignOutput(writtenCampaign, place, null),\n        ],\n      })\n    }\n\n    const orgSnapshot = await firestore.collection('orgs').doc(job.orgId).get()\n    const org = (orgSnapshot.data() ?? null) as Record<string, unknown> | null\n    // Asked again here because a plan can change between admission and the run.\n    if (!aiCampaignPlanAllows(org)) {\n      return aiUnspentOutcome(model, { review: aiLimitReview(AI_CAMPAIGN_PLAN_REFUSAL) })\n    }\n    const context = { orgId: job.orgId, hostId, uid: job.createdBy, org, now }\n\n    // Who it is for and when to send it: read from the site, told to the\n    // person, and never sent to the model.\n    const list = await suggestAiCampaignList({ hostId, brief: job.brief })\n    const sendTime = list ? await readAiListSendTime(firestore, { hostId, listId: list.id }) : null\n    const note = aiCampaignAudienceNote(list, sendTime)\n\n    // A design an earlier run wrote is drafted into its campaign, unspent.\n    if (writtenDesign) {\n      return draftCampaign({\n        campaign,\n        context,\n        job,\n        copy: aiCampaignCopyFromDesign(writtenDesign),\n        designId: writtenDesign.id,\n        spent: aiUnspentOutcome(model),\n        outputs: [aiEmailDesignOutput(writtenDesign, place, null)],\n        place,\n        note,\n      })\n    }\n\n    const [inventory, products] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      resolveAiEmailProducts(firestore, { hostId, brief: job.brief, inputs: job.inputs }),\n    ])\n    const refusal = await design.refusal(context)\n    if (refusal) {\n      return refusal.status === 403\n        ? aiUnspentOutcome(model, { review: aiLimitReview(refusal.error) })\n        : { ...aiUnspentOutcome(model), failure: refusal.error }\n    }\n\n    const asked = aiJobInputName(job)\n    const generated = await generateAiEmail({\n      job,\n      step: 'job.campaign',\n      model,\n      heading: asked ? `Campaign name: ${asked}` : null,\n      plan: aiConfirmedPlan(job),\n      inventory,\n      hostId,\n      products,\n      design,\n      ...(signal ? { signal } : {}),\n    })\n    const { result } = generated\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    if (!generated.copy || !generated.nodes) return { ...spent, failure: AI_EMAIL_SAVE_FAILURE_COPY }\n\n    const { copy } = generated\n    const name = aiCampaignName(job, copy)\n    const write = await design.write({\n      ...context,\n      id: designId,\n      name,\n      content: aiEmailDesignContent(generated.nodes, copy),\n    })\n    if (write.ok === false) {\n      return write.status === 403\n        ? { ...spent, review: aiLimitReview(write.error) }\n        : { ...spent, failure: AI_EMAIL_SAVE_FAILURE_COPY }\n    }\n    return draftCampaign({\n      campaign,\n      context,\n      job,\n      copy,\n      designId: write.id,\n      spent,\n      outputs: [aiEmailDesignOutput(write, place, null)],\n      place,\n      note,\n    })\n  }\n}\n\ninterface AiCampaignDraftInput {\n  campaign: PluginResourceDraftWriter\n  context: { orgId: string; hostId: string; uid: string; org: Record<string, unknown> | null; now: Date }\n  job: AiJob\n  copy: AiEmailCopy\n  designId: string\n  /** What the generation cost, or an unspent outcome for a run that reached no model. */\n  spent: Pick<AiJobStepOutcome, 'outputs' | 'usage' | 'estCostUsd' | 'model' | 'stopReason'>\n  /** The design's output, reported beside the campaign once it is drafted. */\n  outputs: AiJobOutput[]\n  place: { hostId: string; hostSubdomain: string | null }\n  note: string\n}\n\n/**\n * Drafts the campaign around a design that exists. A campaign that cannot be\n * drafted reports NO outputs: the design on its own is not what the job was\n * asked for, and a run that names it would read as finished.\n */\nasync function draftCampaign(input: AiCampaignDraftInput): Promise<AiJobStepOutcome> {\n  const write = await input.campaign.write({\n    ...input.context,\n    id: aiJobDraftId(input.job, 'campaign'),\n    name: aiCampaignName(input.job, input.copy),\n    content: aiCampaignDraftContent(input.designId, input.copy),\n  })\n  if (write.ok === false) {\n    return write.status === 403\n      ? { ...input.spent, review: aiLimitReview(write.error) }\n      : { ...input.spent, failure: AI_CAMPAIGN_SAVE_FAILURE_COPY }\n  }\n  return {\n    ...input.spent,\n    outputs: [...input.outputs, aiCampaignOutput(write, input.place, input.note)],\n  }\n}\n\nexport const runAiJobCampaignStep = createAiJobCampaignStep()\n\n/**\n * The least time one campaign step needs before it starts (AGL-3035): the\n * email generation it drafts the campaign's design with, on the campaign's own\n * routing row. Writing the draft campaign asks no model.\n */\nexport const AI_JOB_CAMPAIGN_STEP_MINIMUM_MS = AI_JOB_EMAIL_STEP_BUDGETS['job.campaign'].minimumMs\n\n/** Registers the campaign step and the check a campaign job passes before it is created or resumed. */\nexport function registerAiCampaignJob(): void {\n  registerAiJobStep('campaign', runAiJobCampaignStep, { minimumMs: AI_JOB_CAMPAIGN_STEP_MINIMUM_MS })\n  registerAiJobAdmission('campaign', aiCampaignJobAdmission)\n}\n"],"names":["checkQuota","aiModelForStep","readSiteInventory","aiCampaignAudienceNote","readAiListSendTime","resolveAiEmailProducts","suggestAiCampaignList","registerAiJobAdmission","aiJobDraftId","aiSiteSubdomain","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiLimitReview","aiUnspentOutcome","AI_EMAIL_DESIGN_RESOURCE","AI_EMAIL_PLUGIN_ID","AI_EMAIL_SAVE_FAILURE_COPY","AI_JOB_EMAIL_STEP_BUDGETS","aiEmailDesignContent","aiEmailDesignOutput","aiJobInputName","generateAiEmail","aiPluginDraftAdmissionRefusal","aiPluginDraftWriter","registerAiJobStep","AI_CAMPAIGN_PLUGIN_ID","AI_CAMPAIGN_RESOURCE","AI_JOB_CAMPAIGN_DEFAULT_NAME","AI_CAMPAIGN_UNAVAILABLE_COPY","AI_CAMPAIGN_SAVE_FAILURE_COPY","AI_CAMPAIGN_PLAN_REFUSAL","aiCampaignPlanAllows","org","allowed","aiCampaignOutput","record","place","note","resource","id","versionId","hostId","hostSubdomain","label","name","aiCampaignCopyFromDesign","lines","value","Array","isArray","filter","entry","subject","String","facts","preheader","subjects","preheaders","length","aiCampaignDraftContent","designId","copy","templateScreenId","subjectVariants","preheaderVariants","aiCampaignName","job","aiCampaignJobAdmission","context","kind","drafts","pluginId","ownCheck","status","error","writers","writerFor","design","campaign","createAiJobCampaignStep","deps","readInventory","now","signal","firestore","modelFor","orgSnapshot","Error","model","found","failure","writtenDesign","writtenCampaign","Promise","all","read","outputs","collection","doc","orgId","get","data","review","uid","createdBy","list","brief","sendTime","listId","draftCampaign","spent","inventory","products","inputs","refusal","asked","generated","step","heading","plan","result","refused","nodes","write","content","ok","input","runAiJobCampaignStep","AI_JOB_CAMPAIGN_STEP_MINIMUM_MS","minimumMs","registerAiCampaignJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-component-checks.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types';
+import type { AiJobPlan } from '../model/ai-jobs.types';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+import type { AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * The highest heading a component may carry (AGL-3057): a page section opens
+ * with its own h2, and whatever the section places sits under it.
+ */
+export declare const AI_COMPONENT_TOP_HEADING_LEVEL = 3;
+/** One `name:type` field of the confirmed plan's component; `type` is empty when the field names none. */
+export interface AiPlannedComponentField {
+    name: string;
+    type: string;
+}
+/** The fields the confirmed plan lists for its component, read from `name:type`, each name once. */
+export declare function aiPlannedComponentFields(plan: AiJobPlan | null): AiPlannedComponentField[];
+/** The property names the confirmed plan lists for its component, from its `name:type` fields. */
+export declare function aiPlannedComponentProps(plan: AiJobPlan | null): string[];
+/**
+ * The component door's check of its bindings, on a tree the doctrine admitted
+ * and the properties the same answer declared: every token names a declared
+ * property on a field of its kind, every property is bound, an icon is never
+ * shown as words, a part is hidden by a `Hide …` Yes / no that defaults to No,
+ * and a default fits the field it fills. `refused` names properties the answer
+ * declared and the reading refused, which are reported there and not again
+ * here.
+ */
+export declare function aiComponentBindingViolations(tree: Pick<AiValidatedTree, 'rootId' | 'nodes' | 'sourceIds'>, props: readonly ReusableComponentProp[], inventory: AiSiteInventory | null, refused?: readonly string[]): AiDoctrineViolation[];
+/**
+ * Rule 7: the properties the confirmed plan lists for the component are
+ * declared, and a field the plan lists as an icon is an icon property, so
+ * the plan and the binding checks ask for the same thing (AGL-3054).
+ */
+export declare function aiPlannedPropViolations(plan: AiJobPlan | null, props: readonly Pick<ReusableComponentProp, 'name' | 'type'>[]): AiDoctrineViolation[];
+/**
+ * Rule 11 on a component's own outline (AGL-3057). A page's outline check
+ * reads an instance as one node, and the site inventory carries no component
+ * tree to read in its place, so a component's h2 renders beside the h2 that
+ * opens the section placing it, and the page reads h2, h2, h2. The component
+ * is held to headings a section can hold instead: h3 or below. A component
+ * that would be a whole section, its own h2 and all, is refused the same way:
+ * that section is built on the page.
+ */
+export declare function aiComponentHeadingViolations(tree: Pick<AiValidatedTree, 'rootId' | 'nodes' | 'sourceIds'>): AiDoctrineViolation[];
+/** Rule 14 on the copy a component shows until a page sets it. */
+export declare function aiComponentDefaultCopyViolations(props: readonly ReusableComponentProp[]): AiDoctrineViolation[];
+/**
+ * Every check the component door adds to the doctrine's, on a tree it
+ * admitted and the answer the tree came in. `onProps` receives the properties
+ * that answer declared, so the step keeps the declaration of the answer the
+ * loop keeps — the last one it checked.
+ */
+export declare function aiComponentCheck(input: {
+    inventory: AiSiteInventory | null;
+    plan: AiJobPlan | null;
+    onProps: (props: ReusableComponentProp[]) => void;
+}): (tree: AiValidatedTree, answer: Record<string, unknown>) => AiDoctrineViolation[];