@aglyn/plugins-ai 1.0.0-beta.228 → 1.0.0-beta.230

package/src/lib/model/ai-logic-job.js

@@ -0,0 +1,327 @@
+/**
+ * @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 { evaluateHostFunction, expressionSyntaxError, functionReferencedNames } from "@aglyn/aglyn/app-utils/functions";
+import { functionGlobals, VARIABLE_NAME_PATTERN } from "@aglyn/aglyn/app-utils/variables";
+/**
+ * A `logic` job (AGL-3603): a site's Functions & Variables, by AI.
+ *
+ *  - `function` proposes a function — parameters, locals, the numbered
+ *    if/then/otherwise operations and the value it returns — from a
+ *    description, or, naming a saved function, a changed or fixed copy of
+ *    it. Every expression is held to the evaluator's own grammar
+ *    (`expressionSyntaxError`), every name it reads to the function's own
+ *    names and the site's variables, and the whole definition is run once
+ *    with each parameter at its starting value before anyone sees it.
+ *  - `variable` proposes one site variable: a name, a type and a value in
+ *    that type's stored form.
+ *  - `explain` reads a saved function and answers in plain words what it
+ *    computes, and anything in it worth checking.
+ *
+ * Nothing is written: a proposal rides on the job's output, and the logic
+ * editor is where a person saves it, or does not.
+ */ export const AI_LOGIC_JOB_MODES = [
+    'function',
+    'variable',
+    'explain'
+];
+const DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/;
+export const AI_LOGIC_PICK_FUNCTION_COPY = 'Pick the function to explain';
+/** A job's inputs read into its mode, or the sentence that says what is wrong with them. */ export function parseAiLogicJobInputs(inputs) {
+    var _ref;
+    const mode = (_ref = inputs == null ? void 0 : inputs['mode']) != null ? _ref : 'function';
+    if (!AI_LOGIC_JOB_MODES.includes(mode)) {
+        return 'inputs.mode must be function, variable or explain';
+    }
+    if (mode === 'variable') return {
+        mode
+    };
+    const functionId = inputs == null ? void 0 : inputs['functionId'];
+    const named = typeof functionId === 'string' && DOCUMENT_ID.test(functionId) ? functionId : null;
+    if (functionId != null && !named) return AI_LOGIC_PICK_FUNCTION_COPY;
+    if (mode === 'explain') return named ? {
+        mode,
+        functionId: named
+    } : AI_LOGIC_PICK_FUNCTION_COPY;
+    return {
+        mode: 'function',
+        functionId: named
+    };
+}
+// ── The bounds a proposal is held to ──────────────────────────────────────
+export const AI_LOGIC_MAX_PARAMETERS = 12;
+export const AI_LOGIC_MAX_LOCALS = 20;
+export const AI_LOGIC_MAX_OPERATIONS = 24;
+export const AI_LOGIC_MAX_SETS = 12;
+export const AI_LOGIC_EXPRESSION_MAX_CHARS = 400;
+export const AI_LOGIC_LABEL_MAX_CHARS = 80;
+export const AI_LOGIC_VARIABLE_VALUE_MAX_CHARS = 2000;
+export const AI_LOGIC_VALUE_TYPES = [
+    'number',
+    'text',
+    'boolean'
+];
+export const AI_LOGIC_COMPARATORS = [
+    '==',
+    '!=',
+    '<',
+    '<=',
+    '>',
+    '>='
+];
+/** The variable types a proposal may use: every type the Variables editor offers. */ export const AI_LOGIC_VARIABLE_TYPES = [
+    'text',
+    'number',
+    'boolean',
+    'date',
+    'time',
+    'dictionary',
+    'collection'
+];
+const violation = (code, message)=>({
+        rule: null,
+        code,
+        message
+    });
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+const MARKUP = /<\s*\/?\s*(script|iframe|style|object|embed)\b|javascript:/i;
+/** A starting value a parameter's type can hold, for the run every proposal is given. */ function sampleFor(type, defaultValue) {
+    if (defaultValue) return defaultValue;
+    return type === 'number' ? '1' : type === 'boolean' ? 'true' : 'sample';
+}
+/**
+ * A `submit_function` answer read into a definition the function editor
+ * opens, or the violations a re-ask names. Only what the evaluator can run
+ * is kept: an expression it cannot parse, a name it cannot find, a SET on a
+ * site variable, or a run that fails on starting values is refused.
+ */ export function checkAiLogicFunction(answer, context) {
+    const violations = [];
+    const name = str(answer['name']);
+    if (!VARIABLE_NAME_PATTERN.test(name)) {
+        violations.push(violation('logic-name', 'The function name must start with a letter or _, then letters, digits or _; at most 40 characters.'));
+    } else if (name !== context.editing && context.functions.includes(name)) {
+        violations.push(violation('logic-name-taken', `The site already has a function named ${name}. Choose another name.`));
+    }
+    const own = new Set();
+    const ownName = (raw, what)=>{
+        const value = str(raw);
+        if (!VARIABLE_NAME_PATTERN.test(value)) {
+            violations.push(violation('logic-name', `A ${what} name must start with a letter or _, then letters, digits or _.`));
+        } else if (own.has(value)) {
+            violations.push(violation('logic-name-repeated', `The name ${value} is used twice. Each parameter and local needs its own name.`));
+        }
+        own.add(value);
+        return value;
+    };
+    const typeOf = (raw)=>{
+        if (AI_LOGIC_VALUE_TYPES.includes(raw)) return raw;
+        violations.push(violation('logic-type', 'A type is number, text or boolean.'));
+        return 'number';
+    };
+    const rawParameters = Array.isArray(answer['parameters']) ? answer['parameters'].filter(isRecord) : [];
+    const rawLocals = Array.isArray(answer['locals']) ? answer['locals'].filter(isRecord) : [];
+    const rawOperations = Array.isArray(answer['operations']) ? answer['operations'].filter(isRecord) : [];
+    if (rawParameters.length > AI_LOGIC_MAX_PARAMETERS) {
+        violations.push(violation('logic-size', `At most ${AI_LOGIC_MAX_PARAMETERS} parameters.`));
+    }
+    if (rawLocals.length > AI_LOGIC_MAX_LOCALS) {
+        violations.push(violation('logic-size', `At most ${AI_LOGIC_MAX_LOCALS} locals.`));
+    }
+    if (!rawOperations.length || rawOperations.length > AI_LOGIC_MAX_OPERATIONS) {
+        violations.push(violation('logic-size', `Between 1 and ${AI_LOGIC_MAX_OPERATIONS} operations.`));
+    }
+    const parameters = rawParameters.slice(0, AI_LOGIC_MAX_PARAMETERS).map((raw)=>{
+        const parameter = {
+            name: ownName(raw['name'], 'parameter'),
+            type: typeOf(raw['type']),
+            required: raw['required'] === true
+        };
+        const label = str(raw['label']).slice(0, AI_LOGIC_LABEL_MAX_CHARS);
+        if (label) parameter.label = label;
+        const start = str(raw['defaultValue']).slice(0, AI_LOGIC_LABEL_MAX_CHARS);
+        if (start) parameter.defaultValue = start;
+        return parameter;
+    });
+    const variables = rawLocals.slice(0, AI_LOGIC_MAX_LOCALS).map((raw)=>({
+            name: ownName(raw['name'], 'local'),
+            type: typeOf(raw['type'])
+        }));
+    const site = new Set(context.variables.map((variable)=>variable.name));
+    const expression = (raw, where)=>{
+        const text = typeof raw === 'string' ? raw.trim() : '';
+        if (!text) {
+            violations.push(violation('logic-expression', `${where} is empty. Write a value, a name or an expression.`));
+            return text;
+        }
+        if (text.length > AI_LOGIC_EXPRESSION_MAX_CHARS || MARKUP.test(text)) {
+            violations.push(violation('logic-expression', `${where} is not an expression the function can run.`));
+            return text;
+        }
+        const problem = expressionSyntaxError(text);
+        if (problem) violations.push(violation('logic-syntax', `${where} cannot be read: ${problem}.`));
+        return text;
+    };
+    const sets = (raw, where)=>{
+        const list = Array.isArray(raw) ? raw.filter(isRecord) : [];
+        if (list.length > AI_LOGIC_MAX_SETS) {
+            violations.push(violation('logic-size', `${where} has more than ${AI_LOGIC_MAX_SETS} assignments.`));
+        }
+        return list.slice(0, AI_LOGIC_MAX_SETS).map((set, index)=>{
+            const target = str(set['set']);
+            if (!own.has(target)) {
+                violations.push(violation('logic-set-target', site.has(target) ? `${where}, assignment ${index + 1}, sets the site variable ${target}. A function reads site variables and sets only its own parameters and locals.` : `${where}, assignment ${index + 1}, sets ${target || 'nothing'}, which is not one of the function's parameters or locals.`));
+            }
+            return {
+                set: target,
+                expression: expression(set['expression'], `${where}, assignment ${index + 1}`)
+            };
+        });
+    };
+    const operations = rawOperations.slice(0, AI_LOGIC_MAX_OPERATIONS).map((raw, index)=>{
+        const where = `Operation ${index + 1}`;
+        const condition = isRecord(raw['if']) ? raw['if'] : {};
+        const comparator = AI_LOGIC_COMPARATORS.includes(condition['comparator']) ? condition['comparator'] : null;
+        if (!comparator) violations.push(violation('logic-comparator', `${where}'s condition compares with one of == != < <= > >=.`));
+        return {
+            if: {
+                left: expression(condition['left'], `${where}'s condition (left)`),
+                comparator: comparator != null ? comparator : '==',
+                right: expression(condition['right'], `${where}'s condition (right)`)
+            },
+            then: sets(raw['then'], `${where} (then)`),
+            otherwise: sets(raw['otherwise'], `${where} (otherwise)`)
+        };
+    });
+    const returnValue = str(answer['returnValue']);
+    if (!own.has(returnValue)) {
+        violations.push(violation('logic-return', 'returnValue names one of the function’s own parameters or locals.'));
+    }
+    const definition = {
+        name,
+        parameters,
+        variables,
+        operations,
+        returnValue
+    };
+    // Every name an expression reads that is not the function's own must be a site variable.
+    const unknown = functionReferencedNames(definition).filter((read)=>!site.has(read));
+    if (unknown.length) {
+        violations.push(violation('logic-unknown-name', `The function reads ${unknown.join(', ')}, which is neither one of its own names nor a site variable. Use only the names listed.`));
+    }
+    if (!violations.length) {
+        // One run with every parameter at a starting value: what the editor's
+        // own test run would show first, so a definition that cannot run on its
+        // first try is refused here rather than handed to a person.
+        const variablesByName = Object.fromEntries(context.variables.map((variable)=>[
+                variable.name,
+                variable
+            ]));
+        const args = Object.fromEntries(parameters.map((parameter)=>[
+                parameter.name,
+                sampleFor(parameter.type, parameter.defaultValue)
+            ]));
+        const run = evaluateHostFunction(definition, args, {
+            globals: functionGlobals(definition, variablesByName)
+        });
+        if (run.ok === false) violations.push(violation('logic-run', `The function fails when it runs: ${run.error}.`));
+    }
+    return {
+        value: violations.length ? null : definition,
+        violations
+    };
+}
+/** A `submit_variable` answer read into the variable the Variables editor opens. */ export function checkAiLogicVariable(answer, context) {
+    const violations = [];
+    const name = str(answer['name']);
+    if (!VARIABLE_NAME_PATTERN.test(name)) {
+        violations.push(violation('logic-name', 'The variable name must start with a letter or _, then letters, digits or _; at most 40 characters.'));
+    } else if (context.variables.some((variable)=>variable.name === name)) {
+        violations.push(violation('logic-name-taken', `The site already has a variable named ${name}. Choose another name.`));
+    }
+    const type = answer['type'];
+    if (!AI_LOGIC_VARIABLE_TYPES.includes(type)) {
+        violations.push(violation('logic-type', `A variable's type is one of ${AI_LOGIC_VARIABLE_TYPES.join(', ')}.`));
+    }
+    const value = typeof answer['value'] === 'string' ? answer['value'] : '';
+    if (value.length > AI_LOGIC_VARIABLE_VALUE_MAX_CHARS || MARKUP.test(value)) {
+        violations.push(violation('logic-value', 'The value is too long, or holds markup.'));
+    } else if (type === 'number' && !Number.isFinite(Number(value))) {
+        violations.push(violation('logic-value', 'A number variable’s value is a number, such as 49 or 0.5.'));
+    } else if (type === 'boolean' && value !== 'true' && value !== 'false') {
+        violations.push(violation('logic-value', 'A boolean variable’s value is true or false.'));
+    } else if (type === 'date' && Number.isNaN(new Date(value).getTime())) {
+        violations.push(violation('logic-value', 'A date variable’s value is a date such as 2026-10-01.'));
+    } else if (type === 'dictionary' || type === 'collection') {
+        let parsed;
+        try {
+            parsed = JSON.parse(value);
+        } catch (unused) {
+            parsed = null;
+        }
+        const fits = type === 'collection' ? Array.isArray(parsed) : isRecord(parsed);
+        if (!fits) {
+            violations.push(violation('logic-value', type === 'collection' ? 'A collection’s value is a JSON list, such as ["red","green"].' : 'A dictionary’s value is a JSON object of names to values, such as {"starter":19,"pro":49}.'));
+        }
+    }
+    return {
+        value: violations.length ? null : {
+            name,
+            type: type,
+            value
+        },
+        violations
+    };
+}
+// ── What a job hands the logic editor ─────────────────────────────────────
+/** The output resource a logic proposal rides on. */ export const AI_LOGIC_RESOURCE = 'logic';
+/**
+ * A proposal read back from a job's output, in the browser, before the
+ * editor is handed it; `null` for anything that is not one. The server held
+ * the definition to the grammar; this only refuses a shape that is not one.
+ */ export function readAiLogicProposal(value) {
+    if (!isRecord(value)) return null;
+    if (value['kind'] === 'variable' && isRecord(value['variable'])) {
+        const variable = value['variable'];
+        if (typeof variable['name'] !== 'string' || typeof variable['type'] !== 'string') return null;
+        return {
+            kind: 'variable',
+            variable: {
+                name: variable['name'],
+                type: variable['type'],
+                value: typeof variable['value'] === 'string' ? variable['value'] : ''
+            }
+        };
+    }
+    if (value['kind'] !== 'function' || !isRecord(value['definition'])) return null;
+    const definition = value['definition'];
+    if (typeof definition['name'] !== 'string' || !Array.isArray(definition['parameters']) || !Array.isArray(definition['variables']) || !Array.isArray(definition['operations'])) {
+        return null;
+    }
+    return {
+        kind: 'function',
+        functionId: typeof value['functionId'] === 'string' ? value['functionId'] : null,
+        definition: definition
+    };
+}
+// ── What a job tells a person ─────────────────────────────────────────────
+export const AI_LOGIC_NO_SITE_COPY = 'This logic job names a site this workspace does not have.';
+export const AI_LOGIC_UNAVAILABLE_COPY = 'Turn on Logic for this site before starting the job.';
+export const AI_LOGIC_GONE_COPY = 'That function no longer exists.';
+export const AI_LOGIC_NO_FUNCTION_COPY = 'The AI could not write a function the site can run from this description. Try describing what goes in, and what should come out.';
+export const AI_LOGIC_NO_VARIABLE_COPY = 'The AI could not write a variable from this description. Try naming what it holds, and its value.';
+export const AI_LOGIC_NO_EXPLANATION_COPY = 'The AI could not explain this function. Try again.';
+
+//# sourceMappingURL=ai-logic-job.js.map

package/src/lib/model/ai-logic-job.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-logic-job.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  evaluateHostFunction,\n  expressionSyntaxError,\n  type FunctionComparator,\n  type FunctionValueType,\n  type HostFunction,\n  functionReferencedNames,\n} from '@aglyn/aglyn/app-utils/functions'\nimport {\n  functionGlobals,\n  type HostVariable,\n  type HostVariableType,\n  VARIABLE_NAME_PATTERN,\n} from '@aglyn/aglyn/app-utils/variables'\nimport type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\n\n/**\n * A `logic` job (AGL-3603): a site's Functions & Variables, by AI.\n *\n *  - `function` proposes a function — parameters, locals, the numbered\n *    if/then/otherwise operations and the value it returns — from a\n *    description, or, naming a saved function, a changed or fixed copy of\n *    it. Every expression is held to the evaluator's own grammar\n *    (`expressionSyntaxError`), every name it reads to the function's own\n *    names and the site's variables, and the whole definition is run once\n *    with each parameter at its starting value before anyone sees it.\n *  - `variable` proposes one site variable: a name, a type and a value in\n *    that type's stored form.\n *  - `explain` reads a saved function and answers in plain words what it\n *    computes, and anything in it worth checking.\n *\n * Nothing is written: a proposal rides on the job's output, and the logic\n * editor is where a person saves it, or does not.\n */\n\nexport const AI_LOGIC_JOB_MODES = ['function', 'variable', 'explain'] as const\nexport type AiLogicJobMode = (typeof AI_LOGIC_JOB_MODES)[number]\n\nexport type AiLogicJobInputs =\n  | { mode: 'function'; functionId: string | null }\n  | { mode: 'variable' }\n  | { mode: 'explain'; functionId: string }\n\nconst DOCUMENT_ID = /^[A-Za-z0-9_-]{1,128}$/\n\nexport const AI_LOGIC_PICK_FUNCTION_COPY = 'Pick the function to explain'\n\n/** A job's inputs read into its mode, or the sentence that says what is wrong with them. */\nexport function parseAiLogicJobInputs(\n  inputs: Readonly<Record<string, unknown>> | null | undefined,\n): AiLogicJobInputs | string {\n  const mode = inputs?.['mode'] ?? 'function'\n  if (!(AI_LOGIC_JOB_MODES as readonly unknown[]).includes(mode)) {\n    return 'inputs.mode must be function, variable or explain'\n  }\n  if (mode === 'variable') return { mode }\n  const functionId = inputs?.['functionId']\n  const named = typeof functionId === 'string' && DOCUMENT_ID.test(functionId) ? functionId : null\n  if (functionId != null && !named) return AI_LOGIC_PICK_FUNCTION_COPY\n  if (mode === 'explain') return named ? { mode, functionId: named } : AI_LOGIC_PICK_FUNCTION_COPY\n  return { mode: 'function', functionId: named }\n}\n\n// ── The bounds a proposal is held to ──────────────────────────────────────\n\nexport const AI_LOGIC_MAX_PARAMETERS = 12\nexport const AI_LOGIC_MAX_LOCALS = 20\nexport const AI_LOGIC_MAX_OPERATIONS = 24\nexport const AI_LOGIC_MAX_SETS = 12\nexport const AI_LOGIC_EXPRESSION_MAX_CHARS = 400\nexport const AI_LOGIC_LABEL_MAX_CHARS = 80\nexport const AI_LOGIC_VARIABLE_VALUE_MAX_CHARS = 2_000\n\nexport const AI_LOGIC_VALUE_TYPES: readonly FunctionValueType[] = ['number', 'text', 'boolean']\nexport const AI_LOGIC_COMPARATORS: readonly FunctionComparator[] = ['==', '!=', '<', '<=', '>', '>=']\n\n/** The variable types a proposal may use: every type the Variables editor offers. */\nexport const AI_LOGIC_VARIABLE_TYPES: readonly HostVariableType[] = [\n  'text',\n  'number',\n  'boolean',\n  'date',\n  'time',\n  'dictionary',\n  'collection',\n]\n\n/** A site variable as a proposal is checked against: its name, type and value. */\nexport type AiLogicSiteVariable = Pick<HostVariable, 'name' | 'type' | 'value'>\n\n/** What a proposal's names are checked against: the site's variables and functions. */\nexport interface AiLogicContext {\n  variables: readonly AiLogicSiteVariable[]\n  /** The site's function names, which a new function's name must not repeat. */\n  functions: readonly string[]\n  /** The saved function a change starts from; its own name is free to keep. */\n  editing?: string | null\n}\n\nexport interface AiLogicCheckResult<T> {\n  value: T | null\n  violations: AiDoctrineViolation[]\n}\n\nconst violation = (code: string, message: string): AiDoctrineViolation => ({ rule: null, code, message })\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nconst MARKUP = /<\\s*\\/?\\s*(script|iframe|style|object|embed)\\b|javascript:/i\n\n/** A starting value a parameter's type can hold, for the run every proposal is given. */\nfunction sampleFor(type: FunctionValueType, defaultValue: string | undefined): string {\n  if (defaultValue) return defaultValue\n  return type === 'number' ? '1' : type === 'boolean' ? 'true' : 'sample'\n}\n\n/**\n * A `submit_function` answer read into a definition the function editor\n * opens, or the violations a re-ask names. Only what the evaluator can run\n * is kept: an expression it cannot parse, a name it cannot find, a SET on a\n * site variable, or a run that fails on starting values is refused.\n */\nexport function checkAiLogicFunction(\n  answer: Record<string, unknown>,\n  context: AiLogicContext,\n): AiLogicCheckResult<HostFunction> {\n  const violations: AiDoctrineViolation[] = []\n  const name = str(answer['name'])\n  if (!VARIABLE_NAME_PATTERN.test(name)) {\n    violations.push(\n      violation('logic-name', 'The function name must start with a letter or _, then letters, digits or _; at most 40 characters.'),\n    )\n  } else if (name !== context.editing && context.functions.includes(name)) {\n    violations.push(violation('logic-name-taken', `The site already has a function named ${name}. Choose another name.`))\n  }\n\n  const own = new Set<string>()\n  const ownName = (raw: unknown, what: string): string => {\n    const value = str(raw)\n    if (!VARIABLE_NAME_PATTERN.test(value)) {\n      violations.push(violation('logic-name', `A ${what} name must start with a letter or _, then letters, digits or _.`))\n    } else if (own.has(value)) {\n      violations.push(violation('logic-name-repeated', `The name ${value} is used twice. Each parameter and local needs its own name.`))\n    }\n    own.add(value)\n    return value\n  }\n  const typeOf = (raw: unknown): FunctionValueType => {\n    if ((AI_LOGIC_VALUE_TYPES as readonly unknown[]).includes(raw)) return raw as FunctionValueType\n    violations.push(violation('logic-type', 'A type is number, text or boolean.'))\n    return 'number'\n  }\n\n  const rawParameters = Array.isArray(answer['parameters']) ? answer['parameters'].filter(isRecord) : []\n  const rawLocals = Array.isArray(answer['locals']) ? answer['locals'].filter(isRecord) : []\n  const rawOperations = Array.isArray(answer['operations']) ? answer['operations'].filter(isRecord) : []\n  if (rawParameters.length > AI_LOGIC_MAX_PARAMETERS) {\n    violations.push(violation('logic-size', `At most ${AI_LOGIC_MAX_PARAMETERS} parameters.`))\n  }\n  if (rawLocals.length > AI_LOGIC_MAX_LOCALS) {\n    violations.push(violation('logic-size', `At most ${AI_LOGIC_MAX_LOCALS} locals.`))\n  }\n  if (!rawOperations.length || rawOperations.length > AI_LOGIC_MAX_OPERATIONS) {\n    violations.push(violation('logic-size', `Between 1 and ${AI_LOGIC_MAX_OPERATIONS} operations.`))\n  }\n\n  const parameters = rawParameters.slice(0, AI_LOGIC_MAX_PARAMETERS).map((raw) => {\n    const parameter: HostFunction['parameters'][number] = {\n      name: ownName(raw['name'], 'parameter'),\n      type: typeOf(raw['type']),\n      required: raw['required'] === true,\n    }\n    const label = str(raw['label']).slice(0, AI_LOGIC_LABEL_MAX_CHARS)\n    if (label) parameter.label = label\n    const start = str(raw['defaultValue']).slice(0, AI_LOGIC_LABEL_MAX_CHARS)\n    if (start) parameter.defaultValue = start\n    return parameter\n  })\n  const variables = rawLocals.slice(0, AI_LOGIC_MAX_LOCALS).map((raw) => ({\n    name: ownName(raw['name'], 'local'),\n    type: typeOf(raw['type']),\n  }))\n\n  const site = new Set(context.variables.map((variable) => variable.name))\n  const expression = (raw: unknown, where: string): string => {\n    const text = typeof raw === 'string' ? raw.trim() : ''\n    if (!text) {\n      violations.push(violation('logic-expression', `${where} is empty. Write a value, a name or an expression.`))\n      return text\n    }\n    if (text.length > AI_LOGIC_EXPRESSION_MAX_CHARS || MARKUP.test(text)) {\n      violations.push(violation('logic-expression', `${where} is not an expression the function can run.`))\n      return text\n    }\n    const problem = expressionSyntaxError(text)\n    if (problem) violations.push(violation('logic-syntax', `${where} cannot be read: ${problem}.`))\n    return text\n  }\n  const sets = (raw: unknown, where: string) => {\n    const list = Array.isArray(raw) ? raw.filter(isRecord) : []\n    if (list.length > AI_LOGIC_MAX_SETS) {\n      violations.push(violation('logic-size', `${where} has more than ${AI_LOGIC_MAX_SETS} assignments.`))\n    }\n    return list.slice(0, AI_LOGIC_MAX_SETS).map((set, index) => {\n      const target = str(set['set'])\n      if (!own.has(target)) {\n        violations.push(\n          violation(\n            'logic-set-target',\n            site.has(target)\n              ? `${where}, assignment ${index + 1}, sets the site variable ${target}. A function reads site variables and sets only its own parameters and locals.`\n              : `${where}, assignment ${index + 1}, sets ${target || 'nothing'}, which is not one of the function's parameters or locals.`,\n          ),\n        )\n      }\n      return { set: target, expression: expression(set['expression'], `${where}, assignment ${index + 1}`) }\n    })\n  }\n  const operations = rawOperations.slice(0, AI_LOGIC_MAX_OPERATIONS).map((raw, index) => {\n    const where = `Operation ${index + 1}`\n    const condition = isRecord(raw['if']) ? raw['if'] : {}\n    const comparator = (AI_LOGIC_COMPARATORS as readonly unknown[]).includes(condition['comparator'])\n      ? (condition['comparator'] as FunctionComparator)\n      : null\n    if (!comparator) violations.push(violation('logic-comparator', `${where}'s condition compares with one of == != < <= > >=.`))\n    return {\n      if: {\n        left: expression(condition['left'], `${where}'s condition (left)`),\n        comparator: comparator ?? '==',\n        right: expression(condition['right'], `${where}'s condition (right)`),\n      },\n      then: sets(raw['then'], `${where} (then)`),\n      otherwise: sets(raw['otherwise'], `${where} (otherwise)`),\n    }\n  })\n\n  const returnValue = str(answer['returnValue'])\n  if (!own.has(returnValue)) {\n    violations.push(violation('logic-return', 'returnValue names one of the function’s own parameters or locals.'))\n  }\n  const definition: HostFunction = { name, parameters, variables, operations, returnValue }\n\n  // Every name an expression reads that is not the function's own must be a site variable.\n  const unknown = functionReferencedNames(definition).filter((read) => !site.has(read))\n  if (unknown.length) {\n    violations.push(\n      violation(\n        'logic-unknown-name',\n        `The function reads ${unknown.join(', ')}, which is neither one of its own names nor a site variable. Use only the names listed.`,\n      ),\n    )\n  }\n\n  if (!violations.length) {\n    // One run with every parameter at a starting value: what the editor's\n    // own test run would show first, so a definition that cannot run on its\n    // first try is refused here rather than handed to a person.\n    const variablesByName = Object.fromEntries(\n      context.variables.map((variable) => [variable.name, variable as HostVariable]),\n    )\n    const args = Object.fromEntries(\n      parameters.map((parameter) => [parameter.name, sampleFor(parameter.type, parameter.defaultValue)]),\n    )\n    const run = evaluateHostFunction(definition, args, { globals: functionGlobals(definition, variablesByName) })\n    if (run.ok === false) violations.push(violation('logic-run', `The function fails when it runs: ${run.error}.`))\n  }\n  return { value: violations.length ? null : definition, violations }\n}\n\n/** A `submit_variable` answer read into the variable the Variables editor opens. */\nexport function checkAiLogicVariable(\n  answer: Record<string, unknown>,\n  context: Pick<AiLogicContext, 'variables'>,\n): AiLogicCheckResult<AiLogicSiteVariable> {\n  const violations: AiDoctrineViolation[] = []\n  const name = str(answer['name'])\n  if (!VARIABLE_NAME_PATTERN.test(name)) {\n    violations.push(violation('logic-name', 'The variable name must start with a letter or _, then letters, digits or _; at most 40 characters.'))\n  } else if (context.variables.some((variable) => variable.name === name)) {\n    violations.push(violation('logic-name-taken', `The site already has a variable named ${name}. Choose another name.`))\n  }\n  const type = answer['type']\n  if (!(AI_LOGIC_VARIABLE_TYPES as readonly unknown[]).includes(type)) {\n    violations.push(violation('logic-type', `A variable's type is one of ${AI_LOGIC_VARIABLE_TYPES.join(', ')}.`))\n  }\n  const value = typeof answer['value'] === 'string' ? answer['value'] : ''\n  if (value.length > AI_LOGIC_VARIABLE_VALUE_MAX_CHARS || MARKUP.test(value)) {\n    violations.push(violation('logic-value', 'The value is too long, or holds markup.'))\n  } else if (type === 'number' && !Number.isFinite(Number(value))) {\n    violations.push(violation('logic-value', 'A number variable’s value is a number, such as 49 or 0.5.'))\n  } else if (type === 'boolean' && value !== 'true' && value !== 'false') {\n    violations.push(violation('logic-value', 'A boolean variable’s value is true or false.'))\n  } else if (type === 'date' && Number.isNaN(new Date(value).getTime())) {\n    violations.push(violation('logic-value', 'A date variable’s value is a date such as 2026-10-01.'))\n  } else if (type === 'dictionary' || type === 'collection') {\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(value)\n    } catch {\n      parsed = null\n    }\n    const fits = type === 'collection' ? Array.isArray(parsed) : isRecord(parsed)\n    if (!fits) {\n      violations.push(\n        violation(\n          'logic-value',\n          type === 'collection'\n            ? 'A collection’s value is a JSON list, such as [\"red\",\"green\"].'\n            : 'A dictionary’s value is a JSON object of names to values, such as {\"starter\":19,\"pro\":49}.',\n        ),\n      )\n    }\n  }\n  return {\n    value: violations.length ? null : { name, type: type as HostVariableType, value },\n    violations,\n  }\n}\n\n// ── What a job hands the logic editor ─────────────────────────────────────\n\n/** The output resource a logic proposal rides on. */\nexport const AI_LOGIC_RESOURCE = 'logic'\n\n/** A logic output's proposal: a function to open in the editor, or a variable. */\nexport type AiLogicProposal =\n  | { kind: 'function'; functionId: string | null; definition: HostFunction }\n  | { kind: 'variable'; variable: AiLogicSiteVariable }\n\n/**\n * A proposal read back from a job's output, in the browser, before the\n * editor is handed it; `null` for anything that is not one. The server held\n * the definition to the grammar; this only refuses a shape that is not one.\n */\nexport function readAiLogicProposal(value: unknown): AiLogicProposal | null {\n  if (!isRecord(value)) return null\n  if (value['kind'] === 'variable' && isRecord(value['variable'])) {\n    const variable = value['variable']\n    if (typeof variable['name'] !== 'string' || typeof variable['type'] !== 'string') return null\n    return {\n      kind: 'variable',\n      variable: {\n        name: variable['name'],\n        type: variable['type'] as HostVariableType,\n        value: typeof variable['value'] === 'string' ? variable['value'] : '',\n      },\n    }\n  }\n  if (value['kind'] !== 'function' || !isRecord(value['definition'])) return null\n  const definition = value['definition']\n  if (\n    typeof definition['name'] !== 'string' ||\n    !Array.isArray(definition['parameters']) ||\n    !Array.isArray(definition['variables']) ||\n    !Array.isArray(definition['operations'])\n  ) {\n    return null\n  }\n  return {\n    kind: 'function',\n    functionId: typeof value['functionId'] === 'string' ? value['functionId'] : null,\n    definition: definition as unknown as HostFunction,\n  }\n}\n\n// ── What a job tells a person ─────────────────────────────────────────────\n\nexport const AI_LOGIC_NO_SITE_COPY = 'This logic job names a site this workspace does not have.'\nexport const AI_LOGIC_UNAVAILABLE_COPY = 'Turn on Logic for this site before starting the job.'\nexport const AI_LOGIC_GONE_COPY = 'That function no longer exists.'\nexport const AI_LOGIC_NO_FUNCTION_COPY =\n  'The AI could not write a function the site can run from this description. Try describing what goes in, and what should come out.'\nexport const AI_LOGIC_NO_VARIABLE_COPY =\n  'The AI could not write a variable from this description. Try naming what it holds, and its value.'\nexport const AI_LOGIC_NO_EXPLANATION_COPY = 'The AI could not explain this function. Try again.'\n"],"names":["evaluateHostFunction","expressionSyntaxError","functionReferencedNames","functionGlobals","VARIABLE_NAME_PATTERN","AI_LOGIC_JOB_MODES","DOCUMENT_ID","AI_LOGIC_PICK_FUNCTION_COPY","parseAiLogicJobInputs","inputs","mode","includes","functionId","named","test","AI_LOGIC_MAX_PARAMETERS","AI_LOGIC_MAX_LOCALS","AI_LOGIC_MAX_OPERATIONS","AI_LOGIC_MAX_SETS","AI_LOGIC_EXPRESSION_MAX_CHARS","AI_LOGIC_LABEL_MAX_CHARS","AI_LOGIC_VARIABLE_VALUE_MAX_CHARS","AI_LOGIC_VALUE_TYPES","AI_LOGIC_COMPARATORS","AI_LOGIC_VARIABLE_TYPES","violation","code","message","rule","isRecord","value","Array","isArray","str","trim","MARKUP","sampleFor","type","defaultValue","checkAiLogicFunction","answer","context","violations","name","push","editing","functions","own","Set","ownName","raw","what","has","add","typeOf","rawParameters","filter","rawLocals","rawOperations","length","parameters","slice","map","parameter","required","label","start","variables","site","variable","expression","where","text","problem","sets","list","set","index","target","operations","condition","comparator","if","left","right","then","otherwise","returnValue","definition","unknown","read","join","variablesByName","Object","fromEntries","args","run","globals","ok","error","checkAiLogicVariable","some","Number","isFinite","isNaN","Date","getTime","parsed","JSON","parse","fits","AI_LOGIC_RESOURCE","readAiLogicProposal","kind","AI_LOGIC_NO_SITE_COPY","AI_LOGIC_UNAVAILABLE_COPY","AI_LOGIC_GONE_COPY","AI_LOGIC_NO_FUNCTION_COPY","AI_LOGIC_NO_VARIABLE_COPY","AI_LOGIC_NO_EXPLANATION_COPY"],"mappings":"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"}

package/src/lib/model/ai-media-credits.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @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 { AiUsage } from '../providers/contract';
+import type { AiImageMode } from '../providers/image-contract';
+/**
+ * What one picture in Media is expected to draw (AGL-3602), in credits: the
+ * estimate the dialog shows before anything is spent, and the figure the
+ * door holds a walled band to. Browser-safe, so both read the same number.
+ *
+ * Each is an ESTIMATE at nominal usage, priced at the billed rates:
+ *
+ * - a photo is one picture at its per-picture rate, plus a prompt and the
+ *   thinking Google's model does before it draws;
+ * - an illustration is the text provider's answer — the instructions, the
+ *   description, and a few thousand tokens of SVG.
+ *
+ * What is actually charged is what was spent, measured: a picture held back
+ * or not stored is never charged, and an illustration that needed its second
+ * attempt costs about twice its estimate.
+ */
+/** A photo's nominal tokens beside its picture. */
+export declare const AI_MEDIA_PHOTO_NOMINAL_USAGE: AiUsage & {
+    images: number;
+};
+/**
+ * An illustration's nominal tokens: about 2,100 of instructions — under the
+ * fast tier's caching minimum, so read at full rate every time — the tool and
+ * the description, and a few thousand of SVG.
+ */
+export declare const AI_MEDIA_SVG_NOMINAL_USAGE: AiUsage;
+/**
+ * The model an illustration is estimated at where the server's choice is
+ * not known: the catalog's first fast-tier row, which is what the default
+ * text provider serves illustrations on.
+ */
+export declare const AI_MEDIA_SVG_ESTIMATE_MODEL: string;
+/** The credits one picture is expected to draw in `mode`, on `model`. */
+export declare function aiMediaCreditsPerPicture(mode: AiImageMode, model?: string): number;

package/src/lib/model/ai-media-credits.js

@@ -0,0 +1,61 @@
+/**
+ * @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.
+ */ var _ref;
+var _AI_MODEL_CATALOG_find;
+import { AI_IMAGE_DEFAULT_MODEL, AI_MODEL_CATALOG, estimateAiBilledUsd } from "../providers/catalog.js";
+import { assistCreditsFromUsd } from "../usage/assist-credits.js";
+/**
+ * What one picture in Media is expected to draw (AGL-3602), in credits: the
+ * estimate the dialog shows before anything is spent, and the figure the
+ * door holds a walled band to. Browser-safe, so both read the same number.
+ *
+ * Each is an ESTIMATE at nominal usage, priced at the billed rates:
+ *
+ * - a photo is one picture at its per-picture rate, plus a prompt and the
+ *   thinking Google's model does before it draws;
+ * - an illustration is the text provider's answer — the instructions, the
+ *   description, and a few thousand tokens of SVG.
+ *
+ * What is actually charged is what was spent, measured: a picture held back
+ * or not stored is never charged, and an illustration that needed its second
+ * attempt costs about twice its estimate.
+ */ /** A photo's nominal tokens beside its picture. */ export const AI_MEDIA_PHOTO_NOMINAL_USAGE = {
+    inputTokens: 600,
+    outputTokens: 1500,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0,
+    images: 1
+};
+/**
+ * An illustration's nominal tokens: about 2,100 of instructions — under the
+ * fast tier's caching minimum, so read at full rate every time — the tool and
+ * the description, and a few thousand of SVG.
+ */ export const AI_MEDIA_SVG_NOMINAL_USAGE = {
+    inputTokens: 2500,
+    outputTokens: 3000,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0
+};
+/**
+ * The model an illustration is estimated at where the server's choice is
+ * not known: the catalog's first fast-tier row, which is what the default
+ * text provider serves illustrations on.
+ */ export const AI_MEDIA_SVG_ESTIMATE_MODEL = (_ref = (_AI_MODEL_CATALOG_find = AI_MODEL_CATALOG.find((entry)=>entry.tier === 'fast')) == null ? void 0 : _AI_MODEL_CATALOG_find.id) != null ? _ref : AI_MODEL_CATALOG[0].id;
+/** The credits one picture is expected to draw in `mode`, on `model`. */ export function aiMediaCreditsPerPicture(mode, model) {
+    return mode === 'photo' ? assistCreditsFromUsd(estimateAiBilledUsd(AI_MEDIA_PHOTO_NOMINAL_USAGE, model != null ? model : AI_IMAGE_DEFAULT_MODEL)) : assistCreditsFromUsd(estimateAiBilledUsd(AI_MEDIA_SVG_NOMINAL_USAGE, model != null ? model : AI_MEDIA_SVG_ESTIMATE_MODEL));
+}
+
+//# sourceMappingURL=ai-media-credits.js.map

package/src/lib/model/ai-media-credits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-media-credits.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 type { AiUsage } from '../providers/contract'\nimport {\n  AI_IMAGE_DEFAULT_MODEL,\n  AI_MODEL_CATALOG,\n  estimateAiBilledUsd,\n} from '../providers/catalog'\nimport type { AiImageMode } from '../providers/image-contract'\nimport { assistCreditsFromUsd } from '../usage/assist-credits'\n\n/**\n * What one picture in Media is expected to draw (AGL-3602), in credits: the\n * estimate the dialog shows before anything is spent, and the figure the\n * door holds a walled band to. Browser-safe, so both read the same number.\n *\n * Each is an ESTIMATE at nominal usage, priced at the billed rates:\n *\n * - a photo is one picture at its per-picture rate, plus a prompt and the\n *   thinking Google's model does before it draws;\n * - an illustration is the text provider's answer — the instructions, the\n *   description, and a few thousand tokens of SVG.\n *\n * What is actually charged is what was spent, measured: a picture held back\n * or not stored is never charged, and an illustration that needed its second\n * attempt costs about twice its estimate.\n */\n\n/** A photo's nominal tokens beside its picture. */\nexport const AI_MEDIA_PHOTO_NOMINAL_USAGE: AiUsage & { images: number } = {\n  inputTokens: 600,\n  outputTokens: 1_500,\n  cacheReadTokens: 0,\n  cacheWriteTokens: 0,\n  images: 1,\n}\n\n/**\n * An illustration's nominal tokens: about 2,100 of instructions — under the\n * fast tier's caching minimum, so read at full rate every time — the tool and\n * the description, and a few thousand of SVG.\n */\nexport const AI_MEDIA_SVG_NOMINAL_USAGE: AiUsage = {\n  inputTokens: 2_500,\n  outputTokens: 3_000,\n  cacheReadTokens: 0,\n  cacheWriteTokens: 0,\n}\n\n/**\n * The model an illustration is estimated at where the server's choice is\n * not known: the catalog's first fast-tier row, which is what the default\n * text provider serves illustrations on.\n */\nexport const AI_MEDIA_SVG_ESTIMATE_MODEL =\n  AI_MODEL_CATALOG.find((entry) => entry.tier === 'fast')?.id ?? AI_MODEL_CATALOG[0].id\n\n/** The credits one picture is expected to draw in `mode`, on `model`. */\nexport function aiMediaCreditsPerPicture(mode: AiImageMode, model?: string): number {\n  return mode === 'photo'\n    ? assistCreditsFromUsd(estimateAiBilledUsd(AI_MEDIA_PHOTO_NOMINAL_USAGE, model ?? AI_IMAGE_DEFAULT_MODEL))\n    : assistCreditsFromUsd(estimateAiBilledUsd(AI_MEDIA_SVG_NOMINAL_USAGE, model ?? AI_MEDIA_SVG_ESTIMATE_MODEL))\n}\n"],"names":["AI_MODEL_CATALOG","AI_IMAGE_DEFAULT_MODEL","estimateAiBilledUsd","assistCreditsFromUsd","AI_MEDIA_PHOTO_NOMINAL_USAGE","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","images","AI_MEDIA_SVG_NOMINAL_USAGE","AI_MEDIA_SVG_ESTIMATE_MODEL","find","entry","tier","id","aiMediaCreditsPerPicture","mode","model"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;IAuDCA;AApDF,SACEC,sBAAsB,EACtBD,gBAAgB,EAChBE,mBAAmB,QACd,0BAAsB;AAE7B,SAASC,oBAAoB,QAAQ,6BAAyB;AAE9D;;;;;;;;;;;;;;;CAeC,GAED,iDAAiD,GACjD,OAAO,MAAMC,+BAA6D;IACxEC,aAAa;IACbC,cAAc;IACdC,iBAAiB;IACjBC,kBAAkB;IAClBC,QAAQ;AACV,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMC,6BAAsC;IACjDL,aAAa;IACbC,cAAc;IACdC,iBAAiB;IACjBC,kBAAkB;AACpB,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMG,uCACXX,yBAAAA,iBAAiBY,IAAI,CAAC,CAACC,QAAUA,MAAMC,IAAI,KAAK,4BAAhDd,uBAAyDe,EAAE,mBAAIf,gBAAgB,CAAC,EAAE,CAACe,EAAE,CAAA;AAEvF,uEAAuE,GACvE,OAAO,SAASC,yBAAyBC,IAAiB,EAAEC,KAAc;IACxE,OAAOD,SAAS,UACZd,qBAAqBD,oBAAoBE,8BAA8Bc,gBAAAA,QAASjB,2BAChFE,qBAAqBD,oBAAoBQ,4BAA4BQ,gBAAAA,QAASP;AACpF"}

package/src/lib/model/ai-overlay-copy.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @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.
+ */
+/**
+ * Overlay copy by AI (AGL-3603): what a `text` job asked for an announcement
+ * bar's or a popup's copy answers, in the shape the step writes and the
+ * console reads. Pure data, so the widgets and the step share one reading.
+ *
+ * The overlay is the marketing plugin's, and neither plugin imports the other:
+ * the limits and the trigger catalog are handed to the widget by the zone,
+ * and the widget passes them on as the job's inputs. The step then holds the
+ * answer to the TIGHTER of those and its own ceilings below, so a job started
+ * by anything else is still bounded, and drops a trigger the caller did not
+ * name rather than inventing one.
+ */
+/** The `text` job's `inputs.task` that asks for overlay copy. */
+export declare const AI_OVERLAY_COPY_TASK = "overlay";
+/** What the copy is for. */
+export type AiOverlayKind = 'bar' | 'popup';
+/** The fields an answer fills. */
+export type AiOverlayCopyField = 'name' | 'text' | 'headline' | 'body' | 'ctaLabel';
+/** The step's own ceilings: no zone may widen a field past these. */
+export declare const AI_OVERLAY_COPY_CEILINGS: Readonly<Record<AiOverlayCopyField, number>>;
+/** The triggers a popup may be proposed to open on, as the site runtime names them. */
+export declare const AI_OVERLAY_TRIGGERS: readonly ["delay", "scroll", "exit"];
+export type AiOverlayTrigger = (typeof AI_OVERLAY_TRIGGERS)[number];
+/** One trigger as the zone hands it over: its id and the range of its value. */
+export interface AiOverlayTriggerRule {
+    id: string;
+    label: string;
+    unit: 'seconds' | 'percent' | null;
+    min: number;
+    max: number;
+}
+/** The longest description of the current copy a job sends. */
+export declare const AI_OVERLAY_CURRENT_MAX_CHARS = 1200;
+/** What a checked answer proposes. Absent fields propose nothing. */
+export interface AiOverlayCopyProposal {
+    kind: AiOverlayKind;
+    name: string;
+    text: string;
+    headline: string;
+    body: string;
+    ctaLabel: string;
+    trigger: AiOverlayTrigger | null;
+    triggerValue: number | null;
+    /** One sentence on what the copy leans on; shown, never written. */
+    rationale: string;
+}
+/** What the model answered, before the check. */
+export interface AiOverlayCopyAnswer {
+    name: string;
+    text: string;
+    headline: string;
+    body: string;
+    ctaLabel: string;
+    trigger: string;
+    triggerValue: number | null;
+    rationale: string;
+}
+/** The kind a job's inputs name, or `null`. */
+export declare function aiOverlayKind(inputs: Readonly<Record<string, unknown>> | null | undefined): AiOverlayKind | null;
+/** Whether a `text` job's inputs ask for overlay copy. */
+export declare function aiOverlayCopyRequested(inputs: Readonly<Record<string, unknown>> | null | undefined): boolean;
+/**
+ * The limit each field is held to: the caller's, where it named one, never
+ * past the step's ceiling. Inputs carry them as `limit_<field>`.
+ */
+export declare function aiOverlayLimits(inputs: Readonly<Record<string, unknown>> | null | undefined): Record<AiOverlayCopyField, number>;
+/**
+ * The triggers the caller allows, with their ranges. Inputs carry them as
+ * `triggers` (`delay:0-120,scroll:1-100,exit`); an id the runtime does not
+ * know is dropped, and with no list a popup is proposed no trigger at all.
+ */
+export declare function aiOverlayTriggerRanges(inputs: Readonly<Record<string, unknown>> | null | undefined): Map<AiOverlayTrigger, {
+    min: number;
+    max: number;
+} | null>;
+/** The zone's trigger catalog as the job's `triggers` input. */
+export declare function aiOverlayTriggersInput(rules: readonly AiOverlayTriggerRule[]): string;
+/** The zone's limits as the job's `limit_<field>` inputs. */
+export declare function aiOverlayLimitInputs(limits: Readonly<Partial<Record<AiOverlayCopyField, number>>>): Record<string, number>;
+export interface AiOverlayCopyCheck {
+    proposal: AiOverlayCopyProposal;
+    /** What was cut or dropped, for the log. */
+    findings: string[];
+}
+/**
+ * An answer held to the overlay's rules, or `null` when nothing usable is
+ * left: a bar with no text, a popup with no body, or copy carrying markup or
+ * a link. A field over its limit is cut rather than refused, and a trigger
+ * outside the caller's catalog is dropped, with each recorded as a finding.
+ */
+export declare function checkAiOverlayCopy(answer: AiOverlayCopyAnswer | null, kind: AiOverlayKind, limits: Readonly<Record<AiOverlayCopyField, number>>, triggers: ReadonlyMap<AiOverlayTrigger, {
+    min: number;
+    max: number;
+} | null>): AiOverlayCopyCheck | null;
+/** The proposal a finished overlay job's output carries, or `null` for anything else. */
+export declare function readAiOverlayCopy(proposal: Record<string, unknown> | null | undefined): AiOverlayCopyProposal | null;
+/** A proposal as the plain text a `text` output shows on the AI jobs page. */
+export declare function aiOverlayCopyText(proposal: AiOverlayCopyProposal): string;