@aglyn/plugins-ai 1.0.0-beta.233 → 1.0.0-beta.234

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

@@ -18,6 +18,7 @@ import { type AiBuildPlanCreate, type AiBuildPlanScreen } from '../model/ai-buil
 import type { AiJob, AiJobItemLedger, AiJobKind, AiJobOutput, AiJobOutputResource, AiJobPlan } from '../model/ai-jobs.types';
 import { type AiBuildUnit } from '../model/ai-build-job';
 import { type AiSiteJobInputs } from '../model/ai-site-job';
+import { readFreeAiCreditsLeft } from '../usage/free-ai-credits-left';
 import { type AiJobAdmission } from './ai-job-admission';
 import { readAiDraftNodes } from './ai-job-drafts';
 import { aiPublishGuidedSite } from './ai-site-publish';
@@ -219,11 +220,21 @@ export declare function aiSiteUnitJobId(job: Pick<AiJob, '$id' | 'steps'>, unit:
  * for leaving it out.
  */
 export declare function aiSiteUnitJob(job: AiJob, unit: AiSiteUnit, built: BuiltRefs): AiJob;
+/**
+ * Whether this site start writes its first posts (AGL-3676): its ledger owes
+ * the posts part and has not given up on it. The ledger is written before the
+ * layout is built, so the header knows the blog before it exists.
+ */
+export declare function aiSiteWritesPosts(job: Pick<AiJob, 'items'>): boolean;
 /**
  * A scaffold is admitted with inputs that read, for a site of the job's own
  * org, and only where this deployment has loaded the step that builds a page:
  * a scaffold whose pages nothing can build is not a scaffold.
  */
+export declare function createAiSiteJobAdmission(deps?: {
+    freeCreditsLeft?: typeof readFreeAiCreditsLeft;
+    now?: () => Date;
+}): AiJobAdmission;
 export declare const aiSiteJobAdmission: AiJobAdmission;
 /** Whether a scaffold's workspace spends the Free taste (AGL-3594); a missing org reads as paid, as the band has always been. */
 export declare function aiSiteFreeTaste(org: object | null | undefined): boolean;

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

@@ -19,13 +19,14 @@ import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizatio
 import { isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { aiBuildDegradation, aiBuildInitialLedger, aiBuildItemDelivered, aiBuildItemOpen, aiBuildNextUnit } from "../model/ai-build-job.js";
 import { aiBuildBuiltRefs, aiUnitErrorRetryable, aiUnitFailure, aiUnitSpend } from "./ai-build-unit-outcome.js";
-import { AI_SITE_EMAIL_TYPE, AI_SITE_MAX_SECTIONS, AI_SITE_PAGES, aiSiteNameSentence, aiSitePagesRefusal, aiSitePlanRefusal, aiSiteSubmissions, aiSiteWords, parseAiSiteJobInputs } from "../model/ai-site-job.js";
+import { AI_SITE_EMAIL_TYPE, AI_SITE_MAX_SECTIONS, AI_SITE_PAGES, aiFreeSiteShortfall, aiFreeSiteShortfallText, aiSiteNameSentence, aiSitePagesRefusal, aiSitePlanRefusal, aiSiteSubmissions, aiSiteWords, parseAiSiteJobInputs, aiSiteBlogNavPage } from "../model/ai-site-job.js";
+import { readFreeAiCreditsLeft } from "../usage/free-ai-credits-left.js";
 import { AI_SITE_SEO_OUTPUT_ID, aiSiteSeoProposalForInputs } from "../model/ai-site-start-seo.js";
 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_LAYOUT_SITE_PAGES_INPUT, aiLayoutSitePagesOfPlan } from "./ai-job-layout-site-pages.js";
+import { 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_FORM_PAGE_INPUT, AI_LAYOUT_LANGUAGE_INPUT, aiLayoutFormPageOfPlan } from "./ai-job-page-language.js";
 import { aiJobPublishesSite, aiPublishGuidedSite } from "./ai-site-publish.js";
@@ -429,10 +430,22 @@ export const AI_SITE_NO_PLAN_COPY = 'This site job has no confirmed plan to buil
     // ids are minted on the plan, and the platform writes the header's links.
     // A page is told them too, so its buttons may go to a page built after it.
     if (job.kind === 'site' && (unit.kind === 'layout' || unit.kind === 'page')) {
-        // A guided start links every page the person asked for (AGL-3660).
-        const pages = aiLayoutSitePagesOfPlan(plan.screens, {
+        // A guided start links every page the person asked for (AGL-3660), and
+        // the blog its first posts are written into, by its path, second after
+        // Home (AGL-3676): the live Slow Roads start linked an "Articles" page
+        // and never the blog.
+        const planned = aiLayoutSitePagesOfPlan(plan.screens, {
             guided: true
         });
+        const blog = aiSiteWritesPosts(job) ? [
+            aiSiteBlogNavPage(plan.screens)
+        ] : [];
+        const homes = planned.filter((page)=>aiLayoutIsHomeSlug(page.slug));
+        const pages = [
+            ...homes,
+            ...blog,
+            ...planned.filter((page)=>!aiLayoutIsHomeSlug(page.slug))
+        ].slice(0, AI_LAYOUT_SITE_PAGES_MAX);
         if (pages.length) unitInputs[AI_LAYOUT_SITE_PAGES_INPUT] = pages;
     }
     // A site's pages and its layout are designed in the layout language and
@@ -445,7 +458,8 @@ export const AI_SITE_NO_PLAN_COPY = 'This site job has no confirmed plan to buil
         const style = look == null ? void 0 : (_look_proposal = look.proposal) == null ? void 0 : _look_proposal['style'];
         if (style) unitInputs['siteStyle'] = {
             headerAlign: style['headerAlign'],
-            rhythm: style['rhythm']
+            rhythm: style['rhythm'],
+            seed: style['seed']
         };
         unitInputs[AI_LAYOUT_LANGUAGE_INPUT] = true;
         const formPage = aiLayoutFormPageOfPlan(plan);
@@ -484,52 +498,84 @@ export const AI_SITE_NO_PLAN_COPY = 'This site job has no confirmed plan to buil
         brief: brief.join('\n').slice(0, AI_JOB_BRIEF_MAX_CHARS)
     });
 }
+/**
+ * Whether this site start writes its first posts (AGL-3676): its ledger owes
+ * the posts part and has not given up on it. The ledger is written before the
+ * layout is built, so the header knows the blog before it exists.
+ */ export function aiSiteWritesPosts(job) {
+    var _job_items;
+    return ((_job_items = job.items) != null ? _job_items : []).some((row)=>row.slot === 'posts' && row.status !== 'skipped' && row.status !== 'failed');
+}
 /**
  * A scaffold is admitted with inputs that read, for a site of the job's own
  * org, and only where this deployment has loaded the step that builds a page:
  * a scaffold whose pages nothing can build is not a scaffold.
- */ export const aiSiteJobAdmission = async (context)=>{
-    const inputs = parseAiSiteJobInputs(context.inputs);
-    if (typeof inputs === 'string') return {
-        status: 400,
-        error: inputs
-    };
-    // The workspace's own page band (AGL-3594): one or two pages on the Free
-    // taste, four to eight on a paid plan.
-    const freeTaste = aiSiteFreeTaste(context.org);
-    const pages = aiSitePagesRefusal(inputs.pages, freeTaste);
-    if (pages) return {
-        status: 400,
-        error: pages
-    };
-    if (context.plan) {
-        const shape = aiSitePlanRefusal(context.plan, {
-            freeTaste
-        });
-        if (shape) return {
+ */ export function createAiSiteJobAdmission(deps = {}) {
+    var _deps_freeCreditsLeft, _deps_now;
+    const freeCreditsLeft = (_deps_freeCreditsLeft = deps.freeCreditsLeft) != null ? _deps_freeCreditsLeft : readFreeAiCreditsLeft;
+    const now = (_deps_now = deps.now) != null ? _deps_now : ()=>new Date();
+    return async (context)=>{
+        const inputs = parseAiSiteJobInputs(context.inputs);
+        if (typeof inputs === 'string') return {
             status: 400,
-            error: shape
+            error: inputs
         };
-    }
-    if (!context.hostId) {
-        return {
+        // The workspace's own page band (AGL-3594): one or two pages on the Free
+        // taste, four to eight on a paid plan.
+        const freeTaste = aiSiteFreeTaste(context.org);
+        const pages = aiSitePagesRefusal(inputs.pages, freeTaste);
+        if (pages) return {
             status: 400,
-            error: 'Open the site the scaffold is for before starting the job'
+            error: pages
         };
-    }
-    const owner = await resolveOrgIdForHost(context.hostId);
-    if (!owner || owner !== context.orgId) return {
-        status: 404,
-        error: 'Unknown site'
-    };
-    if (!aiJobStepRunnerFor('page')) {
-        return {
-            status: 400,
-            error: AI_SITE_NO_PAGE_STEP_COPY
+        // A Free start that what is left of the month's Free credits cannot pay for
+        // is refused before it spends (AGL-3660), on the figure the dialog quotes —
+        // the dialog asks the same, and this is what a stale dialog meets. Only at
+        // creation: a resume is the same job carrying on from where it paused.
+        if (freeTaste && !context.plan) {
+            const credits = await freeCreditsLeft(context.firestore, {
+                orgId: context.orgId,
+                org: context.org,
+                now: now()
+            });
+            const shortfall = aiFreeSiteShortfall(credits, inputs.pages);
+            if (credits && shortfall) {
+                return {
+                    status: 429,
+                    error: aiFreeSiteShortfallText(shortfall, credits.resetsOn)
+                };
+            }
+        }
+        if (context.plan) {
+            const shape = aiSitePlanRefusal(context.plan, {
+                freeTaste
+            });
+            if (shape) return {
+                status: 400,
+                error: shape
+            };
+        }
+        if (!context.hostId) {
+            return {
+                status: 400,
+                error: 'Open the site the scaffold is for before starting the job'
+            };
+        }
+        const owner = await resolveOrgIdForHost(context.hostId);
+        if (!owner || owner !== context.orgId) return {
+            status: 404,
+            error: 'Unknown site'
         };
-    }
-    return null;
-};
+        if (!aiJobStepRunnerFor('page')) {
+            return {
+                status: 400,
+                error: AI_SITE_NO_PAGE_STEP_COPY
+            };
+        }
+        return null;
+    };
+}
+export const aiSiteJobAdmission = createAiSiteJobAdmission();
 /** Whether a scaffold's workspace spends the Free taste (AGL-3594); a missing org reads as paid, as the band has always been. */ export function aiSiteFreeTaste(org) {
     return Boolean(org) && resolveEffectivePlan(org) === 'free';
 }
@@ -709,12 +755,18 @@ export function createAiJobSiteStep(deps = {}) {
             ]));
         const next = aiBuildNextUnit(ledgerUnits, ledger);
         /** A guided start's last pass puts what it built on the site, once (AGL-3596): only its pages that were built. */ const finish = async (outcome, pages)=>{
+            var _postsRow_outputs;
             if (!aiJobPublishesSite(job) || job.sitePublish || !job.hostId || !pages.length) return outcome;
-            const sitePublish = await publish(context.firestore, {
+            // A blog the header links by path before its posts exist (AGL-3660):
+            // owed and not delivered, its links come out of what is published.
+            const postsRow = rows.get('posts');
+            const sitePublish = await publish(context.firestore, _extends({
                 job,
                 outputs: pages,
                 now: context.now
-            }).catch((error)=>{
+            }, postsRow ? {
+                blogUnwritten: !aiBuildItemDelivered(postsRow) || !((_postsRow_outputs = postsRow.outputs) == null ? void 0 : _postsRow_outputs.length)
+            } : {})).catch((error)=>{
                 // The site is built either way; the pages stay drafts and say so.
                 console.error('ai site publish threw', {
                     orgId: job.orgId,