@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,369 @@
+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 { parseMediaRef } from "@aglyn/aglyn/app-utils/media-ref";
+import { COMPONENT_PROP_NAME_PATTERN } from "@aglyn/aglyn/app-utils/reusable-component-keys";
+import { FieldComponentType } from "@aglyn/aglyn/foundation/definitions/components.types";
+import { REUSABLE_PROP_KINDS } from "@aglyn/aglyn/foundation/definitions/property-kinds";
+import { aiDoctrineTreeTool } from "../runtime/ai-doctrine.js";
+import { HOSTILE_TEXT, isHttpsUrl, isRootRelativePath } from "../runtime/ai-node-tree.js";
+import { AI_TEXT_LIMITS } from "../runtime/ai-palette.js";
+const STYLE_REASON = '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.';
+const RECORD_REASON = 'A pick from the site’s own records is made where a page places the component (rule 8), never invented as a generated default.';
+const PLUGIN_REASON = 'Plugin settings belong to the plugin’s own element, which a generated component never places.';
+/**
+ * Why each property kind the dialog declares is not offered to a model.
+ * Keyed by every kind outside the offered ones, so the table is complete by
+ * type.
+ */ export const AI_COMPONENT_PROP_KINDS_NOT_OFFERED = {
+    [FieldComponentType.MARKDOWN]: 'Long text binds to the same formatted-document fields, with a default a brief can write.',
+    [FieldComponentType.DATA_TABLE]: 'A table is rows and columns a page fills in, not one value a brief describes.',
+    [FieldComponentType.SLIDER]: 'Number binds to every slider, without the range settings a Slider property must declare.',
+    [FieldComponentType.CHECKBOX]: 'Yes / no binds to every switch and single tick box, and no generated element offers a list of tick boxes.',
+    [FieldComponentType.RADIO]: 'Choice binds to every field Radio buttons binds to, with its answers checked in one place.',
+    [FieldComponentType.TOGGLE_BUTTON]: 'Choice binds to every field Toggle buttons binds to, with its answers checked in one place.',
+    [FieldComponentType.DUAL_LIST_SELECT]: 'A pick list holds several answers, and no generated element offers a field that takes several.',
+    [FieldComponentType.COLOR_PICKER]: 'Colors come from the theme (rule 5); a page recolors one placement with an override, not a property.',
+    [FieldComponentType.CSS_DIMENSION]: STYLE_REASON,
+    [FieldComponentType.CSS_BORDER]: STYLE_REASON,
+    [FieldComponentType.CSS_GRADIENT]: STYLE_REASON,
+    [FieldComponentType.BREAKPOINT_SPAN]: STYLE_REASON,
+    [FieldComponentType.PRESET_CHOICE]: STYLE_REASON,
+    [FieldComponentType.THEME_SCALE]: STYLE_REASON,
+    [FieldComponentType.DATE_PICKER]: 'A date is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',
+    [FieldComponentType.TIME_PICKER]: 'A time is a fact the brief would have to give (rule 14), not copy a component shows until a page sets it.',
+    [FieldComponentType.NODE_SELECT]: RECORD_REASON,
+    [FieldComponentType.PRODUCT_SELECT]: RECORD_REASON,
+    [FieldComponentType.COLLECTION_SELECT]: RECORD_REASON,
+    [FieldComponentType.CATEGORY_SELECT]: RECORD_REASON,
+    [FieldComponentType.DATASET_SELECT]: RECORD_REASON,
+    [FieldComponentType.DATASET_FIELD_SELECT]: RECORD_REASON,
+    [FieldComponentType.FORM_SELECT]: 'A form is placed by its id from the Forms page (rule 3), never chosen through a generated property.',
+    [FieldComponentType.PLUGIN_SELECT]: PLUGIN_REASON,
+    [FieldComponentType.PLUGIN_SETTINGS]: PLUGIN_REASON
+};
+/**
+ * The kinds a generated component may declare: the dialog's table less the
+ * kinds above, in the dialog's own order.
+ */ export const AI_COMPONENT_PROP_KINDS = Object.keys(REUSABLE_PROP_KINDS).filter((type)=>!Object.prototype.hasOwnProperty.call(AI_COMPONENT_PROP_KINDS_NOT_OFFERED, type));
+/**
+ * The kinds a property proposed for a section already on a page may take
+ * (AGL-3054): every offered kind but an Icon. That door reads each default off
+ * the live field it binds, and an icon's default is drawn from a path the
+ * picker stores beside its id, which the field it reads does not carry.
+ */ export const AI_COMPONENT_SELECTION_PROP_KINDS = AI_COMPONENT_PROP_KINDS.filter((type)=>type !== 'icon');
+/** The kinds as a model reads them: the stored type and the name a page reads. */ export function aiComponentPropKindWords(kinds = AI_COMPONENT_PROP_KINDS) {
+    return kinds.map((type)=>`${type} (${REUSABLE_PROP_KINDS[type].label})`).join(', ');
+}
+export const AI_COMPONENT_TOOL_NAME = 'submit_component';
+/** The most properties one generated component declares. */ export const AI_COMPONENT_MAX_PROPS = 20;
+const NAME_MAX = 40;
+const LABEL_MAX = 80;
+const HELP_MAX = 200;
+const ANSWER_MAX = 100;
+/**
+ * The strict tool a component arrives through: the doctrine's tree, as the
+ * doctrine's own component tool carries it, and the properties beside it.
+ * Every field of a property is required and flat, because optional
+ * properties are not portable across strict tool implementations; a kind
+ * that has no answers sends `[]`.
+ */ export function aiComponentTool() {
+    const doctrine = aiDoctrineTreeTool('component');
+    const tree = doctrine.inputSchema.properties['tree'];
+    return {
+        name: AI_COMPONENT_TOOL_NAME,
+        description: 'Submit the reusable component: its tree as one flat node map, and every property the tree binds.',
+        strict: true,
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'tree',
+                'props'
+            ],
+            properties: {
+                tree,
+                props: {
+                    type: 'array',
+                    description: 'Every property the tree binds with {{prop.<name>}}, in the order a page sets them.',
+                    items: {
+                        type: 'object',
+                        additionalProperties: false,
+                        required: [
+                            'name',
+                            'type',
+                            'label',
+                            'description',
+                            'defaultValue',
+                            'options'
+                        ],
+                        properties: {
+                            name: {
+                                type: 'string',
+                                description: 'Letters, digits and underscores, starting with a letter; bound as {{prop.<name>}}.'
+                            },
+                            type: {
+                                type: 'string',
+                                enum: [
+                                    ...AI_COMPONENT_PROP_KINDS
+                                ],
+                                description: `The kind, as type (the name a page reads): ${aiComponentPropKindWords()}.`
+                            },
+                            label: {
+                                type: 'string',
+                                description: 'The words a page reads beside the field.'
+                            },
+                            description: {
+                                type: 'string',
+                                description: 'Help beside the field, or "".'
+                            },
+                            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.'
+                            },
+                            options: {
+                                type: 'array',
+                                description: 'The answers of a choice; [] for every other kind.',
+                                items: {
+                                    type: 'object',
+                                    additionalProperties: false,
+                                    required: [
+                                        'value',
+                                        'label'
+                                    ],
+                                    properties: {
+                                        value: {
+                                            type: 'string',
+                                            description: 'What the bound field receives: one of the values that field lists.'
+                                        },
+                                        label: {
+                                            type: 'string',
+                                            description: 'What a page picks.'
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    };
+}
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+/** A scalar the answer wrote, as trimmed text. */ function scalar(value) {
+    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' ? String(value).trim() : '';
+}
+/** A default as the kind stores it, or why it cannot be one. */ function readDefault(type, raw, options, scope) {
+    const value = scalar(raw);
+    if (HOSTILE_TEXT.test(value)) return {
+        error: 'carries markup or script',
+        rule: 1
+    };
+    // Nothing set is a default of its own: the kind's "not set".
+    if (!value) return {
+        value: undefined
+    };
+    switch(type){
+        case 'text':
+        case 'richText':
+            return value.length > AI_TEXT_LIMITS.body ? {
+                error: `runs past ${AI_TEXT_LIMITS.body} characters`,
+                rule: 1
+            } : {
+                value
+            };
+        case 'icon':
+            // The picker stores an icon with the drawing a model cannot name, so
+            // the site owner picks it where a page places the component.
+            return {
+                error: 'is an icon, which the site owner picks; leave it ""',
+                rule: 1
+            };
+        case 'image':
+            if (/^https?:\/\//i.test(value)) {
+                return {
+                    error: 'links a picture from another website; leave it empty for an upload',
+                    rule: 9
+                };
+            }
+            return parseMediaRef(value) ? {
+                value
+            } : {
+                error: 'is not a picture from the media library; leave it empty for an upload',
+                rule: 9
+            };
+        case 'href':
+            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',
+                rule: 1
+            };
+        case 'number':
+            {
+                const parsed = Number(value);
+                return Number.isFinite(parsed) ? {
+                    value: parsed
+                } : {
+                    error: 'is not a number',
+                    rule: 1
+                };
+            }
+        case 'boolean':
+            if (value === 'true') return {
+                value: true
+            };
+            if (value === 'false') return {
+                value: false
+            };
+            return {
+                error: 'is neither true nor false',
+                rule: 1
+            };
+        case 'choice':
+            return options.some((option)=>option.value === value) ? {
+                value
+            } : {
+                error: 'is not the value of one of its answers',
+                rule: 1
+            };
+    }
+}
+/**
+ * The properties a component answer declares, read into the shape the
+ * Properties dialog stores, with a finding for everything that would not
+ * save there or would not read as the brief's own copy.
+ */ export function readAiComponentProps(answer, scope) {
+    const raw = answer['props'];
+    if (!Array.isArray(raw)) {
+        return {
+            props: [],
+            refused: [],
+            violations: [
+                {
+                    rule: 1,
+                    code: 'props-missing',
+                    message: 'The component came without its list of properties. Declare every property the tree binds, or an empty list.',
+                    paths: [
+                        'props'
+                    ]
+                }
+            ]
+        };
+    }
+    const violations = [];
+    const finding = (code, message, path, rule = 1)=>{
+        violations.push({
+            rule,
+            code,
+            message,
+            paths: [
+                path
+            ]
+        });
+    };
+    if (raw.length > AI_COMPONENT_MAX_PROPS) {
+        finding('props-over-limit', `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.`, 'props');
+    }
+    const kindNames = AI_COMPONENT_PROP_KINDS.map((type)=>REUSABLE_PROP_KINDS[type].label);
+    const props = [];
+    const seen = new Set();
+    raw.slice(0, AI_COMPONENT_MAX_PROPS).forEach((entry, index)=>{
+        const at = `props[${index}]`;
+        if (!isRecord(entry)) {
+            finding('prop-shape', 'A property could not be read. Give each one a name, a kind and a default.', at);
+            return;
+        }
+        const name = scalar(entry['name']);
+        const called = name ? `"${name}"` : `number ${index + 1}`;
+        if (!COMPONENT_PROP_NAME_PATTERN.test(name) || name.length > NAME_MAX) {
+            finding('prop-name', `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.`, `${at}.name`);
+            return;
+        }
+        if (seen.has(name)) {
+            finding('prop-duplicate', `Two properties are named "${name}". Give each property its own name.`, `${at}.name`);
+            return;
+        }
+        seen.add(name);
+        const type = scalar(entry['type']);
+        if (!AI_COMPONENT_PROP_KINDS.includes(type)) {
+            finding('prop-kind', `The property "${name}" is a kind a generated component does not declare. Use one of: ${kindNames.join(', ')}.`, `${at}.type`);
+            return;
+        }
+        const options = [];
+        if (type === 'choice') {
+            const answers = Array.isArray(entry['options']) ? entry['options'] : [];
+            const values = new Set();
+            for (const option of answers){
+                const value = isRecord(option) ? scalar(option['value']).slice(0, ANSWER_MAX) : '';
+                const label = isRecord(option) ? scalar(option['label']).slice(0, LABEL_MAX) : '';
+                if (!value || HOSTILE_TEXT.test(value) || HOSTILE_TEXT.test(label)) {
+                    finding('prop-answers', `Every answer of "${name}" needs a plain value.`, `${at}.options`);
+                    return;
+                }
+                if (values.has(value)) {
+                    finding('prop-answers', `Two answers of "${name}" share the value "${value}".`, `${at}.options`);
+                    return;
+                }
+                values.add(value);
+                options.push(_extends({
+                    value
+                }, label && label !== value ? {
+                    label
+                } : {}));
+            }
+            if (!options.length) {
+                finding('prop-answers', `The Choice "${name}" lists no answers. Give it the answers a page picks from.`, `${at}.options`);
+                return;
+            }
+        }
+        const read = readDefault(type, entry['defaultValue'], options, scope);
+        if ('error' in read) {
+            finding('prop-default', `The default of "${name}" ${read.error}.`, `${at}.defaultValue`, read.rule);
+            return;
+        }
+        const label = scalar(entry['label']).slice(0, LABEL_MAX);
+        const description = scalar(entry['description']).slice(0, HELP_MAX);
+        if (HOSTILE_TEXT.test(label) || HOSTILE_TEXT.test(description)) {
+            finding('prop-shape', `The label or help of "${name}" carries markup or script.`, at);
+            return;
+        }
+        props.push(_extends({
+            name,
+            type
+        }, label ? {
+            label
+        } : {}, description ? {
+            description
+        } : {}, read.value !== undefined ? {
+            defaultValue: read.value
+        } : {}, type === 'choice' ? {
+            options
+        } : {}));
+    });
+    // A name that read, and was then refused for its kind, answers, default or label.
+    const refused = [
+        ...seen
+    ].filter((name)=>!props.some((prop)=>prop.name === name));
+    return {
+        props,
+        refused,
+        violations
+    };
+}
+
+//# sourceMappingURL=ai-component-tool.js.map

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

@@ -0,0 +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":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,mCAAkC;AAChE,SAASC,2BAA2B,QAAQ,iDAAgD;AAC5F,SAASC,kBAAkB,QAAQ,uDAAsD;AAOzF,SAASC,mBAAmB,QAAQ,qDAAoD;AAExF,SAASC,kBAAkB,QAAQ,4BAAwB;AAK3D,SAASC,YAAY,EAAEC,UAAU,EAAEC,kBAAkB,QAAQ,6BAAyB;AACtF,SAASC,cAAc,QAAQ,2BAAuB;AA8BtD,MAAMC,eACJ;AACF,MAAMC,gBACJ;AACF,MAAMC,gBACJ;AAEF;;;;CAIC,GACD,OAAO,MAAMC,sCAET;IACF,CAACV,mBAAmBW,QAAQ,CAAC,EAC3B;IACF,CAACX,mBAAmBY,UAAU,CAAC,EAC7B;IACF,CAACZ,mBAAmBa,MAAM,CAAC,EACzB;IACF,CAACb,mBAAmBc,QAAQ,CAAC,EAC3B;IACF,CAACd,mBAAmBe,KAAK,CAAC,EACxB;IACF,CAACf,mBAAmBgB,aAAa,CAAC,EAChC;IACF,CAAChB,mBAAmBiB,gBAAgB,CAAC,EACnC;IACF,CAACjB,mBAAmBkB,YAAY,CAAC,EAC/B;IACF,CAAClB,mBAAmBmB,aAAa,CAAC,EAAEZ;IACpC,CAACP,mBAAmBoB,UAAU,CAAC,EAAEb;IACjC,CAACP,mBAAmBqB,YAAY,CAAC,EAAEd;IACnC,CAACP,mBAAmBsB,eAAe,CAAC,EAAEf;IACtC,CAACP,mBAAmBuB,aAAa,CAAC,EAAEhB;IACpC,CAACP,mBAAmBwB,WAAW,CAAC,EAAEjB;IAClC,CAACP,mBAAmByB,WAAW,CAAC,EAC9B;IACF,CAACzB,mBAAmB0B,WAAW,CAAC,EAC9B;IACF,CAAC1B,mBAAmB2B,WAAW,CAAC,EAAEnB;IAClC,CAACR,mBAAmB4B,cAAc,CAAC,EAAEpB;IACrC,CAACR,mBAAmB6B,iBAAiB,CAAC,EAAErB;IACxC,CAACR,mBAAmB8B,eAAe,CAAC,EAAEtB;IACtC,CAACR,mBAAmB+B,cAAc,CAAC,EAAEvB;IACrC,CAACR,mBAAmBgC,oBAAoB,CAAC,EAAExB;IAC3C,CAACR,mBAAmBiC,WAAW,CAAC,EAC9B;IACF,CAACjC,mBAAmBkC,aAAa,CAAC,EAAEzB;IACpC,CAACT,mBAAmBmC,eAAe,CAAC,EAAE1B;AACxC,EAAC;AAED;;;CAGC,GACD,OAAO,MAAM2B,0BAAkD,AAC7DC,OAAOC,IAAI,CAACrC,qBACZsC,MAAM,CACN,CAACC,OACC,CAACH,OAAOI,SAAS,CAACC,cAAc,CAACC,IAAI,CAACjC,qCAAqC8B,OAC9E;AAID;;;;;CAKC,GACD,OAAO,MAAMI,oCACXR,wBAAwBG,MAAM,CAAC,CAACC,OAASA,SAAS,QAAO;AAE3D,gFAAgF,GAChF,OAAO,SAASK,yBACdC,QAAwCV,uBAAuB;IAE/D,OAAOU,MAAMC,GAAG,CAAC,CAACP,OAAS,GAAGA,KAAK,EAAE,EAAEvC,mBAAmB,CAACuC,KAAK,CAACQ,KAAK,CAAC,CAAC,CAAC,EAAEC,IAAI,CAAC;AAClF;AAEA,OAAO,MAAMC,yBAAyB,mBAAkB;AAExD,0DAA0D,GAC1D,OAAO,MAAMC,yBAAyB,GAAE;AAExC,MAAMC,WAAW;AACjB,MAAMC,YAAY;AAClB,MAAMC,WAAW;AACjB,MAAMC,aAAa;AAEnB;;;;;;CAMC,GACD,OAAO,SAASC;IACd,MAAMC,WAAWvD,mBAAmB;IACpC,MAAMwD,OAAO,AAACD,SAASE,WAAW,CAA6CC,UAAU,CAAC,OAAO;IACjG,OAAO;QACLC,MAAMX;QACNY,aACE;QACFC,QAAQ;QACRJ,aAAa;YACXnB,MAAM;YACNwB,sBAAsB;YACtBC,UAAU;gBAAC;gBAAQ;aAAQ;YAC3BL,YAAY;gBACVF;gBACAQ,OAAO;oBACL1B,MAAM;oBACNsB,aACE;oBACFK,OAAO;wBACL3B,MAAM;wBACNwB,sBAAsB;wBACtBC,UAAU;4BAAC;4BAAQ;4BAAQ;4BAAS;4BAAe;4BAAgB;yBAAU;wBAC7EL,YAAY;4BACVC,MAAM;gCACJrB,MAAM;gCACNsB,aACE;4BACJ;4BACAtB,MAAM;gCACJA,MAAM;gCACN4B,MAAM;uCAAIhC;iCAAwB;gCAClC0B,aAAa,CAAC,2CAA2C,EAAEjB,2BAA2B,CAAC,CAAC;4BAC1F;4BACAG,OAAO;gCAAER,MAAM;gCAAUsB,aAAa;4BAA2C;4BACjFA,aAAa;gCAAEtB,MAAM;gCAAUsB,aAAa;4BAAgC;4BAC5EO,cAAc;gCACZ7B,MAAM;gCACNsB,aACE;4BACJ;4BACAQ,SAAS;gCACP9B,MAAM;gCACNsB,aAAa;gCACbK,OAAO;oCACL3B,MAAM;oCACNwB,sBAAsB;oCACtBC,UAAU;wCAAC;wCAAS;qCAAQ;oCAC5BL,YAAY;wCACVW,OAAO;4CACL/B,MAAM;4CACNsB,aAAa;wCACf;wCACAd,OAAO;4CAAER,MAAM;4CAAUsB,aAAa;wCAAqB;oCAC7D;gCACF;4BACF;wBACF;oBACF;gBACF;YACF;QACF;IACF;AACF;AAmBA,MAAMU,WAAW,CAACD,QAChB,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACE,MAAMC,OAAO,CAACH;AAEhE,gDAAgD,GAChD,SAASI,OAAOJ,KAAc;IAC5B,OAAO,OAAOA,UAAU,YAAY,OAAOA,UAAU,YAAY,OAAOA,UAAU,YAC9EK,OAAOL,OAAOM,IAAI,KAClB;AACN;AAMA,8DAA8D,GAC9D,SAASC,YACPtC,IAAiB,EACjBuC,GAAY,EACZT,OAA+C,EAC/CU,KAA4B;IAE5B,MAAMT,QAAQI,OAAOI;IACrB,IAAI5E,aAAa8E,IAAI,CAACV,QAAQ,OAAO;QAAEW,OAAO;QAA4BC,MAAM;IAAE;IAClF,6DAA6D;IAC7D,IAAI,CAACZ,OAAO,OAAO;QAAEA,OAAOa;IAAU;IACtC,OAAQ5C;QACN,KAAK;QACL,KAAK;YACH,OAAO+B,MAAMc,MAAM,GAAG/E,eAAegF,IAAI,GACrC;gBAAEJ,OAAO,CAAC,UAAU,EAAE5E,eAAegF,IAAI,CAAC,WAAW,CAAC;gBAAEH,MAAM;YAAE,IAChE;gBAAEZ;YAAM;QACd,KAAK;YACH,qEAAqE;YACrE,6DAA6D;YAC7D,OAAO;gBAAEW,OAAO;gBAAuDC,MAAM;YAAE;QACjF,KAAK;YACH,IAAI,gBAAgBF,IAAI,CAACV,QAAQ;gBAC/B,OAAO;oBAAEW,OAAO;oBAAsEC,MAAM;gBAAE;YAChG;YACA,OAAOrF,cAAcyE,SACjB;gBAAEA;YAAM,IACR;gBAAEW,OAAO;gBAAyEC,MAAM;YAAE;QAChG,KAAK;YACH,OAAOH,MAAMO,SAAS,CAACC,GAAG,CAACjB,UAAUlE,mBAAmBkE,UAAUnE,WAAWmE,SACzE;gBAAEA;YAAM,IACR;gBACEW,OAAO;gBACPC,MAAM;YACR;QACN,KAAK;YAAU;gBACb,MAAMM,SAASC,OAAOnB;gBACtB,OAAOmB,OAAOC,QAAQ,CAACF,UAAU;oBAAElB,OAAOkB;gBAAO,IAAI;oBAAEP,OAAO;oBAAmBC,MAAM;gBAAE;YAC3F;QACA,KAAK;YACH,IAAIZ,UAAU,QAAQ,OAAO;gBAAEA,OAAO;YAAK;YAC3C,IAAIA,UAAU,SAAS,OAAO;gBAAEA,OAAO;YAAM;YAC7C,OAAO;gBAAEW,OAAO;gBAA6BC,MAAM;YAAE;QACvD,KAAK;YACH,OAAOb,QAAQsB,IAAI,CAAC,CAACC,SAAWA,OAAOtB,KAAK,KAAKA,SAC7C;gBAAEA;YAAM,IACR;gBAAEW,OAAO;gBAA0CC,MAAM;YAAE;IACnE;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASW,qBACdC,MAA+B,EAC/Bf,KAA4B;IAE5B,MAAMD,MAAMgB,MAAM,CAAC,QAAQ;IAC3B,IAAI,CAACtB,MAAMC,OAAO,CAACK,MAAM;QACvB,OAAO;YACLb,OAAO,EAAE;YACT8B,SAAS,EAAE;YACXC,YAAY;gBACV;oBACEd,MAAM;oBACNe,MAAM;oBACNC,SACE;oBACFC,OAAO;wBAAC;qBAAQ;gBAClB;aACD;QACH;IACF;IACA,MAAMH,aAAoC,EAAE;IAC5C,MAAMI,UAAU,CACdH,MACAC,SACAG,MACAnB,OAA6B,CAAC;QAE9Bc,WAAWM,IAAI,CAAC;YAAEpB;YAAMe;YAAMC;YAASC,OAAO;gBAACE;aAAK;QAAC;IACvD;IACA,IAAIvB,IAAIM,MAAM,GAAGlC,wBAAwB;QACvCkD,QACE,oBACA,CAAC,uBAAuB,EAAEtB,IAAIM,MAAM,CAAC,gDAAgD,EAAElC,uBAAuB,iEAAiE,CAAC,EAChL;IAEJ;IACA,MAAMqD,YAAYpE,wBAAwBW,GAAG,CAAC,CAACP,OAASvC,mBAAmB,CAACuC,KAAK,CAACQ,KAAK;IACvF,MAAMkB,QAAiC,EAAE;IACzC,MAAMuC,OAAO,IAAIC;IACjB3B,IAAI4B,KAAK,CAAC,GAAGxD,wBAAwByD,OAAO,CAAC,CAACC,OAAOC;QACnD,MAAMC,KAAK,CAAC,MAAM,EAAED,MAAM,CAAC,CAAC;QAC5B,IAAI,CAACtC,SAASqC,QAAQ;YACpBR,QAAQ,cAAc,6EAA6EU;YACnG;QACF;QACA,MAAMlD,OAAOc,OAAOkC,KAAK,CAAC,OAAO;QACjC,MAAMG,SAASnD,OAAO,CAAC,CAAC,EAAEA,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAEiD,QAAQ,GAAG;QACzD,IAAI,CAAC/G,4BAA4BkF,IAAI,CAACpB,SAASA,KAAKwB,MAAM,GAAGjC,UAAU;YACrEiD,QACE,aACA,CAAC,aAAa,EAAEW,OAAO,oGAAoG,EAAE5D,SAAS,qBAAqB,CAAC,EAC5J,GAAG2D,GAAG,KAAK,CAAC;YAEd;QACF;QACA,IAAIN,KAAKjB,GAAG,CAAC3B,OAAO;YAClBwC,QAAQ,kBAAkB,CAAC,0BAA0B,EAAExC,KAAK,mCAAmC,CAAC,EAAE,GAAGkD,GAAG,KAAK,CAAC;YAC9G;QACF;QACAN,KAAKQ,GAAG,CAACpD;QACT,MAAMrB,OAAOmC,OAAOkC,KAAK,CAAC,OAAO;QACjC,IAAI,CAACzE,wBAAwB8E,QAAQ,CAAC1E,OAAO;YAC3C6D,QACE,aACA,CAAC,cAAc,EAAExC,KAAK,gEAAgE,EAAE2C,UAAUvD,IAAI,CAAC,MAAM,CAAC,CAAC,EAC/G,GAAG8D,GAAG,KAAK,CAAC;YAEd;QACF;QACA,MAAMzC,UAAyC,EAAE;QACjD,IAAI9B,SAAS,UAAU;YACrB,MAAM2E,UAAU1C,MAAMC,OAAO,CAACmC,KAAK,CAAC,UAAU,IAAIA,KAAK,CAAC,UAAU,GAAG,EAAE;YACvE,MAAMO,SAAS,IAAIV;YACnB,KAAK,MAAMb,UAAUsB,QAAS;gBAC5B,MAAM5C,QAAQC,SAASqB,UAAUlB,OAAOkB,MAAM,CAAC,QAAQ,EAAEc,KAAK,CAAC,GAAGpD,cAAc;gBAChF,MAAMP,QAAQwB,SAASqB,UAAUlB,OAAOkB,MAAM,CAAC,QAAQ,EAAEc,KAAK,CAAC,GAAGtD,aAAa;gBAC/E,IAAI,CAACkB,SAASpE,aAAa8E,IAAI,CAACV,UAAUpE,aAAa8E,IAAI,CAACjC,QAAQ;oBAClEqD,QAAQ,gBAAgB,CAAC,iBAAiB,EAAExC,KAAK,sBAAsB,CAAC,EAAE,GAAGkD,GAAG,QAAQ,CAAC;oBACzF;gBACF;gBACA,IAAIK,OAAO5B,GAAG,CAACjB,QAAQ;oBACrB8B,QAAQ,gBAAgB,CAAC,gBAAgB,EAAExC,KAAK,mBAAmB,EAAEU,MAAM,EAAE,CAAC,EAAE,GAAGwC,GAAG,QAAQ,CAAC;oBAC/F;gBACF;gBACAK,OAAOH,GAAG,CAAC1C;gBACXD,QAAQiC,IAAI,CAAC;oBAAEhC;mBAAWvB,SAASA,UAAUuB,QAAQ;oBAAEvB;gBAAM,IAAI,CAAC;YACpE;YACA,IAAI,CAACsB,QAAQe,MAAM,EAAE;gBACnBgB,QACE,gBACA,CAAC,YAAY,EAAExC,KAAK,0DAA0D,CAAC,EAC/E,GAAGkD,GAAG,QAAQ,CAAC;gBAEjB;YACF;QACF;QACA,MAAMM,OAAOvC,YAAYtC,MAAMqE,KAAK,CAAC,eAAe,EAAEvC,SAASU;QAC/D,IAAI,WAAWqC,MAAM;YACnBhB,QAAQ,gBAAgB,CAAC,gBAAgB,EAAExC,KAAK,EAAE,EAAEwD,KAAKnC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG6B,GAAG,aAAa,CAAC,EAAEM,KAAKlC,IAAI;YAClG;QACF;QACA,MAAMnC,QAAQ2B,OAAOkC,KAAK,CAAC,QAAQ,EAAEF,KAAK,CAAC,GAAGtD;QAC9C,MAAMS,cAAca,OAAOkC,KAAK,CAAC,cAAc,EAAEF,KAAK,CAAC,GAAGrD;QAC1D,IAAInD,aAAa8E,IAAI,CAACjC,UAAU7C,aAAa8E,IAAI,CAACnB,cAAc;YAC9DuC,QAAQ,cAAc,CAAC,sBAAsB,EAAExC,KAAK,2BAA2B,CAAC,EAAEkD;YAClF;QACF;QACA7C,MAAMqC,IAAI,CAAC;YACT1C;YACArB;WACIQ,QAAQ;YAAEA;QAAM,IAAI,CAAC,GACrBc,cAAc;YAAEA;QAAY,IAAI,CAAC,GACjCuD,KAAK9C,KAAK,KAAKa,YAAY;YAAEf,cAAcgD,KAAK9C,KAAK;QAAC,IAAI,CAAC,GAC3D/B,SAAS,WAAW;YAAE8B;QAAQ,IAAI,CAAC;IAE3C;IACA,kFAAkF;IAClF,MAAM0B,UAAU;WAAIS;KAAK,CAAClE,MAAM,CAAC,CAACsB,OAAS,CAACK,MAAM0B,IAAI,CAAC,CAAC0B,OAASA,KAAKzD,IAAI,KAAKA;IAC/E,OAAO;QAAEK;QAAO8B;QAASC;IAAW;AACtC"}

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

@@ -0,0 +1,106 @@
+/**
+ * @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 { ConsoleImportColumn } from '@aglyn/aglyn/plugin-manager/record-zone-props';
+import { type AiCrmColumnMatch, type AiCrmNextStep, type AiCrmRecordKind } from '../model/ai-crm';
+import type { AiTool } from '../providers/contract';
+import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * The strict tools CRM by AI answers through (AGL-2917), and the checks that
+ * hold each answer to what the CRM can take.
+ *
+ * - `propose_record_insight` — a record's summary, and by kind: the next step
+ *   as a task (a contact, company or deal), a stage (a deal), a lead's
+ *   standing. One schema per kind, so no answer carries a field its record
+ *   cannot use, and each keeps its nullable fields to the one or two a member
+ *   may legitimately be offered nothing for.
+ * - `propose_email_draft` — a subject and a plain-text message.
+ * - `propose_column_matches` — the columns of a file matched to import fields.
+ *
+ * A strict schema forbids extra keys, requires every key, says "no value" with
+ * `null`, and accepts no length keyword, so every length is stated in a
+ * description and enforced here. A check returns a value only when nothing in
+ * the answer is broken, and otherwise the violations and the parts at fault,
+ * for the generation call's one re-ask.
+ */
+export declare const AI_CRM_RECORD_TOOL_NAME = "propose_record_insight";
+export declare const AI_CRM_EMAIL_TOOL_NAME = "propose_email_draft";
+export declare const AI_CRM_MAPPING_TOOL_NAME = "propose_column_matches";
+/** The record tool for one kind of record. */
+export declare function aiCrmRecordTool(kind: AiCrmRecordKind): AiTool;
+export declare const AI_CRM_EMAIL_TOOL: AiTool;
+export declare const AI_CRM_MAPPING_TOOL: AiTool;
+export interface AiCrmCheckResult<T> {
+    value: T | null;
+    violations: AiDoctrineViolation[];
+    offending?: Record<string, unknown>;
+}
+type Facts = Readonly<Record<string, unknown>>;
+/** What the record facts say a check needs: a deal's stages and status, and every record's open tasks. */
+export interface AiCrmRecordCheckContext {
+    kind: AiCrmRecordKind;
+    /** The deal's stage, and its pipeline's stages in order. */
+    stageId?: string;
+    status?: string;
+    stages?: ReadonlyArray<{
+        id: string;
+        name: string;
+        kind: string;
+    }>;
+    /** The titles of the record's open tasks, which a next step may not repeat. */
+    openTaskTitles?: readonly string[];
+}
+export interface AiCrmRecordAnswer {
+    summary: string;
+    nextStep: AiCrmNextStep | null;
+    stage: {
+        stageId: string;
+        stageName: string;
+        reason: string;
+    } | null;
+    standing: string | null;
+}
+/** What a record's facts say its check needs. */
+export declare function aiCrmRecordCheckContext(kind: AiCrmRecordKind, facts: Facts): AiCrmRecordCheckContext;
+/** A record answer held to the record it is about. */
+export declare function checkAiCrmRecord(answer: Record<string, unknown>, context: AiCrmRecordCheckContext): AiCrmCheckResult<AiCrmRecordAnswer>;
+/** The merge fields an email from a record may use: never an address. */
+export declare function aiCrmEmailMergeFields(kind: AiCrmRecordKind): string[];
+/** Whether text writes a phone number: a run of ten digits or more that is not a list of days. */
+export declare function aiCrmWritesPhoneNumber(text: string): boolean;
+export interface AiCrmEmailAnswer {
+    subject: string;
+    body: string;
+}
+/** An email answer held to the composer and to what a person may be sent. */
+export declare function checkAiCrmEmail(answer: Record<string, unknown>, context: {
+    mergeFields: readonly string[];
+}): AiCrmCheckResult<AiCrmEmailAnswer>;
+/** One field an import may fill, as the CRM's catalog lists it. */
+export interface AiCrmImportField {
+    key: string;
+    label: string;
+    type: string;
+    required: boolean;
+}
+/** An import catalog's fields as the facts report them, in the order they are numbered. */
+export declare function aiCrmImportFields(facts: Facts): AiCrmImportField[];
+/** A mapping answer held to the file's columns and the import's fields. */
+export declare function checkAiCrmMapping(answer: Record<string, unknown>, context: {
+    columns: readonly ConsoleImportColumn[];
+    fields: readonly AiCrmImportField[];
+}): AiCrmCheckResult<AiCrmColumnMatch[]>;
+export {};