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

package/src/lib/jobs/ai-job-logic-step.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @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 HostFunction } from '@aglyn/aglyn/app-utils/functions';
+import { type AiLogicContext, type AiLogicSiteVariable } from '../model/ai-logic-job';
+import { type AiCustomGenerationInput } from '../runtime/ai-doctrine';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiWorkflowExplanation } from '../tools/ai-workflow-tool';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiJobStepRunner } from './ai-job-text-step';
+import { readAiLogicFunction, readAiLogicRecords } from './ai-logic-records';
+/**
+ * The `logic` step (AGL-3603): a function or a variable proposed from a
+ * description, a saved function changed or fixed, or one explained.
+ *
+ * The model is shown the expression grammar the evaluator runs — operators,
+ * built-ins, how a dictionary's member is read — and, in the user turn, the
+ * site's variables by name, type and value, and its function names. A saved
+ * function is shown as an outline of its own definition. It answers through
+ * `submit_function`, `submit_variable` or `submit_explanation`; a function
+ * is held to the grammar, to the names it may read and to a first run before
+ * it is kept (`checkAiLogicFunction`), and a re-ask names what failed.
+ *
+ * Nothing is written. A proposal rides on a `logic` output, and the logic
+ * editor opens it for a person to save.
+ */
+/** The longest the step may take reading the site first. */
+export declare const AI_LOGIC_RECORDS_READ_MS = 2000;
+/** The step's time: its answer and its re-ask at the `job.logic` ceiling, with its own reads. */
+export declare const AI_JOB_LOGIC_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+export declare const AI_JOB_LOGIC_STEP_MINIMUM_MS: number;
+export declare function aiJobLogicModel(): string;
+/** How many site variables the user turn lists, and how much of each value. */
+export declare const AI_LOGIC_VARIABLES_LISTED = 60;
+export declare const AI_LOGIC_VALUE_LISTED_CHARS = 120;
+/**
+ * The instructions, byte-identical on every request so they cache: one block
+ * for a function, a variable and an explanation alike, because a block of
+ * either half alone is under the balanced tier's cacheable minimum, and the
+ * two halves together clear it on every tool.
+ */
+export declare const AI_JOB_LOGIC_INSTRUCTIONS: readonly AiSystemBlock[];
+/** A saved function as lines a model reads: its own definition, in the editor's terms. */
+export declare function aiLogicFunctionOutline(definition: HostFunction): string;
+/** What a function or a variable is asked from. */
+export declare function aiJobLogicPrompt(input: {
+    brief: string;
+    mode: 'function' | 'variable' | 'explain';
+    context: AiLogicContext;
+    saved: HostFunction | null;
+}): string;
+/** The function generation as the doctrine's loop runs it. */
+export declare function aiJobLogicFunctionGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    saved: HostFunction | null;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<HostFunction>;
+/** The variable generation. */
+export declare function aiJobLogicVariableGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiLogicSiteVariable>;
+/** The explanation generation. */
+export declare function aiJobLogicExplainGeneration(request: {
+    brief: string;
+    context: AiLogicContext;
+    saved: HostFunction;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiWorkflowExplanation>;
+export interface AiJobLogicStepDeps {
+    readRecords?: typeof readAiLogicRecords;
+    readFunction?: typeof readAiLogicFunction;
+}
+export declare function createAiJobLogicStep(deps?: AiJobLogicStepDeps): AiJobStepRunner;
+export declare const runAiJobLogicStep: AiJobStepRunner;
+/** The plugin that keeps Functions & Variables. */
+export declare const AI_LOGIC_PLUGIN_ID = "logic";
+export interface AiLogicJobAdmissionDeps {
+    readFunction?: typeof readAiLogicFunction;
+}
+/**
+ * A logic job is admitted for a site of its org with Logic on for it and past
+ * its release flag; a change or an explanation also needs the function it
+ * names to exist.
+ */
+export declare function createAiLogicJobAdmission(deps?: AiLogicJobAdmissionDeps): AiJobAdmission;
+export declare const aiLogicJobAdmission: AiJobAdmission;
+/** Registers the logic step and the check a logic job passes before it is created or resumed. */
+export declare function registerAiLogicJob(): void;

package/src/lib/jobs/ai-job-logic-step.js

@@ -0,0 +1,395 @@
+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 { FUNCTION_BUILTIN_NAMES } from "@aglyn/aglyn/app-utils/functions";
+import { isHostPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { filterEnabledPluginsByReleaseFlags } from "@aglyn/tenant-data-admin/server/release-flags";
+import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { aiWorkflowExplanationText } from "../model/ai-automation-outline.js";
+import { AI_LOGIC_GONE_COPY, AI_LOGIC_MAX_OPERATIONS, AI_LOGIC_MAX_PARAMETERS, AI_LOGIC_NO_EXPLANATION_COPY, AI_LOGIC_NO_FUNCTION_COPY, AI_LOGIC_NO_SITE_COPY, AI_LOGIC_NO_VARIABLE_COPY, AI_LOGIC_RESOURCE, AI_LOGIC_UNAVAILABLE_COPY, checkAiLogicFunction, checkAiLogicVariable, parseAiLogicJobInputs } from "../model/ai-logic-job.js";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
+import { runValidatedGeneration } from "../runtime/ai-doctrine.js";
+import { aiLogicFunctionTool, aiLogicVariableTool, AI_LOGIC_FUNCTION_TOOL_NAME, AI_LOGIC_VARIABLE_TOOL_NAME } from "../tools/ai-logic-tool.js";
+import { AI_WORKFLOW_EXPLANATION_TOOL_NAME, aiWorkflowExplanationTool, readAiWorkflowExplanation } from "../tools/ai-workflow-tool.js";
+import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+import { aiGenerationSpent, aiUnspentOutcome } from "./ai-job-generation.js";
+import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
+import { registerAiJobStep } from "./ai-jobs.js";
+import { readAiLogicFunction, readAiLogicRecords } from "./ai-logic-records.js";
+/**
+ * The `logic` step (AGL-3603): a function or a variable proposed from a
+ * description, a saved function changed or fixed, or one explained.
+ *
+ * The model is shown the expression grammar the evaluator runs — operators,
+ * built-ins, how a dictionary's member is read — and, in the user turn, the
+ * site's variables by name, type and value, and its function names. A saved
+ * function is shown as an outline of its own definition. It answers through
+ * `submit_function`, `submit_variable` or `submit_explanation`; a function
+ * is held to the grammar, to the names it may read and to a first run before
+ * it is kept (`checkAiLogicFunction`), and a re-ask names what failed.
+ *
+ * Nothing is written. A proposal rides on a `logic` output, and the logic
+ * editor opens it for a person to save.
+ */ /** The longest the step may take reading the site first. */ export const AI_LOGIC_RECORDS_READ_MS = 2000;
+/** The step's time: its answer and its re-ask at the `job.logic` ceiling, with its own reads. */ export const AI_JOB_LOGIC_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.logic'],
+    maxTokens: AI_ROUTING_TABLE['job.logic'].maxTokens,
+    lookups: 0,
+    ownReadsMs: AI_LOGIC_RECORDS_READ_MS
+});
+export const AI_JOB_LOGIC_STEP_MINIMUM_MS = AI_JOB_LOGIC_STEP_BUDGET.minimumMs;
+export function aiJobLogicModel() {
+    return aiModelForStep('job.logic');
+}
+/** How many site variables the user turn lists, and how much of each value. */ export const AI_LOGIC_VARIABLES_LISTED = 60;
+export const AI_LOGIC_VALUE_LISTED_CHARS = 120;
+/**
+ * The instructions, byte-identical on every request so they cache: one block
+ * for a function, a variable and an explanation alike, because a block of
+ * either half alone is under the balanced tier's cacheable minimum, and the
+ * two halves together clear it on every tool.
+ */ export const AI_JOB_LOGIC_INSTRUCTIONS = [
+    {
+        text: [
+            `You work on the Functions & Variables page of a website builder, for the person who owns the site. Asked for a function, call ${AI_LOGIC_FUNCTION_TOOL_NAME}; asked for a variable, call ${AI_LOGIC_VARIABLE_TOOL_NAME}; asked what a function does, call ${AI_WORKFLOW_EXPLANATION_TOOL_NAME}. Call exactly one, once. A reply in prose cannot be used.`,
+            '',
+            'A function has parameters (what it is given), locals (working values), operations run in order, and returnValue, the parameter or local whose final value it returns. Each operation is: if (left comparator right) then assign each of its then list, otherwise each of its otherwise list. A condition that should always hold is written 1 == 1.',
+            '',
+            'Expressions:',
+            '- Numbers, "quoted text", true and false; + - * / and parentheses; + also joins text.',
+            `- Built-in functions only: ${FUNCTION_BUILTIN_NAMES.map((name)=>`${name}()`).join(', ')}.`,
+            '- Names: the function’s own parameters and locals, and the site variables the request lists, by name; a dictionary variable’s member as name.member.',
+            '- An assignment sets only a parameter or a local, never a site variable.',
+            '',
+            'Writing a function or a variable:',
+            `- At most ${AI_LOGIC_MAX_PARAMETERS} parameters and ${AI_LOGIC_MAX_OPERATIONS} operations. Names start with a letter or _, then letters, digits or _.`,
+            '- Types are number, text or boolean. A parameter a visitor fills in gets a short label; defaultValue is what the input starts with, or empty.',
+            '- Use only the names and built-ins listed. Where the description needs a value the site does not hold, make it a parameter rather than inventing a number.',
+            '- When the request shows a saved function to change, answer with the whole function after the change, keeping what the change does not touch.',
+            '- A variable’s value is written as stored: digits; true or false; YYYY-MM-DD; HH:MM; a JSON object for a dictionary; a JSON list for a collection.',
+            '',
+            'Explaining a function, in plain words for someone who does not write code:',
+            '- summary: in one or two sentences, what the function computes from what it is given.',
+            '- points: what it does, operation by operation, in order. One sentence each.',
+            '- suggestions: what is worth checking — a condition that can never hold, a value it returns that nothing sets, a name it reads that the site does not have. Empty when there is nothing to suggest.',
+            '- Explain only what you are shown, and never say you changed anything: you change nothing. Write plain text, with no markdown and no HTML.'
+        ].join('\n'),
+        cacheBreakpoint: true
+    }
+];
+// ── The user turns ────────────────────────────────────────────────────────
+function variableLine(variable) {
+    var _variable_value;
+    const value = String((_variable_value = variable.value) != null ? _variable_value : '').replace(/\s+/g, ' ');
+    return `- ${variable.name} (${variable.type}) = ${value.length > AI_LOGIC_VALUE_LISTED_CHARS ? `${value.slice(0, AI_LOGIC_VALUE_LISTED_CHARS)}…` : value || '(empty)'}`;
+}
+/** A saved function as lines a model reads: its own definition, in the editor's terms. */ export function aiLogicFunctionOutline(definition) {
+    const lines = [
+        `Function: ${definition.name}`
+    ];
+    lines.push('Parameters:', ...definition.parameters.length ? definition.parameters.map((parameter)=>`- ${parameter.name} (${parameter.type}${parameter.required ? ', required' : ''})${parameter.label ? ` labeled "${parameter.label}"` : ''}${parameter.defaultValue ? `, starts as ${parameter.defaultValue}` : ''}`) : [
+        '- none'
+    ], 'Locals:', ...definition.variables.length ? definition.variables.map((local)=>`- ${local.name} (${local.type})`) : [
+        '- none'
+    ], 'Operations, in order:');
+    definition.operations.forEach((operation, index)=>{
+        var _operation_then, _operation_otherwise;
+        var _operation_if, _operation_if1, _operation_if2;
+        const sets = (list)=>list.length ? list.map((set)=>`${set.set} = ${set.workflow ? `the workflow "${set.workflow}"` : set.expression}`).join('; ') : 'nothing';
+        lines.push(`${index + 1}. If ${(_operation_if = operation.if) == null ? void 0 : _operation_if.left} ${(_operation_if1 = operation.if) == null ? void 0 : _operation_if1.comparator} ${(_operation_if2 = operation.if) == null ? void 0 : _operation_if2.right}: ${sets((_operation_then = operation.then) != null ? _operation_then : [])}. Otherwise: ${sets((_operation_otherwise = operation.otherwise) != null ? _operation_otherwise : [])}.`);
+    });
+    lines.push(`Returns: ${definition.returnValue || '(nothing named)'}`);
+    return lines.join('\n');
+}
+/** What a function or a variable is asked from. */ export function aiJobLogicPrompt(input) {
+    const variables = input.context.variables.slice(0, AI_LOGIC_VARIABLES_LISTED);
+    return [
+        input.mode === 'variable' ? 'Asked: one site variable.' : input.mode === 'explain' ? 'Asked: what this function does.' : input.saved ? 'Asked: the saved function below, changed as the request says.' : 'Asked: one new function.',
+        'Site variables (name (type) = value):',
+        ...variables.length ? variables.map(variableLine) : [
+            '- none'
+        ],
+        `Function names already on the site: ${input.context.functions.join(', ') || 'none'}`,
+        ...input.saved ? [
+            'The saved function:',
+            aiLogicFunctionOutline(input.saved)
+        ] : [],
+        `Request: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`
+    ].join('\n');
+}
+function routedEffort() {
+    const row = AI_ROUTING_TABLE['job.logic'];
+    return _extends({}, row.thinking ? {
+        thinking: row.thinking
+    } : {}, row.effort ? {
+        effort: row.effort
+    } : {});
+}
+/** The function generation as the doctrine's loop runs it. */ export function aiJobLogicFunctionGeneration(request) {
+    return _extends({
+        step: 'job.logic',
+        model: request.model,
+        instructions: AI_JOB_LOGIC_INSTRUCTIONS,
+        messages: [
+            {
+                role: 'user',
+                content: aiJobLogicPrompt(_extends({}, request, {
+                    mode: 'function'
+                }))
+            }
+        ],
+        tool: aiLogicFunctionTool(),
+        maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model)
+    }, routedEffort(), request.signal ? {
+        signal: request.signal
+    } : {}, {
+        check: (answer)=>checkAiLogicFunction(answer, request.context)
+    });
+}
+/** The variable generation. */ export function aiJobLogicVariableGeneration(request) {
+    return _extends({
+        step: 'job.logic',
+        model: request.model,
+        instructions: AI_JOB_LOGIC_INSTRUCTIONS,
+        messages: [
+            {
+                role: 'user',
+                content: aiJobLogicPrompt(_extends({}, request, {
+                    mode: 'variable',
+                    saved: null
+                }))
+            }
+        ],
+        tool: aiLogicVariableTool(),
+        maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model)
+    }, routedEffort(), request.signal ? {
+        signal: request.signal
+    } : {}, {
+        check: (answer)=>checkAiLogicVariable(answer, request.context)
+    });
+}
+/** The explanation generation. */ export function aiJobLogicExplainGeneration(request) {
+    return _extends({
+        step: 'job.logic',
+        model: request.model,
+        instructions: AI_JOB_LOGIC_INSTRUCTIONS,
+        messages: [
+            {
+                role: 'user',
+                content: aiJobLogicPrompt(_extends({}, request, {
+                    mode: 'explain'
+                }))
+            }
+        ],
+        tool: aiWorkflowExplanationTool(),
+        maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model)
+    }, routedEffort(), request.signal ? {
+        signal: request.signal
+    } : {}, {
+        check: readAiWorkflowExplanation
+    });
+}
+function proposalOutput(place, id, label, proposal, note) {
+    return {
+        resource: AI_LOGIC_RESOURCE,
+        id,
+        hostId: place.hostId,
+        hostSubdomain: place.hostSubdomain,
+        label,
+        proposal: proposal,
+        note
+    };
+}
+export function createAiJobLogicStep(deps = {}) {
+    var _deps_readRecords, _deps_readFunction;
+    const readRecords = (_deps_readRecords = deps.readRecords) != null ? _deps_readRecords : readAiLogicRecords;
+    const readFunction = (_deps_readFunction = deps.readFunction) != null ? _deps_readFunction : readAiLogicFunction;
+    return async ({ job, signal, firestore, modelFor })=>{
+        var _ref, _ref1;
+        const model = (_ref = modelFor == null ? void 0 : modelFor('job.logic')) != null ? _ref : aiJobLogicModel();
+        const unspent = (failure)=>_extends({}, aiUnspentOutcome(model), {
+                failure
+            });
+        const inputs = parseAiLogicJobInputs(job.inputs);
+        if (typeof inputs === 'string') return unspent(inputs);
+        const hostId = job.hostId;
+        if (!hostId) return unspent(AI_LOGIC_NO_SITE_COPY);
+        const host = await firestore.collection('hosts').doc(hostId).get();
+        if (!host.exists || host.get('orgId') !== job.orgId) return unspent(AI_LOGIC_NO_SITE_COPY);
+        const subdomain = host.get('subdomain');
+        const place = {
+            hostId,
+            hostSubdomain: typeof subdomain === 'string' && subdomain ? subdomain : null
+        };
+        const functionId = inputs.mode === 'variable' ? null : inputs.functionId;
+        const saved = functionId ? await readFunction(firestore, {
+            hostId,
+            id: functionId
+        }) : null;
+        if (functionId && !saved) return unspent(AI_LOGIC_GONE_COPY);
+        const records = await readRecords(firestore, hostId);
+        const context = _extends({}, records, {
+            editing: (_ref1 = saved == null ? void 0 : saved.name) != null ? _ref1 : null
+        });
+        const signalled = signal ? {
+            signal
+        } : {};
+        if (inputs.mode === 'explain' && saved) {
+            const generation = await runValidatedGeneration('logic', aiJobLogicExplainGeneration(_extends({
+                brief: job.brief,
+                context,
+                saved,
+                model
+            }, signalled)));
+            const spent = _extends({}, aiGenerationSpent(generation), generation.effort ? {
+                effort: generation.effort
+            } : {});
+            if (generation.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (generation.status === 'needs_input') return _extends({}, spent, {
+                failure: AI_LOGIC_NO_EXPLANATION_COPY
+            });
+            return _extends({}, spent, {
+                outputs: [
+                    {
+                        resource: 'text',
+                        id: 'explanation',
+                        hostId,
+                        hostSubdomain: place.hostSubdomain,
+                        label: `How ${saved.name} works`,
+                        text: aiWorkflowExplanationText(generation.value, 'explain')
+                    }
+                ]
+            });
+        }
+        if (inputs.mode === 'variable') {
+            const generation = await runValidatedGeneration('logic', aiJobLogicVariableGeneration(_extends({
+                brief: job.brief,
+                context,
+                model
+            }, signalled)));
+            const spent = _extends({}, aiGenerationSpent(generation), generation.effort ? {
+                effort: generation.effort
+            } : {});
+            if (generation.status === 'refused') return _extends({}, spent, {
+                refused: true
+            });
+            if (generation.status === 'needs_input') return _extends({}, spent, {
+                failure: AI_LOGIC_NO_VARIABLE_COPY
+            });
+            const variable = generation.value;
+            return _extends({}, spent, {
+                outputs: [
+                    proposalOutput(place, 'variable', variable.name, {
+                        kind: 'variable',
+                        variable
+                    }, 'Open it in Variables to review and save it.')
+                ]
+            });
+        }
+        const generation = await runValidatedGeneration('logic', aiJobLogicFunctionGeneration(_extends({
+            brief: job.brief,
+            context,
+            saved,
+            model
+        }, signalled)));
+        const spent = _extends({}, aiGenerationSpent(generation), generation.effort ? {
+            effort: generation.effort
+        } : {});
+        if (generation.status === 'refused') return _extends({}, spent, {
+            refused: true
+        });
+        if (generation.status === 'needs_input') return _extends({}, spent, {
+            failure: AI_LOGIC_NO_FUNCTION_COPY
+        });
+        const definition = generation.value;
+        return _extends({}, spent, {
+            outputs: [
+                proposalOutput(place, functionId != null ? functionId : 'function', definition.name, {
+                    kind: 'function',
+                    functionId,
+                    definition
+                }, saved ? `A changed ${saved.name}, checked against the expression grammar and run once. Nothing is saved until you save it in the editor.` : 'Checked against the expression grammar and run once. Nothing is saved until you save it in the editor.')
+            ]
+        });
+    };
+}
+export const runAiJobLogicStep = createAiJobLogicStep();
+// ── Admission ─────────────────────────────────────────────────────────────
+/** The plugin that keeps Functions & Variables. */ export const AI_LOGIC_PLUGIN_ID = 'logic';
+/**
+ * A logic job is admitted for a site of its org with Logic on for it and past
+ * its release flag; a change or an explanation also needs the function it
+ * names to exist.
+ */ export function createAiLogicJobAdmission(deps = {}) {
+    var _deps_readFunction;
+    const readFunction = (_deps_readFunction = deps.readFunction) != null ? _deps_readFunction : readAiLogicFunction;
+    return async (context)=>{
+        var _data;
+        const inputs = parseAiLogicJobInputs(context.inputs);
+        if (typeof inputs === 'string') return {
+            status: 400,
+            error: inputs
+        };
+        const hostId = context.hostId;
+        if (!hostId) return {
+            status: 400,
+            error: 'Open the site the logic is for before starting the job'
+        };
+        const owner = await resolveOrgIdForHost(hostId);
+        if (!owner || owner !== context.orgId) return {
+            status: 404,
+            error: 'Unknown site'
+        };
+        const host = (_data = (await context.firestore.collection('hosts').doc(hostId).get()).data()) != null ? _data : null;
+        const org = context.org;
+        const released = await filterEnabledPluginsByReleaseFlags([
+            AI_LOGIC_PLUGIN_ID
+        ], {
+            orgId: context.orgId,
+            authorization: null
+        });
+        if (!released.includes(AI_LOGIC_PLUGIN_ID) || !isHostPluginEnabled(org, host, AI_LOGIC_PLUGIN_ID)) {
+            return {
+                status: 403,
+                error: AI_LOGIC_UNAVAILABLE_COPY
+            };
+        }
+        const functionId = inputs.mode === 'variable' ? null : inputs.functionId;
+        if (functionId && !await readFunction(context.firestore, {
+            hostId,
+            id: functionId
+        })) {
+            return {
+                status: 404,
+                error: AI_LOGIC_GONE_COPY
+            };
+        }
+        return null;
+    };
+}
+export const aiLogicJobAdmission = createAiLogicJobAdmission();
+/** Registers the logic step and the check a logic job passes before it is created or resumed. */ export function registerAiLogicJob() {
+    registerAiJobStep('logic', runAiJobLogicStep, {
+        minimumMs: AI_JOB_LOGIC_STEP_MINIMUM_MS
+    });
+    registerAiJobAdmission('logic', aiLogicJobAdmission);
+}
+
+//# sourceMappingURL=ai-job-logic-step.js.map

package/src/lib/jobs/ai-job-logic-step.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-logic-step.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 { FUNCTION_BUILTIN_NAMES, type HostFunction } from '@aglyn/aglyn/app-utils/functions'\nimport { isHostPluginEnabled } from '@aglyn/aglyn/plugin-manager/enabled-plugins'\nimport { filterEnabledPluginsByReleaseFlags } from '@aglyn/tenant-data-admin/server/release-flags'\nimport { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport { aiWorkflowExplanationText } from '../model/ai-automation-outline'\nimport type { AiJobOutput, AiJobOutputResource } from '../model/ai-jobs.types'\nimport {\n  AI_LOGIC_GONE_COPY,\n  AI_LOGIC_MAX_OPERATIONS,\n  AI_LOGIC_MAX_PARAMETERS,\n  AI_LOGIC_NO_EXPLANATION_COPY,\n  AI_LOGIC_NO_FUNCTION_COPY,\n  AI_LOGIC_NO_SITE_COPY,\n  AI_LOGIC_NO_VARIABLE_COPY,\n  AI_LOGIC_RESOURCE,\n  AI_LOGIC_UNAVAILABLE_COPY,\n  checkAiLogicFunction,\n  checkAiLogicVariable,\n  parseAiLogicJobInputs,\n  type AiLogicContext,\n  type AiLogicProposal,\n  type AiLogicSiteVariable,\n} from '../model/ai-logic-job'\nimport { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport { runValidatedGeneration, type AiCustomGenerationInput } from '../runtime/ai-doctrine'\nimport type { AiSystemBlock } from '../runtime/ai-runtime'\nimport { aiLogicFunctionTool, aiLogicVariableTool, AI_LOGIC_FUNCTION_TOOL_NAME, AI_LOGIC_VARIABLE_TOOL_NAME } from '../tools/ai-logic-tool'\nimport {\n  AI_WORKFLOW_EXPLANATION_TOOL_NAME,\n  aiWorkflowExplanationTool,\n  readAiWorkflowExplanation,\n  type AiWorkflowExplanation,\n} from '../tools/ai-workflow-tool'\nimport { registerAiJobAdmission, type AiJobAdmission, type AiJobAdmissionRefusal } from './ai-job-admission'\nimport { aiJobStepBudget } from './ai-job-budget'\nimport { aiGenerationSpent, aiUnspentOutcome } from './ai-job-generation'\nimport { AI_JOB_BRIEF_MAX_CHARS, type AiJobStepOutcome, type AiJobStepRunner } from './ai-job-text-step'\nimport { registerAiJobStep } from './ai-jobs'\nimport { readAiLogicFunction, readAiLogicRecords } from './ai-logic-records'\n\n/**\n * The `logic` step (AGL-3603): a function or a variable proposed from a\n * description, a saved function changed or fixed, or one explained.\n *\n * The model is shown the expression grammar the evaluator runs — operators,\n * built-ins, how a dictionary's member is read — and, in the user turn, the\n * site's variables by name, type and value, and its function names. A saved\n * function is shown as an outline of its own definition. It answers through\n * `submit_function`, `submit_variable` or `submit_explanation`; a function\n * is held to the grammar, to the names it may read and to a first run before\n * it is kept (`checkAiLogicFunction`), and a re-ask names what failed.\n *\n * Nothing is written. A proposal rides on a `logic` output, and the logic\n * editor opens it for a person to save.\n */\n\n/** The longest the step may take reading the site first. */\nexport const AI_LOGIC_RECORDS_READ_MS = 2_000\n\n/** The step's time: its answer and its re-ask at the `job.logic` ceiling, with its own reads. */\nexport const AI_JOB_LOGIC_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.logic'],\n  maxTokens: AI_ROUTING_TABLE['job.logic'].maxTokens,\n  lookups: 0,\n  ownReadsMs: AI_LOGIC_RECORDS_READ_MS,\n})\n\nexport const AI_JOB_LOGIC_STEP_MINIMUM_MS = AI_JOB_LOGIC_STEP_BUDGET.minimumMs\n\nexport function aiJobLogicModel(): string {\n  return aiModelForStep('job.logic')\n}\n\n/** How many site variables the user turn lists, and how much of each value. */\nexport const AI_LOGIC_VARIABLES_LISTED = 60\nexport const AI_LOGIC_VALUE_LISTED_CHARS = 120\n\n/**\n * The instructions, byte-identical on every request so they cache: one block\n * for a function, a variable and an explanation alike, because a block of\n * either half alone is under the balanced tier's cacheable minimum, and the\n * two halves together clear it on every tool.\n */\nexport const AI_JOB_LOGIC_INSTRUCTIONS: readonly AiSystemBlock[] = [\n  {\n    text: [\n      `You work on the Functions & Variables page of a website builder, for the person who owns the site. Asked for a function, call ${AI_LOGIC_FUNCTION_TOOL_NAME}; asked for a variable, call ${AI_LOGIC_VARIABLE_TOOL_NAME}; asked what a function does, call ${AI_WORKFLOW_EXPLANATION_TOOL_NAME}. Call exactly one, once. A reply in prose cannot be used.`,\n      '',\n      'A function has parameters (what it is given), locals (working values), operations run in order, and returnValue, the parameter or local whose final value it returns. Each operation is: if (left comparator right) then assign each of its then list, otherwise each of its otherwise list. A condition that should always hold is written 1 == 1.',\n      '',\n      'Expressions:',\n      '- Numbers, \"quoted text\", true and false; + - * / and parentheses; + also joins text.',\n      `- Built-in functions only: ${FUNCTION_BUILTIN_NAMES.map((name) => `${name}()`).join(', ')}.`,\n      '- Names: the function’s own parameters and locals, and the site variables the request lists, by name; a dictionary variable’s member as name.member.',\n      '- An assignment sets only a parameter or a local, never a site variable.',\n      '',\n      'Writing a function or a variable:',\n      `- At most ${AI_LOGIC_MAX_PARAMETERS} parameters and ${AI_LOGIC_MAX_OPERATIONS} operations. Names start with a letter or _, then letters, digits or _.`,\n      '- Types are number, text or boolean. A parameter a visitor fills in gets a short label; defaultValue is what the input starts with, or empty.',\n      '- Use only the names and built-ins listed. Where the description needs a value the site does not hold, make it a parameter rather than inventing a number.',\n      '- When the request shows a saved function to change, answer with the whole function after the change, keeping what the change does not touch.',\n      '- A variable’s value is written as stored: digits; true or false; YYYY-MM-DD; HH:MM; a JSON object for a dictionary; a JSON list for a collection.',\n      '',\n      'Explaining a function, in plain words for someone who does not write code:',\n      '- summary: in one or two sentences, what the function computes from what it is given.',\n      '- points: what it does, operation by operation, in order. One sentence each.',\n      '- suggestions: what is worth checking — a condition that can never hold, a value it returns that nothing sets, a name it reads that the site does not have. Empty when there is nothing to suggest.',\n      '- Explain only what you are shown, and never say you changed anything: you change nothing. Write plain text, with no markdown and no HTML.',\n    ].join('\\n'),\n    cacheBreakpoint: true,\n  },\n]\n\n// ── The user turns ────────────────────────────────────────────────────────\n\nfunction variableLine(variable: AiLogicSiteVariable): string {\n  const value = String(variable.value ?? '').replace(/\\s+/g, ' ')\n  return `- ${variable.name} (${variable.type}) = ${value.length > AI_LOGIC_VALUE_LISTED_CHARS ? `${value.slice(0, AI_LOGIC_VALUE_LISTED_CHARS)}…` : value || '(empty)'}`\n}\n\n/** A saved function as lines a model reads: its own definition, in the editor's terms. */\nexport function aiLogicFunctionOutline(definition: HostFunction): string {\n  const lines = [`Function: ${definition.name}`]\n  lines.push(\n    'Parameters:',\n    ...(definition.parameters.length\n      ? definition.parameters.map(\n          (parameter) =>\n            `- ${parameter.name} (${parameter.type}${parameter.required ? ', required' : ''})${parameter.label ? ` labeled \"${parameter.label}\"` : ''}${parameter.defaultValue ? `, starts as ${parameter.defaultValue}` : ''}`,\n        )\n      : ['- none']),\n    'Locals:',\n    ...(definition.variables.length\n      ? definition.variables.map((local) => `- ${local.name} (${local.type})`)\n      : ['- none']),\n    'Operations, in order:',\n  )\n  definition.operations.forEach((operation, index) => {\n    const sets = (list: HostFunction['operations'][number]['then']) =>\n      list.length ? list.map((set) => `${set.set} = ${set.workflow ? `the workflow \"${set.workflow}\"` : set.expression}`).join('; ') : 'nothing'\n    lines.push(\n      `${index + 1}. If ${operation.if?.left} ${operation.if?.comparator} ${operation.if?.right}: ${sets(operation.then ?? [])}. Otherwise: ${sets(operation.otherwise ?? [])}.`,\n    )\n  })\n  lines.push(`Returns: ${definition.returnValue || '(nothing named)'}`)\n  return lines.join('\\n')\n}\n\n/** What a function or a variable is asked from. */\nexport function aiJobLogicPrompt(input: {\n  brief: string\n  mode: 'function' | 'variable' | 'explain'\n  context: AiLogicContext\n  saved: HostFunction | null\n}): string {\n  const variables = input.context.variables.slice(0, AI_LOGIC_VARIABLES_LISTED)\n  return [\n    input.mode === 'variable'\n      ? 'Asked: one site variable.'\n      : input.mode === 'explain'\n        ? 'Asked: what this function does.'\n        : input.saved\n          ? 'Asked: the saved function below, changed as the request says.'\n          : 'Asked: one new function.',\n    'Site variables (name (type) = value):',\n    ...(variables.length ? variables.map(variableLine) : ['- none']),\n    `Function names already on the site: ${input.context.functions.join(', ') || 'none'}`,\n    ...(input.saved ? ['The saved function:', aiLogicFunctionOutline(input.saved)] : []),\n    `Request: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`,\n  ].join('\\n')\n}\n\nfunction routedEffort(): Pick<AiCustomGenerationInput<unknown>, 'thinking' | 'effort'> {\n  const row = AI_ROUTING_TABLE['job.logic']\n  return {\n    ...(row.thinking ? { thinking: row.thinking } : {}),\n    ...(row.effort ? { effort: row.effort } : {}),\n  }\n}\n\n/** The function generation as the doctrine's loop runs it. */\nexport function aiJobLogicFunctionGeneration(request: {\n  brief: string\n  context: AiLogicContext\n  saved: HostFunction | null\n  model: string\n  signal?: AbortSignal\n}): AiCustomGenerationInput<HostFunction> {\n  return {\n    step: 'job.logic',\n    model: request.model,\n    instructions: AI_JOB_LOGIC_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiJobLogicPrompt({ ...request, mode: 'function' }) }],\n    tool: aiLogicFunctionTool(),\n    maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model),\n    ...routedEffort(),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: (answer) => checkAiLogicFunction(answer, request.context),\n  }\n}\n\n/** The variable generation. */\nexport function aiJobLogicVariableGeneration(request: {\n  brief: string\n  context: AiLogicContext\n  model: string\n  signal?: AbortSignal\n}): AiCustomGenerationInput<AiLogicSiteVariable> {\n  return {\n    step: 'job.logic',\n    model: request.model,\n    instructions: AI_JOB_LOGIC_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiJobLogicPrompt({ ...request, mode: 'variable', saved: null }) }],\n    tool: aiLogicVariableTool(),\n    maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model),\n    ...routedEffort(),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: (answer) => checkAiLogicVariable(answer, request.context),\n  }\n}\n\n/** The explanation generation. */\nexport function aiJobLogicExplainGeneration(request: {\n  brief: string\n  context: AiLogicContext\n  saved: HostFunction\n  model: string\n  signal?: AbortSignal\n}): AiCustomGenerationInput<AiWorkflowExplanation> {\n  return {\n    step: 'job.logic',\n    model: request.model,\n    instructions: AI_JOB_LOGIC_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiJobLogicPrompt({ ...request, mode: 'explain' }) }],\n    tool: aiWorkflowExplanationTool(),\n    maxTokens: AI_JOB_LOGIC_STEP_BUDGET.maxTokens(request.model),\n    ...routedEffort(),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: readAiWorkflowExplanation,\n  }\n}\n\n// ── The runner ────────────────────────────────────────────────────────────\n\nexport interface AiJobLogicStepDeps {\n  readRecords?: typeof readAiLogicRecords\n  readFunction?: typeof readAiLogicFunction\n}\n\nfunction proposalOutput(\n  place: { hostId: string; hostSubdomain: string | null },\n  id: string,\n  label: string,\n  proposal: AiLogicProposal,\n  note: string,\n): AiJobOutput {\n  return {\n    resource: AI_LOGIC_RESOURCE as AiJobOutputResource,\n    id,\n    hostId: place.hostId,\n    hostSubdomain: place.hostSubdomain,\n    label,\n    proposal: proposal as unknown as Record<string, unknown>,\n    note,\n  }\n}\n\nexport function createAiJobLogicStep(deps: AiJobLogicStepDeps = {}): AiJobStepRunner {\n  const readRecords = deps.readRecords ?? readAiLogicRecords\n  const readFunction = deps.readFunction ?? readAiLogicFunction\n  return async ({ job, signal, firestore, modelFor }): Promise<AiJobStepOutcome> => {\n    const model = modelFor?.('job.logic') ?? aiJobLogicModel()\n    const unspent = (failure: string): AiJobStepOutcome => ({ ...aiUnspentOutcome(model), failure })\n    const inputs = parseAiLogicJobInputs(job.inputs)\n    if (typeof inputs === 'string') return unspent(inputs)\n    const hostId = job.hostId\n    if (!hostId) return unspent(AI_LOGIC_NO_SITE_COPY)\n    const host = await firestore.collection('hosts').doc(hostId).get()\n    if (!host.exists || host.get('orgId') !== job.orgId) return unspent(AI_LOGIC_NO_SITE_COPY)\n    const subdomain = host.get('subdomain')\n    const place = { hostId, hostSubdomain: typeof subdomain === 'string' && subdomain ? subdomain : null }\n\n    const functionId = inputs.mode === 'variable' ? null : inputs.functionId\n    const saved = functionId ? await readFunction(firestore, { hostId, id: functionId }) : null\n    if (functionId && !saved) return unspent(AI_LOGIC_GONE_COPY)\n    const records = await readRecords(firestore, hostId)\n    const context: AiLogicContext = { ...records, editing: saved?.name ?? null }\n    const signalled = signal ? { signal } : {}\n\n    if (inputs.mode === 'explain' && saved) {\n      const generation = await runValidatedGeneration(\n        'logic',\n        aiJobLogicExplainGeneration({ brief: job.brief, context, saved, model, ...signalled }),\n      )\n      const spent = { ...aiGenerationSpent(generation), ...(generation.effort ? { effort: generation.effort } : {}) }\n      if (generation.status === 'refused') return { ...spent, refused: true }\n      if (generation.status === 'needs_input') return { ...spent, failure: AI_LOGIC_NO_EXPLANATION_COPY }\n      return {\n        ...spent,\n        outputs: [\n          {\n            resource: 'text',\n            id: 'explanation',\n            hostId,\n            hostSubdomain: place.hostSubdomain,\n            label: `How ${saved.name} works`,\n            text: aiWorkflowExplanationText(generation.value, 'explain'),\n          },\n        ],\n      }\n    }\n\n    if (inputs.mode === 'variable') {\n      const generation = await runValidatedGeneration(\n        'logic',\n        aiJobLogicVariableGeneration({ brief: job.brief, context, model, ...signalled }),\n      )\n      const spent = { ...aiGenerationSpent(generation), ...(generation.effort ? { effort: generation.effort } : {}) }\n      if (generation.status === 'refused') return { ...spent, refused: true }\n      if (generation.status === 'needs_input') return { ...spent, failure: AI_LOGIC_NO_VARIABLE_COPY }\n      const variable = generation.value\n      return {\n        ...spent,\n        outputs: [\n          proposalOutput(place, 'variable', variable.name, { kind: 'variable', variable }, 'Open it in Variables to review and save it.'),\n        ],\n      }\n    }\n\n    const generation = await runValidatedGeneration(\n      'logic',\n      aiJobLogicFunctionGeneration({ brief: job.brief, context, saved, model, ...signalled }),\n    )\n    const spent = { ...aiGenerationSpent(generation), ...(generation.effort ? { effort: generation.effort } : {}) }\n    if (generation.status === 'refused') return { ...spent, refused: true }\n    if (generation.status === 'needs_input') return { ...spent, failure: AI_LOGIC_NO_FUNCTION_COPY }\n    const definition = generation.value\n    return {\n      ...spent,\n      outputs: [\n        proposalOutput(\n          place,\n          functionId ?? 'function',\n          definition.name,\n          { kind: 'function', functionId, definition },\n          saved\n            ? `A changed ${saved.name}, checked against the expression grammar and run once. Nothing is saved until you save it in the editor.`\n            : 'Checked against the expression grammar and run once. Nothing is saved until you save it in the editor.',\n        ),\n      ],\n    }\n  }\n}\n\nexport const runAiJobLogicStep = createAiJobLogicStep()\n\n// ── Admission ─────────────────────────────────────────────────────────────\n\n/** The plugin that keeps Functions & Variables. */\nexport const AI_LOGIC_PLUGIN_ID = 'logic'\n\nexport interface AiLogicJobAdmissionDeps {\n  readFunction?: typeof readAiLogicFunction\n}\n\n/**\n * A logic job is admitted for a site of its org with Logic on for it and past\n * its release flag; a change or an explanation also needs the function it\n * names to exist.\n */\nexport function createAiLogicJobAdmission(deps: AiLogicJobAdmissionDeps = {}): AiJobAdmission {\n  const readFunction = deps.readFunction ?? readAiLogicFunction\n  return async (context): Promise<AiJobAdmissionRefusal | null> => {\n    const inputs = parseAiLogicJobInputs(context.inputs)\n    if (typeof inputs === 'string') return { status: 400, error: inputs }\n    const hostId = context.hostId\n    if (!hostId) return { status: 400, error: 'Open the site the logic is for before starting the job' }\n    const owner = await resolveOrgIdForHost(hostId)\n    if (!owner || owner !== context.orgId) return { status: 404, error: 'Unknown site' }\n    const host = (await context.firestore.collection('hosts').doc(hostId).get()).data() ?? null\n    const org = context.org as { enabledPlugins?: string[] } | null\n    const released = await filterEnabledPluginsByReleaseFlags([AI_LOGIC_PLUGIN_ID], {\n      orgId: context.orgId,\n      authorization: null,\n    })\n    if (!released.includes(AI_LOGIC_PLUGIN_ID) || !isHostPluginEnabled(org, host, AI_LOGIC_PLUGIN_ID)) {\n      return { status: 403, error: AI_LOGIC_UNAVAILABLE_COPY }\n    }\n    const functionId = inputs.mode === 'variable' ? null : inputs.functionId\n    if (functionId && !(await readFunction(context.firestore, { hostId, id: functionId }))) {\n      return { status: 404, error: AI_LOGIC_GONE_COPY }\n    }\n    return null\n  }\n}\n\nexport const aiLogicJobAdmission = createAiLogicJobAdmission()\n\n/** Registers the logic step and the check a logic job passes before it is created or resumed. */\nexport function registerAiLogicJob(): void {\n  registerAiJobStep('logic', runAiJobLogicStep, { minimumMs: AI_JOB_LOGIC_STEP_MINIMUM_MS })\n  registerAiJobAdmission('logic', aiLogicJobAdmission)\n}\n"],"names":["FUNCTION_BUILTIN_NAMES","isHostPluginEnabled","filterEnabledPluginsByReleaseFlags","resolveOrgIdForHost","aiWorkflowExplanationText","AI_LOGIC_GONE_COPY","AI_LOGIC_MAX_OPERATIONS","AI_LOGIC_MAX_PARAMETERS","AI_LOGIC_NO_EXPLANATION_COPY","AI_LOGIC_NO_FUNCTION_COPY","AI_LOGIC_NO_SITE_COPY","AI_LOGIC_NO_VARIABLE_COPY","AI_LOGIC_RESOURCE","AI_LOGIC_UNAVAILABLE_COPY","checkAiLogicFunction","checkAiLogicVariable","parseAiLogicJobInputs","AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","runValidatedGeneration","aiLogicFunctionTool","aiLogicVariableTool","AI_LOGIC_FUNCTION_TOOL_NAME","AI_LOGIC_VARIABLE_TOOL_NAME","AI_WORKFLOW_EXPLANATION_TOOL_NAME","aiWorkflowExplanationTool","readAiWorkflowExplanation","registerAiJobAdmission","aiJobStepBudget","aiGenerationSpent","aiUnspentOutcome","AI_JOB_BRIEF_MAX_CHARS","registerAiJobStep","readAiLogicFunction","readAiLogicRecords","AI_LOGIC_RECORDS_READ_MS","AI_JOB_LOGIC_STEP_BUDGET","tier","maxTokens","lookups","ownReadsMs","AI_JOB_LOGIC_STEP_MINIMUM_MS","minimumMs","aiJobLogicModel","AI_LOGIC_VARIABLES_LISTED","AI_LOGIC_VALUE_LISTED_CHARS","AI_JOB_LOGIC_INSTRUCTIONS","text","map","name","join","cacheBreakpoint","variableLine","variable","value","String","replace","type","length","slice","aiLogicFunctionOutline","definition","lines","push","parameters","parameter","required","label","defaultValue","variables","local","operations","forEach","operation","index","sets","list","set","workflow","expression","if","left","comparator","right","then","otherwise","returnValue","aiJobLogicPrompt","input","context","mode","saved","functions","brief","routedEffort","row","thinking","effort","aiJobLogicFunctionGeneration","request","step","model","instructions","messages","role","content","tool","signal","check","answer","aiJobLogicVariableGeneration","aiJobLogicExplainGeneration","proposalOutput","place","id","proposal","note","resource","hostId","hostSubdomain","createAiJobLogicStep","deps","readRecords","readFunction","job","firestore","modelFor","unspent","failure","inputs","host","collection","doc","get","exists","orgId","subdomain","functionId","records","editing","signalled","generation","spent","status","refused","outputs","kind","runAiJobLogicStep","AI_LOGIC_PLUGIN_ID","createAiLogicJobAdmission","error","owner","data","org","released","authorization","includes","aiLogicJobAdmission","registerAiLogicJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-overlay-copy.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @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 AiOverlayCopyProposal, type AiOverlayKind, type AiOverlayTrigger } from '../model/ai-overlay-copy';
+import type { AiJob, AiJobOutput } from '../model/ai-jobs.types';
+import { type AiSystemBlock } from '../runtime/ai-runtime';
+import type { AiJobStepOutcome } from './ai-job-text-step';
+/**
+ * Overlay copy (AGL-3603): the `text` step asked, by `inputs.task: 'overlay'`,
+ * for an announcement bar's or a popup's copy as fields rather than prose.
+ *
+ * A text job rather than a kind of its own because it IS a text job — a brief
+ * in, a short piece of copy out, one request at the `job.text` route's model
+ * and ceiling — so it runs inline in the create door, is metered as any text
+ * job is and needs no plan. Only the answer's shape differs: one strict tool
+ * call, held by `checkAiOverlayCopy` to the limits and the triggers the
+ * request named.
+ *
+ * ## Nothing is written
+ *
+ * The answer is a proposal on the job's output. The overlay is the marketing
+ * plugin's; its editor fills its fields from the proposal unsaved, or its list
+ * writes a new overlay switched off, and in both a person decides what goes
+ * live. No link, schedule, page targeting or on-switch is ever proposed.
+ *
+ * ## What reaches the model
+ *
+ * The brief, what the overlay is (a bar or a popup), the triggers the site
+ * offers, and — when a person asked from an overlay that has copy — that copy
+ * as the editor holds it. Nothing about the site's visitors or its figures.
+ */
+/** The job's failure when the answer could not be used. */
+export declare const AI_OVERLAY_NO_COPY_COPY = "The AI did not write copy that fits this overlay. Try the brief in different words.";
+/** The job's failure when the inputs name no overlay kind. */
+export declare const AI_OVERLAY_NO_KIND_COPY = "Say whether the copy is for an announcement bar or a popup.";
+/** The rules, static and byte-identical for every workspace, so they cache. */
+export declare const AI_OVERLAY_RULES: string;
+export declare const AI_OVERLAY_SYSTEM: AiSystemBlock[];
+/** The user turn: the brief, the overlay, its triggers and its copy as it stands. */
+export declare function aiOverlayCopyPrompt(input: {
+    brief: string;
+    kind: AiOverlayKind;
+    triggers: ReadonlyMap<AiOverlayTrigger, {
+        min: number;
+        max: number;
+    } | null>;
+    current: string;
+}): string;
+/** A checked proposal as the job's output: shown as text, carried as fields. */
+export declare function aiOverlayCopyOutput(job: Pick<AiJob, 'hostId' | 'inputs'>, proposal: AiOverlayCopyProposal): AiJobOutput;
+/** The overlay task of the text step: one strict tool call, checked, never written. */
+export declare function runAiOverlayCopy(input: {
+    job: Pick<AiJob, '$id' | 'brief' | 'hostId' | 'inputs'>;
+    model: string;
+    maxTokens: number;
+    signal?: AbortSignal;
+}): Promise<AiJobStepOutcome>;