@aglyn/plugins-ai 1.0.0-beta.271 → 1.0.0-beta.273

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

@@ -29,7 +29,7 @@ import { aiModelForStep } from "../providers/routing.js";
 import { registerAiJobAdmission } from "./ai-job-admission.js";
 import { aiOriginJobId, aiRecordedJobDraftId } from "./ai-job-draft-ids.js";
 import { readAiDraftNodes } from "./ai-job-drafts.js";
-import { AI_STOCK_PHOTO_AVOID_INPUT, AI_STOCK_PHOTO_JOB_PHOTOS_INPUT, AI_STOCK_PHOTO_PAGES_INPUT } from "./ai-layout-stock-photos.js";
+import { AI_STOCK_PHOTO_AVOID_INPUT, AI_STOCK_PHOTO_JOB_PHOTOS_INPUT, AI_STOCK_PHOTO_LATE_PASS_INPUT, AI_STOCK_PHOTO_PAGES_INPUT } from "./ai-layout-stock-photos.js";
 import { AI_LAYOUT_SITE_ALIASES_INPUT, AI_LAYOUT_SITE_PAGES_INPUT, AI_LAYOUT_SITE_PAGES_MAX, aiLayoutIsHomeSlug, aiLayoutSitePagesOfPlan } from "./ai-job-layout-site-pages.js";
 import { aiPageSectionNodeId } from "./ai-job-page-sections.js";
 import { AI_LAYOUT_LISTINGS_INPUT, aiLayoutIsShopPage } from "../layout-language/ai-layout-listings.js";
@@ -47,6 +47,8 @@ import { AI_FORM_DATASET_MADE_INPUT } from "./ai-job-form-dataset.js";
 import { aiConfirmedPlan, aiUnspentOutcome } from "./ai-job-generation.js";
 import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
 import { AI_JOB_PAGE_STEP_MINIMUM_MS } from "./ai-job-page-budget.js";
+import { aiSiteMergePhotos, aiSitePhotosOwed } from "../model/ai-site-photos.js";
+import { AI_SITE_LATE_PHOTOS_MINIMUM_MS, aiSiteLatePhotos } from "./ai-site-late-photos.js";
 import { AI_SITE_INSPIRATION_SIGNALS_INPUT, aiSiteInspirationReleased } from "./ai-site-inspiration.js";
 import { aiSiteInspirationRefusal } from "../model/ai-site-inspiration.js";
 import { aiJobStepRunMinimumMs, aiJobStepRunnerFor, registerAiJobStep, registerAiJobStepPasses } from "./ai-jobs.js";
@@ -142,13 +144,18 @@ import { aiJobStepRunMinimumMs, aiJobStepRunnerFor, registerAiJobStep, registerA
 export const AI_SITE_NO_PLAN_COPY = 'This site job has no confirmed plan to build.';
 /** What a scaffold answers where the step that builds a page is not loaded. */ export const AI_SITE_NO_PAGE_STEP_COPY = 'Building a whole site is not available yet.';
 /** A unit that finished without reporting what it built; the scaffold cannot go on. */ export const AI_SITE_UNIT_EMPTY_COPY = 'Part of this site could not be built. Try the site brief again.';
+/**
+ * The passes the late photo pass may add (AGL-3988): the one that hands the
+ * publish to it, its own, and one more where a beat's time ran out on it.
+ * That last one publishes whatever the pictures hold (`latePasses`).
+ */ export const AI_SITE_LATE_PHOTOS_PASSES = 3;
 /**
  * The most passes a scaffold's step may take: the largest plan it admits —
  * eight pages of eight sections, its three creations, a blog's first posts
- * (one a pass, the largest part) and a welcome email — with nothing to
- * spare, so a runner that never finishes is still bounded while a real site
- * is not.
- */ export const AI_SITE_MAX_PASSES = AI_SITE_PAGES.max * (AI_SITE_MAX_SECTIONS + 1) + CREATION_UNITS.length + AI_SITE_DATASETS_MAX + AI_SITE_EVENTS_MAX + AI_SITE_POSTS + 2;
+ * (one a pass, the largest part), a welcome email and the late photo pass
+ * (AGL-3988) — with nothing to spare, so a runner that never finishes is
+ * still bounded while a real site is not.
+ */ export const AI_SITE_MAX_PASSES = AI_SITE_PAGES.max * (AI_SITE_MAX_SECTIONS + 1) + CREATION_UNITS.length + AI_SITE_DATASETS_MAX + AI_SITE_EVENTS_MAX + AI_SITE_POSTS + 2 + AI_SITE_LATE_PHOTOS_PASSES;
 /**
  * The units a plan implies, in build order: the palette first, because a
  * member reads it while the pages are still building; then the layout every
@@ -546,6 +553,8 @@ export const AI_SITE_NO_PLAN_COPY = 'This site job has no confirmed plan to buil
         // Which a picture the library fails takes before any starter (AGL-3988).
         const recordPhotos = aiSiteDatasetPlacedPhotoDetails((_job_outputs4 = job.outputs) != null ? _job_outputs4 : []);
         if (recordPhotos.length) unitInputs[AI_STOCK_PHOTO_JOB_PHOTOS_INPUT] = recordPhotos;
+        // And that the site's late photo pass fills what none of them fits yet (AGL-3988).
+        if (job.kind === 'site') unitInputs[AI_STOCK_PHOTO_LATE_PASS_INPUT] = true;
     }
     // The layout is built before the pages, so it is told them (AGL-3596): their
     // ids are minted on the plan, and the platform writes the header's links.
@@ -906,6 +915,10 @@ export const aiSiteJobAdmission = createAiSiteJobAdmission();
         built: true
     };
 }
+/** The photos state a site job holds once its late photo pass is done: nothing left (AGL-3988). */ const AI_SITE_PHOTOS_SETTLED = {
+    pages: [],
+    lists: []
+};
 /** A page the scaffold reported built that holds none of its plan's sections. */ export const AI_SITE_PAGE_NOT_WRITTEN_COPY = 'A page of this site was not written from its plan. Try the site brief again.';
 /**
  * Whether a page unit's draft holds the sections its plan named, under the
@@ -1004,7 +1017,7 @@ export const aiSiteJobAdmission = createAiSiteJobAdmission();
     }).filter((unit)=>unit.kind === 'store' && ledgered('store') || unit.kind === 'theme' || unit.kind === 'posts' && ledgered('posts') || unit.kind === 'dataset' || unit.kind === 'event' || unit.kind !== 'store' && runnerFor(unit.jobKind));
 }
 export function createAiJobSiteStep(deps = {}) {
-    var _deps_runnerFor, _deps_readNodes, _deps_publish, _deps_siteName, _deps_look, _deps_contentRefusal, _deps_datasetRefusal, _deps_eventRefusal, _deps_storePagesRefusal, _deps_publishPosts, _deps_dropCache, _deps_restoreBlogEntry;
+    var _deps_runnerFor, _deps_readNodes, _deps_publish, _deps_siteName, _deps_look, _deps_contentRefusal, _deps_datasetRefusal, _deps_eventRefusal, _deps_storePagesRefusal, _deps_publishPosts, _deps_dropCache, _deps_restoreBlogEntry, _deps_latePhotos;
     const runnerFor = (_deps_runnerFor = deps.runnerFor) != null ? _deps_runnerFor : aiJobStepRunnerFor;
     const readNodes = (_deps_readNodes = deps.readNodes) != null ? _deps_readNodes : readAiDraftNodes;
     const publish = (_deps_publish = deps.publish) != null ? _deps_publish : aiPublishGuidedSite;
@@ -1017,8 +1030,9 @@ export function createAiJobSiteStep(deps = {}) {
     const publishPosts = (_deps_publishPosts = deps.publishPosts) != null ? _deps_publishPosts : aiPublishSitePosts;
     const dropCache = (_deps_dropCache = deps.dropCache) != null ? _deps_dropCache : dropPluginSiteCache;
     const restoreBlogEntry = (_deps_restoreBlogEntry = deps.restoreBlogEntry) != null ? _deps_restoreBlogEntry : aiRestoreGuidedBlogEntry;
+    const latePhotos = (_deps_latePhotos = deps.latePhotos) != null ? _deps_latePhotos : aiSiteLatePhotos;
     return async (context)=>{
-        var _ref, _job_outputs, _deps_posts, _deps_products, _deps_dataset, _deps_event, _deps_storePages, _job_outputs1;
+        var _ref, _job_outputs, _job_sitePhotos, _deps_posts, _deps_products, _deps_dataset, _deps_event, _deps_storePages, _job_outputs1;
         var _job_items, _rows_get, _rows_get1, _rows_get2, _rows_get3;
         const { job } = context;
         // The scaffold asks no model of its own. What it names where it spends
@@ -1059,6 +1073,17 @@ export function createAiJobSiteStep(deps = {}) {
             ]));
         const next = aiBuildNextUnit(ledgerUnits, ledger);
         /**
+     * The pictures the start left on a starter (AGL-3988): what the job
+     * holds, with what this pass's unit reported merged in once it ran.
+     */ let photos = (_job_sitePhotos = job.sitePhotos) != null ? _job_sitePhotos : null;
+        let photosReported = false;
+        /**
+     * Whether the publish waits for the late photo pass: a record, or a
+     * picture of a page it puts live, is still on a starter. A page that
+     * failed is not published, so its pictures owe nothing. `pages`: the
+     * pages built so far, the one this pass built among them.
+     */ const latePhotosOwed = (pages)=>Boolean(job.hostId) && aiSitePhotosOwed(photos, pages.map((page)=>page.id));
+        /**
      * A guided start's last pass puts what it built on the site (AGL-3596):
      * only its pages that were built. Once it has, Try again's last pass puts
      * only the pages the retry built live (AGL-3730), never the home address
@@ -1240,7 +1265,40 @@ export function createAiJobSiteStep(deps = {}) {
                     unit.screen.id
                 ] : [];
             });
-        if (!next) return finish(_extends({}, aiUnspentOutcome(model), init), builtPages());
+        if (!next) {
+            // Every part is built: the pictures left on a starter take the job's
+            // own photos before the site goes live (AGL-3988), in a pass of their
+            // own, sized to wait out the image hosts' burst.
+            if (latePhotosOwed(builtPages()) && photos && !await aiJobCancelAsked(context.firestore, job, context.signal)) {
+                var _context_org, _photos_latePasses;
+                const late = await latePhotos(_extends({
+                    firestore: context.firestore,
+                    job,
+                    photos,
+                    pageIds: builtPages().map((page)=>page.id),
+                    org: (_context_org = context.org) != null ? _context_org : null,
+                    now: context.now
+                }, context.signal ? {
+                    signal: context.signal
+                } : {}));
+                // A pass whose time ran out while it waited hands what is left to the
+                // next, inside the passes the bound gives it: the last one publishes
+                // whatever the pictures hold, so a site is never held back by them.
+                const latePasses = ((_photos_latePasses = photos.latePasses) != null ? _photos_latePasses : 0) + 1;
+                if (late.photos && latePasses < AI_SITE_LATE_PHOTOS_PASSES - 1) {
+                    return _extends({}, aiUnspentOutcome(model), init, {
+                        continue: true,
+                        sitePhotos: _extends({}, late.photos, {
+                            latePasses
+                        })
+                    });
+                }
+                return finish(_extends({}, aiUnspentOutcome(model), init, {
+                    sitePhotos: AI_SITE_PHOTOS_SETTLED
+                }), builtPages());
+            }
+            return finish(_extends({}, aiUnspentOutcome(model), init), builtPages());
+        }
         const unit = units.find((one)=>one.slot === next.slot);
         // The look is the scaffold's own pass (AGL-3660), not the theme job's proposal.
         const catalog = unit.kind === 'products' ? runnerFor('products') : undefined;
@@ -1267,13 +1325,17 @@ export function createAiJobSiteStep(deps = {}) {
                 item
             }, item.status === 'running' || othersOpen ? {
                 continue: true
+            } : {}, photosReported ? {
+                sitePhotos: photos != null ? photos : AI_SITE_PHOTOS_SETTLED
             } : {});
         /**
      * A unit that failed or was skipped with nothing else open ends the job
      * on this pass (AGL-3676): a guided start whose last unit — its welcome
      * email — failed was never published, because the pass that publishes is
      * the one after. So the end is the publish, whatever the last unit came to.
-     */ const closing = async (outcome)=>outcome.continue ? outcome : finish(outcome, builtPages());
+     */ const closing = async (outcome)=>outcome.continue ? outcome : latePhotosOwed(builtPages()) ? _extends({}, outcome, {
+                continue: true
+            }) : finish(outcome, builtPages());
         // A blog's posts and a store's products ask, before their first pass,
         // whether this member may have them here (AGL-3676): a refusal spends
         // nothing, and the row says why, as a build's item does.
@@ -1424,6 +1486,11 @@ export function createAiJobSiteStep(deps = {}) {
                 }
             }));
         }
+        // The pictures this unit left on a starter, kept on the job for the late photo pass (AGL-3988).
+        if (outcome.sitePhotos) {
+            photos = aiSiteMergePhotos(photos, outcome.sitePhotos);
+            photosReported = true;
+        }
         const spent = aiUnitSpend(outcome);
         const stopped = aiUnitFailure(unit.slot, outcome);
         if (stopped) {
@@ -1472,7 +1539,12 @@ export function createAiJobSiteStep(deps = {}) {
         rows.set(unit.slot, _extends({}, rows.get(unit.slot), {
             status: degraded ? 'degraded' : 'succeeded'
         }));
-        return finish(done, builtPages(unit.kind === 'page' && !templates.has(unit.slot) || unit.kind === 'store' ? outcome.outputs.filter((output)=>output.resource === 'screen') : []));
+        const live = builtPages(unit.kind === 'page' && !templates.has(unit.slot) || unit.kind === 'store' ? outcome.outputs.filter((output)=>output.resource === 'screen') : []);
+        // The publish waits a pass for the late photo pass (AGL-3988).
+        if (latePhotosOwed(live)) return _extends({}, done, {
+            continue: true
+        });
+        return finish(done, live);
     };
 }
 export const runAiJobSiteStep = createAiJobSiteStep();
@@ -1501,7 +1573,9 @@ export const runAiJobSiteStep = createAiJobSiteStep();
     const ledger = ((_job_items1 = job.items) == null ? void 0 : _job_items1.length) ? job.items : aiSiteInitialLedger(units, outputs);
     const next = aiBuildNextUnit(aiSiteLedgerUnits(units), ledger);
     const unit = next ? units.find((one)=>one.slot === next.slot) : undefined;
-    if (!unit) return AI_JOB_PAGE_STEP_MINIMUM_MS;
+    // Nothing left to build: the late photo pass, where a picture is still on
+    // a starter (AGL-3988), and the publish in the same pass.
+    if (!unit) return aiSitePhotosOwed(job.sitePhotos) ? Math.max(AI_JOB_PAGE_STEP_MINIMUM_MS, AI_SITE_LATE_PHOTOS_MINIMUM_MS) : AI_JOB_PAGE_STEP_MINIMUM_MS;
     if (unit.kind === 'theme') return AI_SITE_LOOK_BUDGET.minimumMs;
     if (unit.kind === 'posts') return AI_SITE_POST_BUDGET.minimumMs;
     if (unit.kind === 'dataset') return AI_SITE_DATASET_BUDGET.minimumMs;