@aglyn/plugins-ai 1.0.0-beta.240 → 1.0.0-beta.242

package/src/lib/jobs/ai-job-site-store-pages.js

@@ -0,0 +1,195 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { hostRoleCanWrite } from "@aglyn/aglyn/app-utils/organizations";
+import { ACCOUNTS_PLUGIN_ID } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { HostScreenVisibility } from "@aglyn/aglyn/foundation/definitions/platform.types";
+import { FieldValue } from "firebase-admin/firestore";
+import { aiStorePageNodes, aiStorePagesToWrite, AI_STORE_PAGES } from "../model/ai-site-store-pages.js";
+import { aiModelForStep } from "../providers/routing.js";
+import { aiOriginJobId } from "./ai-job-draft-ids.js";
+import { writeAiDraft, writeAiDraftScreenSeo } from "./ai-job-drafts.js";
+import { aiUnspentOutcome } from "./ai-job-generation.js";
+import { aiPluginDraftAdmissionRefusal } from "./ai-job-plugin-drafts.js";
+/**
+ * The store pages' unit of a site start (AGL-3676): the account, cart and
+ * policy pages a paid store gets beside its planned pages
+ * (`model/ai-site-store-pages.ts`), written by code in one pass that asks no
+ * model and costs no credits.
+ *
+ * Each page is a draft written through the same writer, under the same pages
+ * allowance, as every page the start builds (`writeAiDraft`), under an id
+ * derived from the unit's job, so a pass run again finds its own drafts. The
+ * guided start's publish then puts them live with the rest.
+ *
+ * The site's user accounts are turned on here too: the Customer account's
+ * sign-in, and the platform's /signin and /signup, answer only where the site
+ * serves accounts (`accounts` is off by default on a site that predates
+ * 2026-08; every new site is born with it). A site whose owner switched them
+ * off keeps them off: an explicit deny is theirs.
+ */ /** The unit input a store pages unit carries what it writes in. */ export const AI_SITE_STORE_PAGES_INPUT = 'storePages';
+/** The commerce plugin's name, in the refusal that asks for it. */ const STORE_LABEL = 'Commerce';
+/** What a store pages row says where nothing could be written: our failure. */ export const AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY = 'Your account, cart and policy pages could not be added this time.';
+/** The id of the store page a unit writes for `key`. */ export function aiSiteStorePageId(unitJobId, key) {
+    return `${unitJobId}-${key}`;
+}
+const PATH = /^\/[a-z0-9-]*$/;
+function inputOf(job) {
+    var _job_inputs;
+    const raw = (_job_inputs = job.inputs) == null ? void 0 : _job_inputs[AI_SITE_STORE_PAGES_INPUT];
+    if (!raw || !Array.isArray(raw.pages) || !raw.facts) return null;
+    const keys = new Set(AI_STORE_PAGES.map((page)=>page.key));
+    const pages = raw.pages.filter((page)=>page && keys.has(page.key) && typeof page.slug === 'string');
+    const path = (value, fallback)=>typeof value === 'string' && PATH.test(value) ? value : fallback;
+    return {
+        pages,
+        facts: {
+            contactPath: raw.facts.contactPath ? path(raw.facts.contactPath, '') || null : null,
+            shopPath: path(raw.facts.shopPath, '/shop'),
+            shippingPath: path(raw.facts.shippingPath, '/shipping-returns')
+        },
+        layoutId: typeof raw.layoutId === 'string' && raw.layoutId ? raw.layoutId : null
+    };
+}
+/**
+ * Whether the store pages may be added for this member on this site, asked
+ * before their pass so a refusal spends nothing; `null` admits. The plan must
+ * include a store (Starter and up), the commerce plugin must run here, and the
+ * member must be able to edit the site's pages.
+ */ export async function aiSiteStorePagesRefusal(context, deps = {}) {
+    var _context_org, _deps_admission, _context_org1, _host_get;
+    const { job, firestore } = context;
+    if (!job.hostId) return 'Open the site first.';
+    if (!checkEntitlement((_context_org = context.org) != null ? _context_org : null, 'commerce')) return 'Your plan does not include a store.';
+    const refused = await ((_deps_admission = deps.admission) != null ? _deps_admission : aiPluginDraftAdmissionRefusal)({
+        firestore,
+        orgId: job.orgId,
+        hostId: job.hostId,
+        inputs: {},
+        org: (_context_org1 = context.org) != null ? _context_org1 : null
+    }, {
+        kind: 'site',
+        drafts: [
+            {
+                resource: 'product',
+                label: STORE_LABEL
+            }
+        ],
+        now: context.now
+    });
+    if (refused) return refused.error;
+    const host = await firestore.collection('hosts').doc(job.hostId).get();
+    return hostRoleCanWrite(((_host_get = host.get('memberRoles')) != null ? _host_get : {})[job.createdBy]) ? null : 'Editing requires the editor role';
+}
+/** The store pages' pass: every page written, user accounts on, one output a page. */ export function createAiSiteStorePagesRunner(deps = {}) {
+    var _deps_write, _deps_writeSeo;
+    const write = (_deps_write = deps.write) != null ? _deps_write : writeAiDraft;
+    const writeSeo = (_deps_writeSeo = deps.writeSeo) != null ? _deps_writeSeo : writeAiDraftScreenSeo;
+    return async (context)=>{
+        var _ref;
+        const { job, firestore, now } = context;
+        const model = (_ref = context.modelFor == null ? void 0 : context.modelFor.call(context, 'job.plan')) != null ? _ref : aiModelForStep('job.plan');
+        const input = inputOf(job);
+        const hostId = job.hostId;
+        if (!input || !hostId) return _extends({}, aiUnspentOutcome(model), {
+            failure: AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY
+        });
+        const outputs = [];
+        let refusal = null;
+        for (const page of aiStorePagesToWrite(input.pages)){
+            var _context_org;
+            const definition = AI_STORE_PAGES.find((one)=>one.key === page.key);
+            if (!definition) continue;
+            const id = aiSiteStorePageId(job.$id, page.key);
+            const draft = await write(firestore, _extends({
+                kind: 'screen',
+                hostId,
+                id,
+                uid: job.createdBy,
+                org: (_context_org = context.org) != null ? _context_org : null,
+                name: definition.title,
+                slug: page.slug,
+                nodes: aiStorePageNodes(page.key, input.facts),
+                layoutId: input.layoutId
+            }, definition.noindex ? {
+                visibility: HostScreenVisibility.UNLISTED
+            } : {}, {
+                aiJobId: aiOriginJobId(job),
+                now
+            }));
+            if (draft.ok === false) {
+                // The pages allowance is full, or the site is gone: what was written stays.
+                refusal = draft.error;
+                break;
+            }
+            await writeSeo(firestore, {
+                hostId,
+                id,
+                seo: definition.seo,
+                now
+            });
+            outputs.push({
+                resource: 'screen',
+                id,
+                versionId: draft.versionId,
+                hostId,
+                hostSubdomain: draft.hostSubdomain,
+                label: draft.name,
+                proposal: {
+                    storePage: page.key,
+                    path: page.href
+                }
+            });
+        }
+        if (outputs.length) await turnOnSiteAccounts(firestore, hostId, now);
+        if (!outputs.length) {
+            return refusal ? aiUnspentOutcome(model, {
+                review: {
+                    reason: 'limit',
+                    message: refusal,
+                    findings: []
+                }
+            }) : _extends({}, aiUnspentOutcome(model), {
+                failure: AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY
+            });
+        }
+        return aiUnspentOutcome(model, {
+            outputs
+        });
+    };
+}
+export const runAiSiteStorePagesUnit = createAiSiteStorePagesRunner();
+/**
+ * Turns on the site's user accounts (`accounts`, default-off per site), so
+ * the account page's sign-in and the platform's /signin and /signup answer.
+ * An owner's explicit switch-off is left as it is.
+ */ export async function turnOnSiteAccounts(firestore, hostId, now) {
+    var _host_get, _host_get1;
+    const hostRef = firestore.collection('hosts').doc(hostId);
+    const host = await hostRef.get();
+    if (!host.exists) return false;
+    const disabled = (_host_get = host.get('disabledPlugins')) != null ? _host_get : [];
+    const enabled = (_host_get1 = host.get('enabledPlugins')) != null ? _host_get1 : [];
+    if (disabled.includes(ACCOUNTS_PLUGIN_ID) || enabled.includes(ACCOUNTS_PLUGIN_ID)) return false;
+    await hostRef.update({
+        enabledPlugins: FieldValue.arrayUnion(ACCOUNTS_PLUGIN_ID),
+        updatedAt: now
+    });
+    return true;
+}
+
+//# sourceMappingURL=ai-job-site-store-pages.js.map

package/src/lib/jobs/ai-job-site-store-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-site-store-pages.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 { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { hostRoleCanWrite } from '@aglyn/aglyn/app-utils/organizations'\nimport { ACCOUNTS_PLUGIN_ID } from '@aglyn/aglyn/plugin-manager/enabled-plugins'\nimport { HostScreenVisibility } from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { FieldValue } from 'firebase-admin/firestore'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport {\n  aiStorePageNodes,\n  aiStorePagesToWrite,\n  AI_STORE_PAGES,\n  type AiStorePageFacts,\n  type AiStorePagePlan,\n} from '../model/ai-site-store-pages'\nimport { aiModelForStep } from '../providers/routing'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { writeAiDraft, writeAiDraftScreenSeo } from './ai-job-drafts'\nimport { aiUnspentOutcome } from './ai-job-generation'\nimport { aiPluginDraftAdmissionRefusal } from './ai-job-plugin-drafts'\nimport type { AiJobStepContext, AiJobStepOutcome, AiJobStepRunner } from './ai-job-text-step'\n\n/**\n * The store pages' unit of a site start (AGL-3676): the account, cart and\n * policy pages a paid store gets beside its planned pages\n * (`model/ai-site-store-pages.ts`), written by code in one pass that asks no\n * model and costs no credits.\n *\n * Each page is a draft written through the same writer, under the same pages\n * allowance, as every page the start builds (`writeAiDraft`), under an id\n * derived from the unit's job, so a pass run again finds its own drafts. The\n * guided start's publish then puts them live with the rest.\n *\n * The site's user accounts are turned on here too: the Customer account's\n * sign-in, and the platform's /signin and /signup, answer only where the site\n * serves accounts (`accounts` is off by default on a site that predates\n * 2026-08; every new site is born with it). A site whose owner switched them\n * off keeps them off: an explicit deny is theirs.\n */\n\n/** The unit input a store pages unit carries what it writes in. */\nexport const AI_SITE_STORE_PAGES_INPUT = 'storePages'\n\n/** What a store pages unit is told: the store pages the plan implies, and what their words link. */\nexport interface AiSiteStorePagesInput {\n  pages: AiStorePagePlan[]\n  facts: AiStorePageFacts\n  /** The layout the start built, which the pages render inside; the site's otherwise. */\n  layoutId: string | null\n}\n\n/** The commerce plugin's name, in the refusal that asks for it. */\nconst STORE_LABEL = 'Commerce'\n\n/** What a store pages row says where nothing could be written: our failure. */\nexport const AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY = 'Your account, cart and policy pages could not be added this time.'\n\n/** The id of the store page a unit writes for `key`. */\nexport function aiSiteStorePageId(unitJobId: string, key: string): string {\n  return `${unitJobId}-${key}`\n}\n\nconst PATH = /^\\/[a-z0-9-]*$/\n\nfunction inputOf(job: Pick<AiJob, 'inputs'>): AiSiteStorePagesInput | null {\n  const raw = job.inputs?.[AI_SITE_STORE_PAGES_INPUT] as Partial<AiSiteStorePagesInput> | undefined\n  if (!raw || !Array.isArray(raw.pages) || !raw.facts) return null\n  const keys = new Set(AI_STORE_PAGES.map((page) => page.key))\n  const pages = raw.pages.filter((page) => page && keys.has(page.key) && typeof page.slug === 'string')\n  const path = (value: unknown, fallback: string) => (typeof value === 'string' && PATH.test(value) ? value : fallback)\n  return {\n    pages,\n    facts: {\n      contactPath: raw.facts.contactPath ? path(raw.facts.contactPath, '') || null : null,\n      shopPath: path(raw.facts.shopPath, '/shop'),\n      shippingPath: path(raw.facts.shippingPath, '/shipping-returns'),\n    },\n    layoutId: typeof raw.layoutId === 'string' && raw.layoutId ? raw.layoutId : null,\n  }\n}\n\n/**\n * Whether the store pages may be added for this member on this site, asked\n * before their pass so a refusal spends nothing; `null` admits. The plan must\n * include a store (Starter and up), the commerce plugin must run here, and the\n * member must be able to edit the site's pages.\n */\nexport async function aiSiteStorePagesRefusal(\n  context: Pick<AiJobStepContext, 'firestore' | 'org' | 'now'> & { job: Pick<AiJob, 'orgId' | 'hostId' | 'createdBy'> },\n  deps: { admission?: typeof aiPluginDraftAdmissionRefusal } = {},\n): Promise<string | null> {\n  const { job, firestore } = context\n  if (!job.hostId) return 'Open the site first.'\n  if (!checkEntitlement((context.org ?? null) as never, 'commerce')) return 'Your plan does not include a store.'\n  const refused = await (deps.admission ?? aiPluginDraftAdmissionRefusal)(\n    { firestore, orgId: job.orgId, hostId: job.hostId, inputs: {}, org: context.org ?? null },\n    { kind: 'site', drafts: [{ resource: 'product', label: STORE_LABEL }], now: context.now },\n  )\n  if (refused) return refused.error\n  const host = await firestore.collection('hosts').doc(job.hostId).get()\n  return hostRoleCanWrite((host.get('memberRoles') ?? {})[job.createdBy]) ? null : 'Editing requires the editor role'\n}\n\nexport interface AiSiteStorePagesRunnerDeps {\n  write?: typeof writeAiDraft\n  writeSeo?: typeof writeAiDraftScreenSeo\n}\n\n/** The store pages' pass: every page written, user accounts on, one output a page. */\nexport function createAiSiteStorePagesRunner(deps: AiSiteStorePagesRunnerDeps = {}): AiJobStepRunner {\n  const write = deps.write ?? writeAiDraft\n  const writeSeo = deps.writeSeo ?? writeAiDraftScreenSeo\n  return async (context): Promise<AiJobStepOutcome> => {\n    const { job, firestore, now } = context\n    const model = context.modelFor?.('job.plan') ?? aiModelForStep('job.plan')\n    const input = inputOf(job)\n    const hostId = job.hostId\n    if (!input || !hostId) return { ...aiUnspentOutcome(model), failure: AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY }\n    const outputs: AiJobOutput[] = []\n    let refusal: string | null = null\n    for (const page of aiStorePagesToWrite(input.pages)) {\n      const definition = AI_STORE_PAGES.find((one) => one.key === page.key)\n      if (!definition) continue\n      const id = aiSiteStorePageId(job.$id, page.key)\n      const draft = await write(firestore, {\n        kind: 'screen',\n        hostId,\n        id,\n        uid: job.createdBy,\n        org: context.org ?? null,\n        name: definition.title,\n        slug: page.slug,\n        nodes: aiStorePageNodes(page.key, input.facts) as unknown as NodesMap,\n        layoutId: input.layoutId,\n        // The account and the cart are a shopper's own pages: unlisted, noindex (AGL-3676).\n        ...(definition.noindex ? { visibility: HostScreenVisibility.UNLISTED } : {}),\n        aiJobId: aiOriginJobId(job),\n        now,\n      })\n      if (draft.ok === false) {\n        // The pages allowance is full, or the site is gone: what was written stays.\n        refusal = draft.error\n        break\n      }\n      await writeSeo(firestore, { hostId, id, seo: definition.seo, now })\n      outputs.push({\n        resource: 'screen',\n        id,\n        versionId: draft.versionId,\n        hostId,\n        hostSubdomain: draft.hostSubdomain,\n        label: draft.name,\n        proposal: { storePage: page.key, path: page.href },\n      })\n    }\n    if (outputs.length) await turnOnSiteAccounts(firestore, hostId, now)\n    if (!outputs.length) {\n      return refusal\n        ? aiUnspentOutcome(model, { review: { reason: 'limit', message: refusal, findings: [] } })\n        : { ...aiUnspentOutcome(model), failure: AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY }\n    }\n    return aiUnspentOutcome(model, { outputs })\n  }\n}\n\nexport const runAiSiteStorePagesUnit = createAiSiteStorePagesRunner()\n\n/**\n * Turns on the site's user accounts (`accounts`, default-off per site), so\n * the account page's sign-in and the platform's /signin and /signup answer.\n * An owner's explicit switch-off is left as it is.\n */\nexport async function turnOnSiteAccounts(firestore: FirebaseFirestore.Firestore, hostId: string, now: Date): Promise<boolean> {\n  const hostRef = firestore.collection('hosts').doc(hostId)\n  const host = await hostRef.get()\n  if (!host.exists) return false\n  const disabled = (host.get('disabledPlugins') ?? []) as unknown[]\n  const enabled = (host.get('enabledPlugins') ?? []) as unknown[]\n  if (disabled.includes(ACCOUNTS_PLUGIN_ID) || enabled.includes(ACCOUNTS_PLUGIN_ID)) return false\n  await hostRef.update({ enabledPlugins: FieldValue.arrayUnion(ACCOUNTS_PLUGIN_ID), updatedAt: now })\n  return true\n}\n"],"names":["checkEntitlement","hostRoleCanWrite","ACCOUNTS_PLUGIN_ID","HostScreenVisibility","FieldValue","aiStorePageNodes","aiStorePagesToWrite","AI_STORE_PAGES","aiModelForStep","aiOriginJobId","writeAiDraft","writeAiDraftScreenSeo","aiUnspentOutcome","aiPluginDraftAdmissionRefusal","AI_SITE_STORE_PAGES_INPUT","STORE_LABEL","AI_SITE_STORE_PAGES_NOT_WRITTEN_COPY","aiSiteStorePageId","unitJobId","key","PATH","inputOf","job","raw","inputs","Array","isArray","pages","facts","keys","Set","map","page","filter","has","slug","path","value","fallback","test","contactPath","shopPath","shippingPath","layoutId","aiSiteStorePagesRefusal","context","deps","host","firestore","hostId","org","refused","admission","orgId","kind","drafts","resource","label","now","error","collection","doc","get","createdBy","createAiSiteStorePagesRunner","write","writeSeo","model","modelFor","input","failure","outputs","refusal","definition","find","one","id","$id","draft","uid","name","title","nodes","noindex","visibility","UNLISTED","aiJobId","ok","seo","push","versionId","hostSubdomain","proposal","storePage","href","length","turnOnSiteAccounts","review","reason","message","findings","runAiSiteStorePagesUnit","hostRef","exists","disabled","enabled","includes","update","enabledPlugins","arrayUnion","updatedAt"],"mappings":"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"}

package/src/lib/jobs/ai-job-store-links-layout.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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 { Firestore } from 'firebase-admin/firestore';
+import { type AiStoreLayoutLinks } from '../model/ai-layout-store-links';
+/**
+ * A store's links in the site's own layout, as a DRAFT (AGL-3676): a build
+ * that makes the site a store and builds no layout writes a new version of
+ * the layout its store pages render inside, with Account (and Cart, where
+ * the header has none) in the header and the account and policies in the
+ * footer (`aiLayoutWithStoreLinks`). The layout's current version — the one
+ * visitors see — is never touched: the new version waits beside it, and goes
+ * live only when the build publishes (`aiPublishGuidedSite`'s `storeLinks`),
+ * as every draft the build makes does.
+ */
+/** The field a draft version keeps the version it was made from in, so a publish knows whether it is still current. */
+export declare const AI_STORE_LINKS_SOURCE_FIELD = "aiStoreLinksSourceVersionId";
+/** What a store links draft version is called in the layout's versions. */
+export declare const AI_STORE_LINKS_VERSION_NAME = "Account and policy links";
+/** What writing a store's links into the site's layout came to. */
+export type AiStoreLinksLayoutDraft = {
+    status: 'written';
+    layoutId: string;
+    versionId: string;
+    name: string;
+}
+/** Every link was already there. */
+ | {
+    status: 'present';
+    layoutId: string;
+}
+/** The layout has no header list or no footer list to add to: what it had room for, if anything, was written. */
+ | {
+    status: 'unrecognized';
+    layoutId: string;
+    versionId: string | null;
+    name: string;
+}
+/** The layout is gone, or has no current version to start from. */
+ | {
+    status: 'gone';
+};
+/**
+ * Writes the draft version (idempotent: a version with this id already
+ * written is that draft). Reads the layout's current version and writes the
+ * new one beside it, a copy of it — its fields, everything the editor stored
+ * — with the links added.
+ */
+export declare function writeAiStoreLinksLayoutDraft(firestore: Firestore, input: {
+    hostId: string;
+    layoutId: string;
+    versionId: string;
+    links: AiStoreLayoutLinks;
+    screenPaths: Readonly<Record<string, string>>;
+    uid: string;
+    aiJobId: string;
+    now: Date;
+}): Promise<AiStoreLinksLayoutDraft>;

package/src/lib/jobs/ai-job-store-links-layout.js

@@ -0,0 +1,95 @@
+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 { decodeStoredNodes, encodeStoredNodes } from "@aglyn/aglyn/app-utils/stored-nodes";
+import { aiLayoutWithStoreLinks } from "../model/ai-layout-store-links.js";
+/**
+ * A store's links in the site's own layout, as a DRAFT (AGL-3676): a build
+ * that makes the site a store and builds no layout writes a new version of
+ * the layout its store pages render inside, with Account (and Cart, where
+ * the header has none) in the header and the account and policies in the
+ * footer (`aiLayoutWithStoreLinks`). The layout's current version — the one
+ * visitors see — is never touched: the new version waits beside it, and goes
+ * live only when the build publishes (`aiPublishGuidedSite`'s `storeLinks`),
+ * as every draft the build makes does.
+ */ /** The field a draft version keeps the version it was made from in, so a publish knows whether it is still current. */ export const AI_STORE_LINKS_SOURCE_FIELD = 'aiStoreLinksSourceVersionId';
+/** What a store links draft version is called in the layout's versions. */ export const AI_STORE_LINKS_VERSION_NAME = 'Account and policy links';
+/**
+ * Writes the draft version (idempotent: a version with this id already
+ * written is that draft). Reads the layout's current version and writes the
+ * new one beside it, a copy of it — its fields, everything the editor stored
+ * — with the links added.
+ */ export async function writeAiStoreLinksLayoutDraft(firestore, input) {
+    var _layout_get;
+    const layoutRef = firestore.collection('hosts').doc(input.hostId).collection('layouts').doc(input.layoutId);
+    const layout = await layoutRef.get();
+    const currentVersionId = layout.get('versionId');
+    if (!layout.exists || layout.get('deletedAt') != null || typeof currentVersionId !== 'string' || !currentVersionId) {
+        return {
+            status: 'gone'
+        };
+    }
+    const name = String((_layout_get = layout.get('displayName')) != null ? _layout_get : '') || 'Layout';
+    const draftRef = layoutRef.collection('versions').doc(input.versionId);
+    const already = await draftRef.get();
+    if (already.exists) return {
+        status: 'written',
+        layoutId: input.layoutId,
+        versionId: input.versionId,
+        name
+    };
+    const current = await layoutRef.collection('versions').doc(currentVersionId).get();
+    const nodes = current.exists ? decodeStoredNodes(current.get('nodes')) : null;
+    if (!nodes) return {
+        status: 'gone'
+    };
+    const result = aiLayoutWithStoreLinks(nodes, input.links, input.screenPaths);
+    const recognized = result.header && result.footer;
+    const packed = result.nodes ? encodeStoredNodes(result.nodes) : null;
+    if (!packed) return recognized ? {
+        status: 'present',
+        layoutId: input.layoutId
+    } : {
+        status: 'unrecognized',
+        layoutId: input.layoutId,
+        versionId: null,
+        name
+    };
+    const copy = _extends({}, current.data());
+    delete copy['aiEditJobId'];
+    await draftRef.create(_extends({}, copy, {
+        nodes: Buffer.from(packed),
+        displayName: AI_STORE_LINKS_VERSION_NAME,
+        createdAt: input.now,
+        updatedAt: input.now,
+        createdBy: input.uid,
+        aiJobId: input.aiJobId,
+        [AI_STORE_LINKS_SOURCE_FIELD]: currentVersionId
+    }));
+    return recognized ? {
+        status: 'written',
+        layoutId: input.layoutId,
+        versionId: input.versionId,
+        name
+    } : {
+        status: 'unrecognized',
+        layoutId: input.layoutId,
+        versionId: input.versionId,
+        name
+    };
+}
+
+//# sourceMappingURL=ai-job-store-links-layout.js.map

package/src/lib/jobs/ai-job-store-links-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-store-links-layout.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 { decodeStoredNodes, encodeStoredNodes } from '@aglyn/aglyn/app-utils/stored-nodes'\nimport type { Firestore } from 'firebase-admin/firestore'\nimport { aiLayoutWithStoreLinks, type AiStoreLayoutLinks } from '../model/ai-layout-store-links'\n\n/**\n * A store's links in the site's own layout, as a DRAFT (AGL-3676): a build\n * that makes the site a store and builds no layout writes a new version of\n * the layout its store pages render inside, with Account (and Cart, where\n * the header has none) in the header and the account and policies in the\n * footer (`aiLayoutWithStoreLinks`). The layout's current version — the one\n * visitors see — is never touched: the new version waits beside it, and goes\n * live only when the build publishes (`aiPublishGuidedSite`'s `storeLinks`),\n * as every draft the build makes does.\n */\n\n/** The field a draft version keeps the version it was made from in, so a publish knows whether it is still current. */\nexport const AI_STORE_LINKS_SOURCE_FIELD = 'aiStoreLinksSourceVersionId'\n\n/** What a store links draft version is called in the layout's versions. */\nexport const AI_STORE_LINKS_VERSION_NAME = 'Account and policy links'\n\n/** What writing a store's links into the site's layout came to. */\nexport type AiStoreLinksLayoutDraft =\n  | { status: 'written'; layoutId: string; versionId: string; name: string }\n  /** Every link was already there. */\n  | { status: 'present'; layoutId: string }\n  /** The layout has no header list or no footer list to add to: what it had room for, if anything, was written. */\n  | { status: 'unrecognized'; layoutId: string; versionId: string | null; name: string }\n  /** The layout is gone, or has no current version to start from. */\n  | { status: 'gone' }\n\n/**\n * Writes the draft version (idempotent: a version with this id already\n * written is that draft). Reads the layout's current version and writes the\n * new one beside it, a copy of it — its fields, everything the editor stored\n * — with the links added.\n */\nexport async function writeAiStoreLinksLayoutDraft(\n  firestore: Firestore,\n  input: {\n    hostId: string\n    layoutId: string\n    versionId: string\n    links: AiStoreLayoutLinks\n    screenPaths: Readonly<Record<string, string>>\n    uid: string\n    aiJobId: string\n    now: Date\n  },\n): Promise<AiStoreLinksLayoutDraft> {\n  const layoutRef = firestore.collection('hosts').doc(input.hostId).collection('layouts').doc(input.layoutId)\n  const layout = await layoutRef.get()\n  const currentVersionId = layout.get('versionId')\n  if (!layout.exists || layout.get('deletedAt') != null || typeof currentVersionId !== 'string' || !currentVersionId) {\n    return { status: 'gone' }\n  }\n  const name = String(layout.get('displayName') ?? '') || 'Layout'\n  const draftRef = layoutRef.collection('versions').doc(input.versionId)\n  const already = await draftRef.get()\n  if (already.exists) return { status: 'written', layoutId: input.layoutId, versionId: input.versionId, name }\n  const current = await layoutRef.collection('versions').doc(currentVersionId).get()\n  const nodes = current.exists ? decodeStoredNodes<Record<string, unknown>>(current.get('nodes')) : null\n  if (!nodes) return { status: 'gone' }\n  const result = aiLayoutWithStoreLinks(nodes, input.links, input.screenPaths)\n  const recognized = result.header && result.footer\n  const packed = result.nodes ? encodeStoredNodes(result.nodes as never) : null\n  if (!packed) return recognized ? { status: 'present', layoutId: input.layoutId } : { status: 'unrecognized', layoutId: input.layoutId, versionId: null, name }\n  const copy = { ...(current.data() as Record<string, unknown>) }\n  delete copy['aiEditJobId']\n  await draftRef.create({\n    ...copy,\n    nodes: Buffer.from(packed),\n    displayName: AI_STORE_LINKS_VERSION_NAME,\n    createdAt: input.now,\n    updatedAt: input.now,\n    createdBy: input.uid,\n    aiJobId: input.aiJobId,\n    [AI_STORE_LINKS_SOURCE_FIELD]: currentVersionId,\n  })\n  return recognized\n    ? { status: 'written', layoutId: input.layoutId, versionId: input.versionId, name }\n    : { status: 'unrecognized', layoutId: input.layoutId, versionId: input.versionId, name }\n}\n"],"names":["decodeStoredNodes","encodeStoredNodes","aiLayoutWithStoreLinks","AI_STORE_LINKS_SOURCE_FIELD","AI_STORE_LINKS_VERSION_NAME","writeAiStoreLinksLayoutDraft","firestore","input","layout","layoutRef","collection","doc","hostId","layoutId","get","currentVersionId","exists","status","name","String","draftRef","versionId","already","current","nodes","result","links","screenPaths","recognized","header","footer","packed","copy","data","create","Buffer","from","displayName","createdAt","now","updatedAt","createdBy","uid","aiJobId"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,iBAAiB,EAAEC,iBAAiB,QAAQ,sCAAqC;AAE1F,SAASC,sBAAsB,QAAiC,oCAAgC;AAEhG;;;;;;;;;CASC,GAED,qHAAqH,GACrH,OAAO,MAAMC,8BAA8B,8BAA6B;AAExE,yEAAyE,GACzE,OAAO,MAAMC,8BAA8B,2BAA0B;AAYrE;;;;;CAKC,GACD,OAAO,eAAeC,6BACpBC,SAAoB,EACpBC,KASC;QAQmBC;IANpB,MAAMC,YAAYH,UAAUI,UAAU,CAAC,SAASC,GAAG,CAACJ,MAAMK,MAAM,EAAEF,UAAU,CAAC,WAAWC,GAAG,CAACJ,MAAMM,QAAQ;IAC1G,MAAML,SAAS,MAAMC,UAAUK,GAAG;IAClC,MAAMC,mBAAmBP,OAAOM,GAAG,CAAC;IACpC,IAAI,CAACN,OAAOQ,MAAM,IAAIR,OAAOM,GAAG,CAAC,gBAAgB,QAAQ,OAAOC,qBAAqB,YAAY,CAACA,kBAAkB;QAClH,OAAO;YAAEE,QAAQ;QAAO;IAC1B;IACA,MAAMC,OAAOC,QAAOX,cAAAA,OAAOM,GAAG,CAAC,0BAAXN,cAA6B,OAAO;IACxD,MAAMY,WAAWX,UAAUC,UAAU,CAAC,YAAYC,GAAG,CAACJ,MAAMc,SAAS;IACrE,MAAMC,UAAU,MAAMF,SAASN,GAAG;IAClC,IAAIQ,QAAQN,MAAM,EAAE,OAAO;QAAEC,QAAQ;QAAWJ,UAAUN,MAAMM,QAAQ;QAAEQ,WAAWd,MAAMc,SAAS;QAAEH;IAAK;IAC3G,MAAMK,UAAU,MAAMd,UAAUC,UAAU,CAAC,YAAYC,GAAG,CAACI,kBAAkBD,GAAG;IAChF,MAAMU,QAAQD,QAAQP,MAAM,GAAGhB,kBAA2CuB,QAAQT,GAAG,CAAC,YAAY;IAClG,IAAI,CAACU,OAAO,OAAO;QAAEP,QAAQ;IAAO;IACpC,MAAMQ,SAASvB,uBAAuBsB,OAAOjB,MAAMmB,KAAK,EAAEnB,MAAMoB,WAAW;IAC3E,MAAMC,aAAaH,OAAOI,MAAM,IAAIJ,OAAOK,MAAM;IACjD,MAAMC,SAASN,OAAOD,KAAK,GAAGvB,kBAAkBwB,OAAOD,KAAK,IAAa;IACzE,IAAI,CAACO,QAAQ,OAAOH,aAAa;QAAEX,QAAQ;QAAWJ,UAAUN,MAAMM,QAAQ;IAAC,IAAI;QAAEI,QAAQ;QAAgBJ,UAAUN,MAAMM,QAAQ;QAAEQ,WAAW;QAAMH;IAAK;IAC7J,MAAMc,OAAO,aAAMT,QAAQU,IAAI;IAC/B,OAAOD,IAAI,CAAC,cAAc;IAC1B,MAAMZ,SAASc,MAAM,CAAC,aACjBF;QACHR,OAAOW,OAAOC,IAAI,CAACL;QACnBM,aAAajC;QACbkC,WAAW/B,MAAMgC,GAAG;QACpBC,WAAWjC,MAAMgC,GAAG;QACpBE,WAAWlC,MAAMmC,GAAG;QACpBC,SAASpC,MAAMoC,OAAO;QACtB,CAACxC,4BAA4B,EAAEY;;IAEjC,OAAOa,aACH;QAAEX,QAAQ;QAAWJ,UAAUN,MAAMM,QAAQ;QAAEQ,WAAWd,MAAMc,SAAS;QAAEH;IAAK,IAChF;QAAED,QAAQ;QAAgBJ,UAAUN,MAAMM,QAAQ;QAAEQ,WAAWd,MAAMc,SAAS;QAAEH;IAAK;AAC3F"}

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

@@ -71,6 +71,17 @@ import { type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-
  *    ranked: the object in the hit's first tags (what the photo is OF) over
  *    a mention in its last, the subject's other words, the domain. Among
  *    equals the job's seed picks, so two sites differ and one job repeats.
+ *    What the beta.239 Ember & Oak start added: "hand-poured", "handmade"
+ *    and "by hand" never make "hands" a subject, and a story of the craft
+ *    asks for the maker at work ("candle making"); a hit carrying a topic
+ *    the brief never named (a cross, a grave, a flag, a gun, wine, a child,
+ *    a mannequin) never fills anything; a product, and a collection tile,
+ *    take only a hit naming its head noun among the first tags, held to the
+ *    shop's category; and an object whose word is not enough ("melt") is
+ *    named and searched by its kin ("wax melt", "melt warmer"), never by the
+ *    category alone. And from the Kiln & Clover portfolio: nudity never fills
+ *    anything, for any business; a hit naming a rival craft (glass, for a
+ *    potter) counts only when it names the craft's own words too.
  * 4. **Never twice.** A photo is placed once per job: not twice on a page,
  *    and not on a page when another page (or another pass, in this process)
  *    of the same job already placed it. The caller hands in what the job's
@@ -84,6 +95,18 @@ import { type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-
  *    to its photographer. A copy that fails tries the slot's next accepted
  *    hit.
  *
+ * 6. **Fall back to the craft, never off it** (the beta.241 Saltmarsh Soap
+ *    Co start, a store "for handmade cold-process soap": its craft read as
+ *    nothing, its hero searched "shop" and took a florist's bouquet, and four
+ *    of five products took the starters' laptop desk and living room). A
+ *    business that is only a place takes its craft from what it is for
+ *    ("soap shop"); a hero names the craft itself ({@link AiStockSiteTerms.core});
+ *    a product, after its own searches, tries its head noun anywhere among
+ *    the tags, its gift wrapper with the craft and the craft's broad
+ *    searches, and then — a product or a hero only — reuses an on-topic photo
+ *    the job already shows rather than take a starter. Every slot of a
+ *    craft's site tries the craft's broad searches last.
+ *
  * A slot nothing acceptable answered — the library down, refusing, or out
  * of time — is left `null` for the starter photos. A named object is never
  * given one while the library answers anything of the site's world: the
@@ -103,6 +126,12 @@ export declare const AI_LAYOUT_STOCK_MAX_BYTES: number;
  * written to, whose photos a page does not place again (AGL-3660).
  */
 export declare const AI_STOCK_PHOTO_PAGES_INPUT = "stockPhotoPages";
+/**
+ * The unit job input naming library photos (`media:` references) another
+ * part of the job already shows outside its pages — a dataset's records
+ * (AGL-3616) — which a page does not place again.
+ */
+export declare const AI_STOCK_PHOTO_AVOID_INPUT = "stockPhotoAvoid";
 /**
  * A word's singular, for matching only: "bowls" and "bowl", "vases" and
  * "vase", "berries" and "berry", "dishes" and "dish" meet. Both sides of a
@@ -140,6 +169,22 @@ export interface AiStockSiteTerms {
     domain: string[];
     /** The searches for the site's world itself, broadest last. */
     broad: string[];
+    /** The searches for its maker at work, for a story of the craft (AGL-3660); empty for a craft not listed. */
+    making: string[];
+    /** Every stem of the business type or brief: what lets a sensitive topic in ({@link SENSITIVE_TOPICS}). */
+    named: string[];
+    /** Rival crafts' words, each with the words that must then be named too ({@link CRAFT_KIN}). */
+    rivals: Array<{
+        words: string[];
+        core: string[];
+    }>;
+    /**
+     * The stems a photo of the craft ITSELF names, one of which a hero and a
+     * product's fallbacks must name (AGL-3660): the craft and, for a listed
+     * craft, its own names ("soap", "soapmaker", "skincare"). Empty where the
+     * site names no craft.
+     */
+    core: string[];
 }
 /** The site's terms, read from its business type. */
 export declare function aiStockSiteTerms(businessType: string): AiStockSiteTerms;
@@ -170,19 +215,72 @@ export interface AiStockSearch extends StockPhotoSearchRequest {
     subject?: string;
     /** A word every hit must name: a product's photo names the shop's category (AGL-3676). */
     requires?: string;
+    /**
+     * Words of which a hit must name ONE, `requires` among them (AGL-3660): a
+     * shop's category or the slot's own word of its world, so a soap shop's
+     * body lotion is held to "lotion", never to "soap".
+     */
+    category?: readonly string[];
+    /** The thing every hit must name, where it is not the subject's own: a product's head noun (AGL-3660). */
+    object?: string;
+    /** Phrases that name the object where its own word is not enough: "wax melt" ({@link OBJECT_KIN}). */
+    kin?: readonly string[];
+    /** Whether the object must be among the hit's first tags, what the photo is OF (AGL-3660). */
+    lead?: boolean;
+    /** Whether the hit's first tags must name the site's world, where the object need not lead (AGL-3660). */
+    leadWorld?: boolean;
+}
+/** A slot's part of a page, where it asks for more than its role: a collection tile or a story of the craft (AGL-3660). */
+export type AiStockSlotPart = 'collection' | 'story';
+/**
+ * A slot's part (AGL-3660): a tile of a collections band is product-like,
+ * held to the shop's category and its own object; a picture of a story of
+ * the craft, or of a thing made by hand, shows the maker at work.
+ */
+export declare function aiStockSlotPart(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt'>, sectionName: string): AiStockSlotPart | undefined;
+/** What a product falls back to once its own searches find nothing ({@link aiStockProductSearches}). */
+export interface AiStockProductFallback {
+    /** The site's broad searches ({@link AiStockSiteTerms.broad}): "handmade soap". */
+    broad?: readonly string[];
+    /** The words a photo of the craft itself names ({@link AiStockSiteTerms.core}). */
+    core?: readonly string[];
 }
 /**
  * A product's searches (AGL-3676), most specific first: each of its subjects
  * — its name's noun phrase, then its photo's — with the shop's category
- * where the phrase does not already say it ("candle gift box"), then the
- * category alone, a plain photo of what the shop sells. Every one must find a
- * hit naming the category, so no product is ever filled with a lifestyle shot
- * of something else: the beta.237 Willow Wick start put a laptop and roses
- * under "Candle Wick Trimmer" and an antique tea set under "Candle Gift Set".
+ * where the phrase does not already name the shop's world ("candle gift
+ * box"), then the category alone, a plain photo of what the shop sells. Every
+ * one must find a hit naming the category — or the product's own word of the
+ * shop's world, "lotion" in a soap shop — so no product is ever filled with a
+ * lifestyle shot of something else: the beta.237 Willow Wick start put a
+ * laptop and roses under "Candle Wick Trimmer" and an antique tea set under
+ * "Candle Gift Set".
+ *
+ * And each must find a hit naming the product's own head noun among its
+ * first tags (AGL-3660): the beta.239 Ember & Oak start put a bed with a book,
+ * a mug and a camera (its candle a last tag) under "Hand-Poured Soy Candle".
+ * An object whose own word is not enough ({@link OBJECT_KIN}) is searched by
+ * its kin instead of the category alone, and named by them: a single taper
+ * candle filled "Wax Melt Gift Set".
+ *
+ * Then, before a product is ever given a photo of something else, it falls
+ * back to its own craft (AGL-3660). The Saltmarsh Soap Co start (2026-10-10)
+ * found no hit naming "bar" or "box" among the first tags, and four of its
+ * five products took the starter photos — a laptop and roses, a living room
+ * of plants. So, in order:
+ *
+ * 1. The same searches again, the head noun named anywhere among the tags
+ *    (no extra search: the page remembers its answers), and a gift's own
+ *    wrapper with the craft ("soap gift box").
+ * 2. The site's broad searches ("handmade soap", "natural skincare"), any hit
+ *    naming the craft itself ({@link AiStockSiteTerms.core}).
+ *
+ * The source then reuses an on-topic photo another slot of the job already
+ * shows before it gives up ({@link aiLayoutStockPhotoSource}).
  */
-export declare function aiStockProductSearches(slot: Pick<AiLayoutPictureSlot, 'aspect' | 'product'>, craft: string): AiStockSearch[];
+export declare function aiStockProductSearches(slot: Pick<AiLayoutPictureSlot, 'aspect' | 'product'>, craft: string, domain?: readonly string[], fallback?: AiStockProductFallback): AiStockSearch[];
 /** The searches a slot tries, in order, most specific first, each distinct. */
-export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'>, subject: string): AiStockSearch[];
+export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'> & Partial<Pick<AiStockSiteTerms, 'making' | 'core'>>, subject: string, part?: AiStockSlotPart): AiStockSearch[];
 /** What a hit is judged by. */
 export interface AiStockJudgement {
     /** The words the picture is of; empty for a picture of the site's world. */
@@ -196,10 +294,33 @@ export interface AiStockJudgement {
     strict?: boolean;
     /** A word every hit must name: a product's photo names the shop's category (AGL-3676). */
     requires?: string;
+    /** Words of which a hit must name one, `requires` among them ({@link AiStockSearch.category}). */
+    category?: readonly string[];
+    /** The thing a hit must name, where it is not the subject's own (AGL-3660). */
+    object?: string;
+    /** Phrases naming the object where its word is not enough; one of them is then required, and stands for the category. */
+    kin?: readonly string[];
+    /** Whether the object must be among the hit's first tags (AGL-3660). */
+    lead?: boolean;
+    /** Whether the hit's first tags must name the site's world ({@link AiStockSearch.leadWorld}). */
+    leadWorld?: boolean;
+    /** The stems of the site's business type or brief, which let a sensitive topic in ({@link AiStockSiteTerms.named}). */
+    named?: readonly string[];
+    /** Rival crafts: a hit naming one is rejected unless it names the site's core words ({@link AiStockSiteTerms.rivals}). */
+    rivals?: ReadonlyArray<{
+        words: readonly string[];
+        core: readonly string[];
+    }>;
 }
+/**
+ * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):
+ * a cross, a grave, a flag, a gun, a glass of wine, a child, a mannequin.
+ */
+export declare function aiStockSensitive(photo: Pick<StockPhoto, 'tags' | 'alt' | 'pageUrl'>, named?: readonly string[]): boolean;
 /**
  * How well a hit shows what a slot needs (AGL-3660), or 0 when it must not
- * fill it: a mockup or a blank never; a picture of a thing only when the hit
+ * fill it: a mockup or a blank never; a topic the site never named never
+ * ({@link aiStockSensitive}); a picture of a thing only when the hit
  * names its object AND either the site's world or the subject's own
  * two-word phrase ("bud vase", "wick trimmer"); anything else only when it
  * names the site's world (when the site names one). Among the accepted, the