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

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

@@ -19,7 +19,7 @@ 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_LOGIC_FUNCTION_RESOURCE, AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY, AI_LOGIC_FUNCTION_UNAVAILABLE_COPY, AI_LOGIC_FUNCTION_WRITTEN_NOTE, 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, aiLogicJobIsBuildUnit, 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";
@@ -27,7 +27,8 @@ import { aiLogicFunctionTool, aiLogicVariableTool, AI_LOGIC_FUNCTION_TOOL_NAME,
 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 { aiGenerationSpent, aiLimitReview, aiUnspentOutcome } from "./ai-job-generation.js";
+import { aiPluginDraftWriter } from "./ai-job-plugin-drafts.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";
@@ -45,6 +46,14 @@ import { readAiLogicFunction, readAiLogicRecords } from "./ai-logic-records.js";
  *
  * Nothing is written. A proposal rides on a `logic` output, and the logic
  * editor opens it for a person to save.
+ *
+ * Except for a build's unit (AGL-3616): a job derived for a `function` item
+ * of a confirmed build plan — it carries `inputs.originJobId` — writes the
+ * NEW function it checked, through the `function` draft writer the logic
+ * plugin registers on the core's resource-drafts seam (this plugin imports
+ * no other). The writer's refusal is asked before anything is spent, the
+ * record is written under the unit job's id so a run asked again finds it,
+ * and the output is a `draft` the build's ledger records.
  */ /** 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'],
@@ -204,6 +213,18 @@ function routedEffort() {
         check: readAiWorkflowExplanation
     });
 }
+/** A function a build's unit wrote, as the build's ledger records it. */ export function aiLogicFunctionDraftOutput(place, record) {
+    return {
+        resource: 'draft',
+        id: record.id,
+        versionId: null,
+        hostId: place.hostId,
+        hostSubdomain: place.hostSubdomain,
+        label: record.name,
+        draftResource: AI_LOGIC_FUNCTION_RESOURCE,
+        note: AI_LOGIC_FUNCTION_WRITTEN_NOTE
+    };
+}
 function proposalOutput(place, id, label, proposal, note) {
     return {
         resource: AI_LOGIC_RESOURCE,
@@ -216,11 +237,12 @@ function proposalOutput(place, id, label, proposal, note) {
     };
 }
 export function createAiJobLogicStep(deps = {}) {
-    var _deps_readRecords, _deps_readFunction;
+    var _deps_readRecords, _deps_readFunction, _deps_writerFor;
     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 writerFor = (_deps_writerFor = deps.writerFor) != null ? _deps_writerFor : aiPluginDraftWriter;
+    return async ({ job, now, signal, firestore, org, modelFor })=>{
+        var _ref, _ref1, _ref2;
         const model = (_ref = modelFor == null ? void 0 : modelFor('job.logic')) != null ? _ref : aiJobLogicModel();
         const unspent = (failure)=>_extends({}, aiUnspentOutcome(model), {
                 failure
@@ -237,6 +259,37 @@ export function createAiJobLogicStep(deps = {}) {
             hostSubdomain: typeof subdomain === 'string' && subdomain ? subdomain : null
         };
         const functionId = inputs.mode === 'variable' ? null : inputs.functionId;
+        // A build's new function is written, not proposed: the writer is found,
+        // asked for what it already wrote under this unit's id, and asked whether
+        // this member may have one, all before anything is spent.
+        const writes = inputs.mode === 'function' && !functionId && aiLogicJobIsBuildUnit(job);
+        const writer = writes ? writerFor(AI_LOGIC_FUNCTION_RESOURCE) : null;
+        const draftContext = writes ? {
+            orgId: job.orgId,
+            hostId,
+            uid: job.createdBy,
+            org: (_ref1 = org != null ? org : (await firestore.collection('orgs').doc(job.orgId).get()).data()) != null ? _ref1 : null,
+            now
+        } : null;
+        if (writes) {
+            if (!writer || !draftContext) return unspent(AI_LOGIC_FUNCTION_UNAVAILABLE_COPY);
+            // The unit's job is named by its plan item's id, which is the id its draft is written under.
+            const written = await writer.read({
+                hostId,
+                id: job.$id
+            });
+            if (written) return aiUnspentOutcome(model, {
+                outputs: [
+                    aiLogicFunctionDraftOutput(place, written)
+                ]
+            });
+            const refusal = await writer.refusal(draftContext);
+            if (refusal) {
+                return refusal.status === 403 ? aiUnspentOutcome(model, {
+                    review: aiLimitReview(refusal.error)
+                }) : unspent(refusal.error);
+            }
+        }
         const saved = functionId ? await readFunction(firestore, {
             hostId,
             id: functionId
@@ -244,7 +297,7 @@ export function createAiJobLogicStep(deps = {}) {
         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
+            editing: (_ref2 = saved == null ? void 0 : saved.name) != null ? _ref2 : null
         });
         const signalled = signal ? {
             signal
@@ -319,6 +372,34 @@ export function createAiJobLogicStep(deps = {}) {
             failure: AI_LOGIC_NO_FUNCTION_COPY
         });
         const definition = generation.value;
+        if (writer && draftContext) {
+            var _checked_problems_;
+            // Held to the owner's rules before it is written, as every draft is.
+            const content = definition;
+            const checked = writer.check(content, {
+                hostId
+            });
+            if (checked.ok === false) return _extends({}, spent, {
+                failure: (_checked_problems_ = checked.problems[0]) != null ? _checked_problems_ : AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY
+            });
+            const write = await writer.write(_extends({}, draftContext, {
+                id: job.$id,
+                name: definition.name,
+                content
+            }));
+            if (write.ok === false) {
+                return write.status === 403 ? _extends({}, spent, {
+                    review: aiLimitReview(write.error)
+                }) : _extends({}, spent, {
+                    failure: write.status === 409 ? write.error : AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY
+                });
+            }
+            return _extends({}, spent, {
+                outputs: [
+                    aiLogicFunctionDraftOutput(place, write)
+                ]
+            });
+        }
         return _extends({}, spent, {
             outputs: [
                 proposalOutput(place, functionId != null ? functionId : 'function', definition.name, {

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

@@ -1 +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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"}
+{"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_FUNCTION_RESOURCE,\n  AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY,\n  AI_LOGIC_FUNCTION_UNAVAILABLE_COPY,\n  AI_LOGIC_FUNCTION_WRITTEN_NOTE,\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  aiLogicJobIsBuildUnit,\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, aiLimitReview, aiUnspentOutcome } from './ai-job-generation'\nimport { aiPluginDraftWriter, type AiPluginDraftWriterLookup } from './ai-job-plugin-drafts'\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 * Except for a build's unit (AGL-3616): a job derived for a `function` item\n * of a confirmed build plan — it carries `inputs.originJobId` — writes the\n * NEW function it checked, through the `function` draft writer the logic\n * plugin registers on the core's resource-drafts seam (this plugin imports\n * no other). The writer's refusal is asked before anything is spent, the\n * record is written under the unit job's id so a run asked again finds it,\n * and the output is a `draft` the build's ledger records.\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  /** How the logic plugin's `function` writer is found; the core's registry otherwise. */\n  writerFor?: AiPluginDraftWriterLookup\n}\n\n/** A function a build's unit wrote, as the build's ledger records it. */\nexport function aiLogicFunctionDraftOutput(\n  place: { hostId: string; hostSubdomain: string | null },\n  record: { id: string; name: string },\n): AiJobOutput {\n  return {\n    resource: 'draft',\n    id: record.id,\n    versionId: null,\n    hostId: place.hostId,\n    hostSubdomain: place.hostSubdomain,\n    label: record.name,\n    draftResource: AI_LOGIC_FUNCTION_RESOURCE,\n    note: AI_LOGIC_FUNCTION_WRITTEN_NOTE,\n  }\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  const writerFor = deps.writerFor ?? aiPluginDraftWriter\n  return async ({ job, now, signal, firestore, org, 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\n    // A build's new function is written, not proposed: the writer is found,\n    // asked for what it already wrote under this unit's id, and asked whether\n    // this member may have one, all before anything is spent.\n    const writes = inputs.mode === 'function' && !functionId && aiLogicJobIsBuildUnit(job)\n    const writer = writes ? writerFor(AI_LOGIC_FUNCTION_RESOURCE) : null\n    const draftContext = writes\n      ? {\n          orgId: job.orgId,\n          hostId,\n          uid: job.createdBy,\n          org: (org ?? (await firestore.collection('orgs').doc(job.orgId).get()).data() ?? null) as Record<\n            string,\n            unknown\n          > | null,\n          now,\n        }\n      : null\n    if (writes) {\n      if (!writer || !draftContext) return unspent(AI_LOGIC_FUNCTION_UNAVAILABLE_COPY)\n      // The unit's job is named by its plan item's id, which is the id its draft is written under.\n      const written = await writer.read({ hostId, id: job.$id })\n      if (written) return aiUnspentOutcome(model, { outputs: [aiLogicFunctionDraftOutput(place, written)] })\n      const refusal = await writer.refusal(draftContext)\n      if (refusal) {\n        return refusal.status === 403\n          ? aiUnspentOutcome(model, { review: aiLimitReview(refusal.error) })\n          : unspent(refusal.error)\n      }\n    }\n\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    if (writer && draftContext) {\n      // Held to the owner's rules before it is written, as every draft is.\n      const content = definition as unknown as Record<string, unknown>\n      const checked = writer.check(content, { hostId })\n      if (checked.ok === false) return { ...spent, failure: checked.problems[0] ?? AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY }\n      const write = await writer.write({ ...draftContext, id: job.$id, name: definition.name, content })\n      if (write.ok === false) {\n        return write.status === 403\n          ? { ...spent, review: aiLimitReview(write.error) }\n          : { ...spent, failure: write.status === 409 ? write.error : AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY }\n      }\n      return { ...spent, outputs: [aiLogicFunctionDraftOutput(place, write)] }\n    }\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_FUNCTION_RESOURCE","AI_LOGIC_FUNCTION_SAVE_FAILURE_COPY","AI_LOGIC_FUNCTION_UNAVAILABLE_COPY","AI_LOGIC_FUNCTION_WRITTEN_NOTE","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","aiLogicJobIsBuildUnit","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","aiLimitReview","aiUnspentOutcome","aiPluginDraftWriter","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","aiLogicFunctionDraftOutput","place","record","resource","id","versionId","hostId","hostSubdomain","draftResource","note","proposalOutput","proposal","createAiJobLogicStep","deps","readRecords","readFunction","writerFor","job","now","firestore","org","modelFor","unspent","failure","inputs","host","collection","doc","get","exists","orgId","subdomain","functionId","writes","writer","draftContext","uid","createdBy","data","written","read","$id","outputs","refusal","status","review","error","records","editing","signalled","generation","spent","refused","kind","checked","ok","problems","write","runAiJobLogicStep","AI_LOGIC_PLUGIN_ID","createAiLogicJobAdmission","owner","released","authorization","includes","aiLogicJobAdmission","registerAiLogicJob"],"mappings":"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"}

package/src/lib/jobs/ai-job-page-language.d.ts

@@ -0,0 +1,194 @@
+/**
+ * @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 { NodesMap } from '@aglyn/aglyn/types/nodes';
+import { type AiBuildPlanScreen } from '../model/ai-build-plan';
+import type { AiJob, AiJobPlan } from '../model/ai-jobs.types';
+import { type AiSiteInventory } from '../model/ai-site-inventory';
+import { type AiLayoutSection, type AiLayoutSettlement } from '../layout-language/ai-layout-language';
+import type { AiLayoutTargets } from '../layout-language/ai-layout-links';
+import { type AiGenerationCheck, type AiValidatedGeneration } from '../runtime/ai-doctrine';
+import { type AiDoctrineTreeContext, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+import type { AiLoadEstimate } from '../runtime/ai-palette';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+/**
+ * A page built in the compact layout language (AGL-3660): the page step's
+ * pass for a site's page units — a guided start's and a build's — in place of
+ * the raw-tree section passes.
+ *
+ * ONE answer a page: every planned section, in the language, through
+ * `submit_page`. The compiler writes the tree, the palette validator stores
+ * it as it stores any generated tree, and the doctrine checks the whole page.
+ * A section the answer left out or left empty is the one thing a re-ask asks
+ * for: the sections that read are kept, and the second answer fills only
+ * what is still missing. Then the page step's last pass runs as it always
+ * has — the whole page held to the doctrine again, its listing written, the
+ * draft reported — so the item ledger, the credits and Try again work exactly
+ * as they did.
+ */
+/** The unit input that says a page or a layout is built in the layout language. */
+export declare const AI_LAYOUT_LANGUAGE_INPUT = "layoutLanguage";
+/** The unit input naming the page of the site that places its form, where it is another page. */
+export declare const AI_LAYOUT_FORM_PAGE_INPUT = "layoutFormPage";
+/** Whether this job builds its page or its layout in the layout language. */
+export declare function aiJobUsesLayoutLanguage(job: Pick<AiJob, 'inputs'>): boolean;
+/**
+ * How the language doors think (AGL-3660): adaptively, at an effort named
+ * rather than left to the model's default. Zach, 2026-10-07: quality first —
+ * a page and a site's frame are designed, not transcribed, and the caching
+ * work pays for the thinking. Medium is where Claude Sonnet 5.5, the balanced
+ * default, is tuned to start for multistep design work.
+ */
+export declare const AI_LAYOUT_LANGUAGE_THINKING: {
+    readonly thinking: "adaptive";
+    readonly effort: "medium";
+};
+/**
+ * Room for the thinking a page's answer does before it writes, inside the
+ * same `max_tokens` as the answer: thinking is drawn from the ceiling first,
+ * so a ceiling sized for the answer alone would cut a thoughtful answer off.
+ *
+ * Bounded by TIME, not by money: the page step's answer, its re-ask and the
+ * follow-up must fit the least time a beat gives a step
+ * (`AI_JOB_STEP_MAX_MINIMUM_MS`), and `aiJobStepBudget` quietly lowers every
+ * ceiling to what fits. 2,000 here, with the follow-up's 500, is the most
+ * that fits whole on the balanced tier; at 5,000 the budget cut a page's
+ * ceiling to 879 tokens, under the answer itself.
+ */
+export declare const AI_LAYOUT_PAGE_THINKING_TOKENS = 2000;
+/** The same room for a site's header and footer, whose step has the time for more. */
+export declare const AI_LAYOUT_FRAME_THINKING_TOKENS = 4000;
+/**
+ * The most one page's answer asks for: the answer and the thinking before it.
+ * A section in the language is about 120 to 250 tokens with its copy, so the
+ * largest page a plan admits — eight sections — fits in 3,000 with room (the
+ * live runs of 2026-10-07 wrote 683 to 1,745); the compiler, not the ceiling,
+ * keeps a page small.
+ */
+export declare const AI_JOB_PAGE_LANGUAGE_TOKENS: number;
+/**
+ * The time a language page pass needs: its lookup rounds, its answer and its
+ * re-ask at `AI_JOB_PAGE_LANGUAGE_TOKENS` on the tier the page step is served
+ * from, with the step's reads and writes.
+ */
+/** The most the follow-up asking only for the sections an answer left out may run to, its thinking included. */
+export declare const AI_JOB_PAGE_LANGUAGE_FOLLOW_UP_TOKENS: number;
+export declare const AI_JOB_PAGE_LANGUAGE_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The doctrine scope the language doors are told: values the compiler checks itself. */
+export declare const AI_LAYOUT_PAGE_KIND = "layout-page";
+/** The language, as the page door's cached instructions. */
+export declare const AI_JOB_PAGE_LANGUAGE_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The page of a site plan that places its form: the form the plan creates, or one the site has. */
+export declare function aiLayoutFormPageOfPlan(plan: Pick<AiJobPlan, 'create' | 'screens'>, formIds?: readonly string[]): string | null;
+/** Every word the job was given, which a page's contact details are held to. */
+export declare function aiLayoutFacts(job: Pick<AiJob, 'brief' | 'inputs'>): string;
+/** What a page's links resolve against: the site's pages, built and planned, its forms and components. */
+export declare function aiLayoutPageTargets(input: {
+    job: Pick<AiJob, 'brief' | 'inputs'>;
+    inventory: AiSiteInventory | null;
+    own: ReadonlyArray<string | null | undefined>;
+}): AiLayoutTargets;
+/** The page's user turn: the page, the brief, the plan, its sections and where its links may go. */
+export declare function aiLayoutPagePrompt(input: {
+    job: Pick<AiJob, 'brief' | 'inputs' | '$id'>;
+    plan: AiJobPlan;
+    screen: AiBuildPlanScreen;
+    targets: AiLayoutTargets;
+    reusableComponents: boolean;
+    /** The sections a re-ask still needs, by plan index; absent on the first ask. */
+    missing?: readonly number[];
+}): string;
+/** A validated language page, stored as the page keeps it. */
+export interface AiLayoutPageBuilt {
+    nodes: NodesMap;
+    load: AiLoadEstimate | null;
+    settled: AiLayoutSettlement[];
+    /** What the last answer's gaps took out of the page (`ai-layout-gaps.ts`). */
+    dropped: string[];
+    /** How many repeated items each plan section shows, as built (AGL-3660). */
+    items: number[];
+}
+export interface AiLayoutPageCheckInput {
+    screen: AiBuildPlanScreen;
+    sectionIds: readonly string[];
+    targets: AiLayoutTargets;
+    context: AiDoctrineTreeContext;
+    reusableComponents: boolean;
+    /**
+     * What earlier answers gave, by plan index, shared between the page's
+     * generations: a follow-up asking only for missing sections fills the rest.
+     */
+    kept?: Array<AiLayoutSection | null>;
+    /** The plan indices this answer's sections fill, in order; absent, every section. */
+    only?: readonly number[];
+}
+/**
+ * The follow-up turn for the sections a page's answer left out (AGL-3660):
+ * the page as before, told which sections it already has, and asked for only
+ * the missing ones, in order — the one part of a page asked for again.
+ */
+export declare function aiLayoutMissingSectionsPrompt(input: {
+    base: string;
+    screen: AiBuildPlanScreen;
+    missing: readonly number[];
+}): string;
+/** The plan indices a page still lacks, after the answers so far. */
+export declare function aiLayoutMissingSections(kept: ReadonlyArray<AiLayoutSection | null>): number[];
+/** The violation a planned section the answer gave nothing usable for is named by. */
+export declare const AI_LAYOUT_SECTION_MISSING_CODE = "layout-section-missing";
+/** The code a section planned with items that shows none is refused under (AGL-3660). */
+export declare const AI_LAYOUT_SECTION_EMPTY_CODE = "layout-section-no-items";
+/**
+ * How many repeated items each section shows once stored (AGL-3660): the
+ * elements the compiler drew for them, under the ids they are stored by,
+ * that are still in the page after anything later took words out.
+ */
+export declare function aiLayoutShownItems(itemIds: readonly (readonly string[])[], storedIds: Readonly<Record<string, string>>, nodes: Readonly<Record<string, unknown>>): number[];
+/**
+ * The sections a page planned with repeated items — cards, steps, a list —
+ * that show none, or too few, once the page is built (AGL-3660). A heading
+ * and an intro over nothing is a section a visitor reads as broken, so it is
+ * asked for again.
+ */
+export declare function aiLayoutEmptyItemSections(screen: Pick<AiBuildPlanScreen, 'sections'>, items: readonly number[]): AiDoctrineViolation[];
+/**
+ * The check a language page answer is held to: each planned section read,
+ * the page compiled, stored and checked whole. Sections that read are kept
+ * across the re-ask, so the second answer is asked only for what was missing,
+ * and a section it sends again that already read is not taken twice.
+ */
+export declare function aiLayoutPageCheck(input: AiLayoutPageCheckInput): AiGenerationCheck<AiLayoutPageBuilt>;
+export interface AiLayoutPageRunInput {
+    job: Pick<AiJob, 'brief' | 'inputs' | '$id'>;
+    plan: AiJobPlan;
+    screen: AiBuildPlanScreen;
+    sectionIds: readonly string[];
+    targets: AiLayoutTargets;
+    context: AiDoctrineTreeContext;
+    reusableComponents: boolean;
+    inventory: AiSiteInventory | null;
+    model: string;
+    signal?: AbortSignal;
+    /** Wraps the check, for an eval that records each answer it reads. */
+    observe?: (check: AiGenerationCheck<AiLayoutPageBuilt>) => AiGenerationCheck<AiLayoutPageBuilt>;
+}
+/**
+ * A whole page in the layout language: one answer for every section, and,
+ * where that answer and its re-ask still left a section out, one follow-up
+ * asking for only those (AGL-3660). The sections that read are kept between
+ * them, so the page is compiled whole once every section is designed.
+ */
+export declare function aiRunLayoutPage(input: AiLayoutPageRunInput): Promise<AiValidatedGeneration<AiLayoutPageBuilt>>;