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

package/src/lib/jobs/ai-layout-owner-photos.d.ts

@@ -49,9 +49,24 @@ export declare function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean;
  * search, in slot order.
  */
 export declare function aiAssignOwnerPhotos(slots: readonly AiLayoutPictureSlot[], photos: readonly PluginMediaAsset[], avoid?: ReadonlySet<string>): Array<AiLayoutPicturePhoto | null>;
+/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */
+export declare const AI_LAYOUT_PAGE_PHOTOS_INPUT = "pagePhotos";
+/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */
+export declare function aiLayoutPagePhotosOf(inputs: Readonly<Record<string, unknown>> | null | undefined): PluginMediaAsset[];
+/**
+ * The photos a page brought in from the owner's own site placed first
+ * (AGL-3976): the page's own pictures, already in the site's library, fill
+ * the slots they fit, in the same order an owner's photos do and with no
+ * job-wide repeat rule, since a team photo the old site showed twice is the
+ * owner's to show twice. The slots left go to `next`.
+ */
+export declare function aiLayoutPagePhotoSource(photos: readonly PluginMediaAsset[], next: AiLayoutPictureSource | null): AiLayoutPictureSource | null;
 /**
  * The source for one page: the owner's photos for the slots they fit, the
  * stock library for the rest. `null` only when neither can answer — no
  * media door and no stock library — which leaves every slot to the starters.
+ * A page a site import brings in (AGL-3976) places its own pictures first.
  */
-export declare function aiLayoutSitePhotoSource(input: AiLayoutStockPhotoSourceInput, deps?: AiLayoutOwnerPhotoDeps): AiLayoutPictureSource | null;
+export declare function aiLayoutSitePhotoSource(input: AiLayoutStockPhotoSourceInput & {
+    pagePhotos?: readonly PluginMediaAsset[];
+}, deps?: AiLayoutOwnerPhotoDeps): AiLayoutPictureSource | null;

package/src/lib/jobs/ai-layout-owner-photos.js

@@ -67,18 +67,65 @@ function area(photo) {
     }
     return answers;
 }
+/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */ export const AI_LAYOUT_PAGE_PHOTOS_INPUT = 'pagePhotos';
+/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */ export function aiLayoutPagePhotosOf(inputs) {
+    const raw = inputs == null ? void 0 : inputs[AI_LAYOUT_PAGE_PHOTOS_INPUT];
+    if (!Array.isArray(raw)) return [];
+    const photos = [];
+    for (const entry of raw){
+        if (!entry || typeof entry !== 'object') continue;
+        const { mediaId, src, width, height, alt } = entry;
+        if (typeof mediaId !== 'string' || typeof src !== 'string' || !src.startsWith('media:')) continue;
+        if (typeof width !== 'number' || typeof height !== 'number' || width <= 0 || height <= 0) continue;
+        photos.push(_extends({
+            mediaId,
+            src,
+            width,
+            height
+        }, typeof alt === 'string' && alt.trim() ? {
+            alt: alt.trim()
+        } : {}));
+    }
+    return photos;
+}
+/**
+ * The photos a page brought in from the owner's own site placed first
+ * (AGL-3976): the page's own pictures, already in the site's library, fill
+ * the slots they fit, in the same order an owner's photos do and with no
+ * job-wide repeat rule, since a team photo the old site showed twice is the
+ * owner's to show twice. The slots left go to `next`.
+ */ export function aiLayoutPagePhotoSource(photos, next) {
+    if (!photos.length) return next;
+    return async (slots, report)=>{
+        const answers = aiAssignOwnerPhotos(slots, photos);
+        if (!next) return answers;
+        const open = slots.filter((_slot, index)=>!answers[index]);
+        if (!open.length) return answers;
+        const found = await next(open, report);
+        let index = 0;
+        return answers.map((answer)=>{
+            var _ref;
+            return (_ref = answer != null ? answer : found[index++]) != null ? _ref : null;
+        });
+    };
+}
 /**
  * The source for one page: the owner's photos for the slots they fit, the
  * stock library for the rest. `null` only when neither can answer — no
  * media door and no stock library — which leaves every slot to the starters.
+ * A page a site import brings in (AGL-3976) places its own pictures first.
  */ export function aiLayoutSitePhotoSource(input, deps = {}) {
+    var _input_pagePhotos;
+    return aiLayoutPagePhotoSource((_input_pagePhotos = input.pagePhotos) != null ? _input_pagePhotos : [], aiLayoutOwnerAndStockSource(input, deps));
+}
+function aiLayoutOwnerAndStockSource(input, deps) {
     var _deps_stock, _deps_ingest;
     var _ingest_listOwnerPhotos;
     const stock = ((_deps_stock = deps.stock) != null ? _deps_stock : aiLayoutStockPhotoSource)(input, deps);
     const ingest = ((_deps_ingest = deps.ingest) != null ? _deps_ingest : pluginMediaIngest)();
     const list = ingest == null ? void 0 : (_ingest_listOwnerPhotos = ingest.listOwnerPhotos) == null ? void 0 : _ingest_listOwnerPhotos.bind(ingest);
     if (!list || !input.hostId) return stock;
-    return async (slots)=>{
+    return async (slots, report)=>{
         var _input_avoid;
         let photos = [];
         try {
@@ -98,7 +145,7 @@ function area(photo) {
         if (!open.length) return answers;
         // The stock source sees only the slots the owner's photos left, so its
         // own no-repeat rules and search budget are spent on those alone.
-        const found = await stock(open);
+        const found = await stock(open, report);
         let next = 0;
         return answers.map((answer)=>{
             var _ref;

package/src/lib/jobs/ai-layout-owner-photos.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-owner-photos.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 type { PluginMediaAsset } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport { pluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport type {\n  AiLayoutPicturePhoto,\n  AiLayoutPictureSlot,\n  AiLayoutPictureSource,\n} from '../layout-language/ai-layout-pictures'\nimport {\n  aiLayoutStockPhotoSource,\n  type AiLayoutStockPhotoDeps,\n  type AiLayoutStockPhotoSourceInput,\n} from './ai-layout-stock-photos'\n\n/**\n * THE BUSINESS'S OWN PHOTOS COME FIRST (AGL-3957).\n *\n * A site built for an owner at a booth or on a doorstep has, by the time its\n * pages are drawn, the photos they sent from their phone through a site\n * photo link: their van, their shop, their work. A photo of the owner's own\n * work beats any stock photo, so a page's picture slots are filled from\n * those first, and only the slots left over are searched for in the stock\n * library, the way they were before.\n *\n * Which photo goes where is decided by shape and size, not by subject: an\n * owner's photo says nothing a search could read. The hero takes the widest\n * photo among the largest; the about picture takes the next largest; the\n * gallery takes the rest, newest first, each photo once on the page and once\n * across the job (`avoid`). A product's photo, a person's portrait and a\n * record's cover are of one named thing, which a photo of the business in\n * general is not, so those slots go to the stock search untouched.\n */\n\nexport interface AiLayoutOwnerPhotoDeps extends AiLayoutStockPhotoDeps {\n  /** The stock source the leftover slots go to; the real one otherwise. Specs hand in a fake. */\n  stock?: typeof aiLayoutStockPhotoSource\n  /** The most owner photos read for one page. */\n  limit?: number\n}\n\nconst OWNER_PHOTOS_LIMIT = 60\n\n/** A slot an owner's photo may fill: one of the business in general, not of one named thing. */\nexport function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean {\n  return !slot.product && !slot.people && !slot.record\n}\n\n/** Fill order: the hero first, so the biggest photo is the first one seen; then about; then the gallery in document order. */\nconst ROLE_RANK = { hero: 0, about: 1, gallery: 2 } as const\n\nfunction area(photo: PluginMediaAsset): number {\n  return (photo.width ?? 0) * (photo.height ?? 0)\n}\n\n/**\n * Assigns the owner's photos to the slots, in the order above. Pure, so a\n * spec can hold the choice itself: `null` for a slot left to the stock\n * search, in slot order.\n */\nexport function aiAssignOwnerPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  photos: readonly PluginMediaAsset[],\n  avoid: ReadonlySet<string> = new Set(),\n): Array<AiLayoutPicturePhoto | null> {\n  const pool = photos\n    .filter((photo) => photo.src && (photo.width ?? 0) > 0 && (photo.height ?? 0) > 0 && !avoid.has(photo.src))\n    .sort((a, b) => area(b) - area(a))\n  const answers: Array<AiLayoutPicturePhoto | null> = slots.map(() => null)\n  const used = new Set<string>()\n  const order = slots\n    .map((slot, index) => ({ slot, index }))\n    .filter(({ slot }) => aiOwnerPhotoFits(slot))\n    .sort((a, b) => ROLE_RANK[a.slot.role] - ROLE_RANK[b.slot.role] || a.index - b.index)\n  for (const { slot, index } of order) {\n    const free = pool.filter((photo) => !used.has(photo.src))\n    if (!free.length) break\n    // The hero wants the widest of the three largest; a portrait phone photo\n    // in a wide frame is the one mismatch a visitor sees first.\n    const pick =\n      slot.role === 'hero'\n        ? [...free.slice(0, 3)].sort(\n            (a, b) => (b.width ?? 0) / (b.height ?? 1) - (a.width ?? 0) / (a.height ?? 1),\n          )[0]\n        : free[0]\n    if (!pick) break\n    used.add(pick.src)\n    answers[index] = {\n      src: pick.src,\n      width: pick.width as number,\n      height: pick.height as number,\n      ...(pick.alt ? { alt: pick.alt } : {}),\n    }\n  }\n  return answers\n}\n\n/**\n * The source for one page: the owner's photos for the slots they fit, the\n * stock library for the rest. `null` only when neither can answer — no\n * media door and no stock library — which leaves every slot to the starters.\n */\nexport function aiLayoutSitePhotoSource(\n  input: AiLayoutStockPhotoSourceInput,\n  deps: AiLayoutOwnerPhotoDeps = {},\n): AiLayoutPictureSource | null {\n  const stock = (deps.stock ?? aiLayoutStockPhotoSource)(input, deps)\n  const ingest = (deps.ingest ?? pluginMediaIngest)()\n  const list = ingest?.listOwnerPhotos?.bind(ingest)\n  if (!list || !input.hostId) return stock\n  return async (slots) => {\n    let photos: PluginMediaAsset[] = []\n    try {\n      photos = await list({ hostId: input.hostId, limit: deps.limit ?? OWNER_PHOTOS_LIMIT })\n    } catch (error) {\n      console.warn('ai layout pictures: the owner photos could not be read; stock photos fill the page', { error })\n    }\n    const answers = aiAssignOwnerPhotos(slots, photos, new Set(input.avoid ?? []))\n    if (!stock) return answers\n    const open = slots.filter((_slot, index) => !answers[index])\n    if (!open.length) return answers\n    // The stock source sees only the slots the owner's photos left, so its\n    // own no-repeat rules and search budget are spent on those alone.\n    const found = await stock(open)\n    let next = 0\n    return answers.map((answer) => answer ?? found[next++] ?? null)\n  }\n}\n"],"names":["pluginMediaIngest","aiLayoutStockPhotoSource","OWNER_PHOTOS_LIMIT","aiOwnerPhotoFits","slot","product","people","record","ROLE_RANK","hero","about","gallery","area","photo","width","height","aiAssignOwnerPhotos","slots","photos","avoid","Set","pool","filter","src","has","sort","a","b","answers","map","used","order","index","role","free","length","pick","slice","add","alt","aiLayoutSitePhotoSource","input","deps","ingest","stock","list","listOwnerPhotos","bind","hostId","limit","error","console","warn","open","_slot","found","next","answer"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-owner-photos.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 type { PluginMediaAsset } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport { pluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport type {\n  AiLayoutPicturePhoto,\n  AiLayoutPictureSlot,\n  AiLayoutPictureSource,\n} from '../layout-language/ai-layout-pictures'\nimport {\n  aiLayoutStockPhotoSource,\n  type AiLayoutStockPhotoDeps,\n  type AiLayoutStockPhotoSourceInput,\n} from './ai-layout-stock-photos'\n\n/**\n * THE BUSINESS'S OWN PHOTOS COME FIRST (AGL-3957).\n *\n * A site built for an owner at a booth or on a doorstep has, by the time its\n * pages are drawn, the photos they sent from their phone through a site\n * photo link: their van, their shop, their work. A photo of the owner's own\n * work beats any stock photo, so a page's picture slots are filled from\n * those first, and only the slots left over are searched for in the stock\n * library, the way they were before.\n *\n * Which photo goes where is decided by shape and size, not by subject: an\n * owner's photo says nothing a search could read. The hero takes the widest\n * photo among the largest; the about picture takes the next largest; the\n * gallery takes the rest, newest first, each photo once on the page and once\n * across the job (`avoid`). A product's photo, a person's portrait and a\n * record's cover are of one named thing, which a photo of the business in\n * general is not, so those slots go to the stock search untouched.\n */\n\nexport interface AiLayoutOwnerPhotoDeps extends AiLayoutStockPhotoDeps {\n  /** The stock source the leftover slots go to; the real one otherwise. Specs hand in a fake. */\n  stock?: typeof aiLayoutStockPhotoSource\n  /** The most owner photos read for one page. */\n  limit?: number\n}\n\nconst OWNER_PHOTOS_LIMIT = 60\n\n/** A slot an owner's photo may fill: one of the business in general, not of one named thing. */\nexport function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean {\n  return !slot.product && !slot.people && !slot.record\n}\n\n/** Fill order: the hero first, so the biggest photo is the first one seen; then about; then the gallery in document order. */\nconst ROLE_RANK = { hero: 0, about: 1, gallery: 2 } as const\n\nfunction area(photo: PluginMediaAsset): number {\n  return (photo.width ?? 0) * (photo.height ?? 0)\n}\n\n/**\n * Assigns the owner's photos to the slots, in the order above. Pure, so a\n * spec can hold the choice itself: `null` for a slot left to the stock\n * search, in slot order.\n */\nexport function aiAssignOwnerPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  photos: readonly PluginMediaAsset[],\n  avoid: ReadonlySet<string> = new Set(),\n): Array<AiLayoutPicturePhoto | null> {\n  const pool = photos\n    .filter((photo) => photo.src && (photo.width ?? 0) > 0 && (photo.height ?? 0) > 0 && !avoid.has(photo.src))\n    .sort((a, b) => area(b) - area(a))\n  const answers: Array<AiLayoutPicturePhoto | null> = slots.map(() => null)\n  const used = new Set<string>()\n  const order = slots\n    .map((slot, index) => ({ slot, index }))\n    .filter(({ slot }) => aiOwnerPhotoFits(slot))\n    .sort((a, b) => ROLE_RANK[a.slot.role] - ROLE_RANK[b.slot.role] || a.index - b.index)\n  for (const { slot, index } of order) {\n    const free = pool.filter((photo) => !used.has(photo.src))\n    if (!free.length) break\n    // The hero wants the widest of the three largest; a portrait phone photo\n    // in a wide frame is the one mismatch a visitor sees first.\n    const pick =\n      slot.role === 'hero'\n        ? [...free.slice(0, 3)].sort(\n            (a, b) => (b.width ?? 0) / (b.height ?? 1) - (a.width ?? 0) / (a.height ?? 1),\n          )[0]\n        : free[0]\n    if (!pick) break\n    used.add(pick.src)\n    answers[index] = {\n      src: pick.src,\n      width: pick.width as number,\n      height: pick.height as number,\n      ...(pick.alt ? { alt: pick.alt } : {}),\n    }\n  }\n  return answers\n}\n\n/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */\nexport const AI_LAYOUT_PAGE_PHOTOS_INPUT = 'pagePhotos'\n\n/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */\nexport function aiLayoutPagePhotosOf(inputs: Readonly<Record<string, unknown>> | null | undefined): PluginMediaAsset[] {\n  const raw = inputs?.[AI_LAYOUT_PAGE_PHOTOS_INPUT]\n  if (!Array.isArray(raw)) return []\n  const photos: PluginMediaAsset[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { mediaId, src, width, height, alt } = entry as Record<string, unknown>\n    if (typeof mediaId !== 'string' || typeof src !== 'string' || !src.startsWith('media:')) continue\n    if (typeof width !== 'number' || typeof height !== 'number' || width <= 0 || height <= 0) continue\n    photos.push({ mediaId, src, width, height, ...(typeof alt === 'string' && alt.trim() ? { alt: alt.trim() } : {}) })\n  }\n  return photos\n}\n\n/**\n * The photos a page brought in from the owner's own site placed first\n * (AGL-3976): the page's own pictures, already in the site's library, fill\n * the slots they fit, in the same order an owner's photos do and with no\n * job-wide repeat rule, since a team photo the old site showed twice is the\n * owner's to show twice. The slots left go to `next`.\n */\nexport function aiLayoutPagePhotoSource(\n  photos: readonly PluginMediaAsset[],\n  next: AiLayoutPictureSource | null,\n): AiLayoutPictureSource | null {\n  if (!photos.length) return next\n  return async (slots, report) => {\n    const answers = aiAssignOwnerPhotos(slots, photos)\n    if (!next) return answers\n    const open = slots.filter((_slot, index) => !answers[index])\n    if (!open.length) return answers\n    const found = await next(open, report)\n    let index = 0\n    return answers.map((answer) => answer ?? found[index++] ?? null)\n  }\n}\n\n/**\n * The source for one page: the owner's photos for the slots they fit, the\n * stock library for the rest. `null` only when neither can answer — no\n * media door and no stock library — which leaves every slot to the starters.\n * A page a site import brings in (AGL-3976) places its own pictures first.\n */\nexport function aiLayoutSitePhotoSource(\n  input: AiLayoutStockPhotoSourceInput & { pagePhotos?: readonly PluginMediaAsset[] },\n  deps: AiLayoutOwnerPhotoDeps = {},\n): AiLayoutPictureSource | null {\n  return aiLayoutPagePhotoSource(input.pagePhotos ?? [], aiLayoutOwnerAndStockSource(input, deps))\n}\n\nfunction aiLayoutOwnerAndStockSource(\n  input: AiLayoutStockPhotoSourceInput,\n  deps: AiLayoutOwnerPhotoDeps,\n): AiLayoutPictureSource | null {\n  const stock = (deps.stock ?? aiLayoutStockPhotoSource)(input, deps)\n  const ingest = (deps.ingest ?? pluginMediaIngest)()\n  const list = ingest?.listOwnerPhotos?.bind(ingest)\n  if (!list || !input.hostId) return stock\n  return async (slots, report) => {\n    let photos: PluginMediaAsset[] = []\n    try {\n      photos = await list({ hostId: input.hostId, limit: deps.limit ?? OWNER_PHOTOS_LIMIT })\n    } catch (error) {\n      console.warn('ai layout pictures: the owner photos could not be read; stock photos fill the page', { error })\n    }\n    const answers = aiAssignOwnerPhotos(slots, photos, new Set(input.avoid ?? []))\n    if (!stock) return answers\n    const open = slots.filter((_slot, index) => !answers[index])\n    if (!open.length) return answers\n    // The stock source sees only the slots the owner's photos left, so its\n    // own no-repeat rules and search budget are spent on those alone.\n    const found = await stock(open, report)\n    let next = 0\n    return answers.map((answer) => answer ?? found[next++] ?? null)\n  }\n}\n"],"names":["pluginMediaIngest","aiLayoutStockPhotoSource","OWNER_PHOTOS_LIMIT","aiOwnerPhotoFits","slot","product","people","record","ROLE_RANK","hero","about","gallery","area","photo","width","height","aiAssignOwnerPhotos","slots","photos","avoid","Set","pool","filter","src","has","sort","a","b","answers","map","used","order","index","role","free","length","pick","slice","add","alt","AI_LAYOUT_PAGE_PHOTOS_INPUT","aiLayoutPagePhotosOf","inputs","raw","Array","isArray","entry","mediaId","startsWith","push","trim","aiLayoutPagePhotoSource","next","report","open","_slot","found","answer","aiLayoutSitePhotoSource","input","deps","pagePhotos","aiLayoutOwnerAndStockSource","ingest","stock","list","listOwnerPhotos","bind","hostId","limit","error","console","warn"],"mappings":"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"}

package/src/lib/jobs/ai-layout-stock-photos.d.ts

@@ -184,6 +184,14 @@ export declare const AI_STOCK_PHOTO_AVOID_INPUT = "stockPhotoAvoid";
  * (AGL-3988): what a picture the library failed takes before any starter.
  */
 export declare const AI_STOCK_PHOTO_JOB_PHOTOS_INPUT = "stockPhotoJobPhotos";
+/**
+ * The unit job input a guided start's page is built under (AGL-3988): its
+ * site step runs a late photo pass once every page is built, so a picture
+ * the library failed that none of the job's photos fits yet keeps a neutral
+ * starter for that pass to fill, rather than lose its frame, and the page
+ * reports it. A page built by any other job keeps #1831's rule.
+ */
+export declare const AI_STOCK_PHOTO_LATE_PASS_INPUT = "stockPhotoLatePass";
 /** The job photos a unit input holds ({@link AI_STOCK_PHOTO_JOB_PHOTOS_INPUT}): library photos with a size; anything else is dropped. */
 export declare function aiStockJobPhotosOf(value: unknown): AiLayoutPicturePhoto[];
 /**
@@ -735,7 +743,34 @@ export interface AiLayoutStockPhotoDeps {
     provider?: () => StockPhotoProvider | null;
     ingest?: () => PluginMediaIngest | null;
     budgetMs?: number;
+    /** The clock a refusal is dated by (AGL-3988); specs hand in a fixed one. */
+    now?: () => number;
 }
+/** A search as it is sent to the library: its words and size, none of how its hits are judged. */
+export declare function aiStockSearchRequest(wanted: AiStockSearch): StockPhotoSearchRequest;
+/**
+ * A search as a job keeps it to ask again (AGL-3988): only what a library's
+ * request is made of, so asked again it is the same request, which the
+ * provider's 24-hour cache answers.
+ */
+export declare function aiStockKeptRequest(request: StockPhotoSearchRequest): StockPhotoSearchRequest;
+/**
+ * The library's own record of a photo copied into a site (AGL-3923, AGL-3988):
+ * what the media library stores beside the bytes as `stockPhoto`, with the
+ * credit its license asks for. One shape for every copy a job makes, a
+ * page's and the late photo pass's.
+ */
+export declare function aiStockIngestRequest(provider: Pick<StockPhotoProvider, 'credit'>, input: {
+    hostId: string;
+    uid: string;
+    photo: StockPhoto;
+    bytes: {
+        bytes: Uint8Array;
+        contentType: string;
+    };
+    alt: string;
+    query: string;
+}): Parameters<PluginMediaIngest['ingest']>[0];
 /**
  * A job's language and English photo words (AGL-3760), the English name of
  * its kind of site (AGL-3771), and the business's name and audience as the

package/src/lib/jobs/ai-layout-stock-photos.js

@@ -183,6 +183,13 @@ import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
  * outside its pages — a dataset's records — with their size and words
  * (AGL-3988): what a picture the library failed takes before any starter.
  */ export const AI_STOCK_PHOTO_JOB_PHOTOS_INPUT = 'stockPhotoJobPhotos';
+/**
+ * The unit job input a guided start's page is built under (AGL-3988): its
+ * site step runs a late photo pass once every page is built, so a picture
+ * the library failed that none of the job's photos fits yet keeps a neutral
+ * starter for that pass to fill, rather than lose its frame, and the page
+ * reports it. A page built by any other job keeps #1831's rule.
+ */ export const AI_STOCK_PHOTO_LATE_PASS_INPUT = 'stockPhotoLatePass';
 /** The job photos a unit input holds ({@link AI_STOCK_PHOTO_JOB_PHOTOS_INPUT}): library photos with a size; anything else is dropped. */ export function aiStockJobPhotosOf(value) {
     if (!Array.isArray(value)) return [];
     return value.flatMap((entry)=>{
@@ -3643,6 +3650,80 @@ const EXTENSIONS = {
     'image/png': 'png',
     'image/webp': 'webp'
 };
+/** The words of a search that only this module reads, never sent to a library. */ const SEARCH_JUDGMENT_KEYS = [
+    'broad',
+    'subject',
+    'requires',
+    'object',
+    'kin',
+    'lead',
+    'leadWorld',
+    'first',
+    'category',
+    'strict',
+    'refuse',
+    'needs',
+    'allow',
+    'refuseLead',
+    'worldless',
+    'away'
+];
+/** A search as it is sent to the library: its words and size, none of how its hits are judged. */ export function aiStockSearchRequest(wanted) {
+    const request = _extends({}, wanted);
+    for (const key of SEARCH_JUDGMENT_KEYS)delete request[key];
+    return request;
+}
+/**
+ * A search as a job keeps it to ask again (AGL-3988): only what a library's
+ * request is made of, so asked again it is the same request, which the
+ * provider's 24-hour cache answers.
+ */ export function aiStockKeptRequest(request) {
+    return _extends({
+        query: request.query
+    }, request.orientation ? {
+        orientation: request.orientation
+    } : {}, request.minWidth ? {
+        minWidth: request.minWidth
+    } : {}, request.minHeight ? {
+        minHeight: request.minHeight
+    } : {}, request.people ? {
+        people: true
+    } : {});
+}
+/**
+ * The library's own record of a photo copied into a site (AGL-3923, AGL-3988):
+ * what the media library stores beside the bytes as `stockPhoto`, with the
+ * credit its license asks for. One shape for every copy a job makes, a
+ * page's and the late photo pass's.
+ */ export function aiStockIngestRequest(provider, input) {
+    var _EXTENSIONS_bytes_contentType;
+    const { photo, bytes } = input;
+    const credit = provider.credit(photo);
+    return {
+        hostId: input.hostId,
+        uid: input.uid,
+        fileName: `${photo.provider}-${photo.id}.${(_EXTENSIONS_bytes_contentType = EXTENSIONS[bytes.contentType]) != null ? _EXTENSIONS_bytes_contentType : 'jpg'}`,
+        contentType: bytes.contentType,
+        bytes: bytes.bytes,
+        alt: input.alt,
+        description: credit.text,
+        stockPhoto: _extends({
+            key: stockPhotoSourceKey(photo),
+            provider: photo.provider,
+            providerLabel: credit.providerLabel,
+            id: photo.id,
+            pageUrl: photo.pageUrl,
+            photographer: photo.photographer
+        }, photo.photographerUrl ? {
+            photographerUrl: photo.photographerUrl
+        } : {}, {
+            license: credit.license,
+            licenseUrl: credit.licenseUrl,
+            attributionRequired: credit.attributionRequired,
+            query: input.query
+        })
+    };
+}
 /**
  * A job's language and English photo words (AGL-3760), the English name of
  * its kind of site (AGL-3771), and the business's name and audience as the
@@ -4872,7 +4953,7 @@ const WORKSPACE = {
  * The source for one page, or `null` when this deployment has no stock
  * photo library or no media door, which leaves every slot to the starters.
  */ export function aiLayoutStockPhotoSource(input, deps = {}) {
-    var _deps_provider, _deps_ingest, _input_kind;
+    var _deps_provider, _deps_ingest, _input_kind, _deps_now;
     const provider = ((_deps_provider = deps.provider) != null ? _deps_provider : stockPhotoProvider)();
     const ingest = ((_deps_ingest = deps.ingest) != null ? _deps_ingest : pluginMediaIngest)();
     if (!provider || !ingest || !input.hostId || !input.uid) return null;
@@ -4888,7 +4969,8 @@ const WORKSPACE = {
     const wider = aiStockWiderTerms(terms, (_input_kind = input.kind) != null ? _input_kind : '');
     const unlisted = aiStockWorldIsUnlisted(terms);
     const proper = aiStockProperWords(input.business);
-    return async (slots)=>{
+    const now = (_deps_now = deps.now) != null ? _deps_now : Date.now;
+    return async (slots, report)=>{
         var _deps_budgetMs, _input_avoid;
         const timeout = AbortSignal.timeout((_deps_budgetMs = deps.budgetMs) != null ? _deps_budgetMs : AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS);
         const signal = input.signal ? AbortSignal.any([
@@ -4907,6 +4989,7 @@ const WORKSPACE = {
         let searches = 0;
         let storing = true;
         /** Slots a photo was chosen for and could not be copied into the library (AGL-3923). */ const uncopied = new Set();
+        /** Each slot's picks the image hosts would not hand over, and when (AGL-3988). */ const refusedPicks = new Map();
         /** Whether the library answered any search of this page: a slot left empty then found nothing fitting. */ let answered = false;
         const remember = (sourceKey, src)=>{
             placedSrcs.add(src);
@@ -4915,23 +4998,7 @@ const WORKSPACE = {
         };
         /** A search's hits; the same words twice are answered from memory, and `null` once the page's searches are spent. */ const search = (wanted)=>{
             var _input_searches;
-            const request = _extends({}, wanted);
-            delete request.broad;
-            delete request.subject;
-            delete request.requires;
-            delete request.object;
-            delete request.kin;
-            delete request.lead;
-            delete request.leadWorld;
-            delete request.first;
-            delete request.category;
-            delete request.strict;
-            delete request.refuse;
-            delete request.needs;
-            delete request.allow;
-            delete request.refuseLead;
-            delete request.worldless;
-            delete request.away;
+            const request = aiStockSearchRequest(wanted);
             const key = JSON.stringify([
                 request.query,
                 request.orientation,
@@ -4967,7 +5034,6 @@ const WORKSPACE = {
                 alt
             };
             try {
-                var _EXTENSIONS_bytes_contentType;
                 const kept = await ingest.findStockPhoto({
                     hostId: input.hostId,
                     sourceKey
@@ -4993,7 +5059,16 @@ const WORKSPACE = {
                 if (!bytes || signal.aborted || !storing) {
                     // A copy the library would not hand over is otherwise silent (AGL-3923).
                     if (!bytes && !signal.aborted) {
+                        var _refusedPicks_get;
                         uncopied.add(slot);
+                        // Asked for again by the late photo pass, once the burst is over (AGL-3988).
+                        const held = (_refusedPicks_get = refusedPicks.get(slot)) != null ? _refusedPicks_get : {
+                            keys: [],
+                            at: 0
+                        };
+                        if (!held.keys.includes(sourceKey)) held.keys.push(sourceKey);
+                        held.at = now();
+                        refusedPicks.set(slot, held);
                         console.warn('ai layout pictures: a stock photo could not be downloaded', {
                             provider: photo.provider,
                             id: photo.id
@@ -5001,31 +5076,14 @@ const WORKSPACE = {
                     }
                     return null;
                 }
-                const credit = provider.credit(photo);
-                const stored = await ingest.ingest({
+                const stored = await ingest.ingest(aiStockIngestRequest(provider, {
                     hostId: input.hostId,
                     uid: input.uid,
-                    fileName: `${photo.provider}-${photo.id}.${(_EXTENSIONS_bytes_contentType = EXTENSIONS[bytes.contentType]) != null ? _EXTENSIONS_bytes_contentType : 'jpg'}`,
-                    contentType: bytes.contentType,
-                    bytes: bytes.bytes,
+                    photo,
+                    bytes,
                     alt: alt != null ? alt : slot.alt,
-                    description: credit.text,
-                    stockPhoto: _extends({
-                        key: sourceKey,
-                        provider: photo.provider,
-                        providerLabel: credit.providerLabel,
-                        id: photo.id,
-                        pageUrl: photo.pageUrl,
-                        photographer: photo.photographer
-                    }, photo.photographerUrl ? {
-                        photographerUrl: photo.photographerUrl
-                    } : {}, {
-                        license: credit.license,
-                        licenseUrl: credit.licenseUrl,
-                        attributionRequired: credit.attributionRequired,
-                        query
-                    })
-                });
+                    query
+                }));
                 if (stored.ok) {
                     var _stored_width, _stored_height;
                     remember(sourceKey, stored.src);
@@ -5306,7 +5364,8 @@ const WORKSPACE = {
                     }
                     return _extends({
                         candidates: ranked.slice(0, AI_LAYOUT_STOCK_TRIES_PER_SLOT),
-                        query: request.query
+                        query: request.query,
+                        request: aiStockKeptRequest(aiStockSearchRequest(request))
                     }, repeat ? {
                         repeat: true
                     } : {});
@@ -5423,6 +5482,18 @@ const WORKSPACE = {
             length: Math.min(AI_LAYOUT_STOCK_COPIES_AT_ONCE, firsts.length)
         }, worker));
         for (const [index, choice] of choices.entries())if (choice == null ? void 0 : choice.repeat) await fill(index);
+        // A slot left without a photo because its picks were refused: what they
+        // were, for the late photo pass to ask for again (AGL-3988).
+        for (const [index, slot] of slots.entries()){
+            const held = refusedPicks.get(slot);
+            const choice = choices[index];
+            if (photos[index] || !(held == null ? void 0 : held.keys.length) || !choice) continue;
+            report == null ? void 0 : report.refused.set(slot, {
+                request: choice.request,
+                keys: held.keys,
+                at: new Date(held.at).toISOString()
+            });
+        }
         // The library answered and nothing in it fits: no photo rather than a
         // starter that shows another business (AGL-3831). A library that never
         // answered, or a site that refused to store, leaves the starters.