@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,105 @@
+/**
+ * @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 { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource';
+import type { AiJob, AiJobPlan } from '../model/ai-jobs.types';
+import { type AiTemplateSubjectDefinition } from '../model/ai-template-subjects';
+import { type AiValidatedTree } from '../runtime/ai-doctrine';
+import { type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { readSiteInventory } from '../runtime/site-inventory';
+import { type AiJobAdmission } from './ai-job-admission';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The template step (AGL-2909): the generation step of a `template` job, run
+ * once a member confirmed the job's plan.
+ *
+ * It builds ONE page template — the page a site renders once per record: a
+ * content collection's entry, a product, an author — through
+ * `runValidatedGeneration('template', …)`. Everything that differs per
+ * record is a binding token from the subject's vocabulary
+ * (`model/ai-template-subjects.ts`), which is the list the besigner's insert
+ * picker offers for that page; a link or media prop may hold one of those
+ * tokens whole, which the palette validator admits only because this door
+ * names them. The door adds one check of its own through `extend` (rule 8):
+ * no token the page does not fill, an h1 bound to the subject's title, and no
+ * block that fills itself only on another subject's page.
+ *
+ * The model is shown the platform's starter pages as examples, in a cached
+ * block (`runtime/ai-template-examples.ts`), and writes against them.
+ *
+ * The template lands in the site's library as a new draft
+ * (`ai-job-drafts.ts`), inert until a member uses it: bound to no
+ * collection, set as no product or author page, served nowhere. A plan that
+ * starts from a copy of a template the site has gets that copy instead.
+ */
+/** The longest answer a template may run to; the tree is held to the template budget either way. */
+export declare const AI_JOB_TEMPLATE_MAX_TOKENS: number;
+/**
+ * The template step's time (AGL-3035, AGL-3036): its two inventory-lookup
+ * rounds, its answer and its re-ask at the routing table's ceiling on the tier
+ * `job.template` is served from, fitted to what a beat can give a step. It
+ * runs on the job beat, never at an inline door, and asks for no more of the
+ * ceiling than fits that time on the model it runs.
+ */
+export declare const AI_JOB_TEMPLATE_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one template step needs before it starts. */
+export declare const AI_JOB_TEMPLATE_STEP_MINIMUM_MS: number;
+/** The template step's own instructions, cached after the doctrine and before the examples. */
+export declare const AI_JOB_TEMPLATE_INSTRUCTIONS: readonly AiSystemBlock[];
+/** A content collection an entry template is for, as the prompt and the draft name it. */
+export interface AiTemplateCollection {
+    id: string;
+    name: string;
+    slug: string;
+}
+/** The content collection by that id on the site, or `null` when there is none. */
+export declare function readAiTemplateCollection(firestore: FirebaseFirestore.Firestore, hostId: string, collectionId: string): Promise<AiTemplateCollection | null>;
+/** The template's name: the plan's, else the collection's or the subject's. */
+export declare function aiTemplateDraftName(definition: AiTemplateSubjectDefinition, collection: AiTemplateCollection | null, planned: string | null | undefined): string;
+/** The address Use template offers for the page it creates. */
+export declare function aiTemplateDraftSlug(definition: AiTemplateSubjectDefinition, collection: AiTemplateCollection | null): string | null;
+/** The template job as the generation's user turn. */
+export declare function aiJobTemplatePrompt(job: Pick<AiJob, 'brief'>, definition: AiTemplateSubjectDefinition, collection: AiTemplateCollection | null, plan: AiJobPlan | null, name: string): string;
+/**
+ * The template door's check on a tree the doctrine admitted (rule 8): every
+ * token is one the page fills, the h1 binds the subject's title, and no block
+ * that fills itself on another subject's page is placed — except inside a
+ * Collection Entries card, where each fills from the card's own entry.
+ */
+export declare function aiTemplateBindingCheck(definition: AiTemplateSubjectDefinition): (tree: AiValidatedTree) => AiDoctrineViolation[];
+export interface AiTemplateJobAdmissionDeps {
+    readCollection?: typeof readAiTemplateCollection;
+}
+/**
+ * A template job is admitted with inputs that say what the page is for, for
+ * a site of the job's own org that holds the collection it names, with a
+ * template to spare.
+ */
+export declare function createAiTemplateJobAdmission(deps?: AiTemplateJobAdmissionDeps): AiJobAdmission;
+export interface AiJobTemplateStepDeps {
+    /** The inventory reader; specs hand in a fake. */
+    readInventory?: typeof readSiteInventory;
+    /** The platform's duplicate module, for a plan that starts from a copy. */
+    duplicate?: typeof duplicateResource;
+    readCollection?: typeof readAiTemplateCollection;
+    /** The starter examples block; built from the starters once per process otherwise. */
+    examples?: () => AiSystemBlock;
+}
+export declare function createAiJobTemplateStep(deps?: AiJobTemplateStepDeps): AiJobStepRunner;
+export declare const runAiJobTemplateStep: AiJobStepRunner;
+/** Registers the template step and the check a template job passes before it is created or resumed. */
+export declare function registerAiTemplateJob(): void;

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

@@ -0,0 +1,391 @@
+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 { hostCollectionKind } from "@aglyn/aglyn/app-utils/collection-kind";
+import { normalizeScreenSlug } from "@aglyn/aglyn/app-utils/screen-route";
+import { duplicateResource } from "@aglyn/tenant-data-admin/server/duplicate-resource";
+import { AI_TEMPLATE_SUBJECT_DEFINITIONS, AI_TEMPLATE_SUBJECTS, aiBindingTokensIn, aiTemplateAddressTokens, parseAiTemplateJobInputs } from "../model/ai-template-subjects.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 { walkTree } from "../runtime/ai-doctrine-validators.js";
+import { AI_PALETTE } from "../runtime/ai-palette.generated.js";
+import { aiTemplateExamplesSystemBlock } from "../runtime/ai-template-examples.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 { 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 template step (AGL-2909): the generation step of a `template` job, run
+ * once a member confirmed the job's plan.
+ *
+ * It builds ONE page template — the page a site renders once per record: a
+ * content collection's entry, a product, an author — through
+ * `runValidatedGeneration('template', …)`. Everything that differs per
+ * record is a binding token from the subject's vocabulary
+ * (`model/ai-template-subjects.ts`), which is the list the besigner's insert
+ * picker offers for that page; a link or media prop may hold one of those
+ * tokens whole, which the palette validator admits only because this door
+ * names them. The door adds one check of its own through `extend` (rule 8):
+ * no token the page does not fill, an h1 bound to the subject's title, and no
+ * block that fills itself only on another subject's page.
+ *
+ * The model is shown the platform's starter pages as examples, in a cached
+ * block (`runtime/ai-template-examples.ts`), and writes against them.
+ *
+ * The template lands in the site's library as a new draft
+ * (`ai-job-drafts.ts`), inert until a member uses it: bound to no
+ * collection, set as no product or author page, served nowhere. A plan that
+ * starts from a copy of a template the site has gets that copy instead.
+ */ /** The longest answer a template may run to; the tree is held to the template budget either way. */ export const AI_JOB_TEMPLATE_MAX_TOKENS = AI_ROUTING_TABLE['job.template'].maxTokens;
+/**
+ * The template step's time (AGL-3035, AGL-3036): its two inventory-lookup
+ * rounds, its answer and its re-ask at the routing table's ceiling on the tier
+ * `job.template` is served from, fitted to what a beat can give a step. It
+ * runs on the job beat, never at an inline door, and asks for no more of the
+ * ceiling than fits that time on the model it runs.
+ */ export const AI_JOB_TEMPLATE_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.template'],
+    maxTokens: AI_JOB_TEMPLATE_MAX_TOKENS
+});
+/** The least time one template step needs before it starts. */ export const AI_JOB_TEMPLATE_STEP_MINIMUM_MS = AI_JOB_TEMPLATE_STEP_BUDGET.minimumMs;
+/** The template step's own instructions, cached after the doctrine and before the examples. */ export const AI_JOB_TEMPLATE_INSTRUCTIONS = [
+    {
+        text: [
+            'You build one page template: the page a website renders once for each record it keeps, such as each entry of a content collection, each product or each author. Answer with submit_template: the whole page as one flat node map.',
+            'Everything that differs from one record to the next is a binding token, never typed copy. The request names what the page is for, the tokens that page fills and the blocks that fill themselves there; bind only those tokens.',
+            'The page’s one h1 holds the title token the request names. Copy that reads the same on every record, such as a section heading, is written in the site’s voice.',
+            'A link or media prop holds exactly one token from the request’s link and media tokens, such as an Image whose src is {{entry.coverImage}}; its alt text may combine words and tokens.',
+            'The page renders inside the site’s layout, so it carries no header, navigation or footer of its own.'
+        ].join('\n')
+    }
+];
+/** The content collection by that id on the site, or `null` when there is none. */ export async function readAiTemplateCollection(firestore, hostId, collectionId) {
+    var _snapshot_data;
+    const snapshot = await firestore.collection('hosts').doc(hostId).collection('collections').doc(collectionId).get();
+    if (!snapshot.exists) return null;
+    const data = (_snapshot_data = snapshot.data()) != null ? _snapshot_data : {};
+    if (hostCollectionKind(data) !== 'content') return null;
+    const text = (value)=>typeof value === 'string' ? value.trim() : '';
+    const slug = text(data['slug']);
+    return {
+        id: collectionId,
+        name: text(data['displayName']) || text(data['name']) || slug || collectionId,
+        slug
+    };
+}
+/** The template's name: the plan's, else the collection's or the subject's. */ export function aiTemplateDraftName(definition, collection, planned) {
+    return planned || (collection ? `${collection.name} entry template` : definition.defaultName);
+}
+/** The address Use template offers for the page it creates. */ export function aiTemplateDraftSlug(definition, collection) {
+    var _normalizeScreenSlug;
+    return (_normalizeScreenSlug = normalizeScreenSlug(collection ? `${collection.slug || collection.id}-entry-template` : `${definition.subject}-page-template`)) != null ? _normalizeScreenSlug : null;
+}
+/** The template job as the generation's user turn. */ export function aiJobTemplatePrompt(job, definition, collection, plan, name) {
+    const of = collection ? ` of the "${collection.name}" collection${collection.slug ? ` (/${collection.slug})` : ''}` : '';
+    return [
+        `Template name: ${name}`,
+        `The page is for ${definition.noun}${of}.`,
+        `Title token: ${definition.titleToken}`,
+        `Tokens this page fills: ${definition.tokens.map((entry)=>`${entry.token} ${entry.label}`).join('; ')}`,
+        `Link and media tokens: ${aiTemplateAddressTokens(definition).join(', ')}`,
+        definition.blocks.length ? `Blocks that fill themselves on this page: ${definition.blocks.join(', ')}` : 'No block fills itself on this page: bind the tokens.',
+        aiJobBriefLine(job),
+        ...aiPlanReferenceLines(plan)
+    ].join('\n');
+}
+/** Which subject's page each self-filling block belongs to. */ const BLOCK_SUBJECTS = new Map(AI_TEMPLATE_SUBJECTS.flatMap((subject)=>AI_TEMPLATE_SUBJECT_DEFINITIONS[subject].blocks.map((block)=>[
+            block,
+            AI_TEMPLATE_SUBJECT_DEFINITIONS[subject]
+        ])));
+/** Every string a prop value holds, however deeply. */ function stringsIn(value, out = []) {
+    if (typeof value === 'string') out.push(value);
+    else if (Array.isArray(value)) for (const inner of value)stringsIn(inner, out);
+    else if (value && typeof value === 'object') {
+        for (const inner of Object.values(value))stringsIn(inner, out);
+    }
+    return out;
+}
+/** The page's title: a Typography that renders as an h1. */ function isPageTitle(node) {
+    var _ref;
+    var _node_props, _node_props1;
+    if (node.componentId !== 'muiTypography') return false;
+    const element = typeof ((_node_props = node.props) == null ? void 0 : _node_props['component']) === 'string' ? String(node.props['component']) : '';
+    return (element || String((_ref = (_node_props1 = node.props) == null ? void 0 : _node_props1['variant']) != null ? _ref : '')) === 'h1';
+}
+/**
+ * The template door's check on a tree the doctrine admitted (rule 8): every
+ * token is one the page fills, the h1 binds the subject's title, and no block
+ * that fills itself on another subject's page is placed — except inside a
+ * Collection Entries card, where each fills from the card's own entry.
+ */ export function aiTemplateBindingCheck(definition) {
+    const allowed = new Set(definition.tokens.map((entry)=>entry.token));
+    return (tree)=>{
+        const nodes = tree.nodes;
+        const unknown = new Set();
+        const unknownAt = [];
+        const foreign = [];
+        const titles = [];
+        let titleBound = false;
+        for (const { id, node, ancestors } of walkTree({
+            rootId: tree.rootId,
+            nodes
+        })){
+            const tokens = stringsIn(node.props).flatMap(aiBindingTokensIn);
+            const strays = tokens.filter((token)=>!allowed.has(token));
+            if (strays.length) {
+                for (const token of strays)unknown.add(token);
+                unknownAt.push(id);
+            }
+            const owner = BLOCK_SUBJECTS.get(node.componentId);
+            const inCard = ancestors.some((ancestor)=>{
+                var _nodes_ancestor;
+                return ((_nodes_ancestor = nodes[ancestor]) == null ? void 0 : _nodes_ancestor.componentId) === 'collectionEntries';
+            });
+            if (owner && owner.subject !== definition.subject && !inCard) {
+                foreign.push({
+                    id,
+                    componentId: node.componentId,
+                    owner
+                });
+            }
+            if (isPageTitle(node)) {
+                titles.push(id);
+                if (tokens.includes(definition.titleToken)) titleBound = true;
+            }
+        }
+        const violations = [];
+        if (unknown.size) {
+            violations.push({
+                rule: 8,
+                code: 'unknown-binding',
+                message: `This binds ${[
+                    ...unknown
+                ].slice(0, 3).join(', ')}, which ${definition.noun}’s page does not fill. Bind only the tokens listed for this page.`,
+                nodeIds: aiModelNodeIds(unknownAt, tree.sourceIds)
+            });
+        }
+        // The doctrine already refuses a page with no h1 or with several.
+        if (titles.length === 1 && !titleBound) {
+            violations.push({
+                rule: 8,
+                code: 'typed-title',
+                message: `The page title is typed, so every record would show the same one. Put ${definition.titleToken} in the h1.`,
+                nodeIds: aiModelNodeIds(titles, tree.sourceIds)
+            });
+        }
+        if (foreign.length) {
+            var _ref;
+            var _AI_PALETTE_first_componentId;
+            const [first] = foreign;
+            violations.push({
+                rule: 8,
+                code: 'foreign-block',
+                message: `The ${(_ref = (_AI_PALETTE_first_componentId = AI_PALETTE[first.componentId]) == null ? void 0 : _AI_PALETTE_first_componentId.displayName) != null ? _ref : first.componentId} block fills itself only on ${first.owner.noun}’s page, and this template is for ${definition.noun}. Remove it.`,
+                nodeIds: aiModelNodeIds(foreign.map((entry)=>entry.id), tree.sourceIds)
+            });
+        }
+        return violations;
+    };
+}
+/**
+ * A template job is admitted with inputs that say what the page is for, for
+ * a site of the job's own org that holds the collection it names, with a
+ * template to spare.
+ */ export function createAiTemplateJobAdmission(deps = {}) {
+    var _deps_readCollection;
+    const readCollection = (_deps_readCollection = deps.readCollection) != null ? _deps_readCollection : readAiTemplateCollection;
+    return async (context)=>{
+        const inputs = parseAiTemplateJobInputs(context.inputs);
+        if (typeof inputs === 'string') return {
+            status: 400,
+            error: inputs
+        };
+        return aiDraftAdmissionRefusal(context.firestore, {
+            orgId: context.orgId,
+            hostId: context.hostId,
+            kind: 'template',
+            org: context.org,
+            ownCheck: async (hostId)=>inputs.collectionId && !await readCollection(context.firestore, hostId, inputs.collectionId) ? {
+                    status: 404,
+                    error: 'That content collection is not on this site'
+                } : null
+        });
+    };
+}
+export function createAiJobTemplateStep(deps = {}) {
+    var _deps_readInventory, _deps_duplicate, _deps_readCollection, _deps_examples;
+    const readInventory = (_deps_readInventory = deps.readInventory) != null ? _deps_readInventory : readSiteInventory;
+    const duplicate = (_deps_duplicate = deps.duplicate) != null ? _deps_duplicate : duplicateResource;
+    const readCollection = (_deps_readCollection = deps.readCollection) != null ? _deps_readCollection : readAiTemplateCollection;
+    const examples = (_deps_examples = deps.examples) != null ? _deps_examples : aiTemplateExamplesSystemBlock;
+    return async ({ job, now, signal, firestore, modelFor })=>{
+        var _ref, _orgSnapshot_data;
+        const hostId = job.hostId;
+        if (!hostId) throw new Error('a template job names no site, and its admission refuses one');
+        const inputs = parseAiTemplateJobInputs(job.inputs);
+        if (typeof inputs === 'string') {
+            throw new Error(`a template job's inputs no longer read as they were admitted: ${inputs}`);
+        }
+        const definition = AI_TEMPLATE_SUBJECT_DEFINITIONS[inputs.subject];
+        const output = (draft, load)=>_extends({
+                resource: 'template',
+                id: draft.id,
+                versionId: null,
+                hostId,
+                hostSubdomain: draft.hostSubdomain,
+                label: draft.name
+            }, load ? {
+                load
+            } : {});
+        // The switch's answer for this job, else the routing table's (AGL-2942).
+        const model = (_ref = modelFor == null ? void 0 : modelFor('job.template')) != null ? _ref : aiModelForStep('job.template');
+        // A run cut off after its draft was written reports that draft, found by the id the job recorded.
+        const draftId = aiJobDraftId(job, 'template');
+        const written = await readAiDraft(firestore, {
+            kind: 'template',
+            hostId,
+            id: draftId
+        });
+        if (written) return aiUnspentOutcome(model, {
+            outputs: [
+                output(written)
+            ]
+        });
+        const [inventory, orgSnapshot, collection] = await Promise.all([
+            readInventory(job.orgId, hostId, {
+                firestore
+            }),
+            firestore.collection('orgs').doc(job.orgId).get(),
+            inputs.collectionId ? readCollection(firestore, hostId, inputs.collectionId) : Promise.resolve(null)
+        ]);
+        if (inputs.collectionId && !collection) {
+            throw new Error(`collection ${inputs.collectionId} left site ${hostId} after its template job was admitted`);
+        }
+        const org = (_orgSnapshot_data = orgSnapshot.data()) != null ? _orgSnapshot_data : null;
+        const plan = aiConfirmedPlan(job);
+        const creation = aiPlanCreation(plan, 'template');
+        const name = aiTemplateDraftName(definition, collection, creation == null ? void 0 : creation.name);
+        // The plan starts from a copy of a template 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.templates.some((template)=>template.id === creation.duplicateOf)) {
+            const copy = await duplicate('template', {
+                orgId: job.orgId,
+                hostId,
+                sourceId: creation.duplicateOf,
+                name,
+                uid: job.createdBy,
+                org: org
+            });
+            if (copy.ok) {
+                const hostSubdomain = await aiSiteSubdomain(firestore, hostId);
+                return aiUnspentOutcome(model, {
+                    outputs: [
+                        output({
+                            id: copy.id,
+                            versionId: null,
+                            name: copy.name,
+                            hostSubdomain
+                        })
+                    ]
+                });
+            }
+            if (copy.ok === false && copy.status === 403) {
+                return aiUnspentOutcome(model, {
+                    review: aiLimitReview(copy.error)
+                });
+            }
+        }
+        const allowance = await aiDraftAllowanceRefusal(firestore, {
+            kind: 'template',
+            hostId,
+            org
+        });
+        if (allowance) return aiUnspentOutcome(model, {
+            review: aiLimitReview(allowance)
+        });
+        const result = await runValidatedGeneration('template', _extends({
+            step: 'job.template',
+            model,
+            instructions: [
+                ...AI_JOB_TEMPLATE_INSTRUCTIONS,
+                examples()
+            ],
+            inventory,
+            messages: [
+                {
+                    role: 'user',
+                    content: aiJobTemplatePrompt(job, definition, collection, plan, name)
+                }
+            ],
+            tool: aiDoctrineTreeTool('template'),
+            maxTokens: AI_JOB_TEMPLATE_STEP_BUDGET.maxTokens(model)
+        }, AI_ROUTING_TABLE['job.template'].thinking ? {
+            thinking: AI_ROUTING_TABLE['job.template'].thinking
+        } : {}, AI_ROUTING_TABLE['job.template'].effort ? {
+            effort: AI_ROUTING_TABLE['job.template'].effort
+        } : {}, {
+            context: {
+                bindingTokens: aiTemplateAddressTokens(definition)
+            },
+            extend: aiTemplateBindingCheck(definition)
+        }, 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 = await writeAiDraft(firestore, {
+            kind: 'template',
+            hostId,
+            id: draftId,
+            uid: job.createdBy,
+            org,
+            name,
+            nodes: result.value.nodes,
+            slug: aiTemplateDraftSlug(definition, collection),
+            now
+        });
+        if (draft.ok === false) {
+            if (draft.status === 404) throw new Error(`site ${hostId} vanished while its template was generated`);
+            return _extends({}, spent, {
+                review: aiLimitReview(draft.error)
+            });
+        }
+        return _extends({}, spent, {
+            outputs: [
+                output(draft, result.value.load)
+            ]
+        });
+    };
+}
+export const runAiJobTemplateStep = createAiJobTemplateStep();
+/** Registers the template step and the check a template job passes before it is created or resumed. */ export function registerAiTemplateJob() {
+    registerAiJobStep('template', runAiJobTemplateStep, {
+        minimumMs: AI_JOB_TEMPLATE_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission('template', createAiTemplateJobAdmission());
+}
+
+//# sourceMappingURL=ai-job-template-step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-template-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 { hostCollectionKind } from '@aglyn/aglyn/app-utils/collection-kind'\nimport { normalizeScreenSlug } from '@aglyn/aglyn/app-utils/screen-route'\nimport type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport type { AiJob, AiJobOutput, AiJobPlan } from '../model/ai-jobs.types'\nimport {\n  AI_TEMPLATE_SUBJECT_DEFINITIONS,\n  AI_TEMPLATE_SUBJECTS,\n  aiBindingTokensIn,\n  aiTemplateAddressTokens,\n  parseAiTemplateJobInputs,\n  type AiTemplateSubjectDefinition,\n} from '../model/ai-template-subjects'\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 {\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport { AI_PALETTE } from '../runtime/ai-palette.generated'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { aiTemplateExamplesSystemBlock } from '../runtime/ai-template-examples'\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  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 template step (AGL-2909): the generation step of a `template` job, run\n * once a member confirmed the job's plan.\n *\n * It builds ONE page template — the page a site renders once per record: a\n * content collection's entry, a product, an author — through\n * `runValidatedGeneration('template', …)`. Everything that differs per\n * record is a binding token from the subject's vocabulary\n * (`model/ai-template-subjects.ts`), which is the list the besigner's insert\n * picker offers for that page; a link or media prop may hold one of those\n * tokens whole, which the palette validator admits only because this door\n * names them. The door adds one check of its own through `extend` (rule 8):\n * no token the page does not fill, an h1 bound to the subject's title, and no\n * block that fills itself only on another subject's page.\n *\n * The model is shown the platform's starter pages as examples, in a cached\n * block (`runtime/ai-template-examples.ts`), and writes against them.\n *\n * The template lands in the site's library as a new draft\n * (`ai-job-drafts.ts`), inert until a member uses it: bound to no\n * collection, set as no product or author page, served nowhere. A plan that\n * starts from a copy of a template the site has gets that copy instead.\n */\n\n/** The longest answer a template may run to; the tree is held to the template budget either way. */\nexport const AI_JOB_TEMPLATE_MAX_TOKENS = AI_ROUTING_TABLE['job.template'].maxTokens\n\n/**\n * The template step's time (AGL-3035, AGL-3036): its two inventory-lookup\n * rounds, its answer and its re-ask at the routing table's ceiling on the tier\n * `job.template` is served from, fitted to what a beat can give a step. It\n * runs on the job beat, never at an inline door, and asks for no more of the\n * ceiling than fits that time on the model it runs.\n */\nexport const AI_JOB_TEMPLATE_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.template'],\n  maxTokens: AI_JOB_TEMPLATE_MAX_TOKENS,\n})\n\n/** The least time one template step needs before it starts. */\nexport const AI_JOB_TEMPLATE_STEP_MINIMUM_MS = AI_JOB_TEMPLATE_STEP_BUDGET.minimumMs\n\n/** The template step's own instructions, cached after the doctrine and before the examples. */\nexport const AI_JOB_TEMPLATE_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      'You build one page template: the page a website renders once for each record it keeps, such as each entry of a content collection, each product or each author. Answer with submit_template: the whole page as one flat node map.',\n      'Everything that differs from one record to the next is a binding token, never typed copy. The request names what the page is for, the tokens that page fills and the blocks that fill themselves there; bind only those tokens.',\n      'The page’s one h1 holds the title token the request names. Copy that reads the same on every record, such as a section heading, is written in the site’s voice.',\n      'A link or media prop holds exactly one token from the request’s link and media tokens, such as an Image whose src is {{entry.coverImage}}; its alt text may combine words and tokens.',\n      'The page renders inside the site’s layout, so it carries no header, navigation or footer of its own.',\n    ].join('\\n'),\n  },\n]\n\n/** A content collection an entry template is for, as the prompt and the draft name it. */\nexport interface AiTemplateCollection {\n  id: string\n  name: string\n  slug: string\n}\n\n/** The content collection by that id on the site, or `null` when there is none. */\nexport async function readAiTemplateCollection(\n  firestore: FirebaseFirestore.Firestore,\n  hostId: string,\n  collectionId: string,\n): Promise<AiTemplateCollection | null> {\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(hostId)\n    .collection('collections')\n    .doc(collectionId)\n    .get()\n  if (!snapshot.exists) return null\n  const data = (snapshot.data() ?? {}) as Record<string, unknown>\n  if (hostCollectionKind(data) !== 'content') return null\n  const text = (value: unknown) => (typeof value === 'string' ? value.trim() : '')\n  const slug = text(data['slug'])\n  return {\n    id: collectionId,\n    name: text(data['displayName']) || text(data['name']) || slug || collectionId,\n    slug,\n  }\n}\n\n/** The template's name: the plan's, else the collection's or the subject's. */\nexport function aiTemplateDraftName(\n  definition: AiTemplateSubjectDefinition,\n  collection: AiTemplateCollection | null,\n  planned: string | null | undefined,\n): string {\n  return planned || (collection ? `${collection.name} entry template` : definition.defaultName)\n}\n\n/** The address Use template offers for the page it creates. */\nexport function aiTemplateDraftSlug(\n  definition: AiTemplateSubjectDefinition,\n  collection: AiTemplateCollection | null,\n): string | null {\n  return (\n    normalizeScreenSlug(\n      collection\n        ? `${collection.slug || collection.id}-entry-template`\n        : `${definition.subject}-page-template`,\n    ) ?? null\n  )\n}\n\n/** The template job as the generation's user turn. */\nexport function aiJobTemplatePrompt(\n  job: Pick<AiJob, 'brief'>,\n  definition: AiTemplateSubjectDefinition,\n  collection: AiTemplateCollection | null,\n  plan: AiJobPlan | null,\n  name: string,\n): string {\n  const of = collection\n    ? ` of the \"${collection.name}\" collection${collection.slug ? ` (/${collection.slug})` : ''}`\n    : ''\n  return [\n    `Template name: ${name}`,\n    `The page is for ${definition.noun}${of}.`,\n    `Title token: ${definition.titleToken}`,\n    `Tokens this page fills: ${definition.tokens.map((entry) => `${entry.token} ${entry.label}`).join('; ')}`,\n    `Link and media tokens: ${aiTemplateAddressTokens(definition).join(', ')}`,\n    definition.blocks.length\n      ? `Blocks that fill themselves on this page: ${definition.blocks.join(', ')}`\n      : 'No block fills itself on this page: bind the tokens.',\n    aiJobBriefLine(job),\n    ...aiPlanReferenceLines(plan),\n  ].join('\\n')\n}\n\n/** Which subject's page each self-filling block belongs to. */\nconst BLOCK_SUBJECTS = new Map<string, AiTemplateSubjectDefinition>(\n  AI_TEMPLATE_SUBJECTS.flatMap((subject) =>\n    AI_TEMPLATE_SUBJECT_DEFINITIONS[subject].blocks.map(\n      (block) => [block, AI_TEMPLATE_SUBJECT_DEFINITIONS[subject]] as const,\n    ),\n  ),\n)\n\n/** Every string a prop value holds, however deeply. */\nfunction stringsIn(value: unknown, out: string[] = []): string[] {\n  if (typeof value === 'string') out.push(value)\n  else if (Array.isArray(value)) for (const inner of value) stringsIn(inner, out)\n  else if (value && typeof value === 'object') {\n    for (const inner of Object.values(value as Record<string, unknown>)) stringsIn(inner, out)\n  }\n  return out\n}\n\n/** The page's title: a Typography that renders as an h1. */\nfunction isPageTitle(node: AiDoctrineNode): boolean {\n  if (node.componentId !== 'muiTypography') return false\n  const element = typeof node.props?.['component'] === 'string' ? String(node.props['component']) : ''\n  return (element || String(node.props?.['variant'] ?? '')) === 'h1'\n}\n\n/**\n * The template door's check on a tree the doctrine admitted (rule 8): every\n * token is one the page fills, the h1 binds the subject's title, and no block\n * that fills itself on another subject's page is placed — except inside a\n * Collection Entries card, where each fills from the card's own entry.\n */\nexport function aiTemplateBindingCheck(\n  definition: AiTemplateSubjectDefinition,\n): (tree: AiValidatedTree) => AiDoctrineViolation[] {\n  const allowed = new Set(definition.tokens.map((entry) => entry.token))\n  return (tree) => {\n    const nodes = tree.nodes as unknown as Record<string, AiDoctrineNode>\n    const unknown = new Set<string>()\n    const unknownAt: string[] = []\n    const foreign: Array<{ id: string; componentId: string; owner: AiTemplateSubjectDefinition }> = []\n    const titles: string[] = []\n    let titleBound = false\n    for (const { id, node, ancestors } of walkTree({ rootId: tree.rootId, nodes })) {\n      const tokens = stringsIn(node.props).flatMap(aiBindingTokensIn)\n      const strays = tokens.filter((token) => !allowed.has(token))\n      if (strays.length) {\n        for (const token of strays) unknown.add(token)\n        unknownAt.push(id)\n      }\n      const owner = BLOCK_SUBJECTS.get(node.componentId)\n      const inCard = ancestors.some((ancestor) => nodes[ancestor]?.componentId === 'collectionEntries')\n      if (owner && owner.subject !== definition.subject && !inCard) {\n        foreign.push({ id, componentId: node.componentId, owner })\n      }\n      if (isPageTitle(node)) {\n        titles.push(id)\n        if (tokens.includes(definition.titleToken)) titleBound = true\n      }\n    }\n    const violations: AiDoctrineViolation[] = []\n    if (unknown.size) {\n      violations.push({\n        rule: 8,\n        code: 'unknown-binding',\n        message: `This binds ${[...unknown].slice(0, 3).join(', ')}, which ${definition.noun}’s page does not fill. Bind only the tokens listed for this page.`,\n        nodeIds: aiModelNodeIds(unknownAt, tree.sourceIds),\n      })\n    }\n    // The doctrine already refuses a page with no h1 or with several.\n    if (titles.length === 1 && !titleBound) {\n      violations.push({\n        rule: 8,\n        code: 'typed-title',\n        message: `The page title is typed, so every record would show the same one. Put ${definition.titleToken} in the h1.`,\n        nodeIds: aiModelNodeIds(titles, tree.sourceIds),\n      })\n    }\n    if (foreign.length) {\n      const [first] = foreign\n      violations.push({\n        rule: 8,\n        code: 'foreign-block',\n        message: `The ${AI_PALETTE[first.componentId]?.displayName ?? first.componentId} block fills itself only on ${first.owner.noun}’s page, and this template is for ${definition.noun}. Remove it.`,\n        nodeIds: aiModelNodeIds(\n          foreign.map((entry) => entry.id),\n          tree.sourceIds,\n        ),\n      })\n    }\n    return violations\n  }\n}\n\nexport interface AiTemplateJobAdmissionDeps {\n  readCollection?: typeof readAiTemplateCollection\n}\n\n/**\n * A template job is admitted with inputs that say what the page is for, for\n * a site of the job's own org that holds the collection it names, with a\n * template to spare.\n */\nexport function createAiTemplateJobAdmission(deps: AiTemplateJobAdmissionDeps = {}): AiJobAdmission {\n  const readCollection = deps.readCollection ?? readAiTemplateCollection\n  return async (context) => {\n    const inputs = parseAiTemplateJobInputs(context.inputs)\n    if (typeof inputs === 'string') return { status: 400, error: inputs }\n    return aiDraftAdmissionRefusal(context.firestore, {\n      orgId: context.orgId,\n      hostId: context.hostId,\n      kind: 'template',\n      org: context.org,\n      ownCheck: async (hostId) =>\n        inputs.collectionId && !(await readCollection(context.firestore, hostId, inputs.collectionId))\n          ? { status: 404, error: 'That content collection is not on this site' }\n          : null,\n    })\n  }\n}\n\nexport interface AiJobTemplateStepDeps {\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  readCollection?: typeof readAiTemplateCollection\n  /** The starter examples block; built from the starters once per process otherwise. */\n  examples?: () => AiSystemBlock\n}\n\nexport function createAiJobTemplateStep(deps: AiJobTemplateStepDeps = {}): AiJobStepRunner {\n  const readInventory = deps.readInventory ?? readSiteInventory\n  const duplicate = deps.duplicate ?? duplicateResource\n  const readCollection = deps.readCollection ?? readAiTemplateCollection\n  const examples = deps.examples ?? aiTemplateExamplesSystemBlock\n  return async ({ job, now, signal, firestore, modelFor }) => {\n    const hostId = job.hostId\n    if (!hostId) throw new Error('a template job names no site, and its admission refuses one')\n    const inputs = parseAiTemplateJobInputs(job.inputs)\n    if (typeof inputs === 'string') {\n      throw new Error(`a template job's inputs no longer read as they were admitted: ${inputs}`)\n    }\n    const definition = AI_TEMPLATE_SUBJECT_DEFINITIONS[inputs.subject]\n    const output = (draft: AiDraftRecord, load?: AiLoadEstimate | null): AiJobOutput => ({\n      resource: 'template',\n      id: draft.id,\n      versionId: null,\n      hostId,\n      hostSubdomain: draft.hostSubdomain,\n      label: draft.name,\n      ...(load ? { load } : {}),\n    })\n    // The switch's answer for this job, else the routing table's (AGL-2942).\n    const model = modelFor?.('job.template') ?? aiModelForStep('job.template')\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, 'template')\n    const written = await readAiDraft(firestore, { kind: 'template', hostId, id: draftId })\n    if (written) return aiUnspentOutcome(model, { outputs: [output(written)] })\n\n    const [inventory, orgSnapshot, collection] = await Promise.all([\n      readInventory(job.orgId, hostId, { firestore }),\n      firestore.collection('orgs').doc(job.orgId).get(),\n      inputs.collectionId\n        ? readCollection(firestore, hostId, inputs.collectionId)\n        : Promise.resolve(null),\n    ])\n    if (inputs.collectionId && !collection) {\n      throw new Error(`collection ${inputs.collectionId} left site ${hostId} after its template job was admitted`)\n    }\n    const org = (orgSnapshot.data() ?? null) as Partial<AglynOrgBilling> | null\n    const plan = aiConfirmedPlan(job)\n    const creation = aiPlanCreation(plan, 'template')\n    const name = aiTemplateDraftName(definition, collection, creation?.name)\n\n    // The plan starts from a copy of a template the site has (rule 15): the\n    // copy is the draft, and nothing is generated. A source gone since the\n    // plan was made is built from the brief instead.\n    if (\n      creation?.duplicateOf &&\n      inventory.templates.some((template) => template.id === creation.duplicateOf)\n    ) {\n      const copy = await duplicate('template', {\n        orgId: job.orgId,\n        hostId,\n        sourceId: creation.duplicateOf,\n        name,\n        uid: job.createdBy,\n        org: org as Record<string, unknown> | null,\n      })\n      if (copy.ok) {\n        const hostSubdomain = await aiSiteSubdomain(firestore, hostId)\n        return aiUnspentOutcome(model, {\n          outputs: [output({ id: copy.id, versionId: null, 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: 'template', hostId, org })\n    if (allowance) return aiUnspentOutcome(model, { review: aiLimitReview(allowance) })\n\n    const result = await runValidatedGeneration('template', {\n      step: 'job.template',\n      model,\n      instructions: [...AI_JOB_TEMPLATE_INSTRUCTIONS, examples()],\n      inventory,\n      messages: [\n        {\n          role: 'user',\n          content: aiJobTemplatePrompt(job, definition, collection, plan, name),\n        },\n      ],\n      tool: aiDoctrineTreeTool('template'),\n      maxTokens: AI_JOB_TEMPLATE_STEP_BUDGET.maxTokens(model),\n      ...(AI_ROUTING_TABLE['job.template'].thinking ? { thinking: AI_ROUTING_TABLE['job.template'].thinking } : {}),\n      ...(AI_ROUTING_TABLE['job.template'].effort ? { effort: AI_ROUTING_TABLE['job.template'].effort } : {}),\n      context: { bindingTokens: aiTemplateAddressTokens(definition) },\n      extend: aiTemplateBindingCheck(definition),\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 = await writeAiDraft(firestore, {\n      kind: 'template',\n      hostId,\n      id: draftId,\n      uid: job.createdBy,\n      org,\n      name,\n      nodes: result.value.nodes,\n      slug: aiTemplateDraftSlug(definition, collection),\n      now,\n    })\n    if (draft.ok === false) {\n      if (draft.status === 404) throw new Error(`site ${hostId} vanished while its template was generated`)\n      return { ...spent, review: aiLimitReview(draft.error) }\n    }\n    return { ...spent, outputs: [output(draft, result.value.load)] }\n  }\n}\n\nexport const runAiJobTemplateStep = createAiJobTemplateStep()\n\n/** Registers the template step and the check a template job passes before it is created or resumed. */\nexport function registerAiTemplateJob(): void {\n  registerAiJobStep('template', runAiJobTemplateStep, { minimumMs: AI_JOB_TEMPLATE_STEP_MINIMUM_MS })\n  registerAiJobAdmission('template', createAiTemplateJobAdmission())\n}\n"],"names":["hostCollectionKind","normalizeScreenSlug","duplicateResource","AI_TEMPLATE_SUBJECT_DEFINITIONS","AI_TEMPLATE_SUBJECTS","aiBindingTokensIn","aiTemplateAddressTokens","parseAiTemplateJobInputs","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","aiDoctrineTreeTool","runValidatedGeneration","walkTree","AI_PALETTE","aiTemplateExamplesSystemBlock","readSiteInventory","registerAiJobAdmission","aiJobDraftId","aiDraftAdmissionRefusal","aiDraftAllowanceRefusal","aiSiteSubdomain","readAiDraft","writeAiDraft","aiConfirmedPlan","aiDoctrineReview","aiGenerationSpent","aiJobBriefLine","aiLimitReview","aiModelNodeIds","aiPlanCreation","aiPlanReferenceLines","aiUnspentOutcome","aiJobStepBudget","registerAiJobStep","AI_JOB_TEMPLATE_MAX_TOKENS","maxTokens","AI_JOB_TEMPLATE_STEP_BUDGET","tier","AI_JOB_TEMPLATE_STEP_MINIMUM_MS","minimumMs","AI_JOB_TEMPLATE_INSTRUCTIONS","text","join","readAiTemplateCollection","firestore","hostId","collectionId","snapshot","collection","doc","get","exists","data","value","trim","slug","id","name","aiTemplateDraftName","definition","planned","defaultName","aiTemplateDraftSlug","subject","aiJobTemplatePrompt","job","plan","of","noun","titleToken","tokens","map","entry","token","label","blocks","length","BLOCK_SUBJECTS","Map","flatMap","block","stringsIn","out","push","Array","isArray","inner","Object","values","isPageTitle","node","componentId","element","props","String","aiTemplateBindingCheck","allowed","Set","tree","nodes","unknown","unknownAt","foreign","titles","titleBound","ancestors","rootId","strays","filter","has","add","owner","inCard","some","ancestor","includes","violations","size","rule","code","message","slice","nodeIds","sourceIds","first","displayName","createAiTemplateJobAdmission","deps","readCollection","context","inputs","status","error","orgId","kind","org","ownCheck","createAiJobTemplateStep","readInventory","duplicate","examples","now","signal","modelFor","orgSnapshot","Error","output","draft","load","resource","versionId","hostSubdomain","model","draftId","written","outputs","inventory","Promise","all","resolve","creation","duplicateOf","templates","template","copy","sourceId","uid","createdBy","ok","review","allowance","result","step","instructions","messages","role","content","tool","thinking","effort","bindingTokens","extend","spent","refused","runAiJobTemplateStep","registerAiTemplateJob"],"mappings":"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"}