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

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

@@ -19,7 +19,7 @@ import { STOCK_PHOTO_QUERY_MAX_CHARS, stockPhotoProvider, stockPhotoSourceKey }
 import { AI_LAYOUT_NO_PHOTO, aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
 import { aiStorefrontSays } from "../layout-language/ai-layout-storefront.js";
 import { aiLayoutLabel, aiLayoutSpeaksOtherThanEnglish } from "../layout-language/ai-layout-labels.js";
-import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
+import { aiSiteKind, aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
 import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
@@ -157,6 +157,18 @@ import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
 /** The accepted hits a slot keeps in hand, in case a copy fails. */ const AI_LAYOUT_STOCK_TRIES_PER_SLOT = 3;
 /** Copies made side by side. */ const AI_LAYOUT_STOCK_COPIES_AT_ONCE = 4;
 /** The largest photo copied: inside one direct upload. */ export const AI_LAYOUT_STOCK_MAX_BYTES = 3 * 1024 * 1024;
+/**
+ * The media library's refusals that are about ONE photo's own bytes, as the
+ * console's `ingestMedia` returns them (AGL-3923): 415 for a type or contents
+ * it does not accept, 413 for a photo too large to store, 451 for a file
+ * held in quarantine. The slot then tries its next hit, and the page goes on
+ * storing. Every other refusal (403 from the storage band, the site's scope
+ * or a lockdown; 500) holds for the whole page.
+ */ export const AI_STOCK_PHOTO_OWN_REFUSALS = new Set([
+    413,
+    415,
+    451
+]);
 /**
  * The unit job input naming the screen drafts the job's other pages were
  * written to, whose photos a page does not place again (AGL-3660).
@@ -1529,8 +1541,14 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         ]
     });
 }
+/**
+ * Words that say a picture is one of a set, never what it shows (AGL-3923):
+ * the beta.266 Mexicano portfolio's gallery was "Project one" to "Project
+ * four", and searched "project" (students at a whiteboard), "project four"
+ * (lavender) and "four" (a running track's lane numbers).
+ */ const PLACEHOLDER_SUBJECTS = words('project projects piece pieces item items example examples sample samples entry entries untitled work works ' + 'selected recent latest ' + 'four five six seven eight nine ten first second third fourth fifth sixth seventh eighth ninth tenth');
 /** A phrase's content words without its filler; all filler, and nothing is left. */ function subjectOf(list) {
-    return list.filter((word)=>!FILLER.has(word));
+    return list.filter((word)=>!FILLER.has(word) && !PLACEHOLDER_SUBJECTS.has(word));
 }
 /**
  * A picture's subject in a few words (AGL-3660): the noun phrase its alt
@@ -2812,6 +2830,7 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
  * later does not place what an earlier one did, while a pass repeated over
  * its own page keeps its own photos. Bounded; the oldest job goes first.
  */ const JOB_PHOTOS = new Map();
+/** What a job's photos map holds for a photo the media library refused for its own bytes: no page's scope (AGL-3923). */ const REFUSED_BY_THE_LIBRARY = '\u0000refused';
 const JOB_PHOTOS_MAX = 200;
 function jobPhotos(key) {
     if (!key) return null;
@@ -3425,6 +3444,16 @@ const EXTENSIONS = {
         broad: [
             'artist studio',
             'creative workspace'
+        ],
+        // "Artist" names a bee and a tattooist as often as a painter (AGL-3923):
+        // the beta.266 Mexicano hero's first pick was "artist bee, giant artist bee".
+        shunLead: [
+            'bee',
+            'insect',
+            'insects',
+            'tattoo',
+            'makeup',
+            'cosmetics'
         ]
     },
     studio: {
@@ -3776,7 +3805,7 @@ const EXTENSIONS = {
 }
 /** What a kind of site's pictures are searched and judged by ({@link KIND_SUBJECTS}); `null` for a kind not listed. */ export function aiStockKindTerms(kind) {
     var _entry_broad;
-    var _entry_kin;
+    var _entry_kin, _entry_shunLead;
     const entry = KIND_SUBJECTS[kind];
     if (!entry) return null;
     const base = aiStockSiteTerms(entry.subject);
@@ -3799,7 +3828,562 @@ const EXTENSIONS = {
                 ...kin
             ])
         ]
-    });
+    }, ((_entry_shunLead = entry.shunLead) == null ? void 0 : _entry_shunLead.length) ? {
+        shunLead: [
+            ...new Set([
+                ...base.shunLead,
+                ...entry.shunLead.map(aiStockStem)
+            ])
+        ]
+    } : {});
+}
+/**
+ * The kind of site each starter is the shape of (`AiSiteKind.starter`): what
+ * a picture is searched by, widened past the kind the person picked, where
+ * nothing narrower found one (AGL-3923).
+ */ const STARTER_KINDS = {
+    business: 'business',
+    'physical-shop': 'store',
+    portfolio: 'portfolio',
+    landing: 'landing'
+};
+const OFFICE = {
+    kin: [
+        'office',
+        'workspace',
+        'desk',
+        'laptop',
+        'computer',
+        'meeting',
+        'business',
+        'work',
+        'workplace',
+        'team',
+        'notebook',
+        'coffee',
+        'teamwork',
+        'conference'
+    ],
+    broad: [
+        'office workspace',
+        'business meeting',
+        'workspace desk laptop'
+    ]
+};
+const WORKSPACE = {
+    kin: [
+        'workspace',
+        'desk',
+        'laptop',
+        'notebook',
+        'coffee',
+        'office',
+        'book',
+        'books',
+        'workplace'
+    ],
+    broad: [
+        'workspace desk laptop',
+        'notebook coffee desk'
+    ]
+};
+/**
+ * The last searches a picture tries, for each kind of site the guided start
+ * offers (AGL-3923): plain, common photos of where that kind's work happens,
+ * which every library holds many of, held to their own words. Never a face
+ * as the lead, never a child, never a product nor a rival business: a
+ * restaurant's are its tables and plates, never an office. A kind with no set
+ * keeps a slot nothing fits without a photo (AGL-3831).
+ */ const KIND_GENERIC = {
+    business: OFFICE,
+    trades: {
+        kin: [
+            'tools',
+            'tool',
+            'toolbox',
+            'workbench',
+            'workshop',
+            'construction',
+            'repair',
+            'renovation',
+            'drill',
+            'hammer',
+            'wrench',
+            'roof',
+            'house',
+            'carpentry'
+        ],
+        broad: [
+            'tools workbench',
+            'home renovation',
+            'construction tools'
+        ]
+    },
+    professional: {
+        kin: [
+            'office',
+            'desk',
+            'documents',
+            'document',
+            'meeting',
+            'conference',
+            'laptop',
+            'workplace',
+            'business',
+            'notebook',
+            'paperwork',
+            'consulting'
+        ],
+        broad: [
+            'office desk documents',
+            'business meeting',
+            'conference room'
+        ]
+    },
+    wellness: {
+        kin: [
+            'spa',
+            'massage',
+            'wellness',
+            'relaxation',
+            'relax',
+            'towel',
+            'towels',
+            'candle',
+            'stones',
+            'therapy',
+            'treatment',
+            'aromatherapy'
+        ],
+        broad: [
+            'spa stones towel',
+            'massage room',
+            'wellness spa'
+        ]
+    },
+    restaurant: {
+        kin: [
+            'restaurant',
+            'table',
+            'dining',
+            'food',
+            'plate',
+            'dish',
+            'meal',
+            'kitchen',
+            'cafe',
+            'dinner',
+            'lunch',
+            'cuisine'
+        ],
+        broad: [
+            'restaurant interior',
+            'restaurant table food',
+            'food plate'
+        ]
+    },
+    store: {
+        kin: [
+            'shop',
+            'store',
+            'retail',
+            'shelf',
+            'shelves',
+            'display',
+            'interior',
+            'boutique',
+            'storefront',
+            'counter'
+        ],
+        broad: [
+            'shop interior',
+            'retail store'
+        ]
+    },
+    portfolio: {
+        kin: [
+            'studio',
+            'workspace',
+            'desk',
+            'art',
+            'design',
+            'creative',
+            'sketch',
+            'drawing',
+            'paint',
+            'painting',
+            'brush',
+            'brushes',
+            'canvas',
+            'pencil',
+            'pencils',
+            'paper'
+        ],
+        broad: [
+            'art supplies',
+            'creative workspace',
+            'art studio'
+        ]
+    },
+    studio: {
+        kin: [
+            'design',
+            'studio',
+            'workspace',
+            'desk',
+            'laptop',
+            'sketch',
+            'creative',
+            'office',
+            'drawing',
+            'pencil'
+        ],
+        broad: [
+            'design studio workspace',
+            'creative workspace',
+            'workspace desk laptop'
+        ]
+    },
+    photography: {
+        kin: [
+            'camera',
+            'cameras',
+            'photography',
+            'lens',
+            'photographer',
+            'studio',
+            'film',
+            'tripod'
+        ],
+        broad: [
+            'camera lens',
+            'photography studio',
+            'vintage camera'
+        ]
+    },
+    blog: {
+        kin: [
+            'notebook',
+            'desk',
+            'writing',
+            'laptop',
+            'coffee',
+            'journal',
+            'book',
+            'books',
+            'workspace',
+            'pen',
+            'typewriter'
+        ],
+        broad: [
+            'writing desk notebook',
+            'laptop coffee desk'
+        ]
+    },
+    events: {
+        kin: [
+            'event',
+            'venue',
+            'wedding',
+            'reception',
+            'party',
+            'celebration',
+            'table',
+            'decoration',
+            'banquet',
+            'hall',
+            'flowers'
+        ],
+        broad: [
+            'event venue decoration',
+            'banquet table',
+            'party decoration'
+        ]
+    },
+    fitness: {
+        kin: [
+            'gym',
+            'fitness',
+            'weights',
+            'dumbbell',
+            'dumbbells',
+            'barbell',
+            'kettlebell',
+            'workout',
+            'exercise',
+            'training'
+        ],
+        broad: [
+            'gym equipment',
+            'dumbbells gym',
+            'fitness gym'
+        ]
+    },
+    yoga: {
+        kin: [
+            'yoga',
+            'mat',
+            'meditation',
+            'studio',
+            'relaxation',
+            'candle',
+            'zen',
+            'mindfulness'
+        ],
+        broad: [
+            'yoga mat',
+            'yoga studio',
+            'meditation candle'
+        ]
+    },
+    beauty: {
+        kin: [
+            'salon',
+            'beauty',
+            'hair',
+            'makeup',
+            'cosmetics',
+            'nails',
+            'manicure',
+            'spa',
+            'mirror',
+            'brush',
+            'brushes'
+        ],
+        broad: [
+            'beauty salon interior',
+            'makeup brushes cosmetics',
+            'hair salon chair'
+        ]
+    },
+    realestate: {
+        kin: [
+            'house',
+            'home',
+            'interior',
+            'living',
+            'room',
+            'property',
+            'architecture',
+            'apartment',
+            'kitchen',
+            'estate'
+        ],
+        broad: [
+            'house exterior',
+            'home interior living room',
+            'modern kitchen interior'
+        ]
+    },
+    education: {
+        kin: [
+            'classroom',
+            'books',
+            'book',
+            'library',
+            'school',
+            'desk',
+            'education',
+            'learning',
+            'study',
+            'studying',
+            'notebook',
+            'chalkboard',
+            'blackboard',
+            'lecture'
+        ],
+        broad: [
+            'library books',
+            'classroom',
+            'study desk books'
+        ]
+    },
+    nonprofit: {
+        kin: [
+            'volunteer',
+            'volunteers',
+            'volunteering',
+            'charity',
+            'donation',
+            'donations',
+            'community',
+            'helping',
+            'help',
+            'hands'
+        ],
+        broad: [
+            'volunteers charity',
+            'donation box',
+            'community volunteering'
+        ]
+    },
+    music: {
+        kin: [
+            'music',
+            'guitar',
+            'piano',
+            'instrument',
+            'instruments',
+            'concert',
+            'stage',
+            'microphone',
+            'drums',
+            'studio',
+            'vinyl'
+        ],
+        broad: [
+            'guitar instrument',
+            'concert stage lights',
+            'music studio microphone'
+        ]
+    },
+    personal: WORKSPACE,
+    landing: {
+        kin: [
+            'office',
+            'workspace',
+            'desk',
+            'laptop',
+            'computer',
+            'meeting',
+            'business',
+            'work',
+            'workplace',
+            'team',
+            'technology',
+            'startup'
+        ],
+        broad: [
+            'modern office',
+            'workspace desk laptop',
+            'business meeting'
+        ]
+    },
+    'coming-soon': WORKSPACE
+};
+/** The kind of site whose common photos each starter falls back to. */ const STARTER_GENERIC_KIND = {
+    business: 'business',
+    'physical-shop': 'store',
+    portfolio: 'portfolio',
+    landing: 'landing'
+};
+/** Stems no common photo leads with: a face, a portrait (AGL-3923). */ const FACE_STEMS = [
+    'face',
+    'portrait',
+    'selfie',
+    'headshot'
+].map(aiStockStem);
+/** The starter a kind of site follows ({@link STARTER_KINDS}); a kind not listed follows the business starter. */ function starterOfKind(kind) {
+    var _ref;
+    var _aiSiteKind;
+    const starter = (_ref = (_aiSiteKind = aiSiteKind(kind)) == null ? void 0 : _aiSiteKind.starter) != null ? _ref : 'business';
+    return STARTER_KINDS[starter] ? starter : 'business';
+}
+/** A kind of site's common photos as a world to search and judge by ({@link KIND_GENERIC}); `null` for a kind with no set. */ export function aiStockKindGenericTerms(kind) {
+    const set = KIND_GENERIC[kind];
+    if (!set) return null;
+    const kin = [
+        ...new Set(set.kin.map(aiStockStem))
+    ];
+    return {
+        business: '',
+        craft: '',
+        domain: kin,
+        broad: [
+            ...set.broad
+        ],
+        making: [],
+        named: [],
+        rivals: [],
+        core: kin,
+        shun: [],
+        shunLead: []
+    };
+}
+/**
+ * Whether a site's world is only its own words (AGL-3923): no craft this
+ * module lists and no kind of site named it, so its broad searches are its
+ * business and its craft read back ("freelencing"), which a library may not
+ * know at all.
+ */ export function aiStockWorldIsUnlisted(terms) {
+    const own = [
+        ...new Set([
+            terms.business,
+            terms.craft
+        ].map((word)=>word.trim()).filter(Boolean))
+    ];
+    return terms.broad.length > 0 && terms.broad.length === own.length && terms.broad.every((query, index)=>query === own[index]);
+}
+/**
+ * Whether a site's world agrees with the kind of site the person picked
+ * (AGL-3923): it was read from the kind, or names one of the kind's own
+ * words. A gym whose owner picked Business & services does not, and is never
+ * given an office.
+ */ function worldOfKind(terms, kind) {
+    var _ref;
+    var _aiStockKindGenericTerms;
+    const own = aiStockKindTerms(kind);
+    if (!own) return false;
+    if (own.craft === terms.craft && own.broad.join('|') === terms.broad.join('|')) return true;
+    const words = new Set([
+        ...own.domain,
+        ...(_ref = (_aiStockKindGenericTerms = aiStockKindGenericTerms(kind)) == null ? void 0 : _aiStockKindGenericTerms.domain) != null ? _ref : []
+    ]);
+    return terms.domain.some((stem)=>words.has(stem));
+}
+/**
+ * What a picture is searched by once nothing narrower found it a photo
+ * (AGL-3923), widest last.
+ *
+ * - A site whose world is its own words alone ({@link aiStockWorldIsUnlisted})
+ *   widens to the kind of site the person picked, the kind its starter is the
+ *   shape of, and last the kind's own common photos ({@link KIND_GENERIC}),
+ *   else its starter's.
+ * - Any other site widens only to its kind's own common photos, and only
+ *   where its world agrees with that kind ({@link worldOfKind}): a portfolio
+ *   read from its kind takes art supplies before no photo at all, and a
+ *   barbecue caterer whose kind says nothing of food never takes an office
+ *   (AGL-3831). A kind with no set keeps a slot nothing fits without a photo.
+ *
+ * A rung that would search what an earlier one did is left out.
+ *
+ * The beta.265 Kasvora Marketing Solutions start (job BK3r4I8bF1) typed its
+ * business as "Freelencing site offer services": its world was the one word
+ * "freelencing", which no library tags, so its cover hero searched it, found
+ * nothing, and shipped a flat dark band with no photo.
+ */ export function aiStockWiderTerms(terms, kind) {
+    var _STARTER_KINDS_starter, _aiStockKindGenericTerms, _STARTER_GENERIC_KIND_starter;
+    const rungs = [];
+    const seen = new Set([
+        JSON.stringify([
+            terms.craft,
+            [
+                ...terms.broad
+            ]
+        ])
+    ]);
+    const add = (rung, found)=>{
+        if (!found || !found.broad.length) return;
+        const key = JSON.stringify([
+            found.craft,
+            found.broad
+        ]);
+        if (seen.has(key)) return;
+        seen.add(key);
+        rungs.push({
+            rung,
+            terms: found
+        });
+    };
+    if (!aiStockWorldIsUnlisted(terms)) {
+        if (kind && worldOfKind(terms, kind)) add('generic', aiStockKindGenericTerms(kind));
+        return rungs;
+    }
+    const starter = starterOfKind(kind);
+    if (kind) add('kind', aiStockKindTerms(kind));
+    add('starter', aiStockKindTerms((_STARTER_KINDS_starter = STARTER_KINDS[starter]) != null ? _STARTER_KINDS_starter : 'business'));
+    add('generic', (_aiStockKindGenericTerms = aiStockKindGenericTerms(kind)) != null ? _aiStockKindGenericTerms : aiStockKindGenericTerms((_STARTER_GENERIC_KIND_starter = STARTER_GENERIC_KIND[starter]) != null ? _STARTER_GENERIC_KIND_starter : 'business'));
+    return rungs;
 }
 /**
  * The first word of a text that names a craft {@link CRAFT_KIN} lists, as
@@ -3841,7 +4425,7 @@ const EXTENSIONS = {
  * 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;
+    var _deps_provider, _deps_ingest, _input_kind;
     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;
@@ -3853,6 +4437,9 @@ const EXTENSIONS = {
     // alt texts, in its own language, name no subject a search could use.
     const english = aiStockSourceSubject(input);
     const terms = aiStockSourceTerms(input);
+    // Where a picture's own world finds nothing, the wider worlds it tries (AGL-3923).
+    const wider = aiStockWiderTerms(terms, (_input_kind = input.kind) != null ? _input_kind : '');
+    const unlisted = aiStockWorldIsUnlisted(terms);
     const proper = aiStockProperWords(input.business);
     return async (slots)=>{
         var _deps_budgetMs, _input_avoid;
@@ -3869,8 +4456,10 @@ const EXTENSIONS = {
         /** The photos this page's slots have claimed, first choices, by slot order. */ const shown = [];
         /** Asset srcs this page has placed. */ const placedSrcs = new Set();
         const answers = new Map();
+        /** The wider world a widened search is judged by (AGL-3923); a search not listed is judged by the site's. */ const worldOf = new WeakMap();
         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();
         /** 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);
@@ -3953,7 +4542,17 @@ const EXTENSIONS = {
                     maxBytes: AI_LAYOUT_STOCK_MAX_BYTES,
                     signal
                 });
-                if (!bytes || signal.aborted || !storing) return null;
+                if (!bytes || signal.aborted || !storing) {
+                    // A copy the library would not hand over is otherwise silent (AGL-3923).
+                    if (!bytes && !signal.aborted) {
+                        uncopied.add(slot);
+                        console.warn('ai layout pictures: a stock photo could not be downloaded', {
+                            provider: photo.provider,
+                            id: photo.id
+                        });
+                    }
+                    return null;
+                }
                 const credit = provider.credit(photo);
                 const stored = await ingest.ingest({
                     hostId: input.hostId,
@@ -3988,13 +4587,28 @@ const EXTENSIONS = {
                         height: (_stored_height = stored.height) != null ? _stored_height : photo.height
                     }, described);
                 }
-                storing = false;
                 const refusal = stored;
+                // One photo's own bytes refused (AGL-3923): the beta.267 Brightvale
+                // start's first pick, Pixabay 10157445, came labeled image/png and was
+                // not PNG, and that one 415 stopped every copy on all four of its
+                // pages, which then showed the starters' pottery bench and coffee
+                // shop. Such a refusal is this photo's: the slot tries its next hit.
+                const ofThisPhoto = AI_STOCK_PHOTO_OWN_REFUSALS.has(refusal.status);
+                if (ofThisPhoto) {
+                    uncopied.add(slot);
+                    // Never tried again by this page's other slots, nor by the job's other pages.
+                    claimed.add(sourceKey);
+                    job == null ? void 0 : job.set(sourceKey, REFUSED_BY_THE_LIBRARY);
+                } else storing = false;
                 console.warn('ai layout pictures: the media library refused a stock photo', {
                     status: refusal.status,
-                    reason: refusal.reason
+                    reason: refusal.reason,
+                    provider: photo.provider,
+                    id: photo.id,
+                    holds: ofThisPhoto ? 'this photo' : 'the page'
                 });
             } catch (error) {
+                uncopied.add(slot);
                 console.warn('ai layout pictures: a stock photo could not be kept', {
                     error: String(error)
                 });
@@ -4006,14 +4620,14 @@ const EXTENSIONS = {
      * hit names a child; a portrait of one of the business's people names an
      * adult, never leads with a child, and is preferred in its role (AGL-3856).
      */ const judgementFor = (slot, request, subject)=>{
-            var _request_refuse, _input_sectionNames_slot_sectionIndex, _request_refuseLead;
+            var _request_refuse, _input_sectionNames_slot_sectionIndex, _worldOf_get, _request_refuseLead;
             var _request_needs, _role_scene, _role_refuse;
             const refuse = [
                 ...(_request_refuse = request.refuse) != null ? _request_refuse : [],
                 ...terms.adults ? CHILD_STEMS : []
             ];
             const role = slot.people ? aiStockPeopleRole(slot.alt, (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '') : null;
-            return _extends({}, judgementOf(slot, request, subject), refuse.length ? {
+            return _extends({}, judgementOf(slot, request, subject, (_worldOf_get = worldOf.get(request)) != null ? _worldOf_get : terms), refuse.length ? {
                 refuse: [
                     ...new Set(refuse)
                 ]
@@ -4033,12 +4647,16 @@ const EXTENSIONS = {
                 roleRefuse: aiStockRoleRefusals(role, slot.alt)
             } : {}) : {});
         };
-        /** A search's own judgement, as its words set it. */ const judgementOf = (slot, request, subject)=>{
+        /**
+     * A search's own judgement, as its words set it, held to the world it was
+     * asked for: the site's own, or a wider one where the site's found nothing
+     * (AGL-3923). What lets a sensitive topic in is always the site's own words.
+     */ const judgementOf = (slot, request, subject, world)=>{
             var _request_subject, _request_shun;
             var _request_allow, _request_shun1, _request_leadAny, _request_refuse, _request_needs, _request_refuseLead;
             return _extends({
                 subject: (_request_subject = request.subject) != null ? _request_subject : request.broad ? '' : subject,
-                domain: terms.domain,
+                domain: world.domain,
                 strict: slot.role === 'gallery' && !request.broad || !!request.requires || !!request.strict,
                 named: ((_request_allow = request.allow) == null ? void 0 : _request_allow.length) ? [
                     ...new Set([
@@ -4046,16 +4664,16 @@ const EXTENSIONS = {
                         ...request.allow
                     ])
                 ] : terms.named,
-                rivals: terms.rivals
-            }, terms.shun.length || ((_request_shun1 = request.shun) == null ? void 0 : _request_shun1.length) ? {
+                rivals: world.rivals
+            }, world.shun.length || ((_request_shun1 = request.shun) == null ? void 0 : _request_shun1.length) ? {
                 shun: [
                     ...new Set([
-                        ...terms.shun,
+                        ...world.shun,
                         ...(_request_shun = request.shun) != null ? _request_shun : []
                     ])
                 ]
-            } : {}, terms.shunLead.length ? {
-                shunLead: terms.shunLead
+            } : {}, world.shunLead.length ? {
+                shunLead: world.shunLead
             } : {}, request.product ? {
                 product: true
             } : {}, ((_request_leadAny = request.leadAny) == null ? void 0 : _request_leadAny.length) ? {
@@ -4089,9 +4707,9 @@ const EXTENSIONS = {
      * The craft's own photos, the last thing a slot of a craft's site is
      * filled from (AGL-3660): its broad searches, any hit naming the craft
      * itself. Never a desk, a laptop or a living room for a soap shop.
-     */ const craftSearches = (slot)=>{
+     */ const craftSearches = (slot, world = terms)=>{
             // A portfolio's record of the work is never filled by the craft's own photos (AGL-3856).
-            if (!terms.core.length || aiStockShowsTheWork(slot, terms)) return [];
+            if (!world.core.length || aiStockShowsTheWork(slot, world)) return [];
             const orientation = aiStockOrientation(slot.aspect);
             const size = slot.role === 'hero' ? {
                 minWidth: 1600
@@ -4100,12 +4718,12 @@ const EXTENSIONS = {
             } : {
                 minWidth: 900
             };
-            return terms.broad.map((query)=>_extends({
+            return world.broad.map((query)=>_extends({
                     query: clip(query),
                     orientation
                 }, size, {
                     broad: true,
-                    category: terms.core
+                    category: world.core
                 }, slot.role === 'hero' ? {
                     first: true
                 } : {}, slot.product ? {
@@ -4113,6 +4731,78 @@ const EXTENSIONS = {
                     tier: 'weak'
                 } : {}));
         };
+        /**
+     * A slot's searches once its own world found it nothing (AGL-3923), in
+     * order: the kind of site's world, the starter's, the slot's own words
+     * alone held to no world, and last the starter's common photos. Each is
+     * judged by the world it was asked for. A product, a portrait of the
+     * business's people and a record's cover keep their own fallbacks.
+     */ const widerSearches = (slot, subject, sectionName)=>{
+            var _wider_find;
+            if (!wider.length || slot.product || slot.people || slot.record) return [];
+            const part = aiStockSlotPart(slot, sectionName);
+            const asked = [];
+            const ask = (world, requests)=>{
+                for (const request of requests){
+                    worldOf.set(request, world);
+                    asked.push(request);
+                }
+            };
+            for (const { rung, terms: world } of wider){
+                if (rung === 'generic') continue;
+                ask(world, [
+                    ...aiStockSearchesFor(slot, world, subject, part, sectionName),
+                    ...craftSearches(slot, world)
+                ]);
+            }
+            const orientation = aiStockOrientation(slot.aspect);
+            const size = slot.role === 'hero' ? {
+                minWidth: 1600
+            } : orientation === 'vertical' ? {
+                minHeight: 900
+            } : {
+                minWidth: 900
+            };
+            // The slot's own words, only where the site's world is its own words
+            // alone, held to the kind's common world (AGL-3923), never to no world:
+            // the beta.267 Brightvale closing band's "ready talk marketing" was
+            // answered with a tin-can telephone, and its pets-and-owners answers
+            // name no office either.
+            const common = (_wider_find = wider.find((rung)=>rung.rung === 'generic')) == null ? void 0 : _wider_find.terms;
+            if (subject && unlisted && common) {
+                const object = aiStockObjectWord(subject);
+                const own = [
+                    ...new Set([
+                        subject,
+                        object
+                    ].map(clip).filter(Boolean))
+                ];
+                ask(common, own.map((query)=>_extends({
+                        query,
+                        orientation
+                    }, size, {
+                        subject,
+                        strict: true
+                    })));
+            }
+            // The kind's common photos: OF its world among their first tags, never
+            // led by a face, never of a child (AGL-3923).
+            for (const { rung, terms: world } of wider)if (rung === 'generic') ask(world, world.broad.map((query)=>_extends({
+                    query: clip(query),
+                    orientation
+                }, size, {
+                    broad: true,
+                    category: world.core
+                }, slot.role === 'hero' ? {
+                    first: true
+                } : {
+                    leadWorld: true
+                }, {
+                    refuse: CHILD_STEMS,
+                    refuseLead: FACE_STEMS
+                })));
+            return asked;
+        };
         // 1. Choose, slot by slot, so the page's choices never collide: each
         //    slot claims its best accepted hit before the next slot looks.
         const choices = [];
@@ -4143,6 +4833,11 @@ const EXTENSIONS = {
                         if (elsewhere(key)) blocked.add(key);
                     }
                 }
+                // A photo the library refused for its own bytes is never a repeat either (AGL-3923).
+                for (const hit of found){
+                    const key = stockPhotoSourceKey(hit);
+                    if ((job == null ? void 0 : job.get(key)) === REFUSED_BY_THE_LIBRARY) blocked.add(key);
+                }
                 const judgement = judgementFor(slot, request, subject);
                 const ranked = aiStockRank(found, blocked, `${input.seed}:${index}:${request.query}`, judgement);
                 // A team's portraits are of different people where the hits allow (AGL-3856).
@@ -4177,6 +4872,9 @@ const EXTENSIONS = {
             const repeats = Boolean(slot.product) || slot.role === 'hero';
             const sure = slot.product ? requests.filter((request)=>request.tier !== 'weak') : requests;
             const unsure = slot.product ? requests.filter((request)=>request.tier === 'weak') : [];
+            // 3. Nothing of its own world at all: the wider worlds (AGL-3923), new
+            //    and then, for a hero, one the job already shows.
+            const widened = widerSearches(slot, subject, sectionName);
             const phases = [
                 [
                     sure,
@@ -4197,6 +4895,18 @@ const EXTENSIONS = {
                         unsure,
                         true
                     ]
+                ] : [],
+                ...widened.length ? [
+                    [
+                        widened,
+                        false
+                    ]
+                ] : [],
+                ...widened.length && repeats ? [
+                    [
+                        widened,
+                        true
+                    ]
                 ] : []
             ];
             for (const [tried, repeat] of phases){
@@ -4265,7 +4975,10 @@ const EXTENSIONS = {
         // 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.
-        return answered && storing ? photos.map((photo)=>photo != null ? photo : AI_LAYOUT_NO_PHOTO) : photos;
+        // A slot whose fitting photo could not be copied was failed by the
+        // library, as one that never answered is, and takes a starter rather
+        // than lose its picture (AGL-3923).
+        return answered && storing ? photos.map((photo, index)=>photo != null ? photo : uncopied.has(slots[index]) ? null : AI_LAYOUT_NO_PHOTO) : photos;
     };
 }