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

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

@@ -17,6 +17,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
 import { aiSiteHomeArc, aiSiteHomeArcSentence } from "../model/ai-site-home-arcs.js";
 import { aiSiteSeed } from "../model/ai-site-look.js";
+import { AI_SITE_INSPIRATION_INPUT } from "../model/ai-site-inspiration.js";
+import { aiSiteInspirationHomeOrder, aiSiteInspirationPlanLines, readAiJobSiteInspiration } from "./ai-site-inspiration.js";
 import { createHash } from "node:crypto";
 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";
@@ -45,7 +47,7 @@ import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
 import { readSiteInventory } from "../runtime/site-inventory.js";
 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 { AI_BUILD_CREATE_KINDS, AI_BUILD_NEEDS_INPUT_CODE, AI_BUILD_STRUCTURAL_OPS, aiBuildPageLimit, aiBuildPlanInputFields, 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";
@@ -119,13 +121,15 @@ 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, now = null) {
+ */ export function aiJobPlanPrompt(job, capabilities = null, inventory = null, ops = null, now = null, options = {}) {
     var _job_inputs;
     const lines = [
         `Job kind: ${job.kind}`,
         `Brief: ${job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`
     ];
     for (const [key, value] of Object.entries((_job_inputs = job.inputs) != null ? _job_inputs : {})){
+        // The sites a person likes are read by code, never shown (AGL-3975).
+        if (key === AI_SITE_INSPIRATION_INPUT) continue;
         if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
             lines.push(`${key}: ${String(value)}`);
         }
@@ -137,7 +141,7 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
         lines.push(AI_PLAN_NO_FORM_SENTENCE);
     }
     lines.push(...aiPlanTemplateTokenLines(job));
-    lines.push(...aiPlanSiteLines(job, inventory, capabilities));
+    lines.push(...aiPlanSiteLines(job, inventory, capabilities, options));
     lines.push(...aiPlanBuildLines(job, capabilities, ops, now));
     return lines.join('\n');
 }
@@ -177,7 +181,7 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
  * (AGL-3497), and a plan that did not know it could replace it planned its own
  * home there and was refused for the clash on every new site. Kept off a page
  * job's turn, whose length the Free page's wall is proven at.
- */ export function aiPlanSiteLines(job, inventory, capabilities) {
+ */ export function aiPlanSiteLines(job, inventory, capabilities, options = {}) {
     var _ref, _job_inputs, _job_inputs1;
     var _job_inputs2, _aiSiteKindOfInputs;
     if (job.kind !== 'site') return [];
@@ -215,8 +219,9 @@ import { AI_JOBS_COLLECTION, registerAiJobPlanStep } from "./ai-jobs.js";
         const bands = ((_aiSiteKindOfInputs1 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs1.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}.`);
         // And its own arc, chosen by the job's seed (AGL-3899): two identical
-        // briefs are two different homes.
-        const arc = aiSitePlanHomeArc(job);
+        // briefs are two different homes. A start whose person named sites they
+        // like takes its order from them instead (AGL-3975).
+        const arc = options.ownOrder ? null : aiSitePlanHomeArc(job);
         if (arc) lines.push(aiSiteHomeArcSentence(arc));
     }
     // The sections are a budget to use (AGL-3660): a prod start of 2026-10-08
@@ -858,6 +863,17 @@ function planMillis(plan) {
         })
     });
 }
+/**
+ * A plan with THIS job's inspiration signals (AGL-3975), or with none: a
+ * reused plan's were the other job's, and a plan the model answered holds
+ * none of its own. The look unit pins them; the plan was told the structure.
+ */ export function aiPlanWithInspiration(plan, inspiration) {
+    const rest = _extends({}, plan);
+    delete rest.inspiration;
+    return inspiration ? _extends({}, rest, {
+        inspiration
+    }) : rest;
+}
 export function createAiJobPlanStep(deps = {}) {
     var _deps_readInventory, _deps_readCapabilities, _deps_admissionRefusal, _deps_readOps;
     const readInventory = (_deps_readInventory = deps.readInventory) != null ? _deps_readInventory : readSiteInventory;
@@ -868,9 +884,10 @@ export function createAiJobPlanStep(deps = {}) {
     const readContext = deps.readSiteContext === undefined ? readAiJobSiteContext : deps.readSiteContext;
     const readFreeCredits = deps.readFreeCredits === undefined ? readFreeAiCreditsLeft : deps.readFreeCredits;
     const readSiteEvents = deps.readSiteEvents === undefined ? readAiSiteEventPlanning : deps.readSiteEvents;
+    const readInspiration = deps.readInspiration === undefined ? readAiJobSiteInspiration : deps.readInspiration;
     return async ({ job, now, signal, firestore, modelFor, org: orgDocument })=>{
-        var _AI_JOB_PLAN_SCOPES_job_kind, _ref, _job_inputs, _ref1;
-        var _aiSiteKindOfInputs, _aiSiteKindOfInputs1;
+        var _AI_JOB_PLAN_SCOPES_job_kind, _ref, _ref1, _job_inputs, _job_inputs1, _job_inputs2, _ref2;
+        var _aiSiteKindOfInputs, _aiSiteKindOfInputs1, _aiSiteKindOfInputs2, _aiSiteKindOfInputs3;
         const org = orgDocument != null ? orgDocument : null;
         // A site start counts each dataset's records (AGL-3912): it reuses only
         // one whose records are its own to show.
@@ -910,18 +927,36 @@ export function createAiJobPlanStep(deps = {}) {
         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;
+        // And the sites the person likes, as signals (AGL-3975): read only on a
+        // site start that names some, while the release flag is on.
+        const [siteEvents, inspiration] = await Promise.all([
+            site && readSiteEvents ? readSiteEvents({
+                job,
+                org,
+                firestore,
+                now,
+                readOps: ()=>readOps({
+                        job,
+                        org,
+                        firestore,
+                        freeTaste
+                    })
+            }) : Promise.resolve(null),
+            site && readInspiration ? readInspiration(_extends({
+                job,
+                org,
+                freeTaste
+            }, signal ? {
+                signal
+            } : {})).catch((error)=>{
+                console.warn('ai plan: the sites the person likes could not be read', {
+                    orgId: job.orgId,
+                    jobId: job.$id,
+                    error
+                });
+                return null;
+            }) : Promise.resolve(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).
@@ -953,9 +988,31 @@ 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'];
+        // What this start can build of what the person's sites offer (AGL-3975):
+        // a restaurant is never offered the events list an event-led start
+        // drafts, or a store's sign-up; and their first site's order, where it
+        // gives one, is the home's in place of the seeded arc.
+        const inspirationStart = {
+            siteKind: (_ref1 = (_aiSiteKindOfInputs = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs.id) != null ? _ref1 : null,
+            posts: aiSiteContentPart((_job_inputs = job.inputs) != null ? _job_inputs : null, freeTaste) === 'posts',
+            sells: aiSiteContentPart((_job_inputs1 = job.inputs) != null ? _job_inputs1 : null, freeTaste) === 'products',
+            events: Boolean(siteEvents),
+            customerWords: aiPlanHasCustomerWords({
+                brief: job.brief,
+                inventory,
+                siteKind: (_aiSiteKindOfInputs1 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs1.id
+            })
+        };
+        const ownOrder = Boolean(aiSiteInspirationHomeOrder(inspiration, inspirationStart));
         const prompt = [
-            aiJobPlanPrompt(job, capabilities, inventory, ops, now),
-            ...siteEvents ? aiSiteEventPlanLines(siteEvents, now) : []
+            aiJobPlanPrompt(job, capabilities, inventory, ops, now, {
+                ownOrder
+            }),
+            ...siteEvents ? aiSiteEventPlanLines(siteEvents, now) : [],
+            ...aiSiteInspirationPlanLines(inspiration, {
+                paid: !freeTaste,
+                start: inspirationStart
+            })
         ].join('\n');
         /**
      * The confirm door's answer for this plan, asked before the plan is kept
@@ -973,6 +1030,12 @@ export function createAiJobPlanStep(deps = {}) {
      *   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.
+     *
+     * A plan only the person can complete — a tracking change with no pixel
+     * ID (AGL-3978) — is KEPT too, and waits in `needs_input` with a field per
+     * id, its review beside it: nothing about it failed, and the answer
+     * returns it to the plan card. Only an item that names no tag at all,
+     * so has no field to fill, still ends with the question.
      */ const refusalOnKeep = async (plan, outcome)=>{
             let refusal = null;
             try {
@@ -994,6 +1057,17 @@ export function createAiJobPlanStep(deps = {}) {
                 });
             }
             if (!refusal || refusal.code === AI_CREDITS_CONFIRM_CODE) return null;
+            const fields = refusal.code === AI_BUILD_NEEDS_INPUT_CODE ? aiBuildPlanInputFields(plan, itemOps) : [];
+            if (fields.length) {
+                return _extends({}, outcome, {
+                    plan,
+                    review: await planReview(outcome.estCostUsd),
+                    input: {
+                        message: refusal.error,
+                        fields
+                    }
+                });
+            }
             return _extends({}, outcome, {
                 failure: refusal.error
             }, refusal.status === 429 ? {
@@ -1031,11 +1105,11 @@ export function createAiJobPlanStep(deps = {}) {
             now
         }) : null;
         if (reused) {
-            var _ref2;
+            var _ref3;
             // The reused plan's draft ids name the other job's drafts; this job's are its own.
             // Settled again against what the datasets hold now (AGL-3912).
             const kept = site ? aiSettlePlanDatasets(aiSettleSiteForeignDatasets(reused.plan, inventory, capabilities), capabilities) : reused.plan;
-            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, kept, {
+            const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, aiPlanWithInspiration(kept, inspiration), {
                 status: 'proposed',
                 labels: aiPlanLabels(kept, inventory),
                 proposedAt: now,
@@ -1045,7 +1119,7 @@ export function createAiJobPlanStep(deps = {}) {
                 reusedFrom: reused.jobId
             }))));
             const unspent = aiUnspentOutcome(resolved);
-            return (_ref2 = await refusalOnKeep(plan, unspent)) != null ? _ref2 : _extends({}, unspent, {
+            return (_ref3 = await refusalOnKeep(plan, unspent)) != null ? _ref3 : _extends({}, unspent, {
                 plan,
                 review: await planReview()
             });
@@ -1103,7 +1177,7 @@ export function createAiJobPlanStep(deps = {}) {
                     keep: aiSiteFormStaysHome(job, capabilities == null ? void 0 : capabilities.freeSitePages)
                 })
         } : {}, {
-            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)
+            extend: aiSiteWithEventItemsCheck(planViolations(scope, job.brief, freeTaste, ops, site ? aiSitePlanHomeRule(inventory, capabilities) : null, site && aiSiteContentPart((_job_inputs2 = job.inputs) != null ? _job_inputs2 : null, freeTaste) === 'posts', site, site && ((_aiSiteKindOfInputs2 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs2.id) === 'store'), site ? siteEvents : undefined, ops)
         }));
         const spent = _extends({
             outputs: [],
@@ -1147,11 +1221,11 @@ 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, {
+        const answered = site && ((_aiSiteKindOfInputs3 = aiSiteKindOfInputs(job.inputs)) == null ? void 0 : _aiSiteKindOfInputs3.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 = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, answered, {
+        const plan = aiPlanWithStorePages(job.kind, ops, inventory, aiPlanWithItemCredits(itemOps, aiPlanWithDraftIds(job.kind, _extends({}, aiPlanWithInspiration(answered, inspiration), {
             status: 'proposed',
             labels: aiPlanLabels(answered, inventory),
             // A Date the Admin SDK stores as a timestamp, like every instant the machine writes.
@@ -1160,7 +1234,7 @@ export function createAiJobPlanStep(deps = {}) {
             confirmedBy: null,
             key
         }))));
-        return (_ref1 = await refusalOnKeep(plan, spent)) != null ? _ref1 : _extends({}, spent, {
+        return (_ref2 = await refusalOnKeep(plan, spent)) != null ? _ref2 : _extends({}, spent, {
             plan,
             review: await planReview(result.estCostUsd)
         });