@aglyn/plugins-ai 1.0.0-beta.244 → 1.0.0-beta.247

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

@@ -16,7 +16,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
 import { createHash } from "node:crypto";
-import { AI_BUILD_PLAN_TOOL, aiBuildPlanToolFor, isAiPlanNewRef } from "../model/ai-build-plan.js";
+import { AI_BUILD_PLAN_TOOL, aiBuildPlanToolFor, aiPlanSlugKey, isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { AI_BUILD_PRODUCT_OP, aiBuildStorePagesFor } from "../model/ai-build-store-pages.js";
 import { readFreeAiCreditsLeft } from "../usage/free-ai-credits-left.js";
 import { AI_TEMPLATE_SUBJECT_DEFINITIONS, aiTemplateShownTokens } from "../model/ai-template-subjects.js";
@@ -24,7 +24,7 @@ import { AI_JOB_CREATE_KINDS, AI_JOB_CREATE_NOUNS } from "../model/ai-job-creati
 import { AI_PAGE_CREATE_KINDS, aiPagePlanShapeRefusal } from "../model/ai-page-job.js";
 import { AI_PLAN_COMPILED_REPEATS_SENTENCE, AI_PLAN_NO_FORM_SENTENCE, aiPlanCanPlaceForm, aiPlanCapabilitiesForJob, aiPlanCapabilityLines } from "../model/ai-plan-capabilities.js";
 import { aiSitePlanDatasetCapability } from "./ai-job-site-datasets.js";
-import { AI_FREE_SITE_WORST_CASE_CREDITS, AI_SITE_CREATE_KINDS, AI_SITE_FREE_PAGES, AI_SITE_PLAN_MAX_TOKENS, AI_SITE_HOME_BANDS, aiFreeSiteSectionsWithin, aiSiteFullPlanSentence, aiSiteHomeMinSections, aiSiteNameSentence, aiSitePlanIsHome, aiSitePlanShapeRefusal, aiSiteBlogStandInViolations, aiSiteThinHomeViolations, AI_SITE_GALLERY_SENTENCE, aiSiteEmptyGalleryViolations, AI_SITE_DATASETS_MAX } from "../model/ai-site-job.js";
+import { AI_FREE_SITE_WORST_CASE_CREDITS, AI_SITE_CREATE_KINDS, AI_SITE_FREE_PAGES, AI_SITE_PLAN_MAX_TOKENS, AI_SITE_HOME_BANDS, aiFreeSiteSectionsWithin, aiSiteFullPlanSentence, aiSiteHomeMinSections, aiSiteNameSentence, aiSitePlanIsHome, aiSitePlanShapeRefusal, aiSiteBlogStandInViolations, aiSiteThinHomeViolations, AI_SITE_GALLERY_SENTENCE, aiSiteEmptyGalleryViolations, AI_SITE_DATASETS_MAX, AI_SITE_GALLERY_MIN_ITEMS } from "../model/ai-site-job.js";
 import { aiSiteContentPart } from "./ai-job-site-content.js";
 import { aiLayoutIsShopPage, aiLayoutShopGridSection } from "../layout-language/ai-layout-listings.js";
 import { aiStorefrontPlanScreens } from "../layout-language/ai-layout-storefront.js";
@@ -43,6 +43,8 @@ import { readAiSiteContext } from "../runtime/site-context.js";
 import { aiInstructionsWithSiteContext } from "../model/ai-site-context.js";
 import { AI_BUILD_CREATE_KINDS, AI_BUILD_STRUCTURAL_OPS, aiBuildPageLimit, aiBuildPlanShapeRefusal } from "../model/ai-build-job.js";
 import { aiBuildOpLines, aiBuildOps } from "./ai-build-capabilities.js";
+import { aiBuildUnlistedEventsCheck, aiSettleBuildEventPage } from "../model/ai-build-event-page.js";
+import { aiSiteEventItemsCheck, aiSiteEventPlanLines, readAiSiteEventPlanning } from "./ai-job-site-events.js";
 import { aiJobAdmissionRefusal } from "./ai-job-admission.js";
 import { AI_CREDITS_CONFIRM_CODE } from "../model/ai-credit-estimate.js";
 import { readAiPlanCapabilities } from "./ai-job-drafts.js";
@@ -113,7 +115,7 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
  * inputs and, where the job read them, what it may create on its site
  * (AGL-3030). Per workspace and per site, which is why they ride here and
  * never in a system block the platform's cache entry is keyed on.
- */ export function aiJobPlanPrompt(job, capabilities = null, inventory = null, ops = null) {
+ */ export function aiJobPlanPrompt(job, capabilities = null, inventory = null, ops = null, now = null) {
     var _job_inputs;
     const lines = [
         `Job kind: ${job.kind}`,
@@ -132,7 +134,7 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
     }
     lines.push(...aiPlanTemplateTokenLines(job));
     lines.push(...aiPlanSiteLines(job, inventory, capabilities));
-    lines.push(...aiPlanBuildLines(job, capabilities, ops));
+    lines.push(...aiPlanBuildLines(job, capabilities, ops, now));
     return lines.join('\n');
 }
 /**
@@ -140,7 +142,7 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
  * creations and items, how many pages it may hold, and the item operations
  * this site has with their arguments. On the job's own turn, never a cached
  * system block, because the operations are per site.
- */ export function aiPlanBuildLines(job, capabilities, ops) {
+ */ export function aiPlanBuildLines(job, capabilities, ops, now = null) {
     if (job.kind !== 'build') return [];
     const pages = aiBuildPageLimit((capabilities == null ? void 0 : capabilities.freeTaste) === true);
     return [
@@ -151,9 +153,16 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
         ...(capabilities == null ? void 0 : capabilities.repeatsCompiled) ? [
             AI_PLAN_COMPILED_REPEATS_SENTENCE
         ] : [],
-        ...ops ? aiBuildOpLines(ops, AI_BUILD_STRUCTURAL_OPS) : []
+        ...ops ? aiBuildOpLines(ops, AI_BUILD_STRUCTURAL_OPS) : [],
+        // An item with a date (an event, AGL-3743) is dated after the build.
+        ...now ? [
+            aiPlanTodaySentence(now)
+        ] : []
     ];
 }
+/** The build's date, so a dated item falls after it (AGL-3743). */ export function aiPlanTodaySentence(now) {
+    return `Today is ${now.toISOString().slice(0, 10)} (UTC). Anything an item dates, such as an event, falls after today.`;
+}
 /**
  * What a SITE job's plan is told beside the inventory (AGL-3594): the pages
  * the site already has and that their addresses are taken, which one — the
@@ -350,7 +359,10 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
 /**
  * A site plan's section that shows the work without its pieces (AGL-3660),
  * asked about on the FIRST answer only, like a thin home: the re-ask names
- * the section, and an answer that keeps it thin is kept.
+ * the section, and an answer that keeps it thin is kept. A site start's plan
+ * is given its fewest pieces in code first (`aiSettlePlanGalleries`,
+ * AGL-3754), so this is the backstop for a section that settle leaves: one
+ * item of a list split into sections.
  */ export function aiSiteEmptyGalleryCheck() {
     let answers = 0;
     return (plan)=>{
@@ -470,6 +482,27 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
         ];
     };
 }
+/** The layout a site's pages render in (AGL-3755): its home page's, else its only layout, else none. */ function aiSiteLayoutOf(inventory) {
+    var _ref;
+    var _inventory_layouts_;
+    const home = inventory == null ? void 0 : inventory.screens.find((screen)=>!screen.template && aiPlanSlugKey(screen.slug) === '/');
+    if (home == null ? void 0 : home.layoutId) return home.layoutId;
+    return (inventory == null ? void 0 : inventory.layouts.length) === 1 ? (_ref = (_inventory_layouts_ = inventory.layouts[0]) == null ? void 0 : _inventory_layouts_.id) != null ? _ref : null : null;
+}
+/**
+ * A site plan's violations with its events' (AGL-3755): its items are only
+ * the events it may plan. Every other kind's are as they are.
+ */ function aiSiteWithEventItemsCheck(violations, siteEvents, ops = null) {
+    // A build's events left on no page are re-asked once (AGL-3755).
+    const unlisted = ops ? aiBuildUnlistedEventsCheck(ops) : null;
+    const events = siteEvents === undefined ? null : aiSiteEventItemsCheck(siteEvents);
+    if (!unlisted && !events) return violations;
+    return (plan)=>[
+            ...violations(plan),
+            ...events ? events(plan) : [],
+            ...unlisted ? unlisted(plan) : []
+        ];
+}
 /**
  * The inventory names of every id the plan references, so the proposal reads
  * "the Services layout" rather than an id — kept on the plan because the
@@ -695,8 +728,9 @@ export function createAiJobPlanStep(deps = {}) {
     const readOps = (_deps_readOps = deps.readOps) != null ? _deps_readOps : readAiBuildOps;
     const readContext = deps.readSiteContext === undefined ? readAiJobSiteContext : deps.readSiteContext;
     const readFreeCredits = deps.readFreeCredits === undefined ? readFreeAiCreditsLeft : deps.readFreeCredits;
+    const readSiteEvents = deps.readSiteEvents === undefined ? readAiSiteEventPlanning : deps.readSiteEvents;
     return async ({ job, now, signal, firestore, modelFor, org: orgDocument })=>{
-        var _AI_JOB_PLAN_SCOPES_job_kind, _job_inputs, _ref;
+        var _AI_JOB_PLAN_SCOPES_job_kind, _ref, _job_inputs, _ref1;
         var _aiSiteKindOfInputs, _aiSiteKindOfInputs1;
         const org = orgDocument != null ? orgDocument : null;
         const [inventory, workspace, siteContext] = await Promise.all([
@@ -728,6 +762,21 @@ export function createAiJobPlanStep(deps = {}) {
             freeTaste
         }) : null;
         const site = job.kind === 'site';
+        // An event-led start's first events (AGL-3755), only where the build's
+        // gate admits the events plugin's operation here and its writer this member.
+        const siteEvents = site && readSiteEvents ? await readSiteEvents({
+            job,
+            org,
+            firestore,
+            now,
+            readOps: ()=>readOps({
+                    job,
+                    org,
+                    firestore,
+                    freeTaste
+                })
+        }) : null;
+        const itemOps = (_ref = ops != null ? ops : siteEvents == null ? void 0 : siteEvents.ops) != null ? _ref : null;
         // A kept plan waits for its confirmation; a Free build's card is told what
         // is left, so it says before Confirm whether the build fits (AGL-3722).
         // Net of what THIS plan just spent: the machine meters the step after it
@@ -758,7 +807,10 @@ export function createAiJobPlanStep(deps = {}) {
         // provider's fast tier (AGL-3594), unless the creator picked a model.
         const model = aiSitePlanModel(job, modelFor == null ? void 0 : modelFor('job.plan'), freeTaste);
         const route = AI_ROUTING_TABLE['job.plan'];
-        const prompt = aiJobPlanPrompt(job, capabilities, inventory, ops);
+        const prompt = [
+            aiJobPlanPrompt(job, capabilities, inventory, ops, now),
+            ...siteEvents ? aiSiteEventPlanLines(siteEvents, now) : []
+        ].join('\n');
         /**
      * The confirm door's answer for this plan, asked before the plan is kept
      * (AGL-3030): the kind's own admission, handed the plan as the resume
@@ -812,10 +864,12 @@ export function createAiJobPlanStep(deps = {}) {
         const resolved = model != null ? model : aiModelForStep('job.plan');
         // A brief that asks for a video is offered the plan's list of players
         // (AGL-3433), and a job that may bind a dataset a record template on
-        // each screen (AGL-3475).
+        // each screen (AGL-3475). A site's plan says the language its brief is
+        // written in, which its guided start sets the site's language from (AGL-3750).
         const tool = aiBuildPlanToolFor(job.brief, {
             records: Boolean(inventory == null ? void 0 : inventory.datasets.length) || (capabilities == null ? void 0 : capabilities.create.dataset.allowed) === true,
-            items: job.kind === 'build'
+            items: job.kind === 'build' || Boolean(siteEvents),
+            language: site
         });
         const key = aiJobPlanKey({
             job,
@@ -831,9 +885,9 @@ export function createAiJobPlanStep(deps = {}) {
             now
         }) : null;
         if (reused) {
-            var _ref1;
+            var _ref2;
             // The reused plan's draft ids name the other job's drafts; this job's are its own.
-            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, _extends({}, reused.plan, {
+            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, reused.plan, {
                 status: 'proposed',
                 labels: aiPlanLabels(reused.plan, inventory),
                 proposedAt: now,
@@ -843,7 +897,7 @@ export function createAiJobPlanStep(deps = {}) {
                 reusedFrom: reused.jobId
             }))));
             const unspent = aiUnspentOutcome(resolved);
-            return (_ref1 = await refusalOnKeep(plan, unspent)) != null ? _ref1 : _extends({}, unspent, {
+            return (_ref2 = await refusalOnKeep(plan, unspent)) != null ? _ref2 : _extends({}, unspent, {
                 plan,
                 review: await planReview()
             });
@@ -875,8 +929,19 @@ export function createAiJobPlanStep(deps = {}) {
         } : {}, signal ? {
             signal
         } : {}, {
-            capabilities,
-            extend: planViolations(scope, job.brief, freeTaste, ops, site ? aiSitePlanHomeRule(inventory, capabilities) : null, site && aiSiteContentPart((_job_inputs = job.inputs) != null ? _job_inputs : null, freeTaste) === 'posts', site, site && ((_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) === 'store')
+            capabilities
+        }, ops ? {
+            settle: (answered)=>{
+                var _ref;
+                return aiSettleBuildEventPage(answered, {
+                    ops,
+                    siteSlugs: ((_ref = inventory == null ? void 0 : inventory.screens) != null ? _ref : []).map((screen)=>screen.slug),
+                    pageLimit: aiBuildPageLimit(freeTaste),
+                    siteLayout: aiSiteLayoutOf(inventory)
+                });
+            }
+        } : {}, {
+            extend: aiSiteWithEventItemsCheck(planViolations(scope, job.brief, freeTaste, ops, site ? aiSitePlanHomeRule(inventory, capabilities) : null, site && aiSiteContentPart((_job_inputs = job.inputs) != null ? _job_inputs : null, freeTaste) === 'posts', site, site && ((_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) === 'store'), site ? siteEvents : undefined, ops)
         }));
         const spent = _extends({
             outputs: [],
@@ -924,7 +989,7 @@ export function createAiJobPlanStep(deps = {}) {
             paid: !freeTaste
         }) : result.value;
         // Each draft the plan decides is named as the plan is kept, before anything is built (AGL-3079).
-        const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, _extends({}, answered, {
+        const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, answered, {
             status: 'proposed',
             labels: aiPlanLabels(answered, inventory),
             // A Date the Admin SDK stores as a timestamp, like every instant the machine writes.
@@ -933,7 +998,7 @@ export function createAiJobPlanStep(deps = {}) {
             confirmedBy: null,
             key
         }))));
-        return (_ref = await refusalOnKeep(plan, spent)) != null ? _ref : _extends({}, spent, {
+        return (_ref1 = await refusalOnKeep(plan, spent)) != null ? _ref1 : _extends({}, spent, {
             plan,
             review: await planReview(result.estCostUsd)
         });
@@ -973,11 +1038,13 @@ export function createAiJobPlanStep(deps = {}) {
             reason: 'a site start draws its repeated items in their sections'
         }
     });
-    // At most a start's few datasets, settled in code where a plan names more (AGL-3616).
+    // At most a start's few datasets, settled in code where a plan names more
+    // (AGL-3616); a section that shows the work with its fewest pieces (AGL-3754).
     const site = _extends({}, capabilities, {
         reusableComponents: false,
         create,
-        datasetsMax: AI_SITE_DATASETS_MAX
+        datasetsMax: AI_SITE_DATASETS_MAX,
+        galleryMinItems: AI_SITE_GALLERY_MIN_ITEMS
     });
     if (!capabilities.freeTaste) return site;
     const asked = Number(((_job_inputs = job.inputs) != null ? _job_inputs : {})['pages']);