@aglyn/plugins-ai 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/runtime/experiment-variant-copy.js

@@ -0,0 +1,102 @@
+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 { AI_TEXT_LIMITS } from "./ai-palette.js";
+/**
+ * One A/B variant's copy, put into a COPY of a page's node map (AGL-3603),
+ * which the caller stores as a new unpublished version for the variant to
+ * pin. Nothing here reads or writes a document, and the map it is handed is
+ * never changed.
+ *
+ * The copy lands in the region the test varies: the whole page's content for
+ * a page test, the one section's subtree for a section test. Within it the
+ * first heading takes the variant's headline and the first plain text after
+ * it takes the body — the same two places the copy under test was read from
+ * when a person pasted "the headline and copy as they stand". Rich text is
+ * never rewritten, structure is never changed, and a region with no plain
+ * heading or text to take the copy says so rather than guessing.
+ */ /** The text elements a variant's copy may be written into, as the SEO fixes read them. */ const TEXT_COMPONENTS = new Set([
+    'muiTypography',
+    'muiInlineText',
+    'muiListItemText'
+]);
+const HEADING = /^h[1-6]$/;
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+/** A text element's own plain text, or `null` for one a variant may not rewrite. */ function plainText(node) {
+    if (!node || !TEXT_COMPONENTS.has(String(node['componentId']))) return null;
+    const props = isRecord(node.props) ? node.props : {};
+    if (typeof props['html'] === 'string' && props['html'].trim()) return null;
+    return typeof props['children'] === 'string' ? props['children'] : null;
+}
+function isHeading(node) {
+    var _props_component, _props_variant;
+    const props = isRecord(node.props) ? node.props : {};
+    return HEADING.test(String((_props_component = props['component']) != null ? _props_component : '')) || HEADING.test(String((_props_variant = props['variant']) != null ? _props_variant : ''));
+}
+/** The region's elements in document order, the region's root first. */ function walk(nodes, rootId) {
+    const order = [];
+    const seen = new Set();
+    const visit = (id)=>{
+        if (seen.has(id) || !nodes[id]) return;
+        seen.add(id);
+        order.push(id);
+        const children = Array.isArray(nodes[id].nodes) ? nodes[id].nodes : [];
+        for (const child of children)if (typeof child === 'string') visit(child);
+    };
+    visit(rootId);
+    return order;
+}
+const line = (value, limit)=>value.replace(/\s+/g, ' ').trim().slice(0, limit).trim();
+/** Put one variant's copy into a copy of `nodes`, inside the region rooted at `regionRootId`. */ export function applyAiExperimentVariantCopy(nodes, copy, regionRootId) {
+    const result = JSON.parse(JSON.stringify(nodes));
+    if (!regionRootId || !result[regionRootId]) {
+        return {
+            nodes: result,
+            changed: [],
+            reason: 'The part of the page under test is no longer there.'
+        };
+    }
+    const order = walk(result, regionRootId);
+    const headline = line(copy.headline, AI_TEXT_LIMITS.headline);
+    const body = copy.body.replace(/\r\n?/g, '\n').trim().slice(0, AI_TEXT_LIMITS.body).trim();
+    const changed = [];
+    const headingAt = order.findIndex((id)=>plainText(result[id]) !== null && isHeading(result[id]));
+    if (headline && headingAt >= 0) {
+        var _node_props;
+        const node = result[order[headingAt]];
+        node.props = _extends({}, (_node_props = node.props) != null ? _node_props : {}, {
+            children: headline
+        });
+        changed.push('headline');
+    }
+    // The body is the first plain text after the heading, or in the region when it has none.
+    const bodyAt = order.findIndex((id, index)=>index > headingAt && plainText(result[id]) !== null && !isHeading(result[id]));
+    if (body && bodyAt >= 0) {
+        var _node_props1;
+        const node = result[order[bodyAt]];
+        node.props = _extends({}, (_node_props1 = node.props) != null ? _node_props1 : {}, {
+            children: body
+        });
+        changed.push('body');
+    }
+    return {
+        nodes: result,
+        changed,
+        reason: changed.length ? null : 'This part of the page has no plain heading or text for the variant’s copy.'
+    };
+}
+
+//# sourceMappingURL=experiment-variant-copy.js.map

package/src/lib/runtime/experiment-variant-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/experiment-variant-copy.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 { AI_TEXT_LIMITS } from './ai-palette'\n\n/**\n * One A/B variant's copy, put into a COPY of a page's node map (AGL-3603),\n * which the caller stores as a new unpublished version for the variant to\n * pin. Nothing here reads or writes a document, and the map it is handed is\n * never changed.\n *\n * The copy lands in the region the test varies: the whole page's content for\n * a page test, the one section's subtree for a section test. Within it the\n * first heading takes the variant's headline and the first plain text after\n * it takes the body — the same two places the copy under test was read from\n * when a person pasted \"the headline and copy as they stand\". Rich text is\n * never rewritten, structure is never changed, and a region with no plain\n * heading or text to take the copy says so rather than guessing.\n */\n\n/** The text elements a variant's copy may be written into, as the SEO fixes read them. */\nconst TEXT_COMPONENTS: ReadonlySet<string> = new Set(['muiTypography', 'muiInlineText', 'muiListItemText'])\n\nconst HEADING = /^h[1-6]$/\n\ntype StoredNode = Record<string, unknown> & { props?: Record<string, unknown>; nodes?: unknown }\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nexport interface AiExperimentVariantCopy {\n  headline: string\n  body: string\n}\n\nexport interface AiExperimentVariantCopyResult {\n  nodes: Record<string, StoredNode>\n  /** Which of the two the copy changed. */\n  changed: Array<'headline' | 'body'>\n  /** Why nothing changed, when nothing did; customer-safe. */\n  reason: string | null\n}\n\n/** A text element's own plain text, or `null` for one a variant may not rewrite. */\nfunction plainText(node: StoredNode | undefined): string | null {\n  if (!node || !TEXT_COMPONENTS.has(String(node['componentId']))) return null\n  const props = isRecord(node.props) ? node.props : {}\n  if (typeof props['html'] === 'string' && props['html'].trim()) return null\n  return typeof props['children'] === 'string' ? props['children'] : null\n}\n\nfunction isHeading(node: StoredNode): boolean {\n  const props = isRecord(node.props) ? node.props : {}\n  return HEADING.test(String(props['component'] ?? '')) || HEADING.test(String(props['variant'] ?? ''))\n}\n\n/** The region's elements in document order, the region's root first. */\nfunction walk(nodes: Record<string, StoredNode>, rootId: string): string[] {\n  const order: string[] = []\n  const seen = new Set<string>()\n  const visit = (id: string) => {\n    if (seen.has(id) || !nodes[id]) return\n    seen.add(id)\n    order.push(id)\n    const children = Array.isArray(nodes[id].nodes) ? (nodes[id].nodes as unknown[]) : []\n    for (const child of children) if (typeof child === 'string') visit(child)\n  }\n  visit(rootId)\n  return order\n}\n\nconst line = (value: string, limit: number) => value.replace(/\\s+/g, ' ').trim().slice(0, limit).trim()\n\n/** Put one variant's copy into a copy of `nodes`, inside the region rooted at `regionRootId`. */\nexport function applyAiExperimentVariantCopy(\n  nodes: Record<string, unknown>,\n  copy: AiExperimentVariantCopy,\n  regionRootId: string | null,\n): AiExperimentVariantCopyResult {\n  const result = JSON.parse(JSON.stringify(nodes)) as Record<string, StoredNode>\n  if (!regionRootId || !result[regionRootId]) {\n    return { nodes: result, changed: [], reason: 'The part of the page under test is no longer there.' }\n  }\n  const order = walk(result, regionRootId)\n  const headline = line(copy.headline, AI_TEXT_LIMITS.headline)\n  const body = copy.body.replace(/\\r\\n?/g, '\\n').trim().slice(0, AI_TEXT_LIMITS.body).trim()\n  const changed: AiExperimentVariantCopyResult['changed'] = []\n\n  const headingAt = order.findIndex((id) => plainText(result[id]) !== null && isHeading(result[id]))\n  if (headline && headingAt >= 0) {\n    const node = result[order[headingAt]]\n    node.props = { ...(node.props ?? {}), children: headline }\n    changed.push('headline')\n  }\n  // The body is the first plain text after the heading, or in the region when it has none.\n  const bodyAt = order.findIndex(\n    (id, index) => index > headingAt && plainText(result[id]) !== null && !isHeading(result[id]),\n  )\n  if (body && bodyAt >= 0) {\n    const node = result[order[bodyAt]]\n    node.props = { ...(node.props ?? {}), children: body }\n    changed.push('body')\n  }\n  return {\n    nodes: result,\n    changed,\n    reason: changed.length ? null : 'This part of the page has no plain heading or text for the variant’s copy.',\n  }\n}\n"],"names":["AI_TEXT_LIMITS","TEXT_COMPONENTS","Set","HEADING","isRecord","value","Array","isArray","plainText","node","has","String","props","trim","isHeading","test","walk","nodes","rootId","order","seen","visit","id","add","push","children","child","line","limit","replace","slice","applyAiExperimentVariantCopy","copy","regionRootId","result","JSON","parse","stringify","changed","reason","headline","body","headingAt","findIndex","bodyAt","index","length"],"mappings":"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"}

package/src/lib/server/ai-experiment-versions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 { AiJob } from '../model/ai-jobs.types';
+import { type AiExperimentVariantsProposalView } from '../model/ai-experiment-proposal';
+/** The id a job's variant version is stored under. */
+export declare function aiExperimentVersionId(jobId: string, index: number): string;
+/** What a version made from a variant is named in the versions list. */
+export declare function aiExperimentVersionName(name: string, index: number): string;
+export interface AiExperimentVersionsInput {
+    hostId: string;
+    screenId: string;
+    /** A section test's element; `null` for a page test. */
+    nodeId: string | null;
+    job: Pick<AiJob, '$id'>;
+    proposal: AiExperimentVariantsProposalView;
+    uid: string;
+    now?: Date;
+}
+export interface AiExperimentVersionsResult {
+    /** One per variant past the control, in order. */
+    versions: Array<{
+        index: number;
+        name: string;
+        versionId: string;
+        changed: string[];
+    }>;
+    skipped: Array<{
+        index: number;
+        reason: string;
+    }>;
+    /** Why no version could be made at all, customer-safe; `null` when one could. */
+    refusal: string | null;
+}
+/** Make the versions. Exported for the spec, which drives it against a Firestore double. */
+export declare function createAiExperimentVersions(firestore: FirebaseFirestore.Firestore, input: AiExperimentVersionsInput): Promise<AiExperimentVersionsResult>;
+export declare function POST(request: Request): Promise<Response>;
+export declare const dynamic = "force-dynamic";

package/src/lib/server/ai-experiment-versions.js

@@ -0,0 +1,270 @@
+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.
+ */ // lockdown-423: via libs/plugins/ai/src/lib/server/ai-jobs-gate.ts
+// The gate carries the org verdict; the handler adds the site's own below,
+// with the host document in hand.
+import { checkEntitlement, encodeStoredNodes, hostRoleCanWrite } from "@aglyn/aglyn/server";
+import { pageContentRootId } from "@aglyn/aglyn/app-utils/page-markdown";
+import { decodeStoredNodes } from "@aglyn/aglyn/app-utils/stored-nodes";
+import { lockdownRefusal } from "@aglyn/tenant-data-admin/server/lockdown";
+import { getAiJob, writeAiJobAudit } from "../jobs/ai-jobs.js";
+import { readAiExperimentVariants } from "../model/ai-experiment-proposal.js";
+import { applyAiExperimentVariantCopy } from "../runtime/experiment-variant-copy.js";
+import { AI_SEO_APPLY_VERSIONING_COPY } from "./ai-seo-apply.js";
+import { aiJobsGate } from "./ai-jobs-gate.js";
+/**
+ * A page's or a section's A/B variants as draft versions (AGL-3603):
+ * `POST /api/ai/experiments/versions { orgId, hostId, jobId, screenId, nodeId? }`.
+ *
+ * An `experiment` job proposes the variants' copy. For an email that copy IS
+ * the variant, and the editor holds it. For a page or a section the variant is
+ * a version of the page, which the editor only pins — so this door makes one
+ * per proposed variant past the first: the page's PUBLISHED version is
+ * copied, the variant's headline and body are put into the region the test
+ * varies (`runtime/experiment-variant-copy.ts`), and the copy is stored as a
+ * new unpublished version named for the variant.
+ *
+ * ## Nothing goes live
+ *
+ * The published version, the screen's `versionId` and the experiment document
+ * are never touched. The A/B testing editor pins each new version to its
+ * variant as an unsaved change; the person reviews the versions, saves the
+ * test and starts it. The first proposed variant is the copy as it stands, so
+ * it is the control and pins the published version, as the editor's default
+ * already does.
+ *
+ * ## The rungs
+ *
+ * The jobs read gate (membership, the release flag, `aiGenerative`, the org
+ * lockdown); then the site — the job's and the org's — a role that writes the
+ * site's content, the site's own lockdown verdict, and the `versioning`
+ * entitlement, because a page that already has a version gains retained
+ * history here, which is what that entitlement sells. Nothing spends a token.
+ *
+ * Idempotent: each version's id is derived from the job and the variant, so
+ * a second press finds the versions the first made.
+ */ const ID_CHARS = /^[A-Za-z0-9_-]{1,100}$/;
+/** The id a job's variant version is stored under. */ export function aiExperimentVersionId(jobId, index) {
+    return `ab-${jobId}-${index}`;
+}
+/** What a version made from a variant is named in the versions list. */ export function aiExperimentVersionName(name, index) {
+    const label = name.replace(/\s+/g, ' ').trim() || `Variant ${index + 1}`;
+    return `A/B: ${label}`.slice(0, 80);
+}
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** Make the versions. Exported for the spec, which drives it against a Firestore double. */ export async function createAiExperimentVersions(firestore, input) {
+    var _input_now, _input_nodeId;
+    const now = (_input_now = input.now) != null ? _input_now : new Date();
+    const screenRef = firestore.collection('hosts').doc(input.hostId).collection('screens').doc(input.screenId);
+    const screen = await screenRef.get();
+    const empty = (refusal)=>({
+            versions: [],
+            skipped: [],
+            refusal
+        });
+    if (!screen.exists || screen.get('deletedAt')) return empty('The page under test no longer exists.');
+    const publishedId = str(screen.get('versionId'));
+    const source = publishedId ? await screenRef.collection('versions').doc(publishedId).get() : null;
+    const sourceData = (source == null ? void 0 : source.exists) ? source.data() : null;
+    const nodes = sourceData ? decodeStoredNodes(sourceData['nodes']) : null;
+    if (!sourceData || !nodes) return empty('The page has no published version to start from.');
+    const rootId = typeof sourceData['rootId'] === 'string' ? sourceData['rootId'] : undefined;
+    const regionRootId = (_input_nodeId = input.nodeId) != null ? _input_nodeId : pageContentRootId(nodes, rootId);
+    const versions = [];
+    const skipped = [];
+    for (const [index, variant] of input.proposal.variants.entries()){
+        // The first variant is the copy as it stands: the control, on the published version.
+        if (index === 0) continue;
+        const versionId = aiExperimentVersionId(input.job.$id, index);
+        const name = aiExperimentVersionName(variant.name, index);
+        const versionRef = screenRef.collection('versions').doc(versionId);
+        const earlier = await versionRef.get();
+        if (earlier.exists && !earlier.get('deletedAt')) {
+            versions.push({
+                index,
+                name: str(earlier.get('displayName')) || name,
+                versionId,
+                changed: []
+            });
+            continue;
+        }
+        const result = applyAiExperimentVariantCopy(nodes, {
+            headline: variant.headline,
+            body: variant.body
+        }, regionRootId);
+        if (!result.changed.length) {
+            var _result_reason;
+            skipped.push({
+                index,
+                reason: (_result_reason = result.reason) != null ? _result_reason : 'Nothing on the page took the variant’s copy.'
+            });
+            continue;
+        }
+        // Compressed at rest, as every write of a version's nodes is.
+        const packed = encodeStoredNodes(result.nodes);
+        await versionRef.set(_extends({}, sourceData, {
+            nodes: packed ? Buffer.from(packed) : result.nodes,
+            displayName: name,
+            createdAt: now,
+            updatedAt: now,
+            createdBy: input.uid
+        }));
+        versions.push({
+            index,
+            name,
+            versionId,
+            changed: result.changed
+        });
+    }
+    return {
+        versions,
+        skipped,
+        refusal: null
+    };
+}
+export async function POST(request) {
+    var _body_orgId, _host_memberRoles, _job_outputs;
+    var _find;
+    let body;
+    try {
+        var _ref;
+        body = (_ref = await request.json()) != null ? _ref : {};
+    } catch (unused) {
+        body = {};
+    }
+    const gate = await aiJobsGate(request, String((_body_orgId = body['orgId']) != null ? _body_orgId : ''));
+    if (gate instanceof Response) return gate;
+    const hostId = str(body['hostId']);
+    const jobId = str(body['jobId']);
+    const screenId = str(body['screenId']);
+    const nodeId = str(body['nodeId']) || null;
+    if (!ID_CHARS.test(hostId) || !ID_CHARS.test(jobId) || !ID_CHARS.test(screenId)) {
+        return Response.json({
+            error: 'Name the site, the page under test and the variants to make'
+        }, {
+            status: 400
+        });
+    }
+    if (nodeId !== null && !ID_CHARS.test(nodeId)) {
+        return Response.json({
+            error: 'That is not a section of the page'
+        }, {
+            status: 400
+        });
+    }
+    const { firestore, orgId, uid, staff, org, decoded } = gate;
+    const hostSnapshot = await firestore.collection('hosts').doc(hostId).get();
+    const host = hostSnapshot.exists ? hostSnapshot.data() : null;
+    if (!host || host['orgId'] !== orgId) {
+        return Response.json({
+            error: 'Unknown site'
+        }, {
+            status: 404
+        });
+    }
+    const role = ((_host_memberRoles = host['memberRoles']) != null ? _host_memberRoles : {})[uid];
+    if (!staff && !hostRoleCanWrite(role)) {
+        return Response.json({
+            error: 'Editing requires the editor role'
+        }, {
+            status: 403
+        });
+    }
+    const locked = await lockdownRefusal({
+        request,
+        staff,
+        uid,
+        org: org,
+        host: host
+    });
+    if (locked) return locked;
+    if (!checkEntitlement(org, 'versioning')) {
+        return Response.json({
+            error: AI_SEO_APPLY_VERSIONING_COPY
+        }, {
+            status: 403
+        });
+    }
+    const job = await getAiJob(firestore, orgId, jobId);
+    if (!job || job.kind !== 'experiment' || job.hostId !== hostId) {
+        return Response.json({
+            error: 'Unknown variants'
+        }, {
+            status: 404
+        });
+    }
+    if (job.status !== 'done') {
+        return Response.json({
+            error: 'The variants are still being written'
+        }, {
+            status: 409
+        });
+    }
+    const proposal = readAiExperimentVariants((_find = ((_job_outputs = job.outputs) != null ? _job_outputs : []).find((output)=>output.resource === 'experiment')) == null ? void 0 : _find.proposal);
+    if (!proposal || proposal.target === 'email') {
+        return Response.json({
+            error: 'These variants are not a page’s or a section’s'
+        }, {
+            status: 409
+        });
+    }
+    if (proposal.target === 'section' && !nodeId) {
+        return Response.json({
+            error: 'Pick the section under test first'
+        }, {
+            status: 400
+        });
+    }
+    const result = await createAiExperimentVersions(firestore, {
+        hostId,
+        screenId,
+        nodeId: proposal.target === 'section' ? nodeId : null,
+        job,
+        proposal,
+        uid
+    });
+    if (result.refusal) return Response.json({
+        error: result.refusal
+    }, {
+        status: 409
+    });
+    const made = result.versions.filter((entry)=>entry.changed.length);
+    if (made.length) {
+        var _decoded_email;
+        await writeAiJobAudit(firestore, {
+            action: 'ai.job.apply',
+            actorUid: uid,
+            actorEmail: (_decoded_email = decoded.email) != null ? _decoded_email : null,
+            orgId,
+            jobId,
+            after: {
+                hostId,
+                screenId,
+                versions: made.map((entry)=>entry.versionId)
+            }
+        });
+    }
+    return Response.json(result, {
+        status: 200,
+        headers: {
+            'Cache-Control': 'no-store'
+        }
+    });
+}
+export const dynamic = 'force-dynamic';
+
+//# sourceMappingURL=ai-experiment-versions.js.map

package/src/lib/server/ai-experiment-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/ai-experiment-versions.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\n// lockdown-423: via libs/plugins/ai/src/lib/server/ai-jobs-gate.ts\n// The gate carries the org verdict; the handler adds the site's own below,\n// with the host document in hand.\n\nimport {\n  checkEntitlement,\n  encodeStoredNodes,\n  hostRoleCanWrite,\n} from '@aglyn/aglyn/server'\nimport { pageContentRootId } from '@aglyn/aglyn/app-utils/page-markdown'\nimport { decodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport { lockdownRefusal } from '@aglyn/tenant-data-admin/server/lockdown'\nimport { getAiJob, writeAiJobAudit } from '../jobs/ai-jobs'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport {\n  readAiExperimentVariants,\n  type AiExperimentVariantsProposalView,\n} from '../model/ai-experiment-proposal'\nimport { applyAiExperimentVariantCopy } from '../runtime/experiment-variant-copy'\nimport { AI_SEO_APPLY_VERSIONING_COPY } from './ai-seo-apply'\nimport { aiJobsGate } from './ai-jobs-gate'\n\n/**\n * A page's or a section's A/B variants as draft versions (AGL-3603):\n * `POST /api/ai/experiments/versions { orgId, hostId, jobId, screenId, nodeId? }`.\n *\n * An `experiment` job proposes the variants' copy. For an email that copy IS\n * the variant, and the editor holds it. For a page or a section the variant is\n * a version of the page, which the editor only pins — so this door makes one\n * per proposed variant past the first: the page's PUBLISHED version is\n * copied, the variant's headline and body are put into the region the test\n * varies (`runtime/experiment-variant-copy.ts`), and the copy is stored as a\n * new unpublished version named for the variant.\n *\n * ## Nothing goes live\n *\n * The published version, the screen's `versionId` and the experiment document\n * are never touched. The A/B testing editor pins each new version to its\n * variant as an unsaved change; the person reviews the versions, saves the\n * test and starts it. The first proposed variant is the copy as it stands, so\n * it is the control and pins the published version, as the editor's default\n * already does.\n *\n * ## The rungs\n *\n * The jobs read gate (membership, the release flag, `aiGenerative`, the org\n * lockdown); then the site — the job's and the org's — a role that writes the\n * site's content, the site's own lockdown verdict, and the `versioning`\n * entitlement, because a page that already has a version gains retained\n * history here, which is what that entitlement sells. Nothing spends a token.\n *\n * Idempotent: each version's id is derived from the job and the variant, so\n * a second press finds the versions the first made.\n */\n\nconst ID_CHARS = /^[A-Za-z0-9_-]{1,100}$/\n\n/** The id a job's variant version is stored under. */\nexport function aiExperimentVersionId(jobId: string, index: number): string {\n  return `ab-${jobId}-${index}`\n}\n\n/** What a version made from a variant is named in the versions list. */\nexport function aiExperimentVersionName(name: string, index: number): string {\n  const label = name.replace(/\\s+/g, ' ').trim() || `Variant ${index + 1}`\n  return `A/B: ${label}`.slice(0, 80)\n}\n\nexport interface AiExperimentVersionsInput {\n  hostId: string\n  screenId: string\n  /** A section test's element; `null` for a page test. */\n  nodeId: string | null\n  job: Pick<AiJob, '$id'>\n  proposal: AiExperimentVariantsProposalView\n  uid: string\n  now?: Date\n}\n\nexport interface AiExperimentVersionsResult {\n  /** One per variant past the control, in order. */\n  versions: Array<{ index: number; name: string; versionId: string; changed: string[] }>\n  skipped: Array<{ index: number; reason: string }>\n  /** Why no version could be made at all, customer-safe; `null` when one could. */\n  refusal: string | null\n}\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** Make the versions. Exported for the spec, which drives it against a Firestore double. */\nexport async function createAiExperimentVersions(\n  firestore: FirebaseFirestore.Firestore,\n  input: AiExperimentVersionsInput,\n): Promise<AiExperimentVersionsResult> {\n  const now = input.now ?? new Date()\n  const screenRef = firestore.collection('hosts').doc(input.hostId).collection('screens').doc(input.screenId)\n  const screen = await screenRef.get()\n  const empty = (refusal: string): AiExperimentVersionsResult => ({ versions: [], skipped: [], refusal })\n  if (!screen.exists || screen.get('deletedAt')) return empty('The page under test no longer exists.')\n  const publishedId = str(screen.get('versionId'))\n  const source = publishedId ? await screenRef.collection('versions').doc(publishedId).get() : null\n  const sourceData = source?.exists ? (source.data() as Record<string, unknown>) : null\n  const nodes = sourceData ? decodeStoredNodes<Record<string, unknown>>(sourceData['nodes']) : null\n  if (!sourceData || !nodes) return empty('The page has no published version to start from.')\n  const rootId = typeof sourceData['rootId'] === 'string' ? sourceData['rootId'] : undefined\n  const regionRootId = input.nodeId ?? pageContentRootId(nodes as never, rootId)\n\n  const versions: AiExperimentVersionsResult['versions'] = []\n  const skipped: AiExperimentVersionsResult['skipped'] = []\n  for (const [index, variant] of input.proposal.variants.entries()) {\n    // The first variant is the copy as it stands: the control, on the published version.\n    if (index === 0) continue\n    const versionId = aiExperimentVersionId(input.job.$id, index)\n    const name = aiExperimentVersionName(variant.name, index)\n    const versionRef = screenRef.collection('versions').doc(versionId)\n    const earlier = await versionRef.get()\n    if (earlier.exists && !earlier.get('deletedAt')) {\n      versions.push({ index, name: str(earlier.get('displayName')) || name, versionId, changed: [] })\n      continue\n    }\n    const result = applyAiExperimentVariantCopy(\n      nodes,\n      { headline: variant.headline, body: variant.body },\n      regionRootId,\n    )\n    if (!result.changed.length) {\n      skipped.push({ index, reason: result.reason ?? 'Nothing on the page took the variant’s copy.' })\n      continue\n    }\n    // Compressed at rest, as every write of a version's nodes is.\n    const packed = encodeStoredNodes(result.nodes)\n    await versionRef.set({\n      ...sourceData,\n      nodes: packed ? Buffer.from(packed) : result.nodes,\n      displayName: name,\n      createdAt: now,\n      updatedAt: now,\n      createdBy: input.uid,\n    })\n    versions.push({ index, name, versionId, changed: result.changed })\n  }\n  return { versions, skipped, refusal: null }\n}\n\nexport async function POST(request: Request): Promise<Response> {\n  let body: Record<string, unknown>\n  try {\n    body = ((await request.json()) ?? {}) as Record<string, unknown>\n  } catch {\n    body = {}\n  }\n  const gate = await aiJobsGate(request, String(body['orgId'] ?? ''))\n  if (gate instanceof Response) return gate\n  const hostId = str(body['hostId'])\n  const jobId = str(body['jobId'])\n  const screenId = str(body['screenId'])\n  const nodeId = str(body['nodeId']) || null\n  if (!ID_CHARS.test(hostId) || !ID_CHARS.test(jobId) || !ID_CHARS.test(screenId)) {\n    return Response.json({ error: 'Name the site, the page under test and the variants to make' }, { status: 400 })\n  }\n  if (nodeId !== null && !ID_CHARS.test(nodeId)) {\n    return Response.json({ error: 'That is not a section of the page' }, { status: 400 })\n  }\n  const { firestore, orgId, uid, staff, org, decoded } = gate\n\n  const hostSnapshot = await firestore.collection('hosts').doc(hostId).get()\n  const host = hostSnapshot.exists ? (hostSnapshot.data() as Record<string, unknown>) : null\n  if (!host || host['orgId'] !== orgId) {\n    return Response.json({ error: 'Unknown site' }, { status: 404 })\n  }\n  const role = ((host['memberRoles'] ?? {}) as Record<string, unknown>)[uid]\n  if (!staff && !hostRoleCanWrite(role)) {\n    return Response.json({ error: 'Editing requires the editor role' }, { status: 403 })\n  }\n  const locked = await lockdownRefusal({\n    request,\n    staff,\n    uid,\n    org: org as Record<string, unknown>,\n    host: host as never,\n  })\n  if (locked) return locked\n  if (!checkEntitlement(org, 'versioning')) {\n    return Response.json({ error: AI_SEO_APPLY_VERSIONING_COPY }, { status: 403 })\n  }\n\n  const job = await getAiJob(firestore, orgId, jobId)\n  if (!job || job.kind !== 'experiment' || job.hostId !== hostId) {\n    return Response.json({ error: 'Unknown variants' }, { status: 404 })\n  }\n  if (job.status !== 'done') {\n    return Response.json({ error: 'The variants are still being written' }, { status: 409 })\n  }\n  const proposal = readAiExperimentVariants(\n    (job.outputs ?? []).find((output) => output.resource === 'experiment')?.proposal,\n  )\n  if (!proposal || proposal.target === 'email') {\n    return Response.json({ error: 'These variants are not a page’s or a section’s' }, { status: 409 })\n  }\n  if (proposal.target === 'section' && !nodeId) {\n    return Response.json({ error: 'Pick the section under test first' }, { status: 400 })\n  }\n\n  const result = await createAiExperimentVersions(firestore, {\n    hostId,\n    screenId,\n    nodeId: proposal.target === 'section' ? nodeId : null,\n    job,\n    proposal,\n    uid,\n  })\n  if (result.refusal) return Response.json({ error: result.refusal }, { status: 409 })\n  const made = result.versions.filter((entry) => entry.changed.length)\n  if (made.length) {\n    await writeAiJobAudit(firestore, {\n      action: 'ai.job.apply',\n      actorUid: uid,\n      actorEmail: decoded.email ?? null,\n      orgId,\n      jobId,\n      after: { hostId, screenId, versions: made.map((entry) => entry.versionId) },\n    })\n  }\n  return Response.json(result, { status: 200, headers: { 'Cache-Control': 'no-store' } })\n}\n\nexport const dynamic = 'force-dynamic'\n"],"names":["checkEntitlement","encodeStoredNodes","hostRoleCanWrite","pageContentRootId","decodeStoredNodes","lockdownRefusal","getAiJob","writeAiJobAudit","readAiExperimentVariants","applyAiExperimentVariantCopy","AI_SEO_APPLY_VERSIONING_COPY","aiJobsGate","ID_CHARS","aiExperimentVersionId","jobId","index","aiExperimentVersionName","name","label","replace","trim","slice","str","value","createAiExperimentVersions","firestore","input","now","Date","screenRef","collection","doc","hostId","screenId","screen","get","empty","refusal","versions","skipped","exists","publishedId","source","sourceData","data","nodes","rootId","undefined","regionRootId","nodeId","variant","proposal","variants","entries","versionId","job","$id","versionRef","earlier","push","changed","result","headline","body","length","reason","packed","set","Buffer","from","displayName","createdAt","updatedAt","createdBy","uid","POST","request","host","json","gate","String","Response","test","error","status","orgId","staff","org","decoded","hostSnapshot","role","locked","kind","outputs","find","output","resource","target","made","filter","entry","action","actorUid","actorEmail","email","after","map","headers","dynamic"],"mappings":"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"}

package/src/lib/server/ai-jobs-resume.js

@@ -17,7 +17,9 @@
 // The POST climbs `aiGateLadder`, whose lockdown rung is the verdict.
 import { randomUUID } from "crypto";
 import { aiJobAdmissionRefusal, aiJobSiteRefusal } from "../jobs/ai-job-admission.js";
-import { AI_JOB_INLINE_BUDGET_MS, aiJobNextStepMinimumMs, aiJobSummary, getAiJob, resumeAiJob, runAiJobStep, writeAiJobAudit } from "../jobs/ai-jobs.js";
+import { AI_JOB_INLINE_BUDGET_MS, aiJobNextStepMinimumMs, aiJobSummary, getAiJob, aiBuildRetryable, resumeAiJob, retryAiBuildJob, runAiJobStep, writeAiJobAudit } from "../jobs/ai-jobs.js";
+import { aiBuildFreeBalanceRefusal, aiBuildFreeTaste } from "../jobs/ai-job-build-step.js";
+import { aiBuildCreditEstimate, aiBuildRetryLedger, aiBuildUnits, aiLedgerUnits } from "../model/ai-build-job.js";
 import { aiGateLadder } from "../runtime/ai-gate.js";
 import { releaseAssistMessage } from "../usage/assist-usage.js";
 /**
@@ -83,6 +85,31 @@ export async function POST(request, context) {
             status: 400
         });
     }
+    // Try again on a build (AGL-3616): its failed items and what they left
+    // unbuilt, never what succeeded, and never its plan again.
+    const retryFailedItems = (payload == null ? void 0 : payload['retry']) === 'failed-items';
+    if (retryFailedItems) {
+        const refusal = await aiBuildRetryRefusal(gate, existing).catch((error)=>{
+            console.error('ai build retry admission failed', {
+                orgId: gate.orgId,
+                jobId,
+                error
+            });
+            return {
+                status: 500,
+                error: 'The AI job could not be resumed'
+            };
+        });
+        if (refusal) {
+            await release();
+            return Response.json({
+                error: refusal.error,
+                job: aiJobSummary(existing, new Date())
+            }, {
+                status: refusal.status
+            });
+        }
+    }
     // A confirmed plan runs the step that writes, and an allowance free when the
     // job was created may be used by now (AGL-2909): the kind is asked again
     // before anything runs, and a refusal leaves the job waiting for review.
@@ -129,9 +156,11 @@ export async function POST(request, context) {
         }
     }
     const now = new Date();
-    const { job, changed } = await resumeAiJob(gate.firestore, gate.orgId, jobId, {
+    const { job, changed } = retryFailedItems ? await retryAiBuildJob(gate.firestore, gate.orgId, jobId, now) : await resumeAiJob(gate.firestore, gate.orgId, jobId, {
         uid: gate.uid
-    }, now);
+    }, now, {
+        publishConfirmed: (payload == null ? void 0 : payload['publish']) === true
+    });
     if (!changed) {
         await release();
         return Response.json({
@@ -149,7 +178,7 @@ export async function POST(request, context) {
         jobId,
         after: {
             status: job.status,
-            reason: (_ref1 = (_existing_review = existing.review) == null ? void 0 : _existing_review.reason) != null ? _ref1 : null,
+            reason: retryFailedItems ? 'retry-failed-items' : (_ref1 = (_existing_review = existing.review) == null ? void 0 : _existing_review.reason) != null ? _ref1 : null,
             kind: existing.kind
         }
     });
@@ -203,6 +232,47 @@ export async function POST(request, context) {
         status: 200
     });
 }
+/**
+ * Why a build's Try again cannot run (AGL-3616), or `null`: it is not a
+ * finished build, the site switched AI off, or — on the Free taste — the
+ * month's Free credits do not cover what the retried items are estimated at.
+ */ async function aiBuildRetryRefusal(gate, job) {
+    var _job_hostId;
+    var _job_plan, _job_items;
+    const plan = ((_job_plan = job.plan) == null ? void 0 : _job_plan.status) === 'confirmed' ? job.plan : null;
+    if (!aiBuildRetryable(job) || !plan || !((_job_items = job.items) == null ? void 0 : _job_items.length)) {
+        return {
+            status: 409,
+            error: 'Only a finished build can try its failed items again'
+        };
+    }
+    const site = await aiJobSiteRefusal({
+        firestore: gate.firestore,
+        org: gate.org,
+        hostId: (_job_hostId = job.hostId) != null ? _job_hostId : null
+    });
+    if (site) return site;
+    const { retried } = aiBuildRetryLedger(job.items, job.kind === 'site' ? aiLedgerUnits(job.items) : aiBuildUnits(plan));
+    if (!retried.length) return {
+        status: 409,
+        error: 'Nothing in this build is left to try again'
+    };
+    // A site's retried parts are its own pages and creations, held by the
+    // reservation each pass takes; a build's are estimated against the Free taste.
+    if (job.kind === 'site' || !aiBuildFreeTaste(gate.org)) return null;
+    const refusal = await aiBuildFreeBalanceRefusal({
+        firestore: gate.firestore,
+        org: gate.org,
+        estimate: aiBuildCreditEstimate(plan, {
+            slots: new Set(retried)
+        }),
+        now: new Date()
+    });
+    return refusal ? {
+        status: 403,
+        error: refusal
+    } : null;
+}
 export const dynamic = 'force-dynamic';
 export const maxDuration = 60;