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

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

@@ -0,0 +1,98 @@
+/**
+ * @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 PluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest';
+import { type StockPhoto, type StockPhotoOrientation, type StockPhotoProvider, type StockPhotoSearchRequest } from '@aglyn/aglyn/plugin-manager/stock-photo-provider';
+import { type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-language/ai-layout-pictures';
+/**
+ * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
+ *
+ * The source `aiResolveLayoutPictures` asks before it falls back to the
+ * starter photos. It names no library: it asks core for the deployment's
+ * stock photo provider (`core.stock-photos`) and for the media library's
+ * server door (`core.media-ingest`), and builds no source at all when either
+ * is missing, so a deployment without a key behaves exactly as before.
+ *
+ * For each slot, in document order:
+ *
+ * 1. **Search.** Plain words: the kind of business (the head of the site's
+ *    business type, "yoga studio" from "a family-owned yoga studio in
+ *    Austin") for the hero; the picture's own subject (the content words of
+ *    the alt text the model wrote, else its section's name) with the business
+ *    for the rest, and an about picture asks for people. The orientation and
+ *    a minimum size come from the slot's frame. The provider caches every
+ *    search for a day and keeps its own rate limit.
+ * 2. **Pick.** Among the first hits not already on the page, by the job's
+ *    seed and the slot, so two sites built from the same words rarely open
+ *    with the same photo while one job always picks the same.
+ * 3. **Keep.** A photo the site's library already holds (by its source key)
+ *    is reused; otherwise its bytes are downloaded from the library and
+ *    stored in the site's own media library as the member who started the
+ *    job, credited to its photographer. The page names the site's asset,
+ *    never the library's address.
+ *
+ * A slot that finds nothing, any error, a refusal from the library (its
+ * storage band, say) or the time running out leaves the slot to a starter
+ * photo. Nothing here throws, and none of it is an AI model call: photos cost
+ * no AI credits.
+ */
+/** Wall clock the whole page's photos may take, inside the step's own signal. */
+export declare const AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS = 20000;
+/** Searches one page may ask, cached ones included. */
+export declare const AI_LAYOUT_STOCK_SEARCHES_PER_PAGE = 8;
+/** The hits a pick is made among. */
+export declare const AI_LAYOUT_STOCK_PICK_WINDOW = 8;
+/** The largest photo copied: inside one direct upload. */
+export declare const AI_LAYOUT_STOCK_MAX_BYTES: number;
+/**
+ * The kind of business in a few words: the first clause of the business
+ * type, before a place or an audience, its last three content words (the
+ * head of an English noun phrase is at its end).
+ */
+export declare function aiStockBusinessWords(businessType: string): string;
+/** A picture's subject in a few words: its alt text's first content words, else its section's name. */
+export declare function aiStockSubjectWords(alt: string, sectionName: string): string;
+/** The frame's orientation: a wide frame wants a landscape photo, a tall one a portrait. */
+export declare function aiStockOrientation(aspect: number): StockPhotoOrientation;
+/** The searches a slot tries, in order, most specific first, each distinct. */
+export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>, words: {
+    business: string;
+    subject: string;
+}): StockPhotoSearchRequest[];
+/** The pick among a search's hits: not on the page yet, among the first few, by the seed. */
+export declare function aiStockPick(photos: readonly StockPhoto[], used: ReadonlySet<string>, seed: string): StockPhoto | null;
+export interface AiLayoutStockPhotoSourceInput {
+    hostId: string;
+    /** The member the photos are stored as: the job's creator. */
+    uid: string;
+    /** The job's seed, as the starter photos turn by. */
+    seed: string;
+    /** The site's business type, else the job's brief. */
+    business: string;
+    /** The page's section names, by plan index. */
+    sectionNames: readonly string[];
+    signal?: AbortSignal;
+}
+export interface AiLayoutStockPhotoDeps {
+    provider?: () => StockPhotoProvider | null;
+    ingest?: () => PluginMediaIngest | null;
+    budgetMs?: number;
+}
+/**
+ * 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 declare function aiLayoutStockPhotoSource(input: AiLayoutStockPhotoSourceInput, deps?: AiLayoutStockPhotoDeps): AiLayoutPictureSource | null;

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

@@ -0,0 +1,248 @@
+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 { pluginMediaIngest } from "@aglyn/aglyn/plugin-manager/plugin-media-ingest";
+import { STOCK_PHOTO_QUERY_MAX_CHARS, stockPhotoProvider, stockPhotoSourceKey } from "@aglyn/aglyn/plugin-manager/stock-photo-provider";
+import { aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
+/**
+ * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
+ *
+ * The source `aiResolveLayoutPictures` asks before it falls back to the
+ * starter photos. It names no library: it asks core for the deployment's
+ * stock photo provider (`core.stock-photos`) and for the media library's
+ * server door (`core.media-ingest`), and builds no source at all when either
+ * is missing, so a deployment without a key behaves exactly as before.
+ *
+ * For each slot, in document order:
+ *
+ * 1. **Search.** Plain words: the kind of business (the head of the site's
+ *    business type, "yoga studio" from "a family-owned yoga studio in
+ *    Austin") for the hero; the picture's own subject (the content words of
+ *    the alt text the model wrote, else its section's name) with the business
+ *    for the rest, and an about picture asks for people. The orientation and
+ *    a minimum size come from the slot's frame. The provider caches every
+ *    search for a day and keeps its own rate limit.
+ * 2. **Pick.** Among the first hits not already on the page, by the job's
+ *    seed and the slot, so two sites built from the same words rarely open
+ *    with the same photo while one job always picks the same.
+ * 3. **Keep.** A photo the site's library already holds (by its source key)
+ *    is reused; otherwise its bytes are downloaded from the library and
+ *    stored in the site's own media library as the member who started the
+ *    job, credited to its photographer. The page names the site's asset,
+ *    never the library's address.
+ *
+ * A slot that finds nothing, any error, a refusal from the library (its
+ * storage band, say) or the time running out leaves the slot to a starter
+ * photo. Nothing here throws, and none of it is an AI model call: photos cost
+ * no AI credits.
+ */ /** Wall clock the whole page's photos may take, inside the step's own signal. */ export const AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS = 20000;
+/** Searches one page may ask, cached ones included. */ export const AI_LAYOUT_STOCK_SEARCHES_PER_PAGE = 8;
+/** The hits a pick is made among. */ export const AI_LAYOUT_STOCK_PICK_WINDOW = 8;
+/** The largest photo copied: inside one direct upload. */ export const AI_LAYOUT_STOCK_MAX_BYTES = 3 * 1024 * 1024;
+/** Words that carry no subject. */ const STOPWORDS = new Set(('a an the and or of in on at to for with from by into onto over under near our your their my his her its ' + 'this that these those is are be being was were who whom which where while as about than then very just ' + 'small local best new top quality premium family-owned family owned independent professional ' + 'business company shop services service site website page photo picture image showing shows show ' + 'someone people person one two three some many several').split(' '));
+/** Lowercase words, letters only, without stopwords. */ function contentWords(text) {
+    return text.toLowerCase().replace(/https?:\/\/\S+|\S+@\S+|\+?\d[\d\s().-]{5,}\d/g, ' ').replace(/[^a-zÀ-ɏ\s-]/g, ' ').split(/\s+/).map((word)=>word.replace(/^-+|-+$/g, '')).filter((word)=>word.length > 1 && !STOPWORDS.has(word));
+}
+/**
+ * The kind of business in a few words: the first clause of the business
+ * type, before a place or an audience, its last three content words (the
+ * head of an English noun phrase is at its end).
+ */ export function aiStockBusinessWords(businessType) {
+    const clause = businessType.toLowerCase().split(/[,;:.()]|\s[-–—]\s|\b(?:in|for|near|serving|based|located|that|which|who|with|from|since|and|&)\b/)[0];
+    const words = contentWords(clause != null ? clause : '');
+    return words.slice(-3).join(' ');
+}
+/** A picture's subject in a few words: its alt text's first content words, else its section's name. */ export function aiStockSubjectWords(alt, sectionName) {
+    const words = contentWords(alt);
+    if (words.length) return words.slice(0, 3).join(' ');
+    return contentWords(sectionName).slice(0, 2).join(' ');
+}
+const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUERY_MAX_CHARS).trim();
+/** The frame's orientation: a wide frame wants a landscape photo, a tall one a portrait. */ export function aiStockOrientation(aspect) {
+    if (aspect > 1.15) return 'horizontal';
+    if (aspect < 0.87) return 'vertical';
+    return 'any';
+}
+/** The searches a slot tries, in order, most specific first, each distinct. */ export function aiStockSearchesFor(slot, words) {
+    const orientation = aiStockOrientation(slot.aspect);
+    const size = slot.role === 'hero' ? {
+        minWidth: 1600
+    } : orientation === 'vertical' ? {
+        minHeight: 900
+    } : {
+        minWidth: 900
+    };
+    const queries = slot.role === 'hero' ? [
+        words.business,
+        `${words.business} ${words.subject}`
+    ] : slot.role === 'about' ? [
+        `${words.business} ${words.subject}`,
+        words.business
+    ] : [
+        `${words.business} ${words.subject}`,
+        words.subject,
+        words.business
+    ];
+    const seen = new Set();
+    const searches = [];
+    for (const raw of queries){
+        const query = clip(raw);
+        if (!query || seen.has(query)) continue;
+        seen.add(query);
+        searches.push(_extends({
+            query,
+            orientation
+        }, size, slot.role === 'about' ? {
+            people: true
+        } : {}));
+    }
+    return searches;
+}
+/** The pick among a search's hits: not on the page yet, among the first few, by the seed. */ export function aiStockPick(photos, used, seed) {
+    var _fresh_;
+    const fresh = photos.filter((photo)=>!used.has(stockPhotoSourceKey(photo))).slice(0, AI_LAYOUT_STOCK_PICK_WINDOW);
+    if (!fresh.length) return null;
+    return (_fresh_ = fresh[aiLayoutSeedNumber(seed) % fresh.length]) != null ? _fresh_ : null;
+}
+const EXTENSIONS = {
+    'image/jpeg': 'jpg',
+    'image/png': 'png',
+    'image/webp': 'webp'
+};
+/**
+ * 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;
+    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;
+    const business = aiStockBusinessWords(input.business);
+    return async (slots)=>{
+        var _deps_budgetMs;
+        const timeout = AbortSignal.timeout((_deps_budgetMs = deps.budgetMs) != null ? _deps_budgetMs : AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS);
+        const signal = input.signal ? AbortSignal.any([
+            input.signal,
+            timeout
+        ]) : timeout;
+        const used = new Set();
+        let searches = 0;
+        let storing = true;
+        const photos = [];
+        for (const [index, slot] of slots.entries()){
+            var _input_sectionNames_slot_sectionIndex;
+            if (signal.aborted) {
+                photos.push(null);
+                continue;
+            }
+            const subject = aiStockSubjectWords(slot.alt, (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '');
+            let placed = null;
+            for (const request of aiStockSearchesFor(slot, {
+                business,
+                subject
+            })){
+                if (placed || signal.aborted || searches >= AI_LAYOUT_STOCK_SEARCHES_PER_PAGE) break;
+                searches += 1;
+                let found;
+                try {
+                    var _ref;
+                    var _this;
+                    found = (_ref = (_this = await provider.search(request, {
+                        signal
+                    })) == null ? void 0 : _this.photos) != null ? _ref : [];
+                } catch (unused) {
+                    found = [];
+                }
+                const photo = aiStockPick(found, used, `${input.seed}:${index}:${request.query}`);
+                if (!photo) continue;
+                const sourceKey = stockPhotoSourceKey(photo);
+                used.add(sourceKey);
+                try {
+                    var _EXTENSIONS_bytes_contentType;
+                    const kept = await ingest.findStockPhoto({
+                        hostId: input.hostId,
+                        sourceKey
+                    });
+                    if (kept) {
+                        var _kept_width, _kept_height;
+                        placed = {
+                            src: kept.src,
+                            width: (_kept_width = kept.width) != null ? _kept_width : photo.width,
+                            height: (_kept_height = kept.height) != null ? _kept_height : photo.height
+                        };
+                        break;
+                    }
+                    // A refusal to store (the storage band, a lockdown) holds for the
+                    // whole page, so the rest of it reuses what it can and copies nothing.
+                    if (!storing) continue;
+                    const bytes = await provider.download(photo, {
+                        maxBytes: AI_LAYOUT_STOCK_MAX_BYTES,
+                        signal
+                    });
+                    if (!bytes || signal.aborted) continue;
+                    const credit = provider.credit(photo);
+                    const stored = await ingest.ingest({
+                        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: 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: request.query
+                        })
+                    });
+                    if (stored.ok) {
+                        var _stored_width, _stored_height;
+                        placed = {
+                            src: stored.src,
+                            width: (_stored_width = stored.width) != null ? _stored_width : photo.width,
+                            height: (_stored_height = stored.height) != null ? _stored_height : photo.height
+                        };
+                    } else {
+                        storing = false;
+                        const refusal = stored;
+                        console.warn('ai layout pictures: the media library refused a stock photo', {
+                            status: refusal.status,
+                            reason: refusal.reason
+                        });
+                    }
+                } catch (error) {
+                    console.warn('ai layout pictures: a stock photo could not be kept', {
+                        error: String(error)
+                    });
+                }
+            }
+            photos.push(placed);
+        }
+        return photos;
+    };
+}
+
+//# sourceMappingURL=ai-layout-stock-photos.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-stock-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 {\n  pluginMediaIngest,\n  type PluginMediaIngest,\n  type PluginMediaIngestResult,\n} from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport {\n  STOCK_PHOTO_QUERY_MAX_CHARS,\n  stockPhotoProvider,\n  stockPhotoSourceKey,\n  type StockPhoto,\n  type StockPhotoOrientation,\n  type StockPhotoProvider,\n  type StockPhotoSearchRequest,\n} from '@aglyn/aglyn/plugin-manager/stock-photo-provider'\nimport {\n  aiLayoutSeedNumber,\n  type AiLayoutPicturePhoto,\n  type AiLayoutPictureSlot,\n  type AiLayoutPictureSource,\n} from '../layout-language/ai-layout-pictures'\n\n/**\n * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).\n *\n * The source `aiResolveLayoutPictures` asks before it falls back to the\n * starter photos. It names no library: it asks core for the deployment's\n * stock photo provider (`core.stock-photos`) and for the media library's\n * server door (`core.media-ingest`), and builds no source at all when either\n * is missing, so a deployment without a key behaves exactly as before.\n *\n * For each slot, in document order:\n *\n * 1. **Search.** Plain words: the kind of business (the head of the site's\n *    business type, \"yoga studio\" from \"a family-owned yoga studio in\n *    Austin\") for the hero; the picture's own subject (the content words of\n *    the alt text the model wrote, else its section's name) with the business\n *    for the rest, and an about picture asks for people. The orientation and\n *    a minimum size come from the slot's frame. The provider caches every\n *    search for a day and keeps its own rate limit.\n * 2. **Pick.** Among the first hits not already on the page, by the job's\n *    seed and the slot, so two sites built from the same words rarely open\n *    with the same photo while one job always picks the same.\n * 3. **Keep.** A photo the site's library already holds (by its source key)\n *    is reused; otherwise its bytes are downloaded from the library and\n *    stored in the site's own media library as the member who started the\n *    job, credited to its photographer. The page names the site's asset,\n *    never the library's address.\n *\n * A slot that finds nothing, any error, a refusal from the library (its\n * storage band, say) or the time running out leaves the slot to a starter\n * photo. Nothing here throws, and none of it is an AI model call: photos cost\n * no AI credits.\n */\n\n/** Wall clock the whole page's photos may take, inside the step's own signal. */\nexport const AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS = 20_000\n\n/** Searches one page may ask, cached ones included. */\nexport const AI_LAYOUT_STOCK_SEARCHES_PER_PAGE = 8\n\n/** The hits a pick is made among. */\nexport const AI_LAYOUT_STOCK_PICK_WINDOW = 8\n\n/** The largest photo copied: inside one direct upload. */\nexport const AI_LAYOUT_STOCK_MAX_BYTES = 3 * 1024 * 1024\n\n/** Words that carry no subject. */\nconst STOPWORDS = new Set(\n  (\n    'a an the and or of in on at to for with from by into onto over under near our your their my his her its ' +\n    'this that these those is are be being was were who whom which where while as about than then very just ' +\n    'small local best new top quality premium family-owned family owned independent professional ' +\n    'business company shop services service site website page photo picture image showing shows show ' +\n    'someone people person one two three some many several'\n  ).split(' '),\n)\n\n/** Lowercase words, letters only, without stopwords. */\nfunction contentWords(text: string): string[] {\n  return text\n    .toLowerCase()\n    .replace(/https?:\\/\\/\\S+|\\S+@\\S+|\\+?\\d[\\d\\s().-]{5,}\\d/g, ' ')\n    .replace(/[^a-zÀ-ɏ\\s-]/g, ' ')\n    .split(/\\s+/)\n    .map((word) => word.replace(/^-+|-+$/g, ''))\n    .filter((word) => word.length > 1 && !STOPWORDS.has(word))\n}\n\n/**\n * The kind of business in a few words: the first clause of the business\n * type, before a place or an audience, its last three content words (the\n * head of an English noun phrase is at its end).\n */\nexport function aiStockBusinessWords(businessType: string): string {\n  const clause = businessType\n    .toLowerCase()\n    .split(/[,;:.()]|\\s[-–—]\\s|\\b(?:in|for|near|serving|based|located|that|which|who|with|from|since|and|&)\\b/)[0]\n  const words = contentWords(clause ?? '')\n  return words.slice(-3).join(' ')\n}\n\n/** A picture's subject in a few words: its alt text's first content words, else its section's name. */\nexport function aiStockSubjectWords(alt: string, sectionName: string): string {\n  const words = contentWords(alt)\n  if (words.length) return words.slice(0, 3).join(' ')\n  return contentWords(sectionName).slice(0, 2).join(' ')\n}\n\nconst clip = (query: string) => query.replace(/\\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUERY_MAX_CHARS).trim()\n\n/** The frame's orientation: a wide frame wants a landscape photo, a tall one a portrait. */\nexport function aiStockOrientation(aspect: number): StockPhotoOrientation {\n  if (aspect > 1.15) return 'horizontal'\n  if (aspect < 0.87) return 'vertical'\n  return 'any'\n}\n\n/** The searches a slot tries, in order, most specific first, each distinct. */\nexport function aiStockSearchesFor(\n  slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>,\n  words: { business: string; subject: string },\n): StockPhotoSearchRequest[] {\n  const orientation = aiStockOrientation(slot.aspect)\n  const size =\n    slot.role === 'hero'\n      ? { minWidth: 1600 }\n      : orientation === 'vertical'\n        ? { minHeight: 900 }\n        : { minWidth: 900 }\n  const queries =\n    slot.role === 'hero'\n      ? [words.business, `${words.business} ${words.subject}`]\n      : slot.role === 'about'\n        ? [`${words.business} ${words.subject}`, words.business]\n        : [`${words.business} ${words.subject}`, words.subject, words.business]\n  const seen = new Set<string>()\n  const searches: StockPhotoSearchRequest[] = []\n  for (const raw of queries) {\n    const query = clip(raw)\n    if (!query || seen.has(query)) continue\n    seen.add(query)\n    searches.push({\n      query,\n      orientation,\n      ...size,\n      ...(slot.role === 'about' ? { people: true } : {}),\n    })\n  }\n  return searches\n}\n\n/** The pick among a search's hits: not on the page yet, among the first few, by the seed. */\nexport function aiStockPick(\n  photos: readonly StockPhoto[],\n  used: ReadonlySet<string>,\n  seed: string,\n): StockPhoto | null {\n  const fresh = photos.filter((photo) => !used.has(stockPhotoSourceKey(photo))).slice(0, AI_LAYOUT_STOCK_PICK_WINDOW)\n  if (!fresh.length) return null\n  return fresh[aiLayoutSeedNumber(seed) % fresh.length] ?? null\n}\n\nconst EXTENSIONS: Record<string, string> = { 'image/jpeg': 'jpg', 'image/png': 'png', 'image/webp': 'webp' }\n\nexport interface AiLayoutStockPhotoSourceInput {\n  hostId: string\n  /** The member the photos are stored as: the job's creator. */\n  uid: string\n  /** The job's seed, as the starter photos turn by. */\n  seed: string\n  /** The site's business type, else the job's brief. */\n  business: string\n  /** The page's section names, by plan index. */\n  sectionNames: readonly string[]\n  signal?: AbortSignal\n}\n\nexport interface AiLayoutStockPhotoDeps {\n  provider?: () => StockPhotoProvider | null\n  ingest?: () => PluginMediaIngest | null\n  budgetMs?: number\n}\n\n/**\n * The source for one page, or `null` when this deployment has no stock\n * photo library or no media door, which leaves every slot to the starters.\n */\nexport function aiLayoutStockPhotoSource(\n  input: AiLayoutStockPhotoSourceInput,\n  deps: AiLayoutStockPhotoDeps = {},\n): AiLayoutPictureSource | null {\n  const provider = (deps.provider ?? stockPhotoProvider)()\n  const ingest = (deps.ingest ?? pluginMediaIngest)()\n  if (!provider || !ingest || !input.hostId || !input.uid) return null\n  const business = aiStockBusinessWords(input.business)\n  return async (slots) => {\n    const timeout = AbortSignal.timeout(deps.budgetMs ?? AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS)\n    const signal = input.signal ? AbortSignal.any([input.signal, timeout]) : timeout\n    const used = new Set<string>()\n    let searches = 0\n    let storing = true\n    const photos: Array<AiLayoutPicturePhoto | null> = []\n    for (const [index, slot] of slots.entries()) {\n      if (signal.aborted) {\n        photos.push(null)\n        continue\n      }\n      const subject = aiStockSubjectWords(slot.alt, input.sectionNames[slot.sectionIndex] ?? '')\n      let placed: AiLayoutPicturePhoto | null = null\n      for (const request of aiStockSearchesFor(slot, { business, subject })) {\n        if (placed || signal.aborted || searches >= AI_LAYOUT_STOCK_SEARCHES_PER_PAGE) break\n        searches += 1\n        let found: StockPhoto[]\n        try {\n          found = (await provider.search(request, { signal }))?.photos ?? []\n        } catch {\n          found = []\n        }\n        const photo = aiStockPick(found, used, `${input.seed}:${index}:${request.query}`)\n        if (!photo) continue\n        const sourceKey = stockPhotoSourceKey(photo)\n        used.add(sourceKey)\n        try {\n          const kept = await ingest.findStockPhoto({ hostId: input.hostId, sourceKey })\n          if (kept) {\n            placed = { src: kept.src, width: kept.width ?? photo.width, height: kept.height ?? photo.height }\n            break\n          }\n          // A refusal to store (the storage band, a lockdown) holds for the\n          // whole page, so the rest of it reuses what it can and copies nothing.\n          if (!storing) continue\n          const bytes = await provider.download(photo, { maxBytes: AI_LAYOUT_STOCK_MAX_BYTES, signal })\n          if (!bytes || signal.aborted) continue\n          const credit = provider.credit(photo)\n          const stored = await ingest.ingest({\n            hostId: input.hostId,\n            uid: input.uid,\n            fileName: `${photo.provider}-${photo.id}.${EXTENSIONS[bytes.contentType] ?? 'jpg'}`,\n            contentType: bytes.contentType,\n            bytes: bytes.bytes,\n            alt: slot.alt,\n            description: credit.text,\n            stockPhoto: {\n              key: sourceKey,\n              provider: photo.provider,\n              providerLabel: credit.providerLabel,\n              id: photo.id,\n              pageUrl: photo.pageUrl,\n              photographer: photo.photographer,\n              ...(photo.photographerUrl ? { photographerUrl: photo.photographerUrl } : {}),\n              license: credit.license,\n              licenseUrl: credit.licenseUrl,\n              attributionRequired: credit.attributionRequired,\n              query: request.query,\n            },\n          })\n          if (stored.ok) {\n            placed = { src: stored.src, width: stored.width ?? photo.width, height: stored.height ?? photo.height }\n          } else {\n            storing = false\n            const refusal = stored as Extract<PluginMediaIngestResult, { ok: false }>\n            console.warn('ai layout pictures: the media library refused a stock photo', {\n              status: refusal.status,\n              reason: refusal.reason,\n            })\n          }\n        } catch (error) {\n          console.warn('ai layout pictures: a stock photo could not be kept', { error: String(error) })\n        }\n      }\n      photos.push(placed)\n    }\n    return photos\n  }\n}\n"],"names":["pluginMediaIngest","STOCK_PHOTO_QUERY_MAX_CHARS","stockPhotoProvider","stockPhotoSourceKey","aiLayoutSeedNumber","AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS","AI_LAYOUT_STOCK_SEARCHES_PER_PAGE","AI_LAYOUT_STOCK_PICK_WINDOW","AI_LAYOUT_STOCK_MAX_BYTES","STOPWORDS","Set","split","contentWords","text","toLowerCase","replace","map","word","filter","length","has","aiStockBusinessWords","businessType","clause","words","slice","join","aiStockSubjectWords","alt","sectionName","clip","query","trim","aiStockOrientation","aspect","aiStockSearchesFor","slot","orientation","size","role","minWidth","minHeight","queries","business","subject","seen","searches","raw","add","push","people","aiStockPick","photos","used","seed","fresh","photo","EXTENSIONS","aiLayoutStockPhotoSource","input","deps","provider","ingest","hostId","uid","slots","timeout","AbortSignal","budgetMs","signal","any","storing","index","entries","aborted","sectionNames","sectionIndex","placed","request","found","search","sourceKey","kept","findStockPhoto","src","width","height","bytes","download","maxBytes","credit","stored","fileName","id","contentType","description","stockPhoto","key","providerLabel","pageUrl","photographer","photographerUrl","license","licenseUrl","attributionRequired","ok","refusal","console","warn","status","reason","error","String"],"mappings":"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"}

package/src/lib/jobs/ai-site-publish.d.ts

@@ -80,6 +80,13 @@ interface NavEntry {
     screenId: string;
     label: string;
 }
+/**
+ * The blog paths a start's layout links and must not publish (AGL-3660): its
+ * header, phone menu and footer link the blog by path while the posts part is
+ * still owed, so a start whose posts part then failed or was skipped drops
+ * every address the blog could have taken. None while the blog was written.
+ */
+export declare function aiSiteUnwrittenBlogHrefs(blogUnwritten: boolean | undefined): string[];
 /**
  * The layout's nodes with its links to the retired starter home pointed at
  * the new home, and a link for each proposed entry the header does not
@@ -91,6 +98,8 @@ export declare function aiLayoutWithNavigation(nodes: NodesMap, input: {
     entries: readonly NavEntry[];
     retiredHomeId?: string | null;
     homeId?: string | null;
+    /** Paths whose links come out: a blog the start linked and never wrote (AGL-3660). */
+    droppedHrefs?: readonly string[];
 }): NodesMap | null;
 /**
  * Publishes the pages a guided site start built. Never throws for a page; a
@@ -101,5 +110,7 @@ export declare function aiPublishGuidedSite(firestore: Firestore, input: {
     job: Pick<AiJob, '$id' | 'orgId' | 'hostId'>;
     outputs: readonly AiJobOutput[];
     now: Date;
+    /** The start owed its blog's posts and wrote none (AGL-3660): its links to the blog come out. */
+    blogUnwritten?: boolean;
 }, deps?: AiSitePublishDeps): Promise<AiJobSitePublish>;
 export {};

package/src/lib/jobs/ai-site-publish.js

@@ -22,6 +22,7 @@ import { decodeStoredNodes, encodeStoredNodes } from "@aglyn/aglyn/app-utils/sto
 import { dropPluginSiteCache } from "@aglyn/aglyn/plugin-manager/plugin-site-cache";
 import { sendGa4SitePublished } from "@aglyn/tenant-data-admin/server/ga4-measurement-protocol";
 import { FieldValue } from "firebase-admin/firestore";
+import { AI_SITE_BLOG_SLUGS } from "../model/ai-site-job.js";
 /**
  * Whether a build puts its pages live (AGL-3616): only where its request
  * asked to (`publish`, set by Assist's proposal) AND the member ticked the
@@ -67,6 +68,14 @@ function navEntriesOf(outputs) {
     }
     return entries;
 }
+/**
+ * The blog paths a start's layout links and must not publish (AGL-3660): its
+ * header, phone menu and footer link the blog by path while the posts part is
+ * still owed, so a start whose posts part then failed or was skipped drops
+ * every address the blog could have taken. None while the blog was written.
+ */ export function aiSiteUnwrittenBlogHrefs(blogUnwritten) {
+    return blogUnwritten ? AI_SITE_BLOG_SLUGS.map((slug)=>`/${slug}`) : [];
+}
 /**
  * The layout's nodes with its links to the retired starter home pointed at
  * the new home, and a link for each proposed entry the header does not
@@ -74,6 +83,7 @@ function navEntriesOf(outputs) {
  * `null` when nothing changes, or when the layout has no toolbar to hold an
  * entry and no link to repoint.
  */ export function aiLayoutWithNavigation(nodes, input) {
+    var _input_droppedHrefs;
     const map = {};
     for (const [id, node] of Object.entries(nodes)){
         map[id] = _extends({}, node, node.props ? {
@@ -85,6 +95,25 @@ function navEntriesOf(outputs) {
         } : {});
     }
     let changed = false;
+    // The header, the phone menu and the footer link a blog by its path before
+    // its posts are written (AGL-3660); a start whose posts were not written
+    // publishes none of those links to a page that does not exist.
+    const dropped = new Set((_input_droppedHrefs = input.droppedHrefs) != null ? _input_droppedHrefs : []);
+    if (dropped.size) {
+        const gone = new Set(Object.entries(map).filter(([, node])=>{
+            var _ref;
+            var _node_props;
+            return node.componentId === 'muiScreenLink' && dropped.has(String((_ref = (_node_props = node.props) == null ? void 0 : _node_props['href']) != null ? _ref : ''));
+        }).map(([id])=>id));
+        if (gone.size) {
+            for (const id of gone)delete map[id];
+            for (const node of Object.values(map)){
+                var _node_nodes;
+                if ((_node_nodes = node.nodes) == null ? void 0 : _node_nodes.some((child)=>gone.has(child))) node.nodes = node.nodes.filter((child)=>!gone.has(child));
+            }
+            changed = true;
+        }
+    }
     const links = Object.values(map).filter((node)=>node.componentId === 'muiScreenLink');
     if (input.retiredHomeId && input.homeId) {
         for (const link of links){
@@ -223,6 +252,7 @@ function navEntriesOf(outputs) {
         hostId,
         pageIds: accepted.map((page)=>page.id),
         entries: navEntriesOf(pages).filter((entry)=>entries[entry.screenId]),
+        droppedHrefs: aiSiteUnwrittenBlogHrefs(input.blogUnwritten),
         retiredHomeId: releases,
         homeId: (_ref = home == null ? void 0 : home.id) != null ? _ref : null,
         jobId: job.$id,
@@ -337,7 +367,7 @@ function navEntriesOf(outputs) {
  * their navigation entries and the home link moved off a retired starter;
  * `null` when there is nothing to change or no one layout to change.
  */ async function aiNavigationLayoutWrite(firestore, input) {
-    if (!input.entries.length && !input.retiredHomeId) return null;
+    if (!input.entries.length && !input.retiredHomeId && !input.droppedHrefs.length) return null;
     const hostRef = firestore.collection('hosts').doc(input.hostId);
     const layoutIds = new Set();
     for (const id of input.pageIds){