@aglyn/plugins-ai 1.0.0-beta.236 → 1.0.0-beta.238

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

@@ -17,12 +17,15 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ 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 { readFreeAiCreditsLeft } from "../usage/free-ai-credits-left.js";
 import { AI_TEMPLATE_SUBJECT_DEFINITIONS, aiTemplateShownTokens } from "../model/ai-template-subjects.js";
 import { AI_JOB_CREATE_KINDS, AI_JOB_CREATE_NOUNS } from "../model/ai-job-creations.js";
 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 { 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 } 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";
 import { AI_GENERATION_MAX_ATTEMPTS } from "../runtime/ai-generation-bounds.js";
 import { aiPlanFailureCopy, aiPlanRetryRefusal } from "../model/ai-job-failure-copy.js";
 import { FREE_AI_TASTE_CREDITS_PER_MONTH } from "../plan-entitlements.js";
@@ -39,6 +42,7 @@ 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 { aiJobAdmissionRefusal } from "./ai-job-admission.js";
+import { AI_CREDITS_CONFIRM_CODE } from "../model/ai-credit-estimate.js";
 import { readAiPlanCapabilities } from "./ai-job-drafts.js";
 import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
 import { aiJobStepBudget } from "./ai-job-budget.js";
@@ -187,7 +191,10 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
     // left to a ceiling the outline is free to stay far under.
     const plansHome = !pages.some((page)=>!page.replaceable && aiSitePlanIsHome(page));
     if (home.min > 0 && plansHome) {
-        lines.push(`The home page at / reads as a full website: at least ${home.min} sections — ${AI_SITE_HOME_BANDS}.`);
+        var _aiSiteKindOfInputs;
+        // A store's home is a storefront (AGL-3676): its own parts, in its own order.
+        const bands = ((_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) === 'store' ? AI_SITE_STORE_HOME_BANDS : AI_SITE_HOME_BANDS;
+        lines.push(`The home page at / reads as a full website: at least ${home.min} sections — ${bands}.`);
     }
     // The sections are a budget to use (AGL-3660): a prod start of 2026-10-08
     // read "at most 8" as leave to plan a home of two.
@@ -204,12 +211,24 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
     // A section that shows the work counts its pieces (AGL-3660): a planned
     // gallery of no items let a page about the work show none.
     lines.push(AI_SITE_GALLERY_SENTENCE);
+    // A section that asks for something places the form (AGL-3660): a live
+    // portfolio start planned a commissions inquiry beside the form it made
+    // for its Contact page, without placing it.
+    if (aiPlanCanPlaceForm(inventory, capabilities)) lines.push(AI_SITE_FORM_SENTENCE);
     // The kind of site the person picked (AGL-3660): the pages it usually has.
     const kind = aiSiteKindOfInputs(job.inputs);
     if (kind) lines.push(`This is a ${kind.label.toLowerCase()} site. ${kind.pages}`);
+    // A store's Shop page IS its storefront (AGL-3676): the platform lists the
+    // real products there, so the plan names the section and draws no range.
+    if ((kind == null ? void 0 : kind.id) === 'store') lines.push(AI_SITE_STORE_SHOP_SENTENCE);
     lines.push("Keep the plan an outline: each page's title, address, a short search title and description, and its sections named in a few words. The build writes the copy.");
     return lines;
 }
+/**
+ * The sentence a site plan's turn states about a section that collects
+ * answers (AGL-3660): it places the saved form by reference, and one form
+ * may be placed on more than one page.
+ */ export const AI_SITE_FORM_SENTENCE = "A section that asks visitors for something (contact, inquiry, commissions, booking, sign-up) places the form: put new:<the form's name> or the site's form id in its uses. One form may be placed on several pages.";
 /**
  * What a site start's home page is held to (AGL-3660): its fewest sections,
  * and on the Free taste the sections the wall fits across the pages, which
@@ -252,6 +271,51 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
         return aiSiteThinHomeViolations(plan, rule);
     };
 }
+/** What a store's plan is told about its Shop page (AGL-3676). */ export const AI_SITE_STORE_SHOP_SENTENCE = 'Plan a Shop page at /shop: a short title section, then a section named "Product grid" second, where the platform lists the store\'s real products with sort, filters, photos, prices and cart, then at most one or two short sections (care, shipping, gifting help). Never open it with a hero, and never plan the products themselves as cards of your own.';
+/** What a store's home is composed of (AGL-3676): a storefront's parts, in a storefront's order. */ export const AI_SITE_STORE_HOME_BANDS = 'a hero that sells first, then "Bestsellers" (the platform lists the real products), "Shop by collection" with 3 or 4 items, the brand story, why buy here with 3 or 4 items, "Customer reviews" (the platform shows the store\'s real ones) and a "Newsletter sign-up" band last';
+/**
+ * A store plan held to a storefront (AGL-3676, `ai-layout-storefront.ts`):
+ * on a paid start its home gains the parts a shopper expects that the plan
+ * left out — bestsellers, collections, reviews, a newsletter sign-up —
+ * while the page has room; on any start its Shop page opens on its grid.
+ * Settled, never re-asked: each part has one answer, and the Free wall's
+ * home keeps the sections it planned.
+ */ export function aiSiteStorefrontPlan(plan, options) {
+    const screens = aiStorefrontPlanScreens(plan.screens, {
+        paid: options.paid,
+        isShopPage: aiLayoutIsShopPage,
+        gridSection: aiLayoutShopGridSection
+    });
+    return screens.every((screen, index)=>screen === plan.screens[index]) ? plan : _extends({}, plan, {
+        screens
+    });
+}
+/** The code a store plan with no Shop page is re-asked under. */ export const AI_SITE_STORE_SHOP_CODE = 'plan-store-shop-page';
+/**
+ * A store plan of two or more pages with no Shop page (AGL-3676): the page
+ * the platform lists the catalog on is the one a shopper looks for. A
+ * one-page Free taste lists its products on the home instead.
+ */ export function aiSiteStoreShopPageViolations(plan) {
+    if (plan.screens.length < 2 || plan.screens.some((screen)=>aiLayoutIsShopPage(screen))) return [];
+    return [
+        {
+            rule: null,
+            code: AI_SITE_STORE_SHOP_CODE,
+            message: 'This store has no Shop page. Plan one at /shop, its second section named "Product grid": the platform lists the real products there.',
+            paths: [
+                'screens'
+            ]
+        }
+    ];
+}
+/** A store plan's missing Shop page, asked about on the FIRST answer only, like a thin home. */ export function aiSiteStoreShopCheck() {
+    let answers = 0;
+    return (plan)=>{
+        answers += 1;
+        if (answers >= AI_GENERATION_MAX_ATTEMPTS) return [];
+        return aiSiteStoreShopPageViolations(plan);
+    };
+}
 /**
  * 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
@@ -343,8 +407,9 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
  * violations the plan's one re-ask names: the players the plan lists against
  * the brief it answers (AGL-3433), which only this step reads beside the plan,
  * and a kind's shape refusal.
- */ function planViolations(scope, brief, freeTaste = false, ops = null, home = null, blog = false, site = false) {
+ */ function planViolations(scope, brief, freeTaste = false, ops = null, home = null, blog = false, site = false, store = false) {
     const thinHome = home && home.min > 0 ? aiSiteThinHomeCheck(home) : null;
+    const storeShop = store ? aiSiteStoreShopCheck() : null;
     const blogStandIn = blog ? aiSiteBlogStandInCheck() : null;
     const emptyGallery = site ? aiSiteEmptyGalleryCheck() : null;
     return (plan)=>{
@@ -369,7 +434,8 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
             ] : [],
             ...thinHome ? thinHome(plan) : [],
             ...blogStandIn ? blogStandIn(plan) : [],
-            ...emptyGallery ? emptyGallery(plan) : []
+            ...emptyGallery ? emptyGallery(plan) : [],
+            ...storeShop ? storeShop(plan) : []
         ];
     };
 }
@@ -559,8 +625,10 @@ export function createAiJobPlanStep(deps = {}) {
     const admissionRefusal = (_deps_admissionRefusal = deps.admissionRefusal) != null ? _deps_admissionRefusal : aiJobAdmissionRefusal;
     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;
     return async ({ job, now, signal, firestore, modelFor, org: orgDocument })=>{
         var _AI_JOB_PLAN_SCOPES_job_kind, _job_inputs, _ref;
+        var _aiSiteKindOfInputs, _aiSiteKindOfInputs1;
         const org = orgDocument != null ? orgDocument : null;
         const [inventory, workspace, siteContext] = await Promise.all([
             job.hostId ? readInventory(job.orgId, job.hostId, {
@@ -591,6 +659,29 @@ export function createAiJobPlanStep(deps = {}) {
             freeTaste
         }) : null;
         const site = job.kind === 'site';
+        // 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
+        // returns, so the meters read here do not hold it yet, and a card told
+        // the figure from before the plan (101) offered Confirm to a person with
+        // 48 left, who met the prompt only after pressing it (2026-10-10).
+        const planReview = async (spentUsd = 0)=>{
+            const review = {
+                reason: 'plan',
+                message: AI_JOB_PLAN_REVIEW_COPY,
+                findings: []
+            };
+            if (job.kind !== 'build' || !freeTaste || !readFreeCredits) return review;
+            const credits = await readFreeCredits(firestore, {
+                orgId: job.orgId,
+                org,
+                now,
+                pendingUsd: spentUsd
+            });
+            return credits ? _extends({}, review, {
+                freeCredits: credits
+            }) : review;
+        };
         // The model switch's answer for this job (AGL-2942): the creator's pick
         // where the plan, the org restriction and the allotment allowlists allow
         // it, and Auto held to those same lists otherwise. Without a resolver the
@@ -605,6 +696,16 @@ export function createAiJobPlanStep(deps = {}) {
      * door hands it. A refusal fails the job with the door's sentence; a door
      * that could not answer keeps the plan, since the resume door asks again
      * before anything is built.
+     *
+     * Two answers are about the month's Free credits, not the plan (AGL-3722):
+     * - the 409 credits prompt KEEPS the plan. The card is told what is left
+     *   (`planReview`) and offers Build what fits / the home page first /
+     *   Upgrade, and the confirm door asks with the person's choice. Failing
+     *   here instead failed every Free build past its p90 before the card
+     *   could offer them — and paged staff with `ai.jobFailed`, as at
+     *   2026-10-09 16:38Z (600 credits estimated, 164 left).
+     * - the 429 "nothing left" still fails the job with its sentence, but as
+     *   the customer's limit, which raises no staff alert.
      */ const refusalOnKeep = async (plan, outcome)=>{
             let refusal = null;
             try {
@@ -625,9 +726,12 @@ export function createAiJobPlanStep(deps = {}) {
                     error
                 });
             }
-            return refusal ? _extends({}, outcome, {
+            if (!refusal || refusal.code === AI_CREDITS_CONFIRM_CODE) return null;
+            return _extends({}, outcome, {
                 failure: refusal.error
-            }) : null;
+            }, refusal.status === 429 ? {
+                customerLimit: true
+            } : {});
         };
         // Reuse before asking (AGL-2937). The key covers the whole request, so a
         // hit is a request that would have been sent the same bytes to the same
@@ -672,11 +776,7 @@ export function createAiJobPlanStep(deps = {}) {
             const unspent = aiUnspentOutcome(resolved);
             return (_ref1 = await refusalOnKeep(plan, unspent)) != null ? _ref1 : _extends({}, unspent, {
                 plan,
-                review: {
-                    reason: 'plan',
-                    message: AI_JOB_PLAN_REVIEW_COPY,
-                    findings: []
-                }
+                review: await planReview()
             });
         }
         const result = await runValidatedGeneration('plan', _extends({
@@ -707,7 +807,7 @@ export function createAiJobPlanStep(deps = {}) {
             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)
+            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')
         }));
         const spent = _extends({
             outputs: [],
@@ -750,10 +850,14 @@ export function createAiJobPlanStep(deps = {}) {
                 } : {})
             });
         }
+        // A store's plan is a storefront's (AGL-3676): settled before it is kept and priced.
+        const answered = site && ((_aiSiteKindOfInputs1 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs1.id) === 'store' ? aiSiteStorefrontPlan(result.value, {
+            paid: !freeTaste
+        }) : result.value;
         // Each draft the plan decides is named as the plan is kept, before anything is built (AGL-3079).
-        const plan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, _extends({}, result.value, {
+        const plan = aiPlanWithItemCredits(ops, aiPlanWithDraftIds(job.kind, _extends({}, answered, {
             status: 'proposed',
-            labels: aiPlanLabels(result.value, inventory),
+            labels: aiPlanLabels(answered, inventory),
             // A Date the Admin SDK stores as a timestamp, like every instant the machine writes.
             proposedAt: now,
             confirmedAt: null,
@@ -762,11 +866,7 @@ export function createAiJobPlanStep(deps = {}) {
         })));
         return (_ref = await refusalOnKeep(plan, spent)) != null ? _ref : _extends({}, spent, {
             plan,
-            review: {
-                reason: 'plan',
-                message: AI_JOB_PLAN_REVIEW_COPY,
-                findings: []
-            }
+            review: await planReview(result.estCostUsd)
         });
     };
 }