@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-plugin-drafts.js

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { isHostPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { pluginResourceDraftWriter } from "@aglyn/aglyn/plugin-manager/plugin-resource-drafts";
+import { filterEnabledPluginsByReleaseFlags } from "@aglyn/tenant-data-admin/server/release-flags";
+import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
+/** The registered writer for a resource, or `null` when no plugin writes it here. */ export const aiPluginDraftWriter = (resource)=>{
+    var _ref;
+    var _pluginResourceDraftWriter;
+    return (_ref = (_pluginResourceDraftWriter = pluginResourceDraftWriter(resource)) == null ? void 0 : _pluginResourceDraftWriter.writer) != null ? _ref : null;
+};
+/** What a person is told when the plugin that owns a draft does not run here. */ export function aiPluginDraftUnavailable(label) {
+    return `Turn on ${label} for this site before starting the job.`;
+}
+/**
+ * Whether a job of this kind may start on this site for this member; `null`
+ * admits it. Nothing here writes, and nothing here spends.
+ */ export async function aiPluginDraftAdmissionRefusal(context, input) {
+    var _input_writerFor, _data, _input_now;
+    const { hostId } = context;
+    if (!hostId) {
+        return {
+            status: 400,
+            error: `Open the site the ${input.kind} is for before starting the job`
+        };
+    }
+    const owner = await resolveOrgIdForHost(hostId);
+    if (!owner || owner !== context.orgId) return {
+        status: 404,
+        error: 'Unknown site'
+    };
+    const writerFor = (_input_writerFor = input.writerFor) != null ? _input_writerFor : aiPluginDraftWriter;
+    const host = (_data = (await context.firestore.collection('hosts').doc(hostId).get()).data()) != null ? _data : null;
+    const org = context.org;
+    // One release-flag read for every owner at once: the answer is per org, and
+    // a plugin subtracted here is one the site cannot reach at all.
+    const released = new Set(await filterEnabledPluginsByReleaseFlags(input.drafts.map((draft)=>draft.pluginId), {
+        orgId: context.orgId,
+        authorization: null
+    }));
+    const writers = [];
+    for (const draft of input.drafts){
+        const writer = writerFor(draft.resource);
+        if (!writer || !released.has(draft.pluginId) || !isHostPluginEnabled(org, host, draft.pluginId)) {
+            return {
+                status: 403,
+                error: aiPluginDraftUnavailable(draft.label)
+            };
+        }
+        writers.push(writer);
+    }
+    const own = await (input.ownCheck == null ? void 0 : input.ownCheck.call(input, hostId));
+    if (own) return own;
+    // Whether this member may create one of each, in the owner's own words. A
+    // door that names no member — the machine re-checking a job it stored —
+    // asks nothing here, because there is nobody to ask about.
+    const uid = context.uid;
+    if (!uid) return null;
+    const now = (_input_now = input.now) != null ? _input_now : new Date();
+    for (const writer of writers){
+        const refusal = await writer.refusal({
+            orgId: context.orgId,
+            hostId,
+            uid,
+            org,
+            now
+        });
+        // The seam's 409 is "one already exists", which for an admission is a
+        // room-to-create answer rather than a fault the door can act on.
+        if (refusal) return {
+            status: refusal.status === 409 ? 403 : refusal.status,
+            error: refusal.error
+        };
+    }
+    return null;
+}
+
+//# sourceMappingURL=ai-job-plugin-drafts.js.map

package/src/lib/jobs/ai-job-plugin-drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-plugin-drafts.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { isHostPluginEnabled } from '@aglyn/aglyn/plugin-manager/enabled-plugins'\nimport {\n  pluginResourceDraftWriter,\n  type PluginResourceDraftWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts'\nimport { filterEnabledPluginsByReleaseFlags } from '@aglyn/tenant-data-admin/server/release-flags'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport type { AiJobKind } from '../model/ai-jobs.types'\nimport type { AiJobAdmissionContext, AiJobAdmissionRefusal } from './ai-job-admission'\n\n/**\n * Admitting a job whose drafts ANOTHER plugin writes (AGL-2912).\n *\n * `aiDraftAdmissionRefusal` admits the kinds this plugin writes itself, where\n * the allowance is one it can read. An email job writes no document of its\n * own: the email plugin owns the email design and the marketing plugin owns\n * the campaign, and each registers a writer on the `plugin-resource-drafts`\n * seam. So the question this answers is different, and it is the caller's\n * half of that seam's contract — the seam carries no authorization of the\n * caller, so a caller establishes, before it asks for anything:\n *\n *  1. a site is named, and it is the job's own org's;\n *  2. the owning plugin runs on that site — switched on for the workspace,\n *    not switched off for the site, and past its release flag — and has\n *    actually registered its writer in this process;\n *  3. whatever the kind checks of its own, such as the plan a campaign needs;\n *  4. that the member the drafts are for may create one of each, which only\n *    the owner can answer, and does, through `refusal`.\n *\n * Asked at the create door before the job exists and again at the resume door\n * before a confirmed plan runs, so a plugin switched off, or an allowance used\n * up, in between is caught before the job spends. A refusal is the owner's own\n * sentence wherever there is one, so a person reads what the console would\n * have told them.\n */\n\n/** How a resource's draft writer is found; the core's registry by default. */\nexport type AiPluginDraftWriterLookup = (resource: string) => PluginResourceDraftWriter | null\n\n/** The registered writer for a resource, or `null` when no plugin writes it here. */\nexport const aiPluginDraftWriter: AiPluginDraftWriterLookup = (resource) =>\n  pluginResourceDraftWriter(resource)?.writer ?? null\n\n/** One draft a job kind needs written, and who owns it. */\nexport interface AiPluginDraftNeed {\n  /** The resource name the owner registered its writer under. */\n  resource: string\n  /** The owning plugin, as `plugins.config.json` names it. */\n  pluginId: string\n  /** What the site's plugin list calls it, for the sentence a person reads. */\n  label: string\n}\n\nexport interface AiPluginDraftAdmissionInput {\n  /** The job kind, named in the refusal that asks for a site. */\n  kind: AiJobKind\n  /** Every draft the kind writes, each checked in turn. */\n  drafts: readonly AiPluginDraftNeed[]\n  /** The kind's own check, asked once the site and its plugins are known good. */\n  ownCheck?: (hostId: string) => Promise<AiJobAdmissionRefusal | null>\n  /** How a writer is found; the registry otherwise. */\n  writerFor?: AiPluginDraftWriterLookup\n  /** The instant the owner's allowance is read against; now otherwise. */\n  now?: Date\n}\n\n/** What a person is told when the plugin that owns a draft does not run here. */\nexport function aiPluginDraftUnavailable(label: string): string {\n  return `Turn on ${label} for this site before starting the job.`\n}\n\n/**\n * Whether a job of this kind may start on this site for this member; `null`\n * admits it. Nothing here writes, and nothing here spends.\n */\nexport async function aiPluginDraftAdmissionRefusal(\n  context: AiJobAdmissionContext,\n  input: AiPluginDraftAdmissionInput,\n): Promise<AiJobAdmissionRefusal | null> {\n  const { hostId } = context\n  if (!hostId) {\n    return { status: 400, error: `Open the site the ${input.kind} is for before starting the job` }\n  }\n  const owner = await resolveOrgIdForHost(hostId)\n  if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n\n  const writerFor = input.writerFor ?? aiPluginDraftWriter\n  const host = (await context.firestore.collection('hosts').doc(hostId).get()).data() ?? null\n  const org = context.org as { enabledPlugins?: string[] } | null\n  // One release-flag read for every owner at once: the answer is per org, and\n  // a plugin subtracted here is one the site cannot reach at all.\n  const released = new Set(\n    await filterEnabledPluginsByReleaseFlags(\n      input.drafts.map((draft) => draft.pluginId),\n      { orgId: context.orgId, authorization: null },\n    ),\n  )\n  const writers: PluginResourceDraftWriter[] = []\n  for (const draft of input.drafts) {\n    const writer = writerFor(draft.resource)\n    if (\n      !writer ||\n      !released.has(draft.pluginId) ||\n      !isHostPluginEnabled(org, host, draft.pluginId)\n    ) {\n      return { status: 403, error: aiPluginDraftUnavailable(draft.label) }\n    }\n    writers.push(writer)\n  }\n\n  const own = await input.ownCheck?.(hostId)\n  if (own) return own\n\n  // Whether this member may create one of each, in the owner's own words. A\n  // door that names no member — the machine re-checking a job it stored —\n  // asks nothing here, because there is nobody to ask about.\n  const uid = context.uid\n  if (!uid) return null\n  const now = input.now ?? new Date()\n  for (const writer of writers) {\n    const refusal = await writer.refusal({ orgId: context.orgId, hostId, uid, org, now })\n    // The seam's 409 is \"one already exists\", which for an admission is a\n    // room-to-create answer rather than a fault the door can act on.\n    if (refusal) return { status: refusal.status === 409 ? 403 : refusal.status, error: refusal.error }\n  }\n  return null\n}\n"],"names":["isHostPluginEnabled","pluginResourceDraftWriter","filterEnabledPluginsByReleaseFlags","resolveOrgIdForHost","aiPluginDraftWriter","resource","writer","aiPluginDraftUnavailable","label","aiPluginDraftAdmissionRefusal","context","input","hostId","status","error","kind","owner","orgId","writerFor","host","firestore","collection","doc","get","data","org","released","Set","drafts","map","draft","pluginId","authorization","writers","has","push","own","ownCheck","uid","now","Date","refusal"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,mBAAmB,QAAQ,8CAA6C;AACjF,SACEC,yBAAyB,QAEpB,qDAAoD;AAC3D,SAASC,kCAAkC,QAAQ,gDAA+C;AAClG,SAASC,mBAAmB,QAAQ,gDAA+C;AAiCnF,mFAAmF,GACnF,OAAO,MAAMC,sBAAiD,CAACC;;QAC7DJ;oBAAAA,6BAAAA,0BAA0BI,8BAA1BJ,2BAAqCK,MAAM,mBAAI;EAAI;AAyBrD,+EAA+E,GAC/E,OAAO,SAASC,yBAAyBC,KAAa;IACpD,OAAO,CAAC,QAAQ,EAAEA,MAAM,uCAAuC,CAAC;AAClE;AAEA;;;CAGC,GACD,OAAO,eAAeC,8BACpBC,OAA8B,EAC9BC,KAAkC;QAShBA,kBACL,OA+BDA;IAvCZ,MAAM,EAAEC,MAAM,EAAE,GAAGF;IACnB,IAAI,CAACE,QAAQ;QACX,OAAO;YAAEC,QAAQ;YAAKC,OAAO,CAAC,kBAAkB,EAAEH,MAAMI,IAAI,CAAC,+BAA+B,CAAC;QAAC;IAChG;IACA,MAAMC,QAAQ,MAAMb,oBAAoBS;IACxC,IAAI,CAACI,SAASA,UAAUN,QAAQO,KAAK,EAAE,OAAO;QAAEJ,QAAQ;QAAKC,OAAO;IAAe;IAEnF,MAAMI,aAAYP,mBAAAA,MAAMO,SAAS,YAAfP,mBAAmBP;IACrC,MAAMe,QAAO,QAAA,AAAC,CAAA,MAAMT,QAAQU,SAAS,CAACC,UAAU,CAAC,SAASC,GAAG,CAACV,QAAQW,GAAG,EAAC,EAAGC,IAAI,cAApE,QAA0E;IACvF,MAAMC,MAAMf,QAAQe,GAAG;IACvB,4EAA4E;IAC5E,gEAAgE;IAChE,MAAMC,WAAW,IAAIC,IACnB,MAAMzB,mCACJS,MAAMiB,MAAM,CAACC,GAAG,CAAC,CAACC,QAAUA,MAAMC,QAAQ,GAC1C;QAAEd,OAAOP,QAAQO,KAAK;QAAEe,eAAe;IAAK;IAGhD,MAAMC,UAAuC,EAAE;IAC/C,KAAK,MAAMH,SAASnB,MAAMiB,MAAM,CAAE;QAChC,MAAMtB,SAASY,UAAUY,MAAMzB,QAAQ;QACvC,IACE,CAACC,UACD,CAACoB,SAASQ,GAAG,CAACJ,MAAMC,QAAQ,KAC5B,CAAC/B,oBAAoByB,KAAKN,MAAMW,MAAMC,QAAQ,GAC9C;YACA,OAAO;gBAAElB,QAAQ;gBAAKC,OAAOP,yBAAyBuB,MAAMtB,KAAK;YAAE;QACrE;QACAyB,QAAQE,IAAI,CAAC7B;IACf;IAEA,MAAM8B,MAAM,OAAMzB,MAAM0B,QAAQ,oBAAd1B,MAAM0B,QAAQ,MAAd1B,OAAiBC;IACnC,IAAIwB,KAAK,OAAOA;IAEhB,0EAA0E;IAC1E,wEAAwE;IACxE,2DAA2D;IAC3D,MAAME,MAAM5B,QAAQ4B,GAAG;IACvB,IAAI,CAACA,KAAK,OAAO;IACjB,MAAMC,OAAM5B,aAAAA,MAAM4B,GAAG,YAAT5B,aAAa,IAAI6B;IAC7B,KAAK,MAAMlC,UAAU2B,QAAS;QAC5B,MAAMQ,UAAU,MAAMnC,OAAOmC,OAAO,CAAC;YAAExB,OAAOP,QAAQO,KAAK;YAAEL;YAAQ0B;YAAKb;YAAKc;QAAI;QACnF,sEAAsE;QACtE,iEAAiE;QACjE,IAAIE,SAAS,OAAO;YAAE5B,QAAQ4B,QAAQ5B,MAAM,KAAK,MAAM,MAAM4B,QAAQ5B,MAAM;YAAEC,OAAO2B,QAAQ3B,KAAK;QAAC;IACpG;IACA,OAAO;AACT"}

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

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiJob } from '../model/ai-jobs.types';
+import { type AiProductPhotoRead } from '../model/ai-products';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiProductImageSeams } from './ai-product-image';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The `products` step (AGL-2916): commerce by AI, as proposals.
+ *
+ * `inputs.target` names the work (`model/ai-products.ts`): one product's copy
+ * from what its editor holds, the copy of many saved products one a pass, a
+ * store's first products from a brief, or its categories and a first set of
+ * discounts from a brief.
+ *
+ * ## It writes nothing
+ *
+ * Like every runner, this reads, asks and returns. Every output is a
+ * `product` proposal, and the commerce plugin's own surfaces write what a
+ * person accepts: the product editor's Save, the products card's apply, and
+ * the create paths the catalog and discount cards already use — each with the
+ * allowance, role and seed checks those paths carry. A proposed product is
+ * created as a draft with no price, and a proposed discount is created
+ * switched off.
+ *
+ * ## A bulk job, a product at a time
+ *
+ * A bulk job's pass writes one product's copy and asks the machine to
+ * continue while products remain, so each product is one reservation and one
+ * provider exchange, and a job that runs out of credits resumes at the
+ * product where it stopped. Which product is next is read from the job's own
+ * outputs, one a product, so nothing is kept anywhere else. A product that is
+ * gone, or whose copy cannot be held to the rules, is reported and passed
+ * over rather than failing the products after it.
+ *
+ * ## What the model is shown
+ *
+ * The product's name, type, text, tags, options and current search listing,
+ * the names of the site's categories, the store's name, and — for a model that
+ * reads pictures — the product's first photo, read from the site's own media
+ * library as `ai-product-image.ts` describes. A catalog or categories request
+ * carries the brief and the store's name, and the second its existing category
+ * names. No price, stock, order, customer or other product is read for any of
+ * them.
+ */
+export declare const AI_PRODUCTS_NO_SITE_COPY = "Open the store this job is for before starting it.";
+export declare const AI_PRODUCTS_UNKNOWN_SITE_COPY = "This AI job names a site this workspace does not have.";
+export declare const AI_PRODUCTS_NOT_ENTITLED_COPY = "Your plan does not include selling products. See Billing.";
+export declare const AI_PRODUCTS_COMMERCE_OFF_COPY = "Turn on Commerce for this site before starting the job.";
+export declare const AI_PRODUCTS_GONE_COPY = "This product is no longer in the catalog.";
+export declare const AI_PRODUCTS_DECLINED_COPY = "The model declined to write copy for this product.";
+/** The notes a proposal carries about its product's photo. */
+export declare const AI_PRODUCT_PHOTO_NOTES: Readonly<Partial<Record<AiProductPhotoRead, string>>>;
+/**
+ * ASSUMED: how long a catalog or categories pass reads the site before it
+ * asks: the host document and, for categories, the category names.
+ */
+export declare const AI_PRODUCTS_SITE_READ_MS = 1000;
+/**
+ * One product's copy (AGL-3035): its generation and re-ask at the copy's own
+ * ceiling on the tier `job.products` is served from, with the photo read. The
+ * least any pass of the step needs, and so what the step registers.
+ */
+export declare const AI_JOB_PRODUCT_COPY_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** A catalog: the largest answer the step asks for, at the routing table's ceiling. */
+export declare const AI_JOB_CATALOG_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** Categories and discounts. */
+export declare const AI_JOB_CATEGORIES_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** What the `products` step registers: the least any of its passes needs. */
+export declare const AI_JOB_PRODUCTS_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time the next pass of a job needs, by what the job asks for. */
+export declare function aiProductsRunMinimumMs(job: Pick<AiJob, 'inputs'>): number;
+export interface AiJobProductsStepDeps {
+    image?: AiProductImageSeams;
+    /** Whether a model reads pictures; the provider's own descriptor otherwise. */
+    readsImages?: (model: string) => boolean;
+}
+/** The step, with its reads replaceable where a spec needs them. */
+export declare function createAiJobProductsStep(deps?: AiJobProductsStepDeps): AiJobStepRunner;
+export declare const runAiJobProductsStep: AiJobStepRunner;
+/**
+ * Whether a `products` job may start: inputs it can run, a site of the job's
+ * own org, a plan that sells products, and Commerce on for the site and past
+ * its release flag. Asked by the create door before the job exists, so a
+ * refusal spends nothing.
+ */
+export declare const aiProductsJobAdmission: AiJobAdmission;
+/**
+ * Registers the `products` step, the least time each of its passes needs, its
+ * pass bound and its admission.
+ */
+export declare function registerAiProductsJob(): void;

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

@@ -0,0 +1,436 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { isHostPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { filterEnabledPluginsByReleaseFlags } from "@aglyn/tenant-data-admin/server/release-flags";
+import { AI_PRODUCT_CATEGORY_LIST_MAX, AI_PRODUCT_OPTIONS_MAX, AI_PRODUCT_OPTION_VALUES_MAX, AI_PRODUCT_TEXT_MAX_CHARS, AI_PRODUCT_TYPES, AI_PRODUCTS_BULK_MAX, AI_PRODUCTS_OUTPUT_IDS, aiProductGaps, aiProductsProposalOf, parseAiProductsJobInputs } from "../model/ai-products.js";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { aiModelForStep } from "../providers/routing.js";
+import { AI_CATALOG_MAX_TOKENS, AI_PRODUCT_CATEGORIES_MAX_TOKENS, AI_PRODUCT_COPY_MAX_TOKENS, AI_PRODUCTS_STEP, generateAiCatalog, generateAiCategories, generateAiProductCopy } from "../runtime/ai-products-generation.js";
+import { aiRouteReadsImages } from "../runtime/ai-runtime.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+import { aiGenerationSpent, aiUnspentOutcome } from "./ai-job-generation.js";
+import { AI_PRODUCT_IMAGE_READ_MS, readAiProductImage } from "./ai-product-image.js";
+import { registerAiJobStep, registerAiJobStepPasses } from "./ai-jobs.js";
+/**
+ * The `products` step (AGL-2916): commerce by AI, as proposals.
+ *
+ * `inputs.target` names the work (`model/ai-products.ts`): one product's copy
+ * from what its editor holds, the copy of many saved products one a pass, a
+ * store's first products from a brief, or its categories and a first set of
+ * discounts from a brief.
+ *
+ * ## It writes nothing
+ *
+ * Like every runner, this reads, asks and returns. Every output is a
+ * `product` proposal, and the commerce plugin's own surfaces write what a
+ * person accepts: the product editor's Save, the products card's apply, and
+ * the create paths the catalog and discount cards already use — each with the
+ * allowance, role and seed checks those paths carry. A proposed product is
+ * created as a draft with no price, and a proposed discount is created
+ * switched off.
+ *
+ * ## A bulk job, a product at a time
+ *
+ * A bulk job's pass writes one product's copy and asks the machine to
+ * continue while products remain, so each product is one reservation and one
+ * provider exchange, and a job that runs out of credits resumes at the
+ * product where it stopped. Which product is next is read from the job's own
+ * outputs, one a product, so nothing is kept anywhere else. A product that is
+ * gone, or whose copy cannot be held to the rules, is reported and passed
+ * over rather than failing the products after it.
+ *
+ * ## What the model is shown
+ *
+ * The product's name, type, text, tags, options and current search listing,
+ * the names of the site's categories, the store's name, and — for a model that
+ * reads pictures — the product's first photo, read from the site's own media
+ * library as `ai-product-image.ts` describes. A catalog or categories request
+ * carries the brief and the store's name, and the second its existing category
+ * names. No price, stock, order, customer or other product is read for any of
+ * them.
+ */ export const AI_PRODUCTS_NO_SITE_COPY = 'Open the store this job is for before starting it.';
+export const AI_PRODUCTS_UNKNOWN_SITE_COPY = 'This AI job names a site this workspace does not have.';
+export const AI_PRODUCTS_NOT_ENTITLED_COPY = 'Your plan does not include selling products. See Billing.';
+export const AI_PRODUCTS_COMMERCE_OFF_COPY = 'Turn on Commerce for this site before starting the job.';
+export const AI_PRODUCTS_GONE_COPY = 'This product is no longer in the catalog.';
+export const AI_PRODUCTS_DECLINED_COPY = 'The model declined to write copy for this product.';
+/** The notes a proposal carries about its product's photo. */ export const AI_PRODUCT_PHOTO_NOTES = {
+    'not-in-library': 'The photo was not read: it is not in this site’s media library. The copy is written from the product’s words.',
+    unreadable: 'The photo could not be read, so the copy is written from the product’s words.',
+    model: 'The photo was not read: the model this job ran on does not read pictures.'
+};
+/** The commerce plugin, as `plugins.config.json` names it. */ const COMMERCE_PLUGIN_ID = 'commerce';
+/**
+ * ASSUMED: how long a catalog or categories pass reads the site before it
+ * asks: the host document and, for categories, the category names.
+ */ export const AI_PRODUCTS_SITE_READ_MS = 1000;
+const TIER = AI_STEP_TIERS[AI_PRODUCTS_STEP];
+/**
+ * One product's copy (AGL-3035): its generation and re-ask at the copy's own
+ * ceiling on the tier `job.products` is served from, with the photo read. The
+ * least any pass of the step needs, and so what the step registers.
+ */ export const AI_JOB_PRODUCT_COPY_BUDGET = aiJobStepBudget({
+    tier: TIER,
+    maxTokens: AI_PRODUCT_COPY_MAX_TOKENS,
+    lookups: 0,
+    ownReadsMs: AI_PRODUCT_IMAGE_READ_MS
+});
+/** A catalog: the largest answer the step asks for, at the routing table's ceiling. */ export const AI_JOB_CATALOG_BUDGET = aiJobStepBudget({
+    tier: TIER,
+    maxTokens: AI_CATALOG_MAX_TOKENS,
+    lookups: 0,
+    ownReadsMs: AI_PRODUCTS_SITE_READ_MS
+});
+/** Categories and discounts. */ export const AI_JOB_CATEGORIES_BUDGET = aiJobStepBudget({
+    tier: TIER,
+    maxTokens: AI_PRODUCT_CATEGORIES_MAX_TOKENS,
+    lookups: 0,
+    ownReadsMs: AI_PRODUCTS_SITE_READ_MS
+});
+/** What the `products` step registers: the least any of its passes needs. */ export const AI_JOB_PRODUCTS_STEP_BUDGET = AI_JOB_PRODUCT_COPY_BUDGET;
+/** The least time the next pass of a job needs, by what the job asks for. */ export function aiProductsRunMinimumMs(job) {
+    const inputs = parseAiProductsJobInputs(job.inputs);
+    if (typeof inputs === 'string') return AI_JOB_PRODUCT_COPY_BUDGET.minimumMs;
+    if (inputs.target === 'catalog') return AI_JOB_CATALOG_BUDGET.minimumMs;
+    if (inputs.target === 'categories') return AI_JOB_CATEGORIES_BUDGET.minimumMs;
+    return AI_JOB_PRODUCT_COPY_BUDGET.minimumMs;
+}
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** Through JSON, so no `undefined` reaches the job document's write. */ const plain = (value)=>JSON.parse(JSON.stringify(value));
+/** The site a job names, read and checked against the job's org. */ async function loadStore(firestore, job) {
+    var _host_seo;
+    if (!job.hostId) return {
+        failure: AI_PRODUCTS_NO_SITE_COPY
+    };
+    const snapshot = await firestore.collection('hosts').doc(job.hostId).get();
+    const host = snapshot.exists ? snapshot.data() : null;
+    // The door checks the caller's membership of the org the job is metered
+    // against; a site of another org is refused here, before anything of it
+    // reaches a prompt.
+    if (!host || host['orgId'] !== job.orgId) return {
+        failure: AI_PRODUCTS_UNKNOWN_SITE_COPY
+    };
+    const seo = (_host_seo = host['seo']) != null ? _host_seo : {};
+    const subdomain = str(host['subdomain']) || null;
+    return {
+        hostId: job.hostId,
+        subdomain,
+        name: str(seo['title']) || str(host['displayName']) || subdomain || ''
+    };
+}
+/** The site's categories by name, as many as a request lists. */ async function readCategories(firestore, hostId) {
+    const snapshot = await firestore.collection('hosts').doc(hostId).collection('productCategories').select('name').limit(AI_PRODUCT_CATEGORY_LIST_MAX).get();
+    return snapshot.docs.map((doc)=>({
+            id: doc.id,
+            name: str(doc.get('name'))
+        })).filter((category)=>category.name).sort((a, b)=>a.name.localeCompare(b.name));
+}
+/** A saved product's facts, as a bulk pass reads them; `null` when it is gone. */ async function readProductFacts(firestore, hostId, productId) {
+    var _data_seo;
+    const snapshot = await firestore.collection('hosts').doc(hostId).collection('products').doc(productId).get();
+    const data = snapshot.exists ? snapshot.data() : null;
+    if (!data || data['deletedAt']) return null;
+    const name = str(data['name']);
+    if (!name) return null;
+    const type = data['type'];
+    const seo = (_data_seo = data['seo']) != null ? _data_seo : {};
+    const mediaUrls = Array.isArray(data['mediaUrls']) ? data['mediaUrls'] : [];
+    return {
+        id: productId,
+        name,
+        type: AI_PRODUCT_TYPES.includes(type) ? type : 'physical',
+        text: str(data['description']).slice(0, AI_PRODUCT_TEXT_MAX_CHARS),
+        tags: (Array.isArray(data['tags']) ? data['tags'] : []).map(str).filter(Boolean),
+        categoryIds: (Array.isArray(data['categoryIds']) ? data['categoryIds'] : []).map(str).filter(Boolean),
+        options: (Array.isArray(data['options']) ? data['options'] : []).slice(0, AI_PRODUCT_OPTIONS_MAX).map((option)=>{
+            const record = option != null ? option : {};
+            return {
+                name: str(record['name']),
+                values: (Array.isArray(record['values']) ? record['values'] : []).map(str).filter(Boolean).slice(0, AI_PRODUCT_OPTION_VALUES_MAX)
+            };
+        }).filter((option)=>option.name),
+        imageUrl: str(mediaUrls[0]) || str(data['imageUrl']) || null,
+        seoTitle: str(seo['title']),
+        seoDescription: str(seo['description'])
+    };
+}
+function modelOf(context) {
+    var _ref;
+    return (_ref = context.modelFor == null ? void 0 : context.modelFor.call(context, AI_PRODUCTS_STEP)) != null ? _ref : aiModelForStep(AI_PRODUCTS_STEP);
+}
+/** An output addressed to the site, so its link opens the site's products. */ function output(site, id, label, proposal) {
+    return {
+        resource: 'product',
+        id,
+        hostId: site.hostId,
+        hostSubdomain: site.subdomain,
+        label,
+        proposal: plain(proposal)
+    };
+}
+/** Ask for one product's copy, and build its proposal from the answer. */ async function writeProductCopy(context, model, site, product, deps) {
+    var _ref;
+    const { job, firestore, signal } = context;
+    const categories = await readCategories(firestore, site.hostId);
+    let photo = 'none';
+    let image = null;
+    if (product.imageUrl) {
+        var _deps_readsImages;
+        if (((_deps_readsImages = deps.readsImages) != null ? _deps_readsImages : aiRouteReadsImages)(model)) {
+            const read = await readAiProductImage(firestore, {
+                value: product.imageUrl,
+                hostId: site.hostId,
+                orgId: job.orgId
+            }, deps.image);
+            photo = read.status;
+            image = read.status === 'read' ? read.image : null;
+        } else {
+            photo = 'model';
+        }
+    }
+    const generation = await generateAiProductCopy(_extends({
+        store: site.name,
+        product,
+        categories,
+        photo: Boolean(image),
+        image,
+        model,
+        maxTokens: AI_JOB_PRODUCT_COPY_BUDGET.maxTokens(model)
+    }, signal ? {
+        signal
+    } : {}));
+    const values = generation.status === 'ok' ? generation.value : null;
+    const names = new Map(categories.map((category)=>[
+            category.id,
+            category.name
+        ]));
+    const note = AI_PRODUCT_PHOTO_NOTES[photo];
+    return {
+        generation,
+        proposal: {
+            kind: 'copy',
+            product: {
+                id: product.id,
+                name: product.name
+            },
+            values,
+            categories: ((_ref = values == null ? void 0 : values.categoryIds) != null ? _ref : []).map((id)=>{
+                var _names_get;
+                return {
+                    id,
+                    name: (_names_get = names.get(id)) != null ? _names_get : id
+                };
+            }),
+            optionNamesBefore: product.options.map((option)=>option.name),
+            gaps: values ? aiProductGaps(values.description) : [],
+            photo,
+            skipped: null,
+            notes: note ? [
+                note
+            ] : []
+        }
+    };
+}
+/** The step, with its reads replaceable where a spec needs them. */ export function createAiJobProductsStep(deps = {}) {
+    return async (context)=>{
+        const { job, firestore, signal } = context;
+        const model = modelOf(context);
+        const inputs = parseAiProductsJobInputs(job.inputs);
+        if (typeof inputs === 'string') return _extends({}, aiUnspentOutcome(model), {
+            failure: inputs
+        });
+        const site = await loadStore(firestore, job);
+        if ('failure' in site) return _extends({}, aiUnspentOutcome(model), {
+            failure: site.failure
+        });
+        if (inputs.target === 'product') {
+            const { generation, proposal } = await writeProductCopy(context, model, site, inputs.product, deps);
+            const spent = aiGenerationSpent(generation);
+            if (generation.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (generation.status === 'needs_input') return _extends({}, spent, {
+                failure: generation.message
+            });
+            return _extends({}, spent, {
+                outputs: [
+                    output(site, AI_PRODUCTS_OUTPUT_IDS.copy(inputs.product.id), `Product copy · ${inputs.product.name}`, proposal)
+                ]
+            });
+        }
+        if (inputs.target === 'bulk') {
+            var _job_outputs;
+            const done = ((_job_outputs = job.outputs) != null ? _job_outputs : []).filter((entry)=>{
+                var _aiProductsProposalOf;
+                return ((_aiProductsProposalOf = aiProductsProposalOf(entry)) == null ? void 0 : _aiProductsProposalOf.kind) === 'copy';
+            }).length;
+            const productId = inputs.productIds[done];
+            if (!productId) return aiUnspentOutcome(model);
+            const more = done + 1 < inputs.productIds.length;
+            const product = await readProductFacts(firestore, site.hostId, productId);
+            if (!product) {
+                const skipped = {
+                    kind: 'copy',
+                    product: {
+                        id: productId,
+                        name: productId
+                    },
+                    values: null,
+                    categories: [],
+                    optionNamesBefore: [],
+                    gaps: [],
+                    photo: 'none',
+                    skipped: AI_PRODUCTS_GONE_COPY,
+                    notes: []
+                };
+                return _extends({}, aiUnspentOutcome(model, {
+                    outputs: [
+                        output(site, AI_PRODUCTS_OUTPUT_IDS.copy(productId), `Product copy · ${productId}`, skipped)
+                    ]
+                }), {
+                    continue: more
+                });
+            }
+            const { generation, proposal } = await writeProductCopy(context, model, site, product, deps);
+            const spent = aiGenerationSpent(generation);
+            // One product the rules could not hold, or the model declined, is
+            // reported and passed over: its tokens are metered with the pass, and
+            // the products after it still get their copy.
+            const reported = generation.status === 'ok' ? proposal : _extends({}, proposal, {
+                skipped: generation.status === 'needs_input' ? generation.message : AI_PRODUCTS_DECLINED_COPY
+            });
+            return _extends({}, spent, {
+                outputs: [
+                    output(site, AI_PRODUCTS_OUTPUT_IDS.copy(productId), `Product copy · ${product.name}`, reported)
+                ],
+                continue: more
+            });
+        }
+        if (inputs.target === 'catalog') {
+            const generation = await generateAiCatalog(_extends({
+                store: site.name,
+                brief: job.brief,
+                model,
+                maxTokens: AI_JOB_CATALOG_BUDGET.maxTokens(model)
+            }, signal ? {
+                signal
+            } : {}));
+            const spent = aiGenerationSpent(generation);
+            if (generation.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (generation.status === 'needs_input') return _extends({}, spent, {
+                failure: generation.message
+            });
+            const proposal = {
+                kind: 'catalog',
+                products: generation.value,
+                notes: []
+            };
+            return _extends({}, spent, {
+                outputs: [
+                    output(site, AI_PRODUCTS_OUTPUT_IDS.catalog, `Proposed products · ${generation.value.length}`, proposal)
+                ]
+            });
+        }
+        const existing = await readCategories(firestore, site.hostId);
+        const generation = await generateAiCategories(_extends({
+            store: site.name,
+            brief: job.brief,
+            existingCategoryNames: existing.map((category)=>category.name),
+            model,
+            maxTokens: AI_JOB_CATEGORIES_BUDGET.maxTokens(model)
+        }, signal ? {
+            signal
+        } : {}));
+        const spent = aiGenerationSpent(generation);
+        if (generation.status === 'refused') return _extends({}, spent, {
+            refused: true
+        });
+        if (generation.status === 'needs_input') return _extends({}, spent, {
+            failure: generation.message
+        });
+        const proposal = _extends({
+            kind: 'categories'
+        }, generation.value, {
+            notes: []
+        });
+        return _extends({}, spent, {
+            outputs: [
+                output(site, AI_PRODUCTS_OUTPUT_IDS.categories, 'Proposed categories and discounts', proposal)
+            ]
+        });
+    };
+}
+export const runAiJobProductsStep = createAiJobProductsStep();
+/**
+ * Whether a `products` job may start: inputs it can run, a site of the job's
+ * own org, a plan that sells products, and Commerce on for the site and past
+ * its release flag. Asked by the create door before the job exists, so a
+ * refusal spends nothing.
+ */ export const aiProductsJobAdmission = async (context)=>{
+    var _data;
+    const inputs = parseAiProductsJobInputs(context.inputs);
+    if (typeof inputs === 'string') return {
+        status: 400,
+        error: inputs
+    };
+    if (!context.hostId) return {
+        status: 400,
+        error: AI_PRODUCTS_NO_SITE_COPY
+    };
+    const owner = await resolveOrgIdForHost(context.hostId);
+    if (!owner || owner !== context.orgId) return {
+        status: 404,
+        error: AI_PRODUCTS_UNKNOWN_SITE_COPY
+    };
+    const org = context.org;
+    if (!checkEntitlement(org, 'commerce')) return {
+        status: 403,
+        error: AI_PRODUCTS_NOT_ENTITLED_COPY
+    };
+    const host = (_data = (await context.firestore.collection('hosts').doc(context.hostId).get()).data()) != null ? _data : null;
+    const released = await filterEnabledPluginsByReleaseFlags([
+        COMMERCE_PLUGIN_ID
+    ], {
+        orgId: context.orgId,
+        authorization: null
+    });
+    if (!released.includes(COMMERCE_PLUGIN_ID) || !isHostPluginEnabled(org, host, COMMERCE_PLUGIN_ID)) {
+        return {
+            status: 403,
+            error: AI_PRODUCTS_COMMERCE_OFF_COPY
+        };
+    }
+    return null;
+};
+/**
+ * Registers the `products` step, the least time each of its passes needs, its
+ * pass bound and its admission.
+ */ export function registerAiProductsJob() {
+    registerAiJobStep('products', runAiJobProductsStep, {
+        minimumMs: AI_JOB_PRODUCTS_STEP_BUDGET.minimumMs,
+        minimumMsFor: aiProductsRunMinimumMs
+    });
+    registerAiJobStepPasses('products', AI_PRODUCTS_BULK_MAX);
+    registerAiJobAdmission('products', aiProductsJobAdmission);
+}
+
+//# sourceMappingURL=ai-job-products-step.js.map