@aglyn/plugins-ai 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/testing/stand-in-pipeline-index.js

@@ -0,0 +1,59 @@
+/**
+ * @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 { registerPluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
+import { unregisterPluginServices } from "@aglyn/aglyn/plugin-manager/plugin-services";
+/**
+ * The `pipeline` index the plugin that keeps pipelines publishes (AGL-3080),
+ * stood in with the answers a spec hands it — this plugin may not load the
+ * CRM that registers the real one. It answers in the shape the CRM's
+ * `pipeline-record-index.ts` documents (live pipelines, `facts.stages`), and
+ * records every question, so a spec can say what was asked. What the CRM
+ * itself answers is held in its own spec.
+ */ const OWNER = 'crm';
+/** Registers the index, answering `pipelines` to every site of every org. */ export function standInPipelineIndex(pipelines) {
+    const stood = {
+        asked: []
+    };
+    const records = pipelines.map((pipeline)=>({
+            id: pipeline.id,
+            name: pipeline.name,
+            facts: {
+                stages: pipeline.stages
+            }
+        }));
+    registerPluginRecordIndex('pipeline', {
+        async list (request) {
+            stood.asked.push(request);
+            return {
+                records: records.slice(0, request.limit),
+                truncated: records.length > request.limit
+            };
+        },
+        async get (request) {
+            var _records_find;
+            stood.asked.push(request);
+            return (_records_find = records.find((record)=>record.id === request.id)) != null ? _records_find : null;
+        }
+    }, {
+        pluginId: OWNER
+    });
+    return stood;
+}
+/** Forgets it, so the next spec starts with no plugin keeping pipelines. */ export function removeStandInPipelineIndex() {
+    unregisterPluginServices(OWNER);
+}
+
+//# sourceMappingURL=stand-in-pipeline-index.js.map

package/src/lib/testing/stand-in-pipeline-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/testing/stand-in-pipeline-index.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  registerPluginRecordIndex,\n  type PluginIndexedRecord,\n  type PluginRecordIndexScope,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { unregisterPluginServices } from '@aglyn/aglyn/plugin-manager/plugin-services'\n\n/**\n * The `pipeline` index the plugin that keeps pipelines publishes (AGL-3080),\n * stood in with the answers a spec hands it — this plugin may not load the\n * CRM that registers the real one. It answers in the shape the CRM's\n * `pipeline-record-index.ts` documents (live pipelines, `facts.stages`), and\n * records every question, so a spec can say what was asked. What the CRM\n * itself answers is held in its own spec.\n */\n\nconst OWNER = 'crm'\n\nexport interface StoodInPipelineIndex {\n  /** Every `list` and `get` asked, in order. */\n  asked: Array<PluginRecordIndexScope & { limit?: number; id?: string }>\n}\n\n/** Registers the index, answering `pipelines` to every site of every org. */\nexport function standInPipelineIndex(\n  pipelines: ReadonlyArray<{ id: string; name: string; stages: ReadonlyArray<Record<string, unknown>> }>,\n): StoodInPipelineIndex {\n  const stood: StoodInPipelineIndex = { asked: [] }\n  const records: PluginIndexedRecord[] = pipelines.map((pipeline) => ({\n    id: pipeline.id,\n    name: pipeline.name,\n    facts: { stages: pipeline.stages },\n  }))\n  registerPluginRecordIndex(\n    'pipeline',\n    {\n      async list(request) {\n        stood.asked.push(request)\n        return { records: records.slice(0, request.limit), truncated: records.length > request.limit }\n      },\n      async get(request) {\n        stood.asked.push(request)\n        return records.find((record) => record.id === request.id) ?? null\n      },\n    },\n    { pluginId: OWNER },\n  )\n  return stood\n}\n\n/** Forgets it, so the next spec starts with no plugin keeping pipelines. */\nexport function removeStandInPipelineIndex(): void {\n  unregisterPluginServices(OWNER)\n}\n"],"names":["registerPluginRecordIndex","unregisterPluginServices","OWNER","standInPipelineIndex","pipelines","stood","asked","records","map","pipeline","id","name","facts","stages","list","request","push","slice","limit","truncated","length","get","find","record","pluginId","removeStandInPipelineIndex"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,yBAAyB,QAGpB,kDAAiD;AACxD,SAASC,wBAAwB,QAAQ,8CAA6C;AAEtF;;;;;;;CAOC,GAED,MAAMC,QAAQ;AAOd,2EAA2E,GAC3E,OAAO,SAASC,qBACdC,SAAsG;IAEtG,MAAMC,QAA8B;QAAEC,OAAO,EAAE;IAAC;IAChD,MAAMC,UAAiCH,UAAUI,GAAG,CAAC,CAACC,WAAc,CAAA;YAClEC,IAAID,SAASC,EAAE;YACfC,MAAMF,SAASE,IAAI;YACnBC,OAAO;gBAAEC,QAAQJ,SAASI,MAAM;YAAC;QACnC,CAAA;IACAb,0BACE,YACA;QACE,MAAMc,MAAKC,OAAO;YAChBV,MAAMC,KAAK,CAACU,IAAI,CAACD;YACjB,OAAO;gBAAER,SAASA,QAAQU,KAAK,CAAC,GAAGF,QAAQG,KAAK;gBAAGC,WAAWZ,QAAQa,MAAM,GAAGL,QAAQG,KAAK;YAAC;QAC/F;QACA,MAAMG,KAAIN,OAAO;gBAERR;YADPF,MAAMC,KAAK,CAACU,IAAI,CAACD;YACjB,QAAOR,gBAAAA,QAAQe,IAAI,CAAC,CAACC,SAAWA,OAAOb,EAAE,KAAKK,QAAQL,EAAE,aAAjDH,gBAAsD;QAC/D;IACF,GACA;QAAEiB,UAAUtB;IAAM;IAEpB,OAAOG;AACT;AAEA,0EAA0E,GAC1E,OAAO,SAASoB;IACdxB,yBAAyBC;AAC3B"}

package/src/lib/testing/stand-in-product-index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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.
+ */
+/** Registers both indexes, reading through `firestore`. */
+export declare function standInProductIndexes(firestore: FirebaseFirestore.Firestore): void;
+/** Forgets both, so the next spec starts with no plugin keeping products. */
+export declare function removeStandInProductIndexes(): void;

package/src/lib/testing/stand-in-product-index.js

@@ -0,0 +1,105 @@
+/**
+ * @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 { registerPluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
+import { unregisterPluginServices } from "@aglyn/aglyn/plugin-manager/plugin-services";
+/**
+ * The product and category indexes a plugin that keeps products publishes
+ * (AGL-3080), stood in over a spec's own Firestore double — this plugin may
+ * not load the commerce plugin that registers the real ones. It answers in
+ * the shape the commerce plugin's `product-record-index.ts` documents: live,
+ * named records only, with the product facts its docblock lists. What the
+ * commerce plugin itself answers is held in its own spec.
+ */ const OWNER = 'commerce';
+const str = (value)=>typeof value === 'string' ? value : '';
+const strings = (value)=>(Array.isArray(value) ? value : []).map(str).filter(Boolean);
+function product(id, data) {
+    var _data_seo;
+    if (!data || data['deletedAt'] != null || !str(data['name'])) return null;
+    const seo = (_data_seo = data['seo']) != null ? _data_seo : {};
+    const mediaUrls = Array.isArray(data['mediaUrls']) ? data['mediaUrls'] : [];
+    return {
+        id,
+        name: str(data['name']),
+        facts: {
+            type: data['type'],
+            description: str(data['description']),
+            tags: strings(data['tags']),
+            categoryIds: strings(data['categoryIds']),
+            options: (Array.isArray(data['options']) ? data['options'] : []).map((option)=>{
+                const record = option != null ? option : {};
+                return {
+                    name: str(record['name']),
+                    values: strings(record['values'])
+                };
+            }),
+            imageUrl: str(mediaUrls[0]) || str(data['imageUrl']) || null,
+            seoTitle: str(seo['title']),
+            seoDescription: str(seo['description'])
+        }
+    };
+}
+/** Registers both indexes, reading through `firestore`. */ export function standInProductIndexes(firestore) {
+    const site = (hostId, name)=>firestore.collection('hosts').doc(hostId).collection(name);
+    registerPluginRecordIndex('product', {
+        async list ({ hostId, limit }) {
+            if (!hostId) return {
+                records: [],
+                truncated: false
+            };
+            const snapshot = await site(hostId, 'products').limit(limit + 1).get();
+            const records = snapshot.docs.map((doc)=>product(doc.id, doc.data())).filter((record)=>record !== null);
+            return {
+                records: records.slice(0, limit),
+                truncated: snapshot.docs.length > limit
+            };
+        },
+        async get ({ hostId, id }) {
+            if (!hostId) return null;
+            const snapshot = await site(hostId, 'products').doc(id).get();
+            return snapshot.exists ? product(snapshot.id, snapshot.data()) : null;
+        }
+    }, {
+        pluginId: OWNER
+    });
+    registerPluginRecordIndex('productCategory', {
+        async list ({ hostId, limit }) {
+            if (!hostId) return {
+                records: [],
+                truncated: false
+            };
+            const snapshot = await site(hostId, 'productCategories').limit(limit + 1).get();
+            const records = snapshot.docs.map((doc)=>({
+                    id: doc.id,
+                    name: str(doc.get('name')),
+                    facts: {}
+                })).filter((record)=>record.name);
+            return {
+                records: records.slice(0, limit),
+                truncated: snapshot.docs.length > limit
+            };
+        },
+        async get () {
+            return null;
+        }
+    }, {
+        pluginId: OWNER
+    });
+}
+/** Forgets both, so the next spec starts with no plugin keeping products. */ export function removeStandInProductIndexes() {
+    unregisterPluginServices(OWNER);
+}
+
+//# sourceMappingURL=stand-in-product-index.js.map

package/src/lib/testing/stand-in-product-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/testing/stand-in-product-index.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  registerPluginRecordIndex,\n  type PluginIndexedRecord,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { unregisterPluginServices } from '@aglyn/aglyn/plugin-manager/plugin-services'\n\n/**\n * The product and category indexes a plugin that keeps products publishes\n * (AGL-3080), stood in over a spec's own Firestore double — this plugin may\n * not load the commerce plugin that registers the real ones. It answers in\n * the shape the commerce plugin's `product-record-index.ts` documents: live,\n * named records only, with the product facts its docblock lists. What the\n * commerce plugin itself answers is held in its own spec.\n */\n\nconst OWNER = 'commerce'\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value : '')\nconst strings = (value: unknown): string[] =>\n  (Array.isArray(value) ? value : []).map(str).filter(Boolean)\n\nfunction product(id: string, data: Record<string, unknown> | undefined): PluginIndexedRecord | null {\n  if (!data || data['deletedAt'] != null || !str(data['name'])) return null\n  const seo = (data['seo'] ?? {}) as Record<string, unknown>\n  const mediaUrls = Array.isArray(data['mediaUrls']) ? data['mediaUrls'] : []\n  return {\n    id,\n    name: str(data['name']),\n    facts: {\n      type: data['type'],\n      description: str(data['description']),\n      tags: strings(data['tags']),\n      categoryIds: strings(data['categoryIds']),\n      options: (Array.isArray(data['options']) ? data['options'] : []).map((option) => {\n        const record = (option ?? {}) as Record<string, unknown>\n        return { name: str(record['name']), values: strings(record['values']) }\n      }),\n      imageUrl: str(mediaUrls[0]) || str(data['imageUrl']) || null,\n      seoTitle: str(seo['title']),\n      seoDescription: str(seo['description']),\n    },\n  }\n}\n\n/** Registers both indexes, reading through `firestore`. */\nexport function standInProductIndexes(firestore: FirebaseFirestore.Firestore): void {\n  const site = (hostId: string, name: string) =>\n    firestore.collection('hosts').doc(hostId).collection(name)\n  registerPluginRecordIndex(\n    'product',\n    {\n      async list({ hostId, limit }) {\n        if (!hostId) return { records: [], truncated: false }\n        const snapshot = await site(hostId, 'products').limit(limit + 1).get()\n        const records = snapshot.docs\n          .map((doc) => product(doc.id, doc.data()))\n          .filter((record): record is PluginIndexedRecord => record !== null)\n        return { records: records.slice(0, limit), truncated: snapshot.docs.length > limit }\n      },\n      async get({ hostId, id }) {\n        if (!hostId) return null\n        const snapshot = await site(hostId, 'products').doc(id).get()\n        return snapshot.exists ? product(snapshot.id, snapshot.data()) : null\n      },\n    },\n    { pluginId: OWNER },\n  )\n  registerPluginRecordIndex(\n    'productCategory',\n    {\n      async list({ hostId, limit }) {\n        if (!hostId) return { records: [], truncated: false }\n        const snapshot = await site(hostId, 'productCategories').limit(limit + 1).get()\n        const records = snapshot.docs\n          .map((doc) => ({ id: doc.id, name: str(doc.get('name')), facts: {} }))\n          .filter((record) => record.name)\n        return { records: records.slice(0, limit), truncated: snapshot.docs.length > limit }\n      },\n      async get() {\n        return null\n      },\n    },\n    { pluginId: OWNER },\n  )\n}\n\n/** Forgets both, so the next spec starts with no plugin keeping products. */\nexport function removeStandInProductIndexes(): void {\n  unregisterPluginServices(OWNER)\n}\n"],"names":["registerPluginRecordIndex","unregisterPluginServices","OWNER","str","value","strings","Array","isArray","map","filter","Boolean","product","id","data","seo","mediaUrls","name","facts","type","description","tags","categoryIds","options","option","record","values","imageUrl","seoTitle","seoDescription","standInProductIndexes","firestore","site","hostId","collection","doc","list","limit","records","truncated","snapshot","get","docs","slice","length","exists","pluginId","removeStandInProductIndexes"],"mappings":"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"}

package/src/lib/tools/ai-component-tool.js

@@ -132,7 +132,7 @@ const ANSWER_MAX = 100;
                             },
                             defaultValue: {
                                 type: 'string',
-                                description: 'What the component shows until a page sets it: copy for text and richText, a screen id from the site inventory or "" for href, "" for image and icon, a number for number, "true" or "false" for boolean, one answer’s value for choice.'
+                                description: 'What the component shows until a page sets it: copy for text and richText, a page id from the site inventory or "" for href, "" for image and icon, a number for number, "true" or "false" for boolean, one answer’s value for choice.'
                             },
                             options: {
                                 type: 'array',
@@ -210,7 +210,7 @@ const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.
             return scope.screenIds.has(value) || isRootRelativePath(value) || isHttpsUrl(value) ? {
                 value
             } : {
-                error: 'is neither a screen id from the site inventory, a path on this site nor an https: address',
+                error: 'is neither a page id from the site inventory, a path on this site nor an https: address',
                 rule: 1
             };
         case 'number':

package/src/lib/tools/ai-component-tool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-component-tool.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 { parseMediaRef } from '@aglyn/aglyn/app-utils/media-ref'\nimport { COMPONENT_PROP_NAME_PATTERN } from '@aglyn/aglyn/app-utils/reusable-component-keys'\nimport { FieldComponentType } from '@aglyn/aglyn/foundation/definitions/components.types'\nimport type {\n  ReusableComponentProp,\n  ReusableComponentPropOption,\n  ReusableComponentPropType,\n  ReusableComponentPropValue,\n} from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport { REUSABLE_PROP_KINDS } from '@aglyn/aglyn/foundation/definitions/property-kinds'\nimport type { AiTool } from '../providers/contract'\nimport { aiDoctrineTreeTool } from '../runtime/ai-doctrine'\nimport type {\n  AiDoctrineRuleNumber,\n  AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { HOSTILE_TEXT, isHttpsUrl, isRootRelativePath } from '../runtime/ai-node-tree'\nimport { AI_TEXT_LIMITS } from '../runtime/ai-palette'\n\n/**\n * The tool a generated reusable component arrives through (AGL-2908), and\n * the reading of the properties it declares.\n *\n * ── The kinds are the Properties dialog's ────────────────────────────────\n *\n * FILE ▸ Properties… declares a property as one of `REUSABLE_PROP_KINDS`,\n * and so does this tool: the kinds it offers are that table less the ones\n * `AI_COMPONENT_PROP_KINDS_NOT_OFFERED` names, each with the reason it is\n * left out, and a spec holds the two in both directions. A kind added to the\n * dialog does not compile here until it is offered or given a reason.\n *\n * What is offered is what a generated element can carry and a brief can\n * fill: copy (Text, Long text), a picture (Image), a link (Link), an icon\n * the site owner picks (Icon), a number (Number), a switch or a part's\n * visibility (Yes / no), and a setting with fixed answers (Choice).\n *\n * ── A declaration as the dialog saves one ────────────────────────────────\n *\n * `readAiComponentProps` returns each property in the shape the dialog's\n * cleaner stores: trimmed, with only the fields its kind uses, and a default\n * in the kind's own type — a Yes / no a real `true` or `false`, a Number a\n * number. Every refusal is a building-rule finding the doctrine's re-ask\n * quotes by its path.\n */\n\ntype OfferedKind = 'text' | 'richText' | 'image' | 'href' | 'icon' | 'number' | 'boolean' | 'choice'\n\nconst STYLE_REASON =\n  'Styling comes from the theme and the component’s own styles (rules 5 and 12); a page restyles one placement with an override, not a property.'\nconst RECORD_REASON =\n  'A pick from the site’s own records is made where a page places the component (rule 8), never invented as a generated default.'\nconst PLUGIN_REASON =\n  'Plugin settings belong to the plugin’s own element, which a generated component never places.'\n\n/**\n * Why each property kind the dialog declares is not offered to a model.\n * Keyed by every kind outside the offered ones, so the table is complete by\n * type.\n */\nexport const AI_COMPONENT_PROP_KINDS_NOT_OFFERED: Readonly<\n  Record<Exclude<ReusableComponentPropType, OfferedKind>, string>\n> = {\n  [FieldComponentType.MARKDOWN]:\n    'Long text binds to the same formatted-document fields, with a default a brief can write.',\n  [FieldComponentType.DATA_TABLE]:\n    'A table is rows and columns a page fills in, not one value a brief describes.',\n  [FieldComponentType.SLIDER]:\n    'Number binds to every slider, without the range settings a Slider property must declare.',\n  [FieldComponentType.CHECKBOX]:\n    'Yes / no binds to every switch and single tick box, and no generated element offers a list of tick boxes.',\n  [FieldComponentType.RADIO]:\n    'Choice binds to every field Radio buttons binds to, with its answers checked in one place.',\n  [FieldComponentType.TOGGLE_BUTTON]:\n    'Choice binds to every field Toggle buttons binds to, with its answers checked in one place.',\n  [FieldComponentType.DUAL_LIST_SELECT]:\n    'A pick list holds several answers, and no generated element offers a field that takes several.',\n  [FieldComponentType.COLOR_PICKER]:\n    'Colors come from the theme (rule 5); a page recolors one placement with an override, not a property.',\n  [FieldComponentType.CSS_DIMENSION]: STYLE_REASON,\n  [FieldComponentType.CSS_BORDER]: STYLE_REASON,\n  [FieldComponentType.CSS_GRADIENT]: STYLE_REASON,\n  [FieldComponentType.BREAKPOINT_SPAN]: STYLE_REASON,\n  [FieldComponentType.PRESET_CHOICE]: STYLE_REASON,\n  [FieldComponentType.THEME_SCALE]: STYLE_REASON,\n  [FieldComponentType.DATE_PICKER]:\n    'A date is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',\n  [FieldComponentType.TIME_PICKER]:\n    'A time is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',\n  [FieldComponentType.NODE_SELECT]: RECORD_REASON,\n  [FieldComponentType.PRODUCT_SELECT]: RECORD_REASON,\n  [FieldComponentType.COLLECTION_SELECT]: RECORD_REASON,\n  [FieldComponentType.CATEGORY_SELECT]: RECORD_REASON,\n  [FieldComponentType.DATASET_SELECT]: RECORD_REASON,\n  [FieldComponentType.DATASET_FIELD_SELECT]: RECORD_REASON,\n  [FieldComponentType.FORM_SELECT]:\n    'A form is placed by its id from the Forms page (rule 3), never chosen through a generated property.',\n  [FieldComponentType.PLUGIN_SELECT]: PLUGIN_REASON,\n  [FieldComponentType.PLUGIN_SETTINGS]: PLUGIN_REASON,\n}\n\n/**\n * The kinds a generated component may declare: the dialog's table less the\n * kinds above, in the dialog's own order.\n */\nexport const AI_COMPONENT_PROP_KINDS: readonly OfferedKind[] = (\n  Object.keys(REUSABLE_PROP_KINDS) as ReusableComponentPropType[]\n).filter(\n  (type): type is OfferedKind =>\n    !Object.prototype.hasOwnProperty.call(AI_COMPONENT_PROP_KINDS_NOT_OFFERED, type),\n)\n\nexport type AiComponentPropKind = OfferedKind\n\n/**\n * The kinds a property proposed for a section already on a page may take\n * (AGL-3054): every offered kind but an Icon. That door reads each default off\n * the live field it binds, and an icon's default is drawn from a path the\n * picker stores beside its id, which the field it reads does not carry.\n */\nexport const AI_COMPONENT_SELECTION_PROP_KINDS: readonly AiComponentPropKind[] =\n  AI_COMPONENT_PROP_KINDS.filter((type) => type !== 'icon')\n\n/** The kinds as a model reads them: the stored type and the name a page reads. */\nexport function aiComponentPropKindWords(\n  kinds: readonly AiComponentPropKind[] = AI_COMPONENT_PROP_KINDS,\n): string {\n  return kinds.map((type) => `${type} (${REUSABLE_PROP_KINDS[type].label})`).join(', ')\n}\n\nexport const AI_COMPONENT_TOOL_NAME = 'submit_component'\n\n/** The most properties one generated component declares. */\nexport const AI_COMPONENT_MAX_PROPS = 20\n\nconst NAME_MAX = 40\nconst LABEL_MAX = 80\nconst HELP_MAX = 200\nconst ANSWER_MAX = 100\n\n/**\n * The strict tool a component arrives through: the doctrine's tree, as the\n * doctrine's own component tool carries it, and the properties beside it.\n * Every field of a property is required and flat, because optional\n * properties are not portable across strict tool implementations; a kind\n * that has no answers sends `[]`.\n */\nexport function aiComponentTool(): AiTool {\n  const doctrine = aiDoctrineTreeTool('component')\n  const tree = (doctrine.inputSchema as { properties: Record<string, unknown> }).properties['tree']\n  return {\n    name: AI_COMPONENT_TOOL_NAME,\n    description:\n      'Submit the reusable component: its tree as one flat node map, and every property the tree binds.',\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['tree', 'props'],\n      properties: {\n        tree,\n        props: {\n          type: 'array',\n          description:\n            'Every property the tree binds with {{prop.<name>}}, in the order a page sets them.',\n          items: {\n            type: 'object',\n            additionalProperties: false,\n            required: ['name', 'type', 'label', 'description', 'defaultValue', 'options'],\n            properties: {\n              name: {\n                type: 'string',\n                description:\n                  'Letters, digits and underscores, starting with a letter; bound as {{prop.<name>}}.',\n              },\n              type: {\n                type: 'string',\n                enum: [...AI_COMPONENT_PROP_KINDS],\n                description: `The kind, as type (the name a page reads): ${aiComponentPropKindWords()}.`,\n              },\n              label: { type: 'string', description: 'The words a page reads beside the field.' },\n              description: { type: 'string', description: 'Help beside the field, or \"\".' },\n              defaultValue: {\n                type: 'string',\n                description:\n                  'What the component shows until a page sets it: copy for text and richText, a screen id from the site inventory or \"\" for href, \"\" for image and icon, a number for number, \"true\" or \"false\" for boolean, one answer’s value for choice.',\n              },\n              options: {\n                type: 'array',\n                description: 'The answers of a choice; [] for every other kind.',\n                items: {\n                  type: 'object',\n                  additionalProperties: false,\n                  required: ['value', 'label'],\n                  properties: {\n                    value: {\n                      type: 'string',\n                      description: 'What the bound field receives: one of the values that field lists.',\n                    },\n                    label: { type: 'string', description: 'What a page picks.' },\n                  },\n                },\n              },\n            },\n          },\n        },\n      },\n    },\n  }\n}\n\nexport interface AiComponentPropsScope {\n  /** The screens a Link default may name: the site inventory's. */\n  screenIds: ReadonlySet<string>\n}\n\nexport interface AiComponentPropsReading {\n  /** Every property that could be read, as the Properties dialog stores one. */\n  props: ReusableComponentProp[]\n  /**\n   * The names of properties that were declared under a usable name and\n   * refused for something else — their kind, answers, default or label — so\n   * a check of the tree does not report their tokens a second time.\n   */\n  refused: string[]\n  violations: AiDoctrineViolation[]\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** A scalar the answer wrote, as trimmed text. */\nfunction scalar(value: unknown): string {\n  return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean'\n    ? String(value).trim()\n    : ''\n}\n\ntype DefaultReading =\n  | { value: ReusableComponentPropValue | undefined }\n  | { error: string; rule: AiDoctrineRuleNumber }\n\n/** A default as the kind stores it, or why it cannot be one. */\nfunction readDefault(\n  type: OfferedKind,\n  raw: unknown,\n  options: readonly ReusableComponentPropOption[],\n  scope: AiComponentPropsScope,\n): DefaultReading {\n  const value = scalar(raw)\n  if (HOSTILE_TEXT.test(value)) return { error: 'carries markup or script', rule: 1 }\n  // Nothing set is a default of its own: the kind's \"not set\".\n  if (!value) return { value: undefined }\n  switch (type) {\n    case 'text':\n    case 'richText':\n      return value.length > AI_TEXT_LIMITS.body\n        ? { error: `runs past ${AI_TEXT_LIMITS.body} characters`, rule: 1 }\n        : { value }\n    case 'icon':\n      // The picker stores an icon with the drawing a model cannot name, so\n      // the site owner picks it where a page places the component.\n      return { error: 'is an icon, which the site owner picks; leave it \"\"', rule: 1 }\n    case 'image':\n      if (/^https?:\\/\\//i.test(value)) {\n        return { error: 'links a picture from another website; leave it empty for an upload', rule: 9 }\n      }\n      return parseMediaRef(value)\n        ? { value }\n        : { error: 'is not a picture from the media library; leave it empty for an upload', rule: 9 }\n    case 'href':\n      return scope.screenIds.has(value) || isRootRelativePath(value) || isHttpsUrl(value)\n        ? { value }\n        : {\n            error: 'is neither a screen id from the site inventory, a path on this site nor an https: address',\n            rule: 1,\n          }\n    case 'number': {\n      const parsed = Number(value)\n      return Number.isFinite(parsed) ? { value: parsed } : { error: 'is not a number', rule: 1 }\n    }\n    case 'boolean':\n      if (value === 'true') return { value: true }\n      if (value === 'false') return { value: false }\n      return { error: 'is neither true nor false', rule: 1 }\n    case 'choice':\n      return options.some((option) => option.value === value)\n        ? { value }\n        : { error: 'is not the value of one of its answers', rule: 1 }\n  }\n}\n\n/**\n * The properties a component answer declares, read into the shape the\n * Properties dialog stores, with a finding for everything that would not\n * save there or would not read as the brief's own copy.\n */\nexport function readAiComponentProps(\n  answer: Record<string, unknown>,\n  scope: AiComponentPropsScope,\n): AiComponentPropsReading {\n  const raw = answer['props']\n  if (!Array.isArray(raw)) {\n    return {\n      props: [],\n      refused: [],\n      violations: [\n        {\n          rule: 1,\n          code: 'props-missing',\n          message:\n            'The component came without its list of properties. Declare every property the tree binds, or an empty list.',\n          paths: ['props'],\n        },\n      ],\n    }\n  }\n  const violations: AiDoctrineViolation[] = []\n  const finding = (\n    code: string,\n    message: string,\n    path: string,\n    rule: AiDoctrineRuleNumber = 1,\n  ): void => {\n    violations.push({ rule, code, message, paths: [path] })\n  }\n  if (raw.length > AI_COMPONENT_MAX_PROPS) {\n    finding(\n      'props-over-limit',\n      `The component declares ${raw.length} properties, and one component declares at most ${AI_COMPONENT_MAX_PROPS}. Keep a property for each value that differs between placements.`,\n      'props',\n    )\n  }\n  const kindNames = AI_COMPONENT_PROP_KINDS.map((type) => REUSABLE_PROP_KINDS[type].label)\n  const props: ReusableComponentProp[] = []\n  const seen = new Set<string>()\n  raw.slice(0, AI_COMPONENT_MAX_PROPS).forEach((entry, index) => {\n    const at = `props[${index}]`\n    if (!isRecord(entry)) {\n      finding('prop-shape', 'A property could not be read. Give each one a name, a kind and a default.', at)\n      return\n    }\n    const name = scalar(entry['name'])\n    const called = name ? `\"${name}\"` : `number ${index + 1}`\n    if (!COMPONENT_PROP_NAME_PATTERN.test(name) || name.length > NAME_MAX) {\n      finding(\n        'prop-name',\n        `The property ${called} is not a name a property can have. Use letters, digits and underscores, starting with a letter, in ${NAME_MAX} characters or fewer.`,\n        `${at}.name`,\n      )\n      return\n    }\n    if (seen.has(name)) {\n      finding('prop-duplicate', `Two properties are named \"${name}\". Give each property its own name.`, `${at}.name`)\n      return\n    }\n    seen.add(name)\n    const type = scalar(entry['type']) as OfferedKind\n    if (!AI_COMPONENT_PROP_KINDS.includes(type)) {\n      finding(\n        'prop-kind',\n        `The property \"${name}\" is a kind a generated component does not declare. Use one of: ${kindNames.join(', ')}.`,\n        `${at}.type`,\n      )\n      return\n    }\n    const options: ReusableComponentPropOption[] = []\n    if (type === 'choice') {\n      const answers = Array.isArray(entry['options']) ? entry['options'] : []\n      const values = new Set<string>()\n      for (const option of answers) {\n        const value = isRecord(option) ? scalar(option['value']).slice(0, ANSWER_MAX) : ''\n        const label = isRecord(option) ? scalar(option['label']).slice(0, LABEL_MAX) : ''\n        if (!value || HOSTILE_TEXT.test(value) || HOSTILE_TEXT.test(label)) {\n          finding('prop-answers', `Every answer of \"${name}\" needs a plain value.`, `${at}.options`)\n          return\n        }\n        if (values.has(value)) {\n          finding('prop-answers', `Two answers of \"${name}\" share the value \"${value}\".`, `${at}.options`)\n          return\n        }\n        values.add(value)\n        options.push({ value, ...(label && label !== value ? { label } : {}) })\n      }\n      if (!options.length) {\n        finding(\n          'prop-answers',\n          `The Choice \"${name}\" lists no answers. Give it the answers a page picks from.`,\n          `${at}.options`,\n        )\n        return\n      }\n    }\n    const read = readDefault(type, entry['defaultValue'], options, scope)\n    if ('error' in read) {\n      finding('prop-default', `The default of \"${name}\" ${read.error}.`, `${at}.defaultValue`, read.rule)\n      return\n    }\n    const label = scalar(entry['label']).slice(0, LABEL_MAX)\n    const description = scalar(entry['description']).slice(0, HELP_MAX)\n    if (HOSTILE_TEXT.test(label) || HOSTILE_TEXT.test(description)) {\n      finding('prop-shape', `The label or help of \"${name}\" carries markup or script.`, at)\n      return\n    }\n    props.push({\n      name,\n      type,\n      ...(label ? { label } : {}),\n      ...(description ? { description } : {}),\n      ...(read.value !== undefined ? { defaultValue: read.value } : {}),\n      ...(type === 'choice' ? { options } : {}),\n    })\n  })\n  // A name that read, and was then refused for its kind, answers, default or label.\n  const refused = [...seen].filter((name) => !props.some((prop) => prop.name === name))\n  return { props, refused, violations }\n}\n"],"names":["parseMediaRef","COMPONENT_PROP_NAME_PATTERN","FieldComponentType","REUSABLE_PROP_KINDS","aiDoctrineTreeTool","HOSTILE_TEXT","isHttpsUrl","isRootRelativePath","AI_TEXT_LIMITS","STYLE_REASON","RECORD_REASON","PLUGIN_REASON","AI_COMPONENT_PROP_KINDS_NOT_OFFERED","MARKDOWN","DATA_TABLE","SLIDER","CHECKBOX","RADIO","TOGGLE_BUTTON","DUAL_LIST_SELECT","COLOR_PICKER","CSS_DIMENSION","CSS_BORDER","CSS_GRADIENT","BREAKPOINT_SPAN","PRESET_CHOICE","THEME_SCALE","DATE_PICKER","TIME_PICKER","NODE_SELECT","PRODUCT_SELECT","COLLECTION_SELECT","CATEGORY_SELECT","DATASET_SELECT","DATASET_FIELD_SELECT","FORM_SELECT","PLUGIN_SELECT","PLUGIN_SETTINGS","AI_COMPONENT_PROP_KINDS","Object","keys","filter","type","prototype","hasOwnProperty","call","AI_COMPONENT_SELECTION_PROP_KINDS","aiComponentPropKindWords","kinds","map","label","join","AI_COMPONENT_TOOL_NAME","AI_COMPONENT_MAX_PROPS","NAME_MAX","LABEL_MAX","HELP_MAX","ANSWER_MAX","aiComponentTool","doctrine","tree","inputSchema","properties","name","description","strict","additionalProperties","required","props","items","enum","defaultValue","options","value","isRecord","Array","isArray","scalar","String","trim","readDefault","raw","scope","test","error","rule","undefined","length","body","screenIds","has","parsed","Number","isFinite","some","option","readAiComponentProps","answer","refused","violations","code","message","paths","finding","path","push","kindNames","seen","Set","slice","forEach","entry","index","at","called","add","includes","answers","values","read","prop"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-component-tool.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 { parseMediaRef } from '@aglyn/aglyn/app-utils/media-ref'\nimport { COMPONENT_PROP_NAME_PATTERN } from '@aglyn/aglyn/app-utils/reusable-component-keys'\nimport { FieldComponentType } from '@aglyn/aglyn/foundation/definitions/components.types'\nimport type {\n  ReusableComponentProp,\n  ReusableComponentPropOption,\n  ReusableComponentPropType,\n  ReusableComponentPropValue,\n} from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport { REUSABLE_PROP_KINDS } from '@aglyn/aglyn/foundation/definitions/property-kinds'\nimport type { AiTool } from '../providers/contract'\nimport { aiDoctrineTreeTool } from '../runtime/ai-doctrine'\nimport type {\n  AiDoctrineRuleNumber,\n  AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { HOSTILE_TEXT, isHttpsUrl, isRootRelativePath } from '../runtime/ai-node-tree'\nimport { AI_TEXT_LIMITS } from '../runtime/ai-palette'\n\n/**\n * The tool a generated reusable component arrives through (AGL-2908), and\n * the reading of the properties it declares.\n *\n * ── The kinds are the Properties dialog's ────────────────────────────────\n *\n * FILE ▸ Properties… declares a property as one of `REUSABLE_PROP_KINDS`,\n * and so does this tool: the kinds it offers are that table less the ones\n * `AI_COMPONENT_PROP_KINDS_NOT_OFFERED` names, each with the reason it is\n * left out, and a spec holds the two in both directions. A kind added to the\n * dialog does not compile here until it is offered or given a reason.\n *\n * What is offered is what a generated element can carry and a brief can\n * fill: copy (Text, Long text), a picture (Image), a link (Link), an icon\n * the site owner picks (Icon), a number (Number), a switch or a part's\n * visibility (Yes / no), and a setting with fixed answers (Choice).\n *\n * ── A declaration as the dialog saves one ────────────────────────────────\n *\n * `readAiComponentProps` returns each property in the shape the dialog's\n * cleaner stores: trimmed, with only the fields its kind uses, and a default\n * in the kind's own type — a Yes / no a real `true` or `false`, a Number a\n * number. Every refusal is a building-rule finding the doctrine's re-ask\n * quotes by its path.\n */\n\ntype OfferedKind = 'text' | 'richText' | 'image' | 'href' | 'icon' | 'number' | 'boolean' | 'choice'\n\nconst STYLE_REASON =\n  'Styling comes from the theme and the component’s own styles (rules 5 and 12); a page restyles one placement with an override, not a property.'\nconst RECORD_REASON =\n  'A pick from the site’s own records is made where a page places the component (rule 8), never invented as a generated default.'\nconst PLUGIN_REASON =\n  'Plugin settings belong to the plugin’s own element, which a generated component never places.'\n\n/**\n * Why each property kind the dialog declares is not offered to a model.\n * Keyed by every kind outside the offered ones, so the table is complete by\n * type.\n */\nexport const AI_COMPONENT_PROP_KINDS_NOT_OFFERED: Readonly<\n  Record<Exclude<ReusableComponentPropType, OfferedKind>, string>\n> = {\n  [FieldComponentType.MARKDOWN]:\n    'Long text binds to the same formatted-document fields, with a default a brief can write.',\n  [FieldComponentType.DATA_TABLE]:\n    'A table is rows and columns a page fills in, not one value a brief describes.',\n  [FieldComponentType.SLIDER]:\n    'Number binds to every slider, without the range settings a Slider property must declare.',\n  [FieldComponentType.CHECKBOX]:\n    'Yes / no binds to every switch and single tick box, and no generated element offers a list of tick boxes.',\n  [FieldComponentType.RADIO]:\n    'Choice binds to every field Radio buttons binds to, with its answers checked in one place.',\n  [FieldComponentType.TOGGLE_BUTTON]:\n    'Choice binds to every field Toggle buttons binds to, with its answers checked in one place.',\n  [FieldComponentType.DUAL_LIST_SELECT]:\n    'A pick list holds several answers, and no generated element offers a field that takes several.',\n  [FieldComponentType.COLOR_PICKER]:\n    'Colors come from the theme (rule 5); a page recolors one placement with an override, not a property.',\n  [FieldComponentType.CSS_DIMENSION]: STYLE_REASON,\n  [FieldComponentType.CSS_BORDER]: STYLE_REASON,\n  [FieldComponentType.CSS_GRADIENT]: STYLE_REASON,\n  [FieldComponentType.BREAKPOINT_SPAN]: STYLE_REASON,\n  [FieldComponentType.PRESET_CHOICE]: STYLE_REASON,\n  [FieldComponentType.THEME_SCALE]: STYLE_REASON,\n  [FieldComponentType.DATE_PICKER]:\n    'A date is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',\n  [FieldComponentType.TIME_PICKER]:\n    'A time is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',\n  [FieldComponentType.NODE_SELECT]: RECORD_REASON,\n  [FieldComponentType.PRODUCT_SELECT]: RECORD_REASON,\n  [FieldComponentType.COLLECTION_SELECT]: RECORD_REASON,\n  [FieldComponentType.CATEGORY_SELECT]: RECORD_REASON,\n  [FieldComponentType.DATASET_SELECT]: RECORD_REASON,\n  [FieldComponentType.DATASET_FIELD_SELECT]: RECORD_REASON,\n  [FieldComponentType.FORM_SELECT]:\n    'A form is placed by its id from the Forms page (rule 3), never chosen through a generated property.',\n  [FieldComponentType.PLUGIN_SELECT]: PLUGIN_REASON,\n  [FieldComponentType.PLUGIN_SETTINGS]: PLUGIN_REASON,\n}\n\n/**\n * The kinds a generated component may declare: the dialog's table less the\n * kinds above, in the dialog's own order.\n */\nexport const AI_COMPONENT_PROP_KINDS: readonly OfferedKind[] = (\n  Object.keys(REUSABLE_PROP_KINDS) as ReusableComponentPropType[]\n).filter(\n  (type): type is OfferedKind =>\n    !Object.prototype.hasOwnProperty.call(AI_COMPONENT_PROP_KINDS_NOT_OFFERED, type),\n)\n\nexport type AiComponentPropKind = OfferedKind\n\n/**\n * The kinds a property proposed for a section already on a page may take\n * (AGL-3054): every offered kind but an Icon. That door reads each default off\n * the live field it binds, and an icon's default is drawn from a path the\n * picker stores beside its id, which the field it reads does not carry.\n */\nexport const AI_COMPONENT_SELECTION_PROP_KINDS: readonly AiComponentPropKind[] =\n  AI_COMPONENT_PROP_KINDS.filter((type) => type !== 'icon')\n\n/** The kinds as a model reads them: the stored type and the name a page reads. */\nexport function aiComponentPropKindWords(\n  kinds: readonly AiComponentPropKind[] = AI_COMPONENT_PROP_KINDS,\n): string {\n  return kinds.map((type) => `${type} (${REUSABLE_PROP_KINDS[type].label})`).join(', ')\n}\n\nexport const AI_COMPONENT_TOOL_NAME = 'submit_component'\n\n/** The most properties one generated component declares. */\nexport const AI_COMPONENT_MAX_PROPS = 20\n\nconst NAME_MAX = 40\nconst LABEL_MAX = 80\nconst HELP_MAX = 200\nconst ANSWER_MAX = 100\n\n/**\n * The strict tool a component arrives through: the doctrine's tree, as the\n * doctrine's own component tool carries it, and the properties beside it.\n * Every field of a property is required and flat, because optional\n * properties are not portable across strict tool implementations; a kind\n * that has no answers sends `[]`.\n */\nexport function aiComponentTool(): AiTool {\n  const doctrine = aiDoctrineTreeTool('component')\n  const tree = (doctrine.inputSchema as { properties: Record<string, unknown> }).properties['tree']\n  return {\n    name: AI_COMPONENT_TOOL_NAME,\n    description:\n      'Submit the reusable component: its tree as one flat node map, and every property the tree binds.',\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['tree', 'props'],\n      properties: {\n        tree,\n        props: {\n          type: 'array',\n          description:\n            'Every property the tree binds with {{prop.<name>}}, in the order a page sets them.',\n          items: {\n            type: 'object',\n            additionalProperties: false,\n            required: ['name', 'type', 'label', 'description', 'defaultValue', 'options'],\n            properties: {\n              name: {\n                type: 'string',\n                description:\n                  'Letters, digits and underscores, starting with a letter; bound as {{prop.<name>}}.',\n              },\n              type: {\n                type: 'string',\n                enum: [...AI_COMPONENT_PROP_KINDS],\n                description: `The kind, as type (the name a page reads): ${aiComponentPropKindWords()}.`,\n              },\n              label: { type: 'string', description: 'The words a page reads beside the field.' },\n              description: { type: 'string', description: 'Help beside the field, or \"\".' },\n              defaultValue: {\n                type: 'string',\n                description:\n                  'What the component shows until a page sets it: copy for text and richText, a page id from the site inventory or \"\" for href, \"\" for image and icon, a number for number, \"true\" or \"false\" for boolean, one answer’s value for choice.',\n              },\n              options: {\n                type: 'array',\n                description: 'The answers of a choice; [] for every other kind.',\n                items: {\n                  type: 'object',\n                  additionalProperties: false,\n                  required: ['value', 'label'],\n                  properties: {\n                    value: {\n                      type: 'string',\n                      description: 'What the bound field receives: one of the values that field lists.',\n                    },\n                    label: { type: 'string', description: 'What a page picks.' },\n                  },\n                },\n              },\n            },\n          },\n        },\n      },\n    },\n  }\n}\n\nexport interface AiComponentPropsScope {\n  /** The screens a Link default may name: the site inventory's. */\n  screenIds: ReadonlySet<string>\n}\n\nexport interface AiComponentPropsReading {\n  /** Every property that could be read, as the Properties dialog stores one. */\n  props: ReusableComponentProp[]\n  /**\n   * The names of properties that were declared under a usable name and\n   * refused for something else — their kind, answers, default or label — so\n   * a check of the tree does not report their tokens a second time.\n   */\n  refused: string[]\n  violations: AiDoctrineViolation[]\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/** A scalar the answer wrote, as trimmed text. */\nfunction scalar(value: unknown): string {\n  return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean'\n    ? String(value).trim()\n    : ''\n}\n\ntype DefaultReading =\n  | { value: ReusableComponentPropValue | undefined }\n  | { error: string; rule: AiDoctrineRuleNumber }\n\n/** A default as the kind stores it, or why it cannot be one. */\nfunction readDefault(\n  type: OfferedKind,\n  raw: unknown,\n  options: readonly ReusableComponentPropOption[],\n  scope: AiComponentPropsScope,\n): DefaultReading {\n  const value = scalar(raw)\n  if (HOSTILE_TEXT.test(value)) return { error: 'carries markup or script', rule: 1 }\n  // Nothing set is a default of its own: the kind's \"not set\".\n  if (!value) return { value: undefined }\n  switch (type) {\n    case 'text':\n    case 'richText':\n      return value.length > AI_TEXT_LIMITS.body\n        ? { error: `runs past ${AI_TEXT_LIMITS.body} characters`, rule: 1 }\n        : { value }\n    case 'icon':\n      // The picker stores an icon with the drawing a model cannot name, so\n      // the site owner picks it where a page places the component.\n      return { error: 'is an icon, which the site owner picks; leave it \"\"', rule: 1 }\n    case 'image':\n      if (/^https?:\\/\\//i.test(value)) {\n        return { error: 'links a picture from another website; leave it empty for an upload', rule: 9 }\n      }\n      return parseMediaRef(value)\n        ? { value }\n        : { error: 'is not a picture from the media library; leave it empty for an upload', rule: 9 }\n    case 'href':\n      return scope.screenIds.has(value) || isRootRelativePath(value) || isHttpsUrl(value)\n        ? { value }\n        : {\n            error: 'is neither a page id from the site inventory, a path on this site nor an https: address',\n            rule: 1,\n          }\n    case 'number': {\n      const parsed = Number(value)\n      return Number.isFinite(parsed) ? { value: parsed } : { error: 'is not a number', rule: 1 }\n    }\n    case 'boolean':\n      if (value === 'true') return { value: true }\n      if (value === 'false') return { value: false }\n      return { error: 'is neither true nor false', rule: 1 }\n    case 'choice':\n      return options.some((option) => option.value === value)\n        ? { value }\n        : { error: 'is not the value of one of its answers', rule: 1 }\n  }\n}\n\n/**\n * The properties a component answer declares, read into the shape the\n * Properties dialog stores, with a finding for everything that would not\n * save there or would not read as the brief's own copy.\n */\nexport function readAiComponentProps(\n  answer: Record<string, unknown>,\n  scope: AiComponentPropsScope,\n): AiComponentPropsReading {\n  const raw = answer['props']\n  if (!Array.isArray(raw)) {\n    return {\n      props: [],\n      refused: [],\n      violations: [\n        {\n          rule: 1,\n          code: 'props-missing',\n          message:\n            'The component came without its list of properties. Declare every property the tree binds, or an empty list.',\n          paths: ['props'],\n        },\n      ],\n    }\n  }\n  const violations: AiDoctrineViolation[] = []\n  const finding = (\n    code: string,\n    message: string,\n    path: string,\n    rule: AiDoctrineRuleNumber = 1,\n  ): void => {\n    violations.push({ rule, code, message, paths: [path] })\n  }\n  if (raw.length > AI_COMPONENT_MAX_PROPS) {\n    finding(\n      'props-over-limit',\n      `The component declares ${raw.length} properties, and one component declares at most ${AI_COMPONENT_MAX_PROPS}. Keep a property for each value that differs between placements.`,\n      'props',\n    )\n  }\n  const kindNames = AI_COMPONENT_PROP_KINDS.map((type) => REUSABLE_PROP_KINDS[type].label)\n  const props: ReusableComponentProp[] = []\n  const seen = new Set<string>()\n  raw.slice(0, AI_COMPONENT_MAX_PROPS).forEach((entry, index) => {\n    const at = `props[${index}]`\n    if (!isRecord(entry)) {\n      finding('prop-shape', 'A property could not be read. Give each one a name, a kind and a default.', at)\n      return\n    }\n    const name = scalar(entry['name'])\n    const called = name ? `\"${name}\"` : `number ${index + 1}`\n    if (!COMPONENT_PROP_NAME_PATTERN.test(name) || name.length > NAME_MAX) {\n      finding(\n        'prop-name',\n        `The property ${called} is not a name a property can have. Use letters, digits and underscores, starting with a letter, in ${NAME_MAX} characters or fewer.`,\n        `${at}.name`,\n      )\n      return\n    }\n    if (seen.has(name)) {\n      finding('prop-duplicate', `Two properties are named \"${name}\". Give each property its own name.`, `${at}.name`)\n      return\n    }\n    seen.add(name)\n    const type = scalar(entry['type']) as OfferedKind\n    if (!AI_COMPONENT_PROP_KINDS.includes(type)) {\n      finding(\n        'prop-kind',\n        `The property \"${name}\" is a kind a generated component does not declare. Use one of: ${kindNames.join(', ')}.`,\n        `${at}.type`,\n      )\n      return\n    }\n    const options: ReusableComponentPropOption[] = []\n    if (type === 'choice') {\n      const answers = Array.isArray(entry['options']) ? entry['options'] : []\n      const values = new Set<string>()\n      for (const option of answers) {\n        const value = isRecord(option) ? scalar(option['value']).slice(0, ANSWER_MAX) : ''\n        const label = isRecord(option) ? scalar(option['label']).slice(0, LABEL_MAX) : ''\n        if (!value || HOSTILE_TEXT.test(value) || HOSTILE_TEXT.test(label)) {\n          finding('prop-answers', `Every answer of \"${name}\" needs a plain value.`, `${at}.options`)\n          return\n        }\n        if (values.has(value)) {\n          finding('prop-answers', `Two answers of \"${name}\" share the value \"${value}\".`, `${at}.options`)\n          return\n        }\n        values.add(value)\n        options.push({ value, ...(label && label !== value ? { label } : {}) })\n      }\n      if (!options.length) {\n        finding(\n          'prop-answers',\n          `The Choice \"${name}\" lists no answers. Give it the answers a page picks from.`,\n          `${at}.options`,\n        )\n        return\n      }\n    }\n    const read = readDefault(type, entry['defaultValue'], options, scope)\n    if ('error' in read) {\n      finding('prop-default', `The default of \"${name}\" ${read.error}.`, `${at}.defaultValue`, read.rule)\n      return\n    }\n    const label = scalar(entry['label']).slice(0, LABEL_MAX)\n    const description = scalar(entry['description']).slice(0, HELP_MAX)\n    if (HOSTILE_TEXT.test(label) || HOSTILE_TEXT.test(description)) {\n      finding('prop-shape', `The label or help of \"${name}\" carries markup or script.`, at)\n      return\n    }\n    props.push({\n      name,\n      type,\n      ...(label ? { label } : {}),\n      ...(description ? { description } : {}),\n      ...(read.value !== undefined ? { defaultValue: read.value } : {}),\n      ...(type === 'choice' ? { options } : {}),\n    })\n  })\n  // A name that read, and was then refused for its kind, answers, default or label.\n  const refused = [...seen].filter((name) => !props.some((prop) => prop.name === name))\n  return { props, refused, violations }\n}\n"],"names":["parseMediaRef","COMPONENT_PROP_NAME_PATTERN","FieldComponentType","REUSABLE_PROP_KINDS","aiDoctrineTreeTool","HOSTILE_TEXT","isHttpsUrl","isRootRelativePath","AI_TEXT_LIMITS","STYLE_REASON","RECORD_REASON","PLUGIN_REASON","AI_COMPONENT_PROP_KINDS_NOT_OFFERED","MARKDOWN","DATA_TABLE","SLIDER","CHECKBOX","RADIO","TOGGLE_BUTTON","DUAL_LIST_SELECT","COLOR_PICKER","CSS_DIMENSION","CSS_BORDER","CSS_GRADIENT","BREAKPOINT_SPAN","PRESET_CHOICE","THEME_SCALE","DATE_PICKER","TIME_PICKER","NODE_SELECT","PRODUCT_SELECT","COLLECTION_SELECT","CATEGORY_SELECT","DATASET_SELECT","DATASET_FIELD_SELECT","FORM_SELECT","PLUGIN_SELECT","PLUGIN_SETTINGS","AI_COMPONENT_PROP_KINDS","Object","keys","filter","type","prototype","hasOwnProperty","call","AI_COMPONENT_SELECTION_PROP_KINDS","aiComponentPropKindWords","kinds","map","label","join","AI_COMPONENT_TOOL_NAME","AI_COMPONENT_MAX_PROPS","NAME_MAX","LABEL_MAX","HELP_MAX","ANSWER_MAX","aiComponentTool","doctrine","tree","inputSchema","properties","name","description","strict","additionalProperties","required","props","items","enum","defaultValue","options","value","isRecord","Array","isArray","scalar","String","trim","readDefault","raw","scope","test","error","rule","undefined","length","body","screenIds","has","parsed","Number","isFinite","some","option","readAiComponentProps","answer","refused","violations","code","message","paths","finding","path","push","kindNames","seen","Set","slice","forEach","entry","index","at","called","add","includes","answers","values","read","prop"],"mappings":"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"}

package/src/lib/tools/ai-duplicate-resource-tool.js

@@ -40,7 +40,7 @@ import { getOrgForUser, memberHasPermissionOnHost } from "@aglyn/tenant-data-adm
  */ export const AI_DUPLICATE_RESOURCE_TOOL_NAME = 'duplicate_resource';
 /** The structured-output tool a generation offers the model. */ export const AI_DUPLICATE_RESOURCE_TOOL = {
     name: AI_DUPLICATE_RESOURCE_TOOL_NAME,
-    description: 'Copy a resource this site already has — a screen, an email design, a component, a layout, ' + 'a template, a form or a workflow — as a new draft to build from, instead of creating it again. ' + 'The copy is unpublished: it has no address, runs nothing and is placed nowhere until a person does.',
+    description: 'Copy a resource this site already has — a page (kind "screen"), an email design, a component, a layout, ' + 'a template, a form or a workflow — as a new draft to build from, instead of creating it again. ' + 'The copy is unpublished: it has no address, runs nothing and is placed nowhere until a person does.',
     inputSchema: {
         type: 'object',
         properties: {

package/src/lib/tools/ai-duplicate-resource-tool.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-duplicate-resource-tool.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  DUPLICABLE_HOST_RESOURCE_KINDS,\n  DUPLICATE_NAME_MAX,\n  isDuplicableHostResourceKind,\n  type DuplicableHostResourceKind,\n} from '@aglyn/aglyn/app-utils/duplicate-resource'\nimport { hostRoleCanWrite } from '@aglyn/aglyn/app-utils/organizations'\nimport { orgPermissionLabel } from '@aglyn/aglyn/app-utils/org-permissions'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport {\n  getOrgForUser,\n  memberHasPermissionOnHost,\n} from '@aglyn/tenant-data-admin/server/organizations'\nimport type { AiTool } from '../providers/contract'\nimport type { AiGateContext } from '../runtime/ai-gate'\n\n/**\n * The `duplicate_resource` tool (AGL-2936, AGL-2984): a model that would\n * rebuild something the site already has copies it instead, through core's\n * `duplicateResource` — the same copy the row menus and the console door\n * make, with the same uniqueness rules, the same band arithmetic and the same\n * activity rows.\n *\n * It spends no tokens of its own, so it calls no provider: it runs inside a\n * door or a job step that has already climbed `aiGateLadder`, and takes that\n * ladder's context as its proof — the caller is signed in and verified, the\n * release flag, entitlement and lockdown rungs admitted the request, and the\n * workspace's band and caps admitted a reservation. On top of that it asks\n * what a copy needs whichever door called it: `ai.generate`, because a copy\n * is a generation's output, and a host role that may write the site, because\n * the copy lands there.\n *\n * DRAFTS ONLY, by construction of the copy: a screen copy has no route, a\n * workflow copy no trigger, and nothing places a component, layout or form\n * copy until a person does.\n */\n\nexport const AI_DUPLICATE_RESOURCE_TOOL_NAME = 'duplicate_resource'\n\n/** The structured-output tool a generation offers the model. */\nexport const AI_DUPLICATE_RESOURCE_TOOL: AiTool = {\n  name: AI_DUPLICATE_RESOURCE_TOOL_NAME,\n  description:\n    'Copy a resource this site already has — a screen, an email design, a component, a layout, ' +\n    'a template, a form or a workflow — as a new draft to build from, instead of creating it again. ' +\n    'The copy is unpublished: it has no address, runs nothing and is placed nowhere until a person does.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      kind: {\n        type: 'string',\n        enum: [...DUPLICABLE_HOST_RESOURCE_KINDS],\n        description: 'The kind of resource to copy.',\n      },\n      sourceId: {\n        type: 'string',\n        description: 'The id of the resource to copy, as the site inventory lists it.',\n      },\n      name: {\n        type: ['string', 'null'],\n        description: `The copy's name, at most ${DUPLICATE_NAME_MAX} characters, or null for \"Copy of\" the source's name.`,\n      },\n    },\n    required: ['kind', 'sourceId', 'name'],\n    additionalProperties: false,\n  },\n  strict: true,\n}\n\n/** A tool call's input, read. */\nexport type AiDuplicateResourceInput = {\n  kind: DuplicableHostResourceKind\n  sourceId: string\n  name: string | null\n}\n\n/** What the tool answers: the copy, or a refusal the caller can relay. */\nexport type AiDuplicateResourceOutcome =\n  | { ok: true; kind: DuplicableHostResourceKind; id: string; versionId: string | null; name: string }\n  | { ok: false; status: number; error: string }\n\n/** Reads a tool call's input; `null` when it is not one this tool accepts. */\nexport function parseAiDuplicateResourceInput(\n  input: Record<string, unknown>,\n): AiDuplicateResourceInput | null {\n  const kind = input['kind']\n  const sourceId = typeof input['sourceId'] === 'string' ? input['sourceId'].trim() : ''\n  const name = input['name']\n  if (!isDuplicableHostResourceKind(kind)) return null\n  if (!sourceId || sourceId.length > 64 || sourceId.includes('/')) return null\n  if (name !== null && typeof name !== 'string') return null\n  const trimmed = typeof name === 'string' ? name.trim().slice(0, DUPLICATE_NAME_MAX) : ''\n  return { kind, sourceId, name: trimmed || null }\n}\n\n/**\n * Makes the copy on `hostId` for the person the gate admitted. Refusals are\n * outcomes, never throws: a model's call that names a missing source or a\n * full band is an answer to relay, not a fault.\n */\nexport async function runAiDuplicateResourceTool(\n  context: { gate: AiGateContext; hostId: string },\n  input: Record<string, unknown>,\n): Promise<AiDuplicateResourceOutcome> {\n  const { gate } = context\n  const hostId = String(context.hostId ?? '').trim()\n  const parsed = parseAiDuplicateResourceInput(input)\n  if (!parsed) return { ok: false, status: 400, error: 'That is not a resource this site can copy' }\n  if (!gate.reservation?.allowed) {\n    return { ok: false, status: 429, error: 'This workspace cannot run AI requests right now' }\n  }\n  if (!hostId) return { ok: false, status: 400, error: 'Name the site to copy on' }\n\n  const host = await gate.firestore.collection('hosts').doc(hostId).get()\n  // A site of another workspace is a site this request cannot see.\n  if (!host.exists || host.get('orgId') !== gate.orgId) {\n    return { ok: false, status: 404, error: 'Unknown site' }\n  }\n  if (!gate.staff) {\n    const membership = await getOrgForUser(gate.uid, gate.orgId)\n    const permitted =\n      membership?.orgId === gate.orgId &&\n      (await memberHasPermissionOnHost(gate.orgId, hostId, membership.member, 'ai.generate'))\n    if (!permitted) {\n      return {\n        ok: false,\n        status: 403,\n        error: `Your role does not include \"${orgPermissionLabel('ai.generate')}\" — ask an organization admin`,\n      }\n    }\n  }\n  const memberRole = ((host.get('memberRoles') ?? {}) as Record<string, unknown>)[gate.uid]\n  if (!hostRoleCanWrite(memberRole)) {\n    return { ok: false, status: 403, error: 'Editing requires the editor role' }\n  }\n\n  const result = await duplicateResource(parsed.kind, {\n    orgId: gate.orgId,\n    hostId,\n    sourceId: parsed.sourceId,\n    name: parsed.name,\n    uid: gate.uid,\n    email: gate.decoded.email ? String(gate.decoded.email) : null,\n    org: gate.org as Record<string, unknown>,\n    attemptKey: null,\n  })\n  if (result.ok === false) return result\n  return {\n    ok: true,\n    kind: parsed.kind,\n    id: result.id,\n    versionId: result.versionId,\n    name: result.name,\n  }\n}\n"],"names":["DUPLICABLE_HOST_RESOURCE_KINDS","DUPLICATE_NAME_MAX","isDuplicableHostResourceKind","hostRoleCanWrite","orgPermissionLabel","duplicateResource","getOrgForUser","memberHasPermissionOnHost","AI_DUPLICATE_RESOURCE_TOOL_NAME","AI_DUPLICATE_RESOURCE_TOOL","name","description","inputSchema","type","properties","kind","enum","sourceId","required","additionalProperties","strict","parseAiDuplicateResourceInput","input","trim","length","includes","trimmed","slice","runAiDuplicateResourceTool","context","host","gate","hostId","String","parsed","ok","status","error","reservation","allowed","firestore","collection","doc","get","exists","orgId","staff","membership","uid","permitted","member","memberRole","result","email","decoded","org","attemptKey","id","versionId"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-duplicate-resource-tool.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  DUPLICABLE_HOST_RESOURCE_KINDS,\n  DUPLICATE_NAME_MAX,\n  isDuplicableHostResourceKind,\n  type DuplicableHostResourceKind,\n} from '@aglyn/aglyn/app-utils/duplicate-resource'\nimport { hostRoleCanWrite } from '@aglyn/aglyn/app-utils/organizations'\nimport { orgPermissionLabel } from '@aglyn/aglyn/app-utils/org-permissions'\nimport { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource'\nimport {\n  getOrgForUser,\n  memberHasPermissionOnHost,\n} from '@aglyn/tenant-data-admin/server/organizations'\nimport type { AiTool } from '../providers/contract'\nimport type { AiGateContext } from '../runtime/ai-gate'\n\n/**\n * The `duplicate_resource` tool (AGL-2936, AGL-2984): a model that would\n * rebuild something the site already has copies it instead, through core's\n * `duplicateResource` — the same copy the row menus and the console door\n * make, with the same uniqueness rules, the same band arithmetic and the same\n * activity rows.\n *\n * It spends no tokens of its own, so it calls no provider: it runs inside a\n * door or a job step that has already climbed `aiGateLadder`, and takes that\n * ladder's context as its proof — the caller is signed in and verified, the\n * release flag, entitlement and lockdown rungs admitted the request, and the\n * workspace's band and caps admitted a reservation. On top of that it asks\n * what a copy needs whichever door called it: `ai.generate`, because a copy\n * is a generation's output, and a host role that may write the site, because\n * the copy lands there.\n *\n * DRAFTS ONLY, by construction of the copy: a screen copy has no route, a\n * workflow copy no trigger, and nothing places a component, layout or form\n * copy until a person does.\n */\n\nexport const AI_DUPLICATE_RESOURCE_TOOL_NAME = 'duplicate_resource'\n\n/** The structured-output tool a generation offers the model. */\nexport const AI_DUPLICATE_RESOURCE_TOOL: AiTool = {\n  name: AI_DUPLICATE_RESOURCE_TOOL_NAME,\n  description:\n    'Copy a resource this site already has — a page (kind \"screen\"), an email design, a component, a layout, ' +\n    'a template, a form or a workflow — as a new draft to build from, instead of creating it again. ' +\n    'The copy is unpublished: it has no address, runs nothing and is placed nowhere until a person does.',\n  inputSchema: {\n    type: 'object',\n    properties: {\n      kind: {\n        type: 'string',\n        enum: [...DUPLICABLE_HOST_RESOURCE_KINDS],\n        description: 'The kind of resource to copy.',\n      },\n      sourceId: {\n        type: 'string',\n        description: 'The id of the resource to copy, as the site inventory lists it.',\n      },\n      name: {\n        type: ['string', 'null'],\n        description: `The copy's name, at most ${DUPLICATE_NAME_MAX} characters, or null for \"Copy of\" the source's name.`,\n      },\n    },\n    required: ['kind', 'sourceId', 'name'],\n    additionalProperties: false,\n  },\n  strict: true,\n}\n\n/** A tool call's input, read. */\nexport type AiDuplicateResourceInput = {\n  kind: DuplicableHostResourceKind\n  sourceId: string\n  name: string | null\n}\n\n/** What the tool answers: the copy, or a refusal the caller can relay. */\nexport type AiDuplicateResourceOutcome =\n  | { ok: true; kind: DuplicableHostResourceKind; id: string; versionId: string | null; name: string }\n  | { ok: false; status: number; error: string }\n\n/** Reads a tool call's input; `null` when it is not one this tool accepts. */\nexport function parseAiDuplicateResourceInput(\n  input: Record<string, unknown>,\n): AiDuplicateResourceInput | null {\n  const kind = input['kind']\n  const sourceId = typeof input['sourceId'] === 'string' ? input['sourceId'].trim() : ''\n  const name = input['name']\n  if (!isDuplicableHostResourceKind(kind)) return null\n  if (!sourceId || sourceId.length > 64 || sourceId.includes('/')) return null\n  if (name !== null && typeof name !== 'string') return null\n  const trimmed = typeof name === 'string' ? name.trim().slice(0, DUPLICATE_NAME_MAX) : ''\n  return { kind, sourceId, name: trimmed || null }\n}\n\n/**\n * Makes the copy on `hostId` for the person the gate admitted. Refusals are\n * outcomes, never throws: a model's call that names a missing source or a\n * full band is an answer to relay, not a fault.\n */\nexport async function runAiDuplicateResourceTool(\n  context: { gate: AiGateContext; hostId: string },\n  input: Record<string, unknown>,\n): Promise<AiDuplicateResourceOutcome> {\n  const { gate } = context\n  const hostId = String(context.hostId ?? '').trim()\n  const parsed = parseAiDuplicateResourceInput(input)\n  if (!parsed) return { ok: false, status: 400, error: 'That is not a resource this site can copy' }\n  if (!gate.reservation?.allowed) {\n    return { ok: false, status: 429, error: 'This workspace cannot run AI requests right now' }\n  }\n  if (!hostId) return { ok: false, status: 400, error: 'Name the site to copy on' }\n\n  const host = await gate.firestore.collection('hosts').doc(hostId).get()\n  // A site of another workspace is a site this request cannot see.\n  if (!host.exists || host.get('orgId') !== gate.orgId) {\n    return { ok: false, status: 404, error: 'Unknown site' }\n  }\n  if (!gate.staff) {\n    const membership = await getOrgForUser(gate.uid, gate.orgId)\n    const permitted =\n      membership?.orgId === gate.orgId &&\n      (await memberHasPermissionOnHost(gate.orgId, hostId, membership.member, 'ai.generate'))\n    if (!permitted) {\n      return {\n        ok: false,\n        status: 403,\n        error: `Your role does not include \"${orgPermissionLabel('ai.generate')}\" — ask an organization admin`,\n      }\n    }\n  }\n  const memberRole = ((host.get('memberRoles') ?? {}) as Record<string, unknown>)[gate.uid]\n  if (!hostRoleCanWrite(memberRole)) {\n    return { ok: false, status: 403, error: 'Editing requires the editor role' }\n  }\n\n  const result = await duplicateResource(parsed.kind, {\n    orgId: gate.orgId,\n    hostId,\n    sourceId: parsed.sourceId,\n    name: parsed.name,\n    uid: gate.uid,\n    email: gate.decoded.email ? String(gate.decoded.email) : null,\n    org: gate.org as Record<string, unknown>,\n    attemptKey: null,\n  })\n  if (result.ok === false) return result\n  return {\n    ok: true,\n    kind: parsed.kind,\n    id: result.id,\n    versionId: result.versionId,\n    name: result.name,\n  }\n}\n"],"names":["DUPLICABLE_HOST_RESOURCE_KINDS","DUPLICATE_NAME_MAX","isDuplicableHostResourceKind","hostRoleCanWrite","orgPermissionLabel","duplicateResource","getOrgForUser","memberHasPermissionOnHost","AI_DUPLICATE_RESOURCE_TOOL_NAME","AI_DUPLICATE_RESOURCE_TOOL","name","description","inputSchema","type","properties","kind","enum","sourceId","required","additionalProperties","strict","parseAiDuplicateResourceInput","input","trim","length","includes","trimmed","slice","runAiDuplicateResourceTool","context","host","gate","hostId","String","parsed","ok","status","error","reservation","allowed","firestore","collection","doc","get","exists","orgId","staff","membership","uid","permitted","member","memberRole","result","email","decoded","org","attemptKey","id","versionId"],"mappings":"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"}

package/src/lib/tools/ai-seo-tool.d.ts

@@ -14,11 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { SeoFindingCode } from '@aglyn/aglyn/app-utils/seo-audit';
 import { type SeoListingFieldKey } from '@aglyn/aglyn/app-utils/seo-listing-fields';
-import type { AiSeoFieldValues, AiSeoFindingCode, AiSeoKeywordCoverage, AiSeoSiteFormField } from '../model/ai-seo';
+import type { SeoPageFacts } from '@aglyn/aglyn/app-utils/seo-page-facts';
+import type { AiSeoFieldValues, AiSeoSiteFormField } from '../model/ai-seo';
 import type { AiTool } from '../providers/contract';
 import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
-import type { AiSeoPageFacts } from '../runtime/seo-page-facts';
 /**
  * The strict tools SEO by AI answers through (AGL-2910), and the checks that
  * hold each answer to the editor it proposes for.
@@ -37,21 +38,8 @@ import type { AiSeoPageFacts } from '../runtime/seo-page-facts';
  * in the answer is broken, and otherwise the violations and the parts at
  * fault, for the generation call's one re-ask.
  */
-/** Target keywords one listing may be asked to cover. */
-export declare const AI_SEO_MAX_KEYWORDS = 5;
 /** The most times one keyword may appear, per field, before it reads as stuffing. */
 export declare const AI_SEO_KEYWORD_LIMITS: Readonly<Partial<Record<SeoListingFieldKey, number>>>;
-/** How many times `keyword` appears in `text` as whole words, any case. */
-export declare function aiSeoKeywordCount(text: string | null | undefined, keyword: string): number;
-/** Keywords as a person typed them: trimmed, deduplicated, capped. */
-export declare function aiSeoKeywordList(raw: unknown): string[];
-/** Where a page already says each target keyword. */
-export declare function aiSeoKeywordCoverage(keywords: readonly string[], sources: {
-    title?: string | null;
-    description?: string | null;
-    h1?: string | null;
-    body?: string | null;
-}): AiSeoKeywordCoverage[];
 export declare const AI_SEO_FIELDS_TOOL_NAME = "propose_search_listing";
 /** The fields a listing proposal must fill; the image description may be left out. */
 export declare const AI_SEO_REQUIRED_FIELDS: ReadonlySet<SeoListingFieldKey>;
@@ -87,7 +75,7 @@ export declare const AI_SEO_FIX_ALT_MAX_CHARS: number;
 /** Undescribed images one page of a batch gets descriptions for; the rest wait for the next audit. */
 export declare const AI_SEO_FIX_IMAGES_PER_PAGE = 3;
 /** The undescribed images a batch asks about for a page, in page order. */
-export declare function aiSeoFixImages(page: Pick<AiSeoBatchPage, 'facts'>): AiSeoPageFacts['imagesMissingAlt'];
+export declare function aiSeoFixImages(page: Pick<AiSeoBatchPage, 'facts'>): SeoPageFacts['imagesMissingAlt'];
 /** The strict tool for one batch: a title, description, heading and image descriptions per page. */
 export declare function aiSeoFixesTool(screenIds: readonly string[]): AiTool;
 /** A batch page as the fixes prompt and check read it. */
@@ -95,7 +83,7 @@ export interface AiSeoBatchPage {
     screenId: string;
     path: string;
     name: string;
-    codes: ReadonlySet<AiSeoFindingCode>;
+    codes: ReadonlySet<SeoFindingCode>;
     keywords: readonly string[];
     seo: {
         title?: string;
@@ -104,7 +92,7 @@ export interface AiSeoBatchPage {
         image?: string;
         imageAlt?: string;
     } | undefined;
-    facts: AiSeoPageFacts;
+    facts: SeoPageFacts;
 }
 /** The findings that let a batch answer propose each value. */
 export declare const AI_SEO_FIX_CODES: {

package/src/lib/tools/ai-seo-tool.js

@@ -14,6 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { MEDIA_ALT_MAX_LENGTH } from "@aglyn/aglyn/app-utils/media-alt";
+import { seoKeywordCount } from "@aglyn/aglyn/app-utils/seo-keywords";
 import { SEO_LISTING_FIELDS } from "@aglyn/aglyn/app-utils/seo-listing-fields";
 import { HostEntityType } from "@aglyn/aglyn/foundation/definitions/platform.types";
 import { AI_TEXT_LIMITS } from "../runtime/ai-palette.js";
@@ -35,45 +36,13 @@ import { AI_TEXT_LIMITS } from "../runtime/ai-palette.js";
  * in the answer is broken, and otherwise the violations and the parts at
  * fault, for the generation call's one re-ask.
  */ /* ------------------------------------------------------------------------ *
- * Keywords: coverage, and what stuffing looks like
- * ------------------------------------------------------------------------ */ /** Target keywords one listing may be asked to cover. */ export const AI_SEO_MAX_KEYWORDS = 5;
-/** The most times one keyword may appear, per field, before it reads as stuffing. */ export const AI_SEO_KEYWORD_LIMITS = {
+ * Keywords: what stuffing looks like. Coverage — whether a page says a
+ * keyword at all — is the platform's (`app-utils/seo-keywords`).
+ * ------------------------------------------------------------------------ */ /** The most times one keyword may appear, per field, before it reads as stuffing. */ export const AI_SEO_KEYWORD_LIMITS = {
     title: 1,
     description: 2,
     breadcrumb: 1
 };
-const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-/** How many times `keyword` appears in `text` as whole words, any case. */ export function aiSeoKeywordCount(text, keyword) {
-    const needle = keyword.trim().toLowerCase();
-    if (!needle || !text) return 0;
-    const pattern = new RegExp(`(^|[^\\p{L}\\p{N}])${escapeRegExp(needle).replace(/\s+/g, '\\s+')}(?=$|[^\\p{L}\\p{N}])`, 'giu');
-    return [
-        ...text.toLowerCase().matchAll(pattern)
-    ].length;
-}
-/** Keywords as a person typed them: trimmed, deduplicated, capped. */ export function aiSeoKeywordList(raw) {
-    const parts = Array.isArray(raw) ? raw.map(String) : String(raw != null ? raw : '').split(/[,\n]/);
-    const seen = new Set();
-    const out = [];
-    for (const part of parts){
-        const keyword = part.replace(/\s+/g, ' ').trim().slice(0, 60);
-        const key = keyword.toLowerCase();
-        if (!keyword || seen.has(key)) continue;
-        seen.add(key);
-        out.push(keyword);
-        if (out.length >= AI_SEO_MAX_KEYWORDS) break;
-    }
-    return out;
-}
-/** Where a page already says each target keyword. */ export function aiSeoKeywordCoverage(keywords, sources) {
-    return keywords.map((keyword)=>({
-            keyword,
-            inTitle: aiSeoKeywordCount(sources.title, keyword) > 0,
-            inDescription: aiSeoKeywordCount(sources.description, keyword) > 0,
-            inH1: aiSeoKeywordCount(sources.h1, keyword) > 0,
-            inBody: aiSeoKeywordCount(sources.body, keyword) > 0
-        }));
-}
 /** A word of four letters or more used three times in one short field reads as stuffing. */ function repeatedWord(text) {
     var _text_toLowerCase_match;
     const counts = new Map();
@@ -176,7 +145,7 @@ const normalizeTitle = (value)=>value.replace(/\s+/g, ' ').trim().toLowerCase();
             continue;
         }
         const limit = AI_SEO_KEYWORD_LIMITS[key];
-        const stuffed = limit ? ((_context_keywords = context.keywords) != null ? _context_keywords : []).find((keyword)=>aiSeoKeywordCount(value, keyword) > limit) : undefined;
+        const stuffed = limit ? ((_context_keywords = context.keywords) != null ? _context_keywords : []).find((keyword)=>seoKeywordCount(value, keyword) > limit) : undefined;
         if (stuffed) {
             violations.push({
                 rule: null,
@@ -353,7 +322,7 @@ const normalizeTitle = (value)=>value.replace(/\s+/g, ' ').trim().toLowerCase();
                 broken.push(`title is ${title.length} characters; the limit is ${SEO_LISTING_FIELDS.title.maxLength}`);
             } else if (page.keywords.some((keyword)=>{
                 var _AI_SEO_KEYWORD_LIMITS_title;
-                return aiSeoKeywordCount(title, keyword) > ((_AI_SEO_KEYWORD_LIMITS_title = AI_SEO_KEYWORD_LIMITS.title) != null ? _AI_SEO_KEYWORD_LIMITS_title : 1);
+                return seoKeywordCount(title, keyword) > ((_AI_SEO_KEYWORD_LIMITS_title = AI_SEO_KEYWORD_LIMITS.title) != null ? _AI_SEO_KEYWORD_LIMITS_title : 1);
             })) {
                 broken.push('title repeats a keyword');
             } else if (taken.has(normalizeTitle(title))) {
@@ -369,7 +338,7 @@ const normalizeTitle = (value)=>value.replace(/\s+/g, ' ').trim().toLowerCase();
                 broken.push(`description is ${description.length} characters; the limit is ${SEO_LISTING_FIELDS.description.maxLength}`);
             } else if (page.keywords.some((keyword)=>{
                 var _AI_SEO_KEYWORD_LIMITS_description;
-                return aiSeoKeywordCount(description, keyword) > ((_AI_SEO_KEYWORD_LIMITS_description = AI_SEO_KEYWORD_LIMITS.description) != null ? _AI_SEO_KEYWORD_LIMITS_description : 2);
+                return seoKeywordCount(description, keyword) > ((_AI_SEO_KEYWORD_LIMITS_description = AI_SEO_KEYWORD_LIMITS.description) != null ? _AI_SEO_KEYWORD_LIMITS_description : 2);
             })) {
                 broken.push('description repeats a keyword');
             } else {