@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,337 @@
+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 { hostThemeSource, resolveSiteTheme } from "@aglyn/aglyn/app-utils/marketplace-theme";
+import { INHERITED_BORDER_RADIUS, INHERITED_FONT_FAMILY, INHERITED_SPACING, INHERITED_TOOLBAR_HEIGHTS, inheritedThemeColor } from "@aglyn/shared-ui-theme/util/theme-editor-defaults";
+import { readDarkScheme, readFontFamily, readThemeColor, readToolbarHeight, SYSTEM_FONT_VALUE, THEME_COLOR_FIELDS, THEME_EDITOR_MEDIA_QUERIES } from "@aglyn/shared-ui-theme/util/theme-editor-fields";
+import { buildAiThemeProposal } from "../model/ai-theme-proposal.js";
+import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
+import { runValidatedGeneration } from "../runtime/ai-doctrine.js";
+import { AI_THEME_TOOL_NAME, aiThemeTool, parseAiThemeToolInput } from "../tools/ai-theme-tool.js";
+import { AI_JOB_BRIEF_MAX_CHARS } from "./ai-job-text-step.js";
+import { AI_JOB_THEME_STEP_BUDGET } from "./ai-job-theme-budget.js";
+import { AI_THEME_BRAND_SOURCE_WORDS, gatherAiThemeBrandInputs } from "./ai-theme-brand-inputs.js";
+/**
+ * The `theme` step (AGL-2938): a brief and a site's current theme in, a theme
+ * proposal out — every control the theme editor exposes, and nothing else.
+ *
+ * The step writes nothing to the site. A site's theme is fields on its host
+ * document, and writing those is the save the Theme section's editor
+ * performs; the step's output is the proposal, which a person puts in the
+ * editor, previews against the current theme, and saves or discards.
+ *
+ * The request is shaped for the cache: the rules and the tool are static and
+ * sit in the cached prefix, and everything about this site — its theme, its
+ * brand colors, the brief — rides in the user turn. The model answers through
+ * one strict tool derived from the editor's own catalog, and the answer is
+ * held to that catalog and to the doctrine (a targeted diff, dark values,
+ * contrast) before it becomes a proposal.
+ */ /**
+ * The routing table's answer for `job.theme`: the model the theme step runs on
+ * when the machine hands it no `modelFor`.
+ */ export function aiJobThemeModel() {
+    return aiModelForStep('job.theme');
+}
+/**
+ * The output budget, from the routing table. The largest answer the tool
+ * accepts — every color in both schemes, the full run of component leaves,
+ * the longest summary — is about 2,500 tokens of JSON
+ * (`ai-job-theme-step.spec.ts` measures it), and the rest is room for the
+ * model to think before it answers.
+ */ export const AI_JOB_THEME_MAX_TOKENS = AI_ROUTING_TABLE['job.theme'].maxTokens;
+/**
+ * The theme's answer ceiling on the model a job runs (AGL-3035): the most
+ * whose worst case — the answer, its re-ask and the brand reads — fits the
+ * least time the step registers (`ai-job-theme-budget.ts`), and never more
+ * than the routing table's.
+ */ export function aiJobThemeMaxTokens(model) {
+    return AI_JOB_THEME_STEP_BUDGET.maxTokens(model);
+}
+/** How many of a site's own component override leaves the prompt lists. */ export const AI_JOB_THEME_INVENTORY_LEAVES = 40;
+/** The customer-safe sentences a failed theme step leaves on the job. */ export const AI_JOB_THEME_NO_SITE_COPY = 'This theme job names a site this workspace does not have.';
+export const AI_JOB_THEME_NO_ANSWER_COPY = 'The AI could not produce a theme proposal from this brief. Try describing the change differently.';
+/**
+ * The theme step's own instructions, byte-identical on every request so they
+ * cache. The acceptable-use rules are not in them: they belong to the block
+ * every generator shares, which the generation call puts ahead of these.
+ */ export const AI_JOB_THEME_INSTRUCTIONS = [
+    {
+        text: 'You change the theme of a website built with a site builder. You are given the ' + "site's current theme — every control its theme editor has, with the value the site " + 'set or the default it inherits — any brand colors that belong to the site, and a ' + 'brief from the person who owns it.\n\n' + `Answer by calling ${AI_THEME_TOOL_NAME} exactly once. A reply in prose cannot be used.\n\n` + 'Rules:\n' + '- In modify mode, name only the controls the brief is about. Every control you leave ' + 'out keeps its current value. "Warmer" is about color, not about fonts or corners.\n' + '- In create mode, design a complete theme: the primary, secondary and tertiary ' + 'accents, the page background and paper, the text colors, and their dark values.\n' + "- Colors are hex values on the theme's own tokens. A theme is where the building rules " + 'send every color, so this is the one answer that writes a color as a value. A component ' + 'style never carries a literal color; color belongs to the palette.\n' + '- Give every color you change a dark value beside its light value unless the dark ' + 'scheme is off. A dark value keeps the hue and reads on a dark background.\n' + '- Keep text readable: body text needs 4.5:1 against the background and the paper, and ' + 'the primary color 3:1 against the background.\n' + '- A hex color written in the brief is used exactly as written. When the brief asks to ' + 'match the brand, build on the brand colors you are given.\n' + '- Fonts come from the list the tool offers, and numbers stay inside the ranges it ' + 'states.\n' + '- Write the summary in the language of the brief.',
+        cacheBreakpoint: true
+    }
+];
+const ZERO_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheReadTokens: 0,
+    cacheWriteTokens: 0
+};
+/** `create` when the job asked for a whole design; `modify` otherwise. */ export function aiJobThemeMode(inputs) {
+    return (inputs == null ? void 0 : inputs['mode']) === 'create' ? 'create' : 'modify';
+}
+const SOURCE_WORDS = {
+    installed: "an installed marketplace theme; a change is stored as the site's own edits on top of it",
+    custom: "the site's own theme",
+    default: "the platform's default theme; a change stores only the values it sets"
+};
+/** One value as the inventory shows it: the site's own, or the default it inherits. */ const shown = (own, inherited)=>own === null || own === undefined ? `${inherited != null ? inherited : 'unset'} (default)` : `${own} (set)`;
+/** The site's own component overrides, one bounded line a leaf. */ function overrideLeaves(theme) {
+    var _ref;
+    const leaves = [];
+    const media = Object.fromEntries(Object.entries(THEME_EDITOR_MEDIA_QUERIES).map(([name, query])=>[
+            query,
+            name
+        ]));
+    const text = (value)=>{
+        var _ref;
+        var _JSON_stringify;
+        return (_ref = (_JSON_stringify = JSON.stringify(value)) == null ? void 0 : _JSON_stringify.slice(0, 60)) != null ? _ref : '';
+    };
+    for (const [component, override] of Object.entries((_ref = theme == null ? void 0 : theme.components) != null ? _ref : {})){
+        var _ref1, _ref2;
+        for (const [prop, value] of Object.entries((_ref1 = override == null ? void 0 : override.defaultProps) != null ? _ref1 : {})){
+            leaves.push(`${component} default ${prop} = ${text(value)}`);
+        }
+        for (const [slot, styles] of Object.entries((_ref2 = override == null ? void 0 : override.styleOverrides) != null ? _ref2 : {})){
+            if (!styles || typeof styles !== 'object') continue;
+            for (const [property, value] of Object.entries(styles)){
+                if (value && typeof value === 'object') {
+                    for (const [nested, nestedValue] of Object.entries(value)){
+                        var _media_property;
+                        leaves.push(`${component} ${slot} ${nested} = ${text(nestedValue)} (${(_media_property = media[property]) != null ? _media_property : property})`);
+                    }
+                } else {
+                    leaves.push(`${component} ${slot} ${property} = ${text(value)}`);
+                }
+            }
+        }
+    }
+    return leaves;
+}
+/**
+ * The site's theme as the model reads it: compact, one control a line, each
+ * value marked as the site's own or the default it inherits, so "make the
+ * background warmer" starts from the color the visitor actually sees.
+ */ export function aiJobThemeInventory(theme, source) {
+    var _theme_shape;
+    const lines = [
+        `Source: ${SOURCE_WORDS[source]}.`,
+        `Dark scheme: ${readDarkScheme(theme)}.`
+    ];
+    lines.push('Colors, light | dark:');
+    for (const { token } of THEME_COLOR_FIELDS){
+        const value = (scheme)=>shown(readThemeColor(theme, scheme, token), inheritedThemeColor(scheme, token));
+        lines.push(`- ${token}: ${value('light')} | ${value('dark')}`);
+    }
+    const font = readFontFamily(theme);
+    lines.push(`Font family: ${shown(font === SYSTEM_FONT_VALUE ? null : font, INHERITED_FONT_FAMILY)}`);
+    lines.push(`Border radius: ${shown(theme == null ? void 0 : (_theme_shape = theme.shape) == null ? void 0 : _theme_shape.borderRadius, INHERITED_BORDER_RADIUS)}`);
+    lines.push(`Spacing unit: ${shown(theme == null ? void 0 : theme.spacing, INHERITED_SPACING)}`);
+    lines.push(`Nav height: mobile ${shown(theme && readToolbarHeight(theme, 'xs'), INHERITED_TOOLBAR_HEIGHTS.xs)}, ` + `desktop ${shown(theme && readToolbarHeight(theme, 'sm'), INHERITED_TOOLBAR_HEIGHTS.sm)}`);
+    const leaves = overrideLeaves(theme);
+    if (!leaves.length) {
+        lines.push('Component overrides: none.');
+    } else {
+        lines.push('Component overrides:');
+        for (const leaf of leaves.slice(0, AI_JOB_THEME_INVENTORY_LEAVES))lines.push(`- ${leaf}`);
+        if (leaves.length > AI_JOB_THEME_INVENTORY_LEAVES) {
+            lines.push(`- and ${leaves.length - AI_JOB_THEME_INVENTORY_LEAVES} more`);
+        }
+    }
+    return lines.join('\n');
+}
+/** The user turn: the mode, the site's theme, its brand colors, and the brief. */ export function aiJobThemePrompt(input) {
+    const sections = [
+        input.mode === 'create' ? 'Mode: create. Design a complete theme over every control.' : 'Mode: modify. Change only what the brief is about.',
+        `Current theme:\n${aiJobThemeInventory(input.theme, input.source)}`
+    ];
+    if (input.brand.length) {
+        sections.push(`Brand colors:\n${input.brand.map((color)=>`- ${color.hex} (${AI_THEME_BRAND_SOURCE_WORDS[color.source]})`).join('\n')}`);
+    }
+    sections.push(`Brief: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`);
+    return sections.join('\n\n');
+}
+/**
+ * The theme tool's answer held to the editor — the check the doctrine's loop
+ * runs on each answer (AGL-2935), which also holds rule 13 on it. Usable when
+ * anything in it survives; refused, naming what was refused, when nothing
+ * does. A call that proposes no change and refuses nothing is a real answer —
+ * the theme already does what the brief asks.
+ */ export const aiJobThemeCheck = (answer)=>{
+    const parse = parseAiThemeToolInput(answer);
+    const nothingUsable = !parse.changes.length && !parse.components.length && !parse.resetComponents;
+    if (!nothingUsable || !parse.dropped.length) return {
+        value: parse,
+        violations: []
+    };
+    return {
+        value: null,
+        violations: parse.dropped.map((message)=>({
+                rule: null,
+                code: 'theme-control',
+                message
+            }))
+    };
+};
+/**
+ * The theme step's generation as the doctrine's loop runs it: its cached
+ * block, which carries the acceptable-use rules, then this step's
+ * instructions; the site's theme in the user turn rather than a site
+ * inventory; the strict tool, the ceiling and the check. The eval harness
+ * records a theme answer through this same call.
+ */ export function aiJobThemeGeneration(request) {
+    return _extends({
+        step: 'job.theme',
+        model: request.model,
+        instructions: AI_JOB_THEME_INSTRUCTIONS,
+        messages: [
+            {
+                role: 'user',
+                content: aiJobThemePrompt(request)
+            }
+        ],
+        tool: aiThemeTool(),
+        maxTokens: aiJobThemeMaxTokens(request.model)
+    }, AI_ROUTING_TABLE['job.theme'].thinking ? {
+        thinking: AI_ROUTING_TABLE['job.theme'].thinking
+    } : {}, AI_ROUTING_TABLE['job.theme'].effort ? {
+        effort: AI_ROUTING_TABLE['job.theme'].effort
+    } : {}, request.signal ? {
+        signal: request.signal
+    } : {}, {
+        check: aiJobThemeCheck
+    });
+}
+/** The site a theme job changes, read and checked against the job's org. */ async function loadThemeSite(firestore, job) {
+    if (!job.hostId) return {
+        failure: AI_JOB_THEME_NO_SITE_COPY
+    };
+    const snapshot = await firestore.collection('hosts').doc(job.hostId).get();
+    const host = snapshot.exists ? snapshot.data() : null;
+    // The route checks the caller's membership of the org the job is metered
+    // against, not that the site it named belongs to that org. A site of some
+    // other org is refused here, before anything about it reaches a prompt.
+    if (!host || host['orgId'] !== job.orgId) return {
+        failure: AI_JOB_THEME_NO_SITE_COPY
+    };
+    return {
+        host,
+        theme: resolveSiteTheme(host),
+        source: hostThemeSource(host)
+    };
+}
+/** How many edits a proposal makes, for its label. */ function proposalSize(proposal) {
+    return proposal.changes.length + proposal.components.length + (proposal.resetComponents ? 1 : 0);
+}
+export const runAiJobThemeStep = async ({ job, signal, firestore, org, modelFor })=>{
+    var _ref, _job_hostId;
+    if (!firestore) {
+        // The machine always hands one in; a runner called without it is a
+        // wiring fault, not a customer path.
+        throw new Error('the theme step reads the site it changes and was given no Firestore');
+    }
+    // The model switch's answer for this job (AGL-2942): the creator's pick
+    // where the plan, the org restriction and the allotment allowlists allow
+    // it, and Auto held to those same lists otherwise. Only a runner called
+    // without a resolver asks the routing table directly.
+    const model = (_ref = modelFor == null ? void 0 : modelFor('job.theme')) != null ? _ref : aiJobThemeModel();
+    const site = await loadThemeSite(firestore, job);
+    if ('failure' in site) {
+        return {
+            outputs: [],
+            usage: ZERO_USAGE,
+            estCostUsd: 0,
+            model,
+            stopReason: null,
+            failure: site.failure
+        };
+    }
+    const mode = aiJobThemeMode(job.inputs);
+    const brand = await gatherAiThemeBrandInputs({
+        firestore,
+        org: org != null ? org : null,
+        hostId: job.hostId,
+        host: site.host,
+        brief: job.brief,
+        signal
+    });
+    // A second refused answer ends in this step's own sentence, below.
+    const generation = await runValidatedGeneration('theme', aiJobThemeGeneration(_extends({
+        brief: job.brief,
+        mode,
+        theme: site.theme,
+        source: site.source,
+        brand: brand.colors,
+        model
+    }, signal ? {
+        signal
+    } : {})));
+    const spent = _extends({
+        usage: generation.usage,
+        estCostUsd: generation.estCostUsd,
+        model: generation.model,
+        stopReason: generation.stopReason
+    }, generation.effort ? {
+        effort: generation.effort
+    } : {});
+    if (generation.status === 'refused') return _extends({
+        outputs: []
+    }, spent, {
+        refused: true
+    });
+    if (generation.status === 'needs_input') {
+        return _extends({
+            outputs: []
+        }, spent, {
+            failure: AI_JOB_THEME_NO_ANSWER_COPY
+        });
+    }
+    const answer = generation.value;
+    const proposal = buildAiThemeProposal({
+        base: site.theme,
+        source: site.source,
+        mode,
+        brief: job.brief,
+        summary: answer.summary,
+        changes: answer.changes,
+        components: answer.components,
+        resetComponents: answer.resetComponents,
+        dropped: answer.dropped,
+        notes: [
+            ...brand.notes,
+            ...answer.notes
+        ]
+    });
+    const size = proposalSize(proposal);
+    const output = {
+        resource: 'theme',
+        // A proposal has no document of its own; the id names what it is within
+        // the job, as a text output's `draft` does.
+        id: 'proposal',
+        hostId: (_job_hostId = job.hostId) != null ? _job_hostId : null,
+        hostSubdomain: typeof site.host['subdomain'] === 'string' ? site.host['subdomain'] : null,
+        label: `Theme proposal · ${size} ${size === 1 ? 'change' : 'changes'}`,
+        // Through JSON so no `undefined` reaches the document write.
+        proposal: JSON.parse(JSON.stringify(proposal))
+    };
+    return _extends({
+        outputs: [
+            output
+        ]
+    }, spent);
+};
+
+//# sourceMappingURL=ai-job-theme-step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-theme-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 {\n  hostThemeSource,\n  resolveSiteTheme,\n  type HostThemeSource,\n  type ThemeHostDocument,\n} from '@aglyn/aglyn/app-utils/marketplace-theme'\nimport type { HostTheme, HostThemeScheme } from '@aglyn/shared-data-types'\nimport {\n  INHERITED_BORDER_RADIUS,\n  INHERITED_FONT_FAMILY,\n  INHERITED_SPACING,\n  INHERITED_TOOLBAR_HEIGHTS,\n  inheritedThemeColor,\n} from '@aglyn/shared-ui-theme/util/theme-editor-defaults'\nimport {\n  readDarkScheme,\n  readFontFamily,\n  readThemeColor,\n  readToolbarHeight,\n  SYSTEM_FONT_VALUE,\n  THEME_COLOR_FIELDS,\n  THEME_EDITOR_MEDIA_QUERIES,\n} from '@aglyn/shared-ui-theme/util/theme-editor-fields'\nimport type { AiJob, AiJobOutput } from '../model/ai-jobs.types'\nimport {\n  buildAiThemeProposal,\n  type AiThemeProposal,\n  type AiThemeProposalMode,\n} from '../model/ai-theme-proposal'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport {\n  runValidatedGeneration,\n  type AiCustomGenerationInput,\n  type AiGenerationCheck,\n} from '../runtime/ai-doctrine'\nimport type { AiSystemBlock, AiUsage } from '../runtime/ai-runtime'\nimport {\n  AI_THEME_TOOL_NAME,\n  aiThemeTool,\n  parseAiThemeToolInput,\n  type AiThemeToolParse,\n} from '../tools/ai-theme-tool'\nimport {\n  AI_JOB_BRIEF_MAX_CHARS,\n  type AiJobStepOutcome,\n  type AiJobStepRunner,\n} from './ai-job-text-step'\nimport { AI_JOB_THEME_STEP_BUDGET } from './ai-job-theme-budget'\nimport {\n  AI_THEME_BRAND_SOURCE_WORDS,\n  gatherAiThemeBrandInputs,\n  type AiThemeBrandColor,\n} from './ai-theme-brand-inputs'\n\n/**\n * The `theme` step (AGL-2938): a brief and a site's current theme in, a theme\n * proposal out — every control the theme editor exposes, and nothing else.\n *\n * The step writes nothing to the site. A site's theme is fields on its host\n * document, and writing those is the save the Theme section's editor\n * performs; the step's output is the proposal, which a person puts in the\n * editor, previews against the current theme, and saves or discards.\n *\n * The request is shaped for the cache: the rules and the tool are static and\n * sit in the cached prefix, and everything about this site — its theme, its\n * brand colors, the brief — rides in the user turn. The model answers through\n * one strict tool derived from the editor's own catalog, and the answer is\n * held to that catalog and to the doctrine (a targeted diff, dark values,\n * contrast) before it becomes a proposal.\n */\n\n/**\n * The routing table's answer for `job.theme`: the model the theme step runs on\n * when the machine hands it no `modelFor`.\n */\nexport function aiJobThemeModel(): string {\n  return aiModelForStep('job.theme')\n}\n\n/**\n * The output budget, from the routing table. The largest answer the tool\n * accepts — every color in both schemes, the full run of component leaves,\n * the longest summary — is about 2,500 tokens of JSON\n * (`ai-job-theme-step.spec.ts` measures it), and the rest is room for the\n * model to think before it answers.\n */\nexport const AI_JOB_THEME_MAX_TOKENS = AI_ROUTING_TABLE['job.theme'].maxTokens\n\n/**\n * The theme's answer ceiling on the model a job runs (AGL-3035): the most\n * whose worst case — the answer, its re-ask and the brand reads — fits the\n * least time the step registers (`ai-job-theme-budget.ts`), and never more\n * than the routing table's.\n */\nexport function aiJobThemeMaxTokens(model: string): number {\n  return AI_JOB_THEME_STEP_BUDGET.maxTokens(model)\n}\n\n/** How many of a site's own component override leaves the prompt lists. */\nexport const AI_JOB_THEME_INVENTORY_LEAVES = 40\n\n/** The customer-safe sentences a failed theme step leaves on the job. */\nexport const AI_JOB_THEME_NO_SITE_COPY =\n  'This theme job names a site this workspace does not have.'\nexport const AI_JOB_THEME_NO_ANSWER_COPY =\n  'The AI could not produce a theme proposal from this brief. Try describing the change differently.'\n\n/**\n * The theme step's own instructions, byte-identical on every request so they\n * cache. The acceptable-use rules are not in them: they belong to the block\n * every generator shares, which the generation call puts ahead of these.\n */\nexport const AI_JOB_THEME_INSTRUCTIONS: AiSystemBlock[] = [\n  {\n    text:\n      'You change the theme of a website built with a site builder. You are given the ' +\n      \"site's current theme — every control its theme editor has, with the value the site \" +\n      'set or the default it inherits — any brand colors that belong to the site, and a ' +\n      'brief from the person who owns it.\\n\\n' +\n      `Answer by calling ${AI_THEME_TOOL_NAME} exactly once. A reply in prose cannot be used.\\n\\n` +\n      'Rules:\\n' +\n      '- In modify mode, name only the controls the brief is about. Every control you leave ' +\n      'out keeps its current value. \"Warmer\" is about color, not about fonts or corners.\\n' +\n      '- In create mode, design a complete theme: the primary, secondary and tertiary ' +\n      'accents, the page background and paper, the text colors, and their dark values.\\n' +\n      \"- Colors are hex values on the theme's own tokens. A theme is where the building rules \" +\n      'send every color, so this is the one answer that writes a color as a value. A component ' +\n      'style never carries a literal color; color belongs to the palette.\\n' +\n      '- Give every color you change a dark value beside its light value unless the dark ' +\n      'scheme is off. A dark value keeps the hue and reads on a dark background.\\n' +\n      '- Keep text readable: body text needs 4.5:1 against the background and the paper, and ' +\n      'the primary color 3:1 against the background.\\n' +\n      '- A hex color written in the brief is used exactly as written. When the brief asks to ' +\n      'match the brand, build on the brand colors you are given.\\n' +\n      '- Fonts come from the list the tool offers, and numbers stay inside the ranges it ' +\n      'states.\\n' +\n      '- Write the summary in the language of the brief.',\n    cacheBreakpoint: true,\n  },\n]\n\nconst ZERO_USAGE: AiUsage = {\n  inputTokens: 0,\n  outputTokens: 0,\n  cacheReadTokens: 0,\n  cacheWriteTokens: 0,\n}\n\n/** `create` when the job asked for a whole design; `modify` otherwise. */\nexport function aiJobThemeMode(inputs: AiJob['inputs'] | undefined): AiThemeProposalMode {\n  return inputs?.['mode'] === 'create' ? 'create' : 'modify'\n}\n\nconst SOURCE_WORDS: Record<HostThemeSource, string> = {\n  installed:\n    \"an installed marketplace theme; a change is stored as the site's own edits on top of it\",\n  custom: \"the site's own theme\",\n  default: \"the platform's default theme; a change stores only the values it sets\",\n}\n\n/** One value as the inventory shows it: the site's own, or the default it inherits. */\nconst shown = (own: string | number | null | undefined, inherited: string | number | undefined) =>\n  own === null || own === undefined ? `${inherited ?? 'unset'} (default)` : `${own} (set)`\n\n/** The site's own component overrides, one bounded line a leaf. */\nfunction overrideLeaves(theme: HostTheme | undefined): string[] {\n  const leaves: string[] = []\n  const media = Object.fromEntries(\n    Object.entries(THEME_EDITOR_MEDIA_QUERIES).map(([name, query]) => [query, name]),\n  )\n  const text = (value: unknown) => JSON.stringify(value)?.slice(0, 60) ?? ''\n  for (const [component, override] of Object.entries(theme?.components ?? {})) {\n    for (const [prop, value] of Object.entries(override?.defaultProps ?? {})) {\n      leaves.push(`${component} default ${prop} = ${text(value)}`)\n    }\n    for (const [slot, styles] of Object.entries(override?.styleOverrides ?? {})) {\n      if (!styles || typeof styles !== 'object') continue\n      for (const [property, value] of Object.entries(styles as Record<string, unknown>)) {\n        if (value && typeof value === 'object') {\n          for (const [nested, nestedValue] of Object.entries(value as Record<string, unknown>)) {\n            leaves.push(\n              `${component} ${slot} ${nested} = ${text(nestedValue)} (${media[property] ?? property})`,\n            )\n          }\n        } else {\n          leaves.push(`${component} ${slot} ${property} = ${text(value)}`)\n        }\n      }\n    }\n  }\n  return leaves\n}\n\n/**\n * The site's theme as the model reads it: compact, one control a line, each\n * value marked as the site's own or the default it inherits, so \"make the\n * background warmer\" starts from the color the visitor actually sees.\n */\nexport function aiJobThemeInventory(theme: HostTheme | undefined, source: HostThemeSource): string {\n  const lines = [`Source: ${SOURCE_WORDS[source]}.`, `Dark scheme: ${readDarkScheme(theme)}.`]\n  lines.push('Colors, light | dark:')\n  for (const { token } of THEME_COLOR_FIELDS) {\n    const value = (scheme: HostThemeScheme) =>\n      shown(readThemeColor(theme, scheme, token), inheritedThemeColor(scheme, token))\n    lines.push(`- ${token}: ${value('light')} | ${value('dark')}`)\n  }\n  const font = readFontFamily(theme)\n  lines.push(`Font family: ${shown(font === SYSTEM_FONT_VALUE ? null : font, INHERITED_FONT_FAMILY)}`)\n  lines.push(`Border radius: ${shown(theme?.shape?.borderRadius, INHERITED_BORDER_RADIUS)}`)\n  lines.push(`Spacing unit: ${shown(theme?.spacing, INHERITED_SPACING)}`)\n  lines.push(\n    `Nav height: mobile ${shown(theme && readToolbarHeight(theme, 'xs'), INHERITED_TOOLBAR_HEIGHTS.xs)}, ` +\n      `desktop ${shown(theme && readToolbarHeight(theme, 'sm'), INHERITED_TOOLBAR_HEIGHTS.sm)}`,\n  )\n  const leaves = overrideLeaves(theme)\n  if (!leaves.length) {\n    lines.push('Component overrides: none.')\n  } else {\n    lines.push('Component overrides:')\n    for (const leaf of leaves.slice(0, AI_JOB_THEME_INVENTORY_LEAVES)) lines.push(`- ${leaf}`)\n    if (leaves.length > AI_JOB_THEME_INVENTORY_LEAVES) {\n      lines.push(`- and ${leaves.length - AI_JOB_THEME_INVENTORY_LEAVES} more`)\n    }\n  }\n  return lines.join('\\n')\n}\n\n/** The user turn: the mode, the site's theme, its brand colors, and the brief. */\nexport function aiJobThemePrompt(input: {\n  brief: string\n  mode: AiThemeProposalMode\n  theme: HostTheme | undefined\n  source: HostThemeSource\n  brand: readonly AiThemeBrandColor[]\n}): string {\n  const sections = [\n    input.mode === 'create'\n      ? 'Mode: create. Design a complete theme over every control.'\n      : 'Mode: modify. Change only what the brief is about.',\n    `Current theme:\\n${aiJobThemeInventory(input.theme, input.source)}`,\n  ]\n  if (input.brand.length) {\n    sections.push(\n      `Brand colors:\\n${input.brand\n        .map((color) => `- ${color.hex} (${AI_THEME_BRAND_SOURCE_WORDS[color.source]})`)\n        .join('\\n')}`,\n    )\n  }\n  sections.push(`Brief: ${input.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)}`)\n  return sections.join('\\n\\n')\n}\n\n/**\n * The theme tool's answer held to the editor — the check the doctrine's loop\n * runs on each answer (AGL-2935), which also holds rule 13 on it. Usable when\n * anything in it survives; refused, naming what was refused, when nothing\n * does. A call that proposes no change and refuses nothing is a real answer —\n * the theme already does what the brief asks.\n */\nexport const aiJobThemeCheck: AiGenerationCheck<AiThemeToolParse> = (answer) => {\n  const parse = parseAiThemeToolInput(answer)\n  const nothingUsable =\n    !parse.changes.length && !parse.components.length && !parse.resetComponents\n  if (!nothingUsable || !parse.dropped.length) return { value: parse, violations: [] }\n  return {\n    value: null,\n    violations: parse.dropped.map((message) => ({ rule: null, code: 'theme-control', message })),\n  }\n}\n\n/** What a theme generation is asked from, once the site and its brand have been read. */\nexport interface AiJobThemeRequest {\n  brief: string\n  mode: AiThemeProposalMode\n  theme: HostTheme | undefined\n  source: HostThemeSource\n  brand: readonly AiThemeBrandColor[]\n  model: string\n  signal?: AbortSignal\n}\n\n/**\n * The theme step's generation as the doctrine's loop runs it: its cached\n * block, which carries the acceptable-use rules, then this step's\n * instructions; the site's theme in the user turn rather than a site\n * inventory; the strict tool, the ceiling and the check. The eval harness\n * records a theme answer through this same call.\n */\nexport function aiJobThemeGeneration(\n  request: AiJobThemeRequest,\n): AiCustomGenerationInput<AiThemeToolParse> {\n  return {\n    step: 'job.theme',\n    model: request.model,\n    instructions: AI_JOB_THEME_INSTRUCTIONS,\n    messages: [{ role: 'user', content: aiJobThemePrompt(request) }],\n    tool: aiThemeTool(),\n    maxTokens: aiJobThemeMaxTokens(request.model),\n    ...(AI_ROUTING_TABLE['job.theme'].thinking ? { thinking: AI_ROUTING_TABLE['job.theme'].thinking } : {}),\n    ...(AI_ROUTING_TABLE['job.theme'].effort ? { effort: AI_ROUTING_TABLE['job.theme'].effort } : {}),\n    ...(request.signal ? { signal: request.signal } : {}),\n    check: aiJobThemeCheck,\n  }\n}\n\n/** The site a theme job changes, read and checked against the job's org. */\nasync function loadThemeSite(\n  firestore: FirebaseFirestore.Firestore,\n  job: AiJob,\n): Promise<\n  | { host: ThemeHostDocument & Record<string, unknown>; theme: HostTheme | undefined; source: HostThemeSource }\n  | { failure: string }\n> {\n  if (!job.hostId) return { failure: AI_JOB_THEME_NO_SITE_COPY }\n  const snapshot = await firestore.collection('hosts').doc(job.hostId).get()\n  const host = snapshot.exists\n    ? (snapshot.data() as ThemeHostDocument & Record<string, unknown>)\n    : null\n  // The route checks the caller's membership of the org the job is metered\n  // against, not that the site it named belongs to that org. A site of some\n  // other org is refused here, before anything about it reaches a prompt.\n  if (!host || host['orgId'] !== job.orgId) return { failure: AI_JOB_THEME_NO_SITE_COPY }\n  return { host, theme: resolveSiteTheme(host), source: hostThemeSource(host) }\n}\n\n/** How many edits a proposal makes, for its label. */\nfunction proposalSize(proposal: AiThemeProposal): number {\n  return proposal.changes.length + proposal.components.length + (proposal.resetComponents ? 1 : 0)\n}\n\nexport const runAiJobThemeStep: AiJobStepRunner = async ({\n  job,\n  signal,\n  firestore,\n  org,\n  modelFor,\n}) => {\n  if (!firestore) {\n    // The machine always hands one in; a runner called without it is a\n    // wiring fault, not a customer path.\n    throw new Error('the theme step reads the site it changes and was given no Firestore')\n  }\n  // The model switch's answer for this job (AGL-2942): the creator's pick\n  // where the plan, the org restriction and the allotment allowlists allow\n  // it, and Auto held to those same lists otherwise. Only a runner called\n  // without a resolver asks the routing table directly.\n  const model = modelFor?.('job.theme') ?? aiJobThemeModel()\n  const site = await loadThemeSite(firestore, job)\n  if ('failure' in site) {\n    return {\n      outputs: [],\n      usage: ZERO_USAGE,\n      estCostUsd: 0,\n      model,\n      stopReason: null,\n      failure: site.failure,\n    }\n  }\n  const mode = aiJobThemeMode(job.inputs)\n  const brand = await gatherAiThemeBrandInputs({\n    firestore,\n    org: org ?? null,\n    hostId: job.hostId as string,\n    host: site.host,\n    brief: job.brief,\n    signal,\n  })\n  // A second refused answer ends in this step's own sentence, below.\n  const generation = await runValidatedGeneration(\n    'theme',\n    aiJobThemeGeneration({\n      brief: job.brief,\n      mode,\n      theme: site.theme,\n      source: site.source,\n      brand: brand.colors,\n      model,\n      ...(signal ? { signal } : {}),\n    }),\n  )\n  const spent: Pick<AiJobStepOutcome, 'usage' | 'estCostUsd' | 'model' | 'stopReason' | 'effort'> = {\n    usage: generation.usage,\n    estCostUsd: generation.estCostUsd,\n    model: generation.model,\n    stopReason: generation.stopReason,\n    ...(generation.effort ? { effort: generation.effort } : {}),\n  }\n  if (generation.status === 'refused') return { outputs: [], ...spent, refused: true }\n  if (generation.status === 'needs_input') {\n    return { outputs: [], ...spent, failure: AI_JOB_THEME_NO_ANSWER_COPY }\n  }\n\n  const answer = generation.value\n  const proposal = buildAiThemeProposal({\n    base: site.theme,\n    source: site.source,\n    mode,\n    brief: job.brief,\n    summary: answer.summary,\n    changes: answer.changes,\n    components: answer.components,\n    resetComponents: answer.resetComponents,\n    dropped: answer.dropped,\n    notes: [...brand.notes, ...answer.notes],\n  })\n  const size = proposalSize(proposal)\n  const output: AiJobOutput = {\n    resource: 'theme',\n    // A proposal has no document of its own; the id names what it is within\n    // the job, as a text output's `draft` does.\n    id: 'proposal',\n    hostId: job.hostId ?? null,\n    hostSubdomain: typeof site.host['subdomain'] === 'string' ? site.host['subdomain'] : null,\n    label: `Theme proposal · ${size} ${size === 1 ? 'change' : 'changes'}`,\n    // Through JSON so no `undefined` reaches the document write.\n    proposal: JSON.parse(JSON.stringify(proposal)) as Record<string, unknown>,\n  }\n  return { outputs: [output], ...spent }\n}\n"],"names":["hostThemeSource","resolveSiteTheme","INHERITED_BORDER_RADIUS","INHERITED_FONT_FAMILY","INHERITED_SPACING","INHERITED_TOOLBAR_HEIGHTS","inheritedThemeColor","readDarkScheme","readFontFamily","readThemeColor","readToolbarHeight","SYSTEM_FONT_VALUE","THEME_COLOR_FIELDS","THEME_EDITOR_MEDIA_QUERIES","buildAiThemeProposal","AI_ROUTING_TABLE","aiModelForStep","runValidatedGeneration","AI_THEME_TOOL_NAME","aiThemeTool","parseAiThemeToolInput","AI_JOB_BRIEF_MAX_CHARS","AI_JOB_THEME_STEP_BUDGET","AI_THEME_BRAND_SOURCE_WORDS","gatherAiThemeBrandInputs","aiJobThemeModel","AI_JOB_THEME_MAX_TOKENS","maxTokens","aiJobThemeMaxTokens","model","AI_JOB_THEME_INVENTORY_LEAVES","AI_JOB_THEME_NO_SITE_COPY","AI_JOB_THEME_NO_ANSWER_COPY","AI_JOB_THEME_INSTRUCTIONS","text","cacheBreakpoint","ZERO_USAGE","inputTokens","outputTokens","cacheReadTokens","cacheWriteTokens","aiJobThemeMode","inputs","SOURCE_WORDS","installed","custom","default","shown","own","inherited","undefined","overrideLeaves","theme","leaves","media","Object","fromEntries","entries","map","name","query","value","JSON","stringify","slice","component","override","components","prop","defaultProps","push","slot","styles","styleOverrides","property","nested","nestedValue","aiJobThemeInventory","source","lines","token","scheme","font","shape","borderRadius","spacing","xs","sm","length","leaf","join","aiJobThemePrompt","input","sections","mode","brand","color","hex","brief","aiJobThemeCheck","answer","parse","nothingUsable","changes","resetComponents","dropped","violations","message","rule","code","aiJobThemeGeneration","request","step","instructions","messages","role","content","tool","thinking","effort","signal","check","loadThemeSite","firestore","job","hostId","failure","snapshot","collection","doc","get","host","exists","data","orgId","proposalSize","proposal","runAiJobThemeStep","org","modelFor","Error","site","outputs","usage","estCostUsd","stopReason","generation","colors","spent","status","refused","base","summary","notes","size","output","resource","id","hostSubdomain","label"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,eAAe,EACfC,gBAAgB,QAGX,2CAA0C;AAEjD,SACEC,uBAAuB,EACvBC,qBAAqB,EACrBC,iBAAiB,EACjBC,yBAAyB,EACzBC,mBAAmB,QACd,oDAAmD;AAC1D,SACEC,cAAc,EACdC,cAAc,EACdC,cAAc,EACdC,iBAAiB,EACjBC,iBAAiB,EACjBC,kBAAkB,EAClBC,0BAA0B,QACrB,kDAAiD;AAExD,SACEC,oBAAoB,QAGf,gCAA4B;AACnC,SAASC,gBAAgB,EAAEC,cAAc,QAAQ,0BAAsB;AACvE,SACEC,sBAAsB,QAGjB,4BAAwB;AAE/B,SACEC,kBAAkB,EAClBC,WAAW,EACXC,qBAAqB,QAEhB,4BAAwB;AAC/B,SACEC,sBAAsB,QAGjB,wBAAoB;AAC3B,SAASC,wBAAwB,QAAQ,2BAAuB;AAChE,SACEC,2BAA2B,EAC3BC,wBAAwB,QAEnB,6BAAyB;AAEhC;;;;;;;;;;;;;;;CAeC,GAED;;;CAGC,GACD,OAAO,SAASC;IACd,OAAOT,eAAe;AACxB;AAEA;;;;;;CAMC,GACD,OAAO,MAAMU,0BAA0BX,gBAAgB,CAAC,YAAY,CAACY,SAAS,CAAA;AAE9E;;;;;CAKC,GACD,OAAO,SAASC,oBAAoBC,KAAa;IAC/C,OAAOP,yBAAyBK,SAAS,CAACE;AAC5C;AAEA,yEAAyE,GACzE,OAAO,MAAMC,gCAAgC,GAAE;AAE/C,uEAAuE,GACvE,OAAO,MAAMC,4BACX,4DAA2D;AAC7D,OAAO,MAAMC,8BACX,oGAAmG;AAErG;;;;CAIC,GACD,OAAO,MAAMC,4BAA6C;IACxD;QACEC,MACE,oFACA,wFACA,sFACA,2CACA,CAAC,kBAAkB,EAAEhB,mBAAmB,mDAAmD,CAAC,GAC5F,aACA,0FACA,wFACA,oFACA,sFACA,4FACA,6FACA,yEACA,uFACA,gFACA,2FACA,oDACA,2FACA,gEACA,uFACA,cACA;QACFiB,iBAAiB;IACnB;CACD,CAAA;AAED,MAAMC,aAAsB;IAC1BC,aAAa;IACbC,cAAc;IACdC,iBAAiB;IACjBC,kBAAkB;AACpB;AAEA,wEAAwE,GACxE,OAAO,SAASC,eAAeC,MAAmC;IAChE,OAAOA,CAAAA,0BAAAA,MAAQ,CAAC,OAAO,MAAK,WAAW,WAAW;AACpD;AAEA,MAAMC,eAAgD;IACpDC,WACE;IACFC,QAAQ;IACRC,SAAS;AACX;AAEA,qFAAqF,GACrF,MAAMC,QAAQ,CAACC,KAAyCC,YACtDD,QAAQ,QAAQA,QAAQE,YAAY,GAAGD,oBAAAA,YAAa,QAAQ,UAAU,CAAC,GAAG,GAAGD,IAAI,MAAM,CAAC;AAE1F,iEAAiE,GACjE,SAASG,eAAeC,KAA4B;;IAClD,MAAMC,SAAmB,EAAE;IAC3B,MAAMC,QAAQC,OAAOC,WAAW,CAC9BD,OAAOE,OAAO,CAAC5C,4BAA4B6C,GAAG,CAAC,CAAC,CAACC,MAAMC,MAAM,GAAK;YAACA;YAAOD;SAAK;IAEjF,MAAMzB,OAAO,CAAC2B;;YAAmBC;wBAAAA,kBAAAA,KAAKC,SAAS,CAACF,2BAAfC,gBAAuBE,KAAK,CAAC,GAAG,sBAAO;;IACxE,KAAK,MAAM,CAACC,WAAWC,SAAS,IAAIX,OAAOE,OAAO,SAACL,yBAAAA,MAAOe,UAAU,mBAAI,CAAC,GAAI;;QAC3E,KAAK,MAAM,CAACC,MAAMP,MAAM,IAAIN,OAAOE,OAAO,UAACS,4BAAAA,SAAUG,YAAY,oBAAI,CAAC,GAAI;YACxEhB,OAAOiB,IAAI,CAAC,GAAGL,UAAU,SAAS,EAAEG,KAAK,GAAG,EAAElC,KAAK2B,QAAQ;QAC7D;QACA,KAAK,MAAM,CAACU,MAAMC,OAAO,IAAIjB,OAAOE,OAAO,UAACS,4BAAAA,SAAUO,cAAc,oBAAI,CAAC,GAAI;YAC3E,IAAI,CAACD,UAAU,OAAOA,WAAW,UAAU;YAC3C,KAAK,MAAM,CAACE,UAAUb,MAAM,IAAIN,OAAOE,OAAO,CAACe,QAAoC;gBACjF,IAAIX,SAAS,OAAOA,UAAU,UAAU;oBACtC,KAAK,MAAM,CAACc,QAAQC,YAAY,IAAIrB,OAAOE,OAAO,CAACI,OAAmC;4BAExBP;wBAD5DD,OAAOiB,IAAI,CACT,GAAGL,UAAU,CAAC,EAAEM,KAAK,CAAC,EAAEI,OAAO,GAAG,EAAEzC,KAAK0C,aAAa,EAAE,GAAEtB,kBAAAA,KAAK,CAACoB,SAAS,YAAfpB,kBAAmBoB,SAAS,CAAC,CAAC;oBAE5F;gBACF,OAAO;oBACLrB,OAAOiB,IAAI,CAAC,GAAGL,UAAU,CAAC,EAAEM,KAAK,CAAC,EAAEG,SAAS,GAAG,EAAExC,KAAK2B,QAAQ;gBACjE;YACF;QACF;IACF;IACA,OAAOR;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASwB,oBAAoBzB,KAA4B,EAAE0B,MAAuB;QAUpD1B;IATnC,MAAM2B,QAAQ;QAAC,CAAC,QAAQ,EAAEpC,YAAY,CAACmC,OAAO,CAAC,CAAC,CAAC;QAAE,CAAC,aAAa,EAAEvE,eAAe6C,OAAO,CAAC,CAAC;KAAC;IAC5F2B,MAAMT,IAAI,CAAC;IACX,KAAK,MAAM,EAAEU,KAAK,EAAE,IAAIpE,mBAAoB;QAC1C,MAAMiD,QAAQ,CAACoB,SACblC,MAAMtC,eAAe2C,OAAO6B,QAAQD,QAAQ1E,oBAAoB2E,QAAQD;QAC1ED,MAAMT,IAAI,CAAC,CAAC,EAAE,EAAEU,MAAM,EAAE,EAAEnB,MAAM,SAAS,GAAG,EAAEA,MAAM,SAAS;IAC/D;IACA,MAAMqB,OAAO1E,eAAe4C;IAC5B2B,MAAMT,IAAI,CAAC,CAAC,aAAa,EAAEvB,MAAMmC,SAASvE,oBAAoB,OAAOuE,MAAM/E,wBAAwB;IACnG4E,MAAMT,IAAI,CAAC,CAAC,eAAe,EAAEvB,MAAMK,0BAAAA,eAAAA,MAAO+B,KAAK,qBAAZ/B,aAAcgC,YAAY,EAAElF,0BAA0B;IACzF6E,MAAMT,IAAI,CAAC,CAAC,cAAc,EAAEvB,MAAMK,yBAAAA,MAAOiC,OAAO,EAAEjF,oBAAoB;IACtE2E,MAAMT,IAAI,CACR,CAAC,mBAAmB,EAAEvB,MAAMK,SAAS1C,kBAAkB0C,OAAO,OAAO/C,0BAA0BiF,EAAE,EAAE,EAAE,CAAC,GACpG,CAAC,QAAQ,EAAEvC,MAAMK,SAAS1C,kBAAkB0C,OAAO,OAAO/C,0BAA0BkF,EAAE,GAAG;IAE7F,MAAMlC,SAASF,eAAeC;IAC9B,IAAI,CAACC,OAAOmC,MAAM,EAAE;QAClBT,MAAMT,IAAI,CAAC;IACb,OAAO;QACLS,MAAMT,IAAI,CAAC;QACX,KAAK,MAAMmB,QAAQpC,OAAOW,KAAK,CAAC,GAAGlC,+BAAgCiD,MAAMT,IAAI,CAAC,CAAC,EAAE,EAAEmB,MAAM;QACzF,IAAIpC,OAAOmC,MAAM,GAAG1D,+BAA+B;YACjDiD,MAAMT,IAAI,CAAC,CAAC,MAAM,EAAEjB,OAAOmC,MAAM,GAAG1D,8BAA8B,KAAK,CAAC;QAC1E;IACF;IACA,OAAOiD,MAAMW,IAAI,CAAC;AACpB;AAEA,gFAAgF,GAChF,OAAO,SAASC,iBAAiBC,KAMhC;IACC,MAAMC,WAAW;QACfD,MAAME,IAAI,KAAK,WACX,8DACA;QACJ,CAAC,gBAAgB,EAAEjB,oBAAoBe,MAAMxC,KAAK,EAAEwC,MAAMd,MAAM,GAAG;KACpE;IACD,IAAIc,MAAMG,KAAK,CAACP,MAAM,EAAE;QACtBK,SAASvB,IAAI,CACX,CAAC,eAAe,EAAEsB,MAAMG,KAAK,CAC1BrC,GAAG,CAAC,CAACsC,QAAU,CAAC,EAAE,EAAEA,MAAMC,GAAG,CAAC,EAAE,EAAE1E,2BAA2B,CAACyE,MAAMlB,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9EY,IAAI,CAAC,OAAO;IAEnB;IACAG,SAASvB,IAAI,CAAC,CAAC,OAAO,EAAEsB,MAAMM,KAAK,CAAClC,KAAK,CAAC,GAAG3C,yBAAyB;IACtE,OAAOwE,SAASH,IAAI,CAAC;AACvB;AAEA;;;;;;CAMC,GACD,OAAO,MAAMS,kBAAuD,CAACC;IACnE,MAAMC,QAAQjF,sBAAsBgF;IACpC,MAAME,gBACJ,CAACD,MAAME,OAAO,CAACf,MAAM,IAAI,CAACa,MAAMlC,UAAU,CAACqB,MAAM,IAAI,CAACa,MAAMG,eAAe;IAC7E,IAAI,CAACF,iBAAiB,CAACD,MAAMI,OAAO,CAACjB,MAAM,EAAE,OAAO;QAAE3B,OAAOwC;QAAOK,YAAY,EAAE;IAAC;IACnF,OAAO;QACL7C,OAAO;QACP6C,YAAYL,MAAMI,OAAO,CAAC/C,GAAG,CAAC,CAACiD,UAAa,CAAA;gBAAEC,MAAM;gBAAMC,MAAM;gBAAiBF;YAAQ,CAAA;IAC3F;AACF,EAAC;AAaD;;;;;;CAMC,GACD,OAAO,SAASG,qBACdC,OAA0B;IAE1B,OAAO;QACLC,MAAM;QACNnF,OAAOkF,QAAQlF,KAAK;QACpBoF,cAAchF;QACdiF,UAAU;YAAC;gBAAEC,MAAM;gBAAQC,SAASzB,iBAAiBoB;YAAS;SAAE;QAChEM,MAAMlG;QACNQ,WAAWC,oBAAoBmF,QAAQlF,KAAK;OACxCd,gBAAgB,CAAC,YAAY,CAACuG,QAAQ,GAAG;QAAEA,UAAUvG,gBAAgB,CAAC,YAAY,CAACuG,QAAQ;IAAC,IAAI,CAAC,GACjGvG,gBAAgB,CAAC,YAAY,CAACwG,MAAM,GAAG;QAAEA,QAAQxG,gBAAgB,CAAC,YAAY,CAACwG,MAAM;IAAC,IAAI,CAAC,GAC3FR,QAAQS,MAAM,GAAG;QAAEA,QAAQT,QAAQS,MAAM;IAAC,IAAI,CAAC;QACnDC,OAAOtB;;AAEX;AAEA,0EAA0E,GAC1E,eAAeuB,cACbC,SAAsC,EACtCC,GAAU;IAKV,IAAI,CAACA,IAAIC,MAAM,EAAE,OAAO;QAAEC,SAAS/F;IAA0B;IAC7D,MAAMgG,WAAW,MAAMJ,UAAUK,UAAU,CAAC,SAASC,GAAG,CAACL,IAAIC,MAAM,EAAEK,GAAG;IACxE,MAAMC,OAAOJ,SAASK,MAAM,GACvBL,SAASM,IAAI,KACd;IACJ,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,IAAI,CAACF,QAAQA,IAAI,CAAC,QAAQ,KAAKP,IAAIU,KAAK,EAAE,OAAO;QAAER,SAAS/F;IAA0B;IACtF,OAAO;QAAEoG;QAAM/E,OAAOnD,iBAAiBkI;QAAOrD,QAAQ9E,gBAAgBmI;IAAM;AAC9E;AAEA,oDAAoD,GACpD,SAASI,aAAaC,QAAyB;IAC7C,OAAOA,SAASjC,OAAO,CAACf,MAAM,GAAGgD,SAASrE,UAAU,CAACqB,MAAM,GAAIgD,CAAAA,SAAShC,eAAe,GAAG,IAAI,CAAA;AAChG;AAEA,OAAO,MAAMiC,oBAAqC,OAAO,EACvDb,GAAG,EACHJ,MAAM,EACNG,SAAS,EACTe,GAAG,EACHC,QAAQ,EACT;cA2EWf;IA1EV,IAAI,CAACD,WAAW;QACd,mEAAmE;QACnE,qCAAqC;QACrC,MAAM,IAAIiB,MAAM;IAClB;IACA,wEAAwE;IACxE,yEAAyE;IACzE,wEAAwE;IACxE,sDAAsD;IACtD,MAAM/G,gBAAQ8G,4BAAAA,SAAW,+BAAgBlH;IACzC,MAAMoH,OAAO,MAAMnB,cAAcC,WAAWC;IAC5C,IAAI,aAAaiB,MAAM;QACrB,OAAO;YACLC,SAAS,EAAE;YACXC,OAAO3G;YACP4G,YAAY;YACZnH;YACAoH,YAAY;YACZnB,SAASe,KAAKf,OAAO;QACvB;IACF;IACA,MAAMhC,OAAOrD,eAAemF,IAAIlF,MAAM;IACtC,MAAMqD,QAAQ,MAAMvE,yBAAyB;QAC3CmG;QACAe,GAAG,EAAEA,cAAAA,MAAO;QACZb,QAAQD,IAAIC,MAAM;QAClBM,MAAMU,KAAKV,IAAI;QACfjC,OAAO0B,IAAI1B,KAAK;QAChBsB;IACF;IACA,mEAAmE;IACnE,MAAM0B,aAAa,MAAMjI,uBACvB,SACA6F,qBAAqB;QACnBZ,OAAO0B,IAAI1B,KAAK;QAChBJ;QACA1C,OAAOyF,KAAKzF,KAAK;QACjB0B,QAAQ+D,KAAK/D,MAAM;QACnBiB,OAAOA,MAAMoD,MAAM;QACnBtH;OACI2F,SAAS;QAAEA;IAAO,IAAI,CAAC;IAG/B,MAAM4B,QAA4F;QAChGL,OAAOG,WAAWH,KAAK;QACvBC,YAAYE,WAAWF,UAAU;QACjCnH,OAAOqH,WAAWrH,KAAK;QACvBoH,YAAYC,WAAWD,UAAU;OAC7BC,WAAW3B,MAAM,GAAG;QAAEA,QAAQ2B,WAAW3B,MAAM;IAAC,IAAI,CAAC;IAE3D,IAAI2B,WAAWG,MAAM,KAAK,WAAW,OAAO;QAAEP,SAAS,EAAE;OAAKM;QAAOE,SAAS;;IAC9E,IAAIJ,WAAWG,MAAM,KAAK,eAAe;QACvC,OAAO;YAAEP,SAAS,EAAE;WAAKM;YAAOtB,SAAS9F;;IAC3C;IAEA,MAAMoE,SAAS8C,WAAWrF,KAAK;IAC/B,MAAM2E,WAAW1H,qBAAqB;QACpCyI,MAAMV,KAAKzF,KAAK;QAChB0B,QAAQ+D,KAAK/D,MAAM;QACnBgB;QACAI,OAAO0B,IAAI1B,KAAK;QAChBsD,SAASpD,OAAOoD,OAAO;QACvBjD,SAASH,OAAOG,OAAO;QACvBpC,YAAYiC,OAAOjC,UAAU;QAC7BqC,iBAAiBJ,OAAOI,eAAe;QACvCC,SAASL,OAAOK,OAAO;QACvBgD,OAAO;eAAI1D,MAAM0D,KAAK;eAAKrD,OAAOqD,KAAK;SAAC;IAC1C;IACA,MAAMC,OAAOnB,aAAaC;IAC1B,MAAMmB,SAAsB;QAC1BC,UAAU;QACV,wEAAwE;QACxE,4CAA4C;QAC5CC,IAAI;QACJhC,MAAM,GAAED,cAAAA,IAAIC,MAAM,YAAVD,cAAc;QACtBkC,eAAe,OAAOjB,KAAKV,IAAI,CAAC,YAAY,KAAK,WAAWU,KAAKV,IAAI,CAAC,YAAY,GAAG;QACrF4B,OAAO,CAAC,iBAAiB,EAAEL,KAAK,CAAC,EAAEA,SAAS,IAAI,WAAW,WAAW;QACtE,6DAA6D;QAC7DlB,UAAU1E,KAAKuC,KAAK,CAACvC,KAAKC,SAAS,CAACyE;IACtC;IACA,OAAO;QAAEM,SAAS;YAACa;SAAO;OAAKP;AACjC,EAAC"}

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

@@ -0,0 +1,139 @@
+/**
+ * @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 AiAutomationRecords } from '../model/ai-automation-draft';
+import { type AiAutomationCapabilities } from '../model/ai-workflow-job';
+import { type AiCustomGenerationInput } from '../runtime/ai-doctrine';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiAutomationAnswer, type AiWorkflowExplanation } from '../tools/ai-workflow-tool';
+import { type AiJobAdmission } from './ai-job-admission';
+import { type AiPluginDraftWriterLookup } from './ai-job-plugin-drafts';
+import { type AiJobStepRunner } from './ai-job-text-step';
+import { readAiAutomationRecords, readAiWorkflowFunctions, readAiWorkflowRun, readAiWorkflowTarget } from './ai-workflow-records';
+/**
+ * The `workflow` step (AGL-2919): an automation drafted from a description,
+ * or a saved automation explained.
+ *
+ * ## Drafting
+ *
+ * The model is shown the platform's automation vocabulary — every trigger with
+ * the fields it carries, every step with the fields it takes — in a cached
+ * block, and in the user turn what this workspace can run, the site's forms
+ * and datasets by name, and the description. It answers through
+ * `submit_automation`, and the answer is held to the vocabulary and to what
+ * the workspace can run before anything is written.
+ *
+ * A record the description names — a list, a campaign, a workflow, a webhook,
+ * a dataset, a form, a deal stage — is answered in the description's WORDS,
+ * and looked up among the site's records in code, after the answer
+ * (`model/ai-automation-draft.ts`). The model is never shown the site's lists,
+ * campaigns, workflows, webhooks or pipelines. Words that name no record, or
+ * more than one, are kept as a placeholder the person fills in.
+ *
+ * The automation is written through the workflows plugin's draft writer —
+ * that plugin's stored shape, validator, role, plan and cap — keyed by the
+ * job's id, and it is written OFF. A run cut off after the write finds its
+ * draft and spends nothing.
+ *
+ * ## Explaining
+ *
+ * The model is shown an outline of the saved automation, and for a failed run
+ * what the run history recorded about it (`model/ai-automation-outline.ts`):
+ * never the stored documents, never an email address, never a run's event
+ * payload. It answers through `submit_explanation`, which becomes a `text`
+ * output. Nothing is changed.
+ */
+/** The longest an explanation or a draft's generation may take reading the site first. */
+export declare const AI_WORKFLOW_RECORDS_READ_MS = 4000;
+/**
+ * The step's time (AGL-3035): its answer and its re-ask at the routing
+ * table's `job.workflow` ceiling on the tier the step is served from. It sends
+ * no site inventory block, so it makes no lookup; its own reads — the records
+ * a draft is matched against, or the automation and run an explanation
+ * reads — are the declared `AI_WORKFLOW_RECORDS_READ_MS`.
+ */
+export declare const AI_JOB_WORKFLOW_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one workflow step needs before it starts. */
+export declare const AI_JOB_WORKFLOW_STEP_MINIMUM_MS: number;
+/** The routing table's answer for `job.workflow`. */
+export declare function aiJobWorkflowModel(): string;
+/** How many forms and datasets the user turn lists, and how many fields a form. */
+export declare const AI_WORKFLOW_FORMS_LISTED = 40;
+export declare const AI_WORKFLOW_FORM_FIELDS_LISTED = 20;
+export declare const AI_WORKFLOW_DATASETS_LISTED = 40;
+/**
+ * The drafting instructions, byte-identical on every request so they cache.
+ * Built from the platform's own trigger and step catalogs, so the vocabulary
+ * the model is shown is the vocabulary the answer is held to.
+ */
+export declare const AI_JOB_WORKFLOW_DRAFT_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The explaining instructions, byte-identical on every request so they cache. */
+export declare const AI_JOB_WORKFLOW_EXPLAIN_INSTRUCTIONS: readonly AiSystemBlock[];
+/** What a draft is asked from: the workspace's reach, the site's forms and datasets, and the brief. */
+export declare function aiJobWorkflowDraftPrompt(input: {
+    brief: string;
+    capabilities: AiAutomationCapabilities;
+    records: Pick<AiAutomationRecords, 'forms' | 'datasets'>;
+}): string;
+/** What an explanation is asked from: the mode, the outlines, and the member's question. */
+export declare function aiJobWorkflowExplainPrompt(input: {
+    brief: string;
+    mode: 'explain' | 'diagnose';
+    outline: string;
+    run: string | null;
+}): string;
+/** The draft generation as the doctrine's loop runs it; the eval harness records one through this same call. */
+export declare function aiJobWorkflowDraftGeneration(request: {
+    brief: string;
+    capabilities: AiAutomationCapabilities;
+    records: Pick<AiAutomationRecords, 'forms' | 'datasets'>;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiAutomationAnswer>;
+/** The explanation generation as the doctrine's loop runs it. */
+export declare function aiJobWorkflowExplainGeneration(request: {
+    brief: string;
+    mode: 'explain' | 'diagnose';
+    outline: string;
+    run: string | null;
+    model: string;
+    signal?: AbortSignal;
+}): AiCustomGenerationInput<AiWorkflowExplanation>;
+export interface AiJobWorkflowStepDeps {
+    /** How the automation draft writer is found; the core's registry otherwise. */
+    writerFor?: AiPluginDraftWriterLookup;
+    readRecords?: typeof readAiAutomationRecords;
+    readTarget?: typeof readAiWorkflowTarget;
+    readRun?: typeof readAiWorkflowRun;
+    readFunctions?: typeof readAiWorkflowFunctions;
+}
+export declare function createAiJobWorkflowStep(deps?: AiJobWorkflowStepDeps): AiJobStepRunner;
+export declare const runAiJobWorkflowStep: AiJobStepRunner;
+export interface AiWorkflowJobAdmissionDeps {
+    readTarget?: typeof readAiWorkflowTarget;
+    readRun?: typeof readAiWorkflowRun;
+    writerFor?: AiPluginDraftWriterLookup;
+}
+/**
+ * A workflow job is admitted for a site of its org with the Automation plugin
+ * on. A draft also needs the draft writer and the member's room and role in
+ * its own words; an explanation needs the automation it names to exist, and
+ * a run's explanation a failed run of it.
+ */
+export declare function createAiWorkflowJobAdmission(deps?: AiWorkflowJobAdmissionDeps): AiJobAdmission;
+export declare const aiWorkflowJobAdmission: AiJobAdmission;
+/** Registers the workflow step and the check a workflow job passes before it is created or resumed. */
+export declare function registerAiWorkflowJob(): void;