@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1,125 @@
+/**
+ * @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 { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types';
+import type { AiJob, AiJobOutput, AiJobPlan, AiJobReview } from '../model/ai-jobs.types';
+import { type AiStepKind } from '../providers/catalog';
+import { type AiEffort, type AiSystemBlock } from '../runtime/ai-runtime';
+import type { AssistTokenUsage } from '../usage/assist-usage';
+/**
+ * The `text` step (AGL-2904): a brief in, a short piece of copy out.
+ *
+ * The one step kind this issue ships for real, so the state machine — the
+ * lease, the reservation, the record, the beat — is exercised end to end by
+ * something that spends tokens, rather than by a stub that could pass with
+ * the meter unplugged. Every other kind refuses until its own issue lands.
+ *
+ * The balanced tier with adaptive thinking: a brief is open-ended in a way the copy
+ * assistant's element mode is not, and the cost is one call per job. The
+ * static system block is cached; the brief rides in the user turn, so no
+ * per-org byte sits inside the cached prefix (AGL-2352, enforced by the
+ * runtime before the request leaves).
+ */
+/** The model the text step runs on: the routing table's answer for `job.text`. */
+export declare function aiJobTextModel(): string;
+/** The text step's answer ceiling, from the routing table. */
+export declare const AI_JOB_TEXT_MAX_TOKENS: number;
+/**
+ * The text step's time (AGL-3035): ONE request — no re-ask, and no site
+ * inventory to look anything up in — at the routing table's ceiling on the
+ * tier `job.text` is served from, with the step's reads and writes. That fits
+ * an inline door's budget, so a door runs a text job where it is asked for,
+ * and the least time is the helper's worst case rather than a figure anyone
+ * chose; a slower tier asks less so its worst case still fits.
+ */
+export declare const AI_JOB_TEXT_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one text step needs before it starts. */
+export declare const AI_JOB_TEXT_STEP_MINIMUM_MS: number;
+/** How much of a brief is sent. Past this a brief is a document, not a brief. */
+export declare const AI_JOB_BRIEF_MAX_CHARS = 4000;
+/**
+ * What a step hands back to the machine. The machine meters `usage` at
+ * `model`'s rates, records the step and appends the outputs; a step never
+ * touches the job document or the meter itself.
+ */
+export interface AiJobStepOutcome {
+    outputs: AiJobOutput[];
+    /**
+     * The step made progress and has more of the same work to do (AGL-2910):
+     * a site audit works through its pages a batch at a time. The machine
+     * records this pass — its spend and its outputs — and hands the SAME step
+     * back to run again, so every pass is one reservation and one provider
+     * exchange, and the job document says how far it got.
+     */
+    continue?: boolean;
+    usage: AssistTokenUsage;
+    estCostUsd: number;
+    model: string;
+    stopReason: string | null;
+    /**
+     * The thinking effort the request asked for, recorded on the step
+     * (AGL-2937); absent or `null` when the request named none.
+     */
+    effort?: AiEffort | null;
+    /** The model declined the brief (`stop_reason: 'refusal'`). Tokens were spent. */
+    refused?: boolean;
+    /**
+     * The model answered and nothing usable came of it — no structured answer
+     * even after the step's own re-ask, say (AGL-2938). Tokens were spent, so
+     * the machine meters the step before it fails the job with this sentence,
+     * which is customer-safe and the only thing a customer reads.
+     */
+    failure?: string;
+    /** The plan the plan step proposed, which the machine keeps on the job (AGL-2935). */
+    plan?: AiJobPlan;
+    /**
+     * The step stopped for a person (AGL-2935). The machine records what it
+     * spent and parks the job `needs_review`: a `plan` review completes the
+     * step, so confirming runs the next one; a `doctrine` review hands the
+     * step back, so trying again runs the same one.
+     */
+    review?: AiJobReview;
+}
+export interface AiJobStepContext {
+    job: AiJob;
+    stepIndex: number;
+    now: Date;
+    /** Aborts the provider call when the runner's budget ends. */
+    signal?: AbortSignal;
+    /**
+     * The Admin SDK handle the machine runs on, for a step that reads what it
+     * builds from — a site's theme, say — or writes a draft. A step never
+     * writes the job document, the meter or the lease through it.
+     */
+    firestore: FirebaseFirestore.Firestore;
+    /** The org document the machine read for the step's reservation. */
+    org?: Partial<AglynOrgBilling> | null;
+    /**
+     * The model a step of this kind runs on for THIS job (AGL-2942): the
+     * creator's pick where the plan and the allotment allowlists allow it,
+     * the routing table otherwise. Absent, a runner asks the table itself.
+     */
+    modelFor?: (kind: AiStepKind) => string | undefined;
+}
+export type AiJobStepRunner = (context: AiJobStepContext) => Promise<AiJobStepOutcome>;
+/**
+ * The static block, byte-identical on every request so it caches. The
+ * customer's brief and the org's inputs never enter it.
+ */
+export declare const AI_JOB_TEXT_SYSTEM: AiSystemBlock[];
+/** The brief as the user turn, with the kind-specific inputs stated plainly. */
+export declare function aiJobTextPrompt(job: Pick<AiJob, 'brief' | 'inputs'>): string;
+export declare const runAiJobTextStep: AiJobStepRunner;

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

@@ -0,0 +1,128 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_STEP_TIERS } from "../providers/catalog.js";
+import { AI_ROUTING_TABLE, aiModelForStep } from "../providers/routing.js";
+import { runAiRequest } from "../runtime/ai-runtime.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+/**
+ * The `text` step (AGL-2904): a brief in, a short piece of copy out.
+ *
+ * The one step kind this issue ships for real, so the state machine — the
+ * lease, the reservation, the record, the beat — is exercised end to end by
+ * something that spends tokens, rather than by a stub that could pass with
+ * the meter unplugged. Every other kind refuses until its own issue lands.
+ *
+ * The balanced tier with adaptive thinking: a brief is open-ended in a way the copy
+ * assistant's element mode is not, and the cost is one call per job. The
+ * static system block is cached; the brief rides in the user turn, so no
+ * per-org byte sits inside the cached prefix (AGL-2352, enforced by the
+ * runtime before the request leaves).
+ */ /** The model the text step runs on: the routing table's answer for `job.text`. */ export function aiJobTextModel() {
+    return aiModelForStep('job.text');
+}
+/** The text step's answer ceiling, from the routing table. */ export const AI_JOB_TEXT_MAX_TOKENS = AI_ROUTING_TABLE['job.text'].maxTokens;
+/**
+ * The text step's time (AGL-3035): ONE request — no re-ask, and no site
+ * inventory to look anything up in — at the routing table's ceiling on the
+ * tier `job.text` is served from, with the step's reads and writes. That fits
+ * an inline door's budget, so a door runs a text job where it is asked for,
+ * and the least time is the helper's worst case rather than a figure anyone
+ * chose; a slower tier asks less so its worst case still fits.
+ */ export const AI_JOB_TEXT_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.text'],
+    maxTokens: AI_JOB_TEXT_MAX_TOKENS,
+    attempts: 1,
+    lookups: 0
+});
+/** The least time one text step needs before it starts. */ export const AI_JOB_TEXT_STEP_MINIMUM_MS = AI_JOB_TEXT_STEP_BUDGET.minimumMs;
+/** How much of a brief is sent. Past this a brief is a document, not a brief. */ export const AI_JOB_BRIEF_MAX_CHARS = 4000;
+/**
+ * The static block, byte-identical on every request so it caches. The
+ * customer's brief and the org's inputs never enter it.
+ */ export const AI_JOB_TEXT_SYSTEM = [
+    {
+        text: 'You write short, publishable copy for a website builder. You are ' + 'given a brief from the person who owns the site. Answer with the ' + 'copy only: no preamble, no headings unless the brief asks for them, ' + 'no closing remarks, no markdown fences. Keep to the length the brief ' + 'implies; when it implies none, write under 150 words. Write in the ' + 'language of the brief. Never invent facts, prices, names or claims ' + 'the brief did not give you; where a detail is missing, leave a ' + 'clearly marked placeholder in square brackets.',
+        cacheBreakpoint: true
+    }
+];
+/** The brief as the user turn, with the kind-specific inputs stated plainly. */ export function aiJobTextPrompt(job) {
+    var _job_inputs, _job_inputs1;
+    const brief = job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS);
+    const tone = typeof ((_job_inputs = job.inputs) == null ? void 0 : _job_inputs['tone']) === 'string' ? job.inputs['tone'] : '';
+    const audience = typeof ((_job_inputs1 = job.inputs) == null ? void 0 : _job_inputs1['audience']) === 'string' ? job.inputs['audience'] : '';
+    const lines = [
+        `Brief: ${brief}`
+    ];
+    if (tone) lines.push(`Tone: ${tone}`);
+    if (audience) lines.push(`Audience: ${audience}`);
+    return lines.join('\n');
+}
+export const runAiJobTextStep = async ({ job, signal, modelFor })=>{
+    var _ref, _job_hostId;
+    const model = (_ref = modelFor == null ? void 0 : modelFor('job.text')) != null ? _ref : aiJobTextModel();
+    const result = await runAiRequest(_extends({
+        model,
+        system: AI_JOB_TEXT_SYSTEM,
+        messages: [
+            {
+                role: 'user',
+                content: aiJobTextPrompt(job)
+            }
+        ],
+        // The routing ceiling, lowered on a tier too slow to answer it inside the
+        // least time the step registered.
+        maxTokens: AI_JOB_TEXT_STEP_BUDGET.maxTokens(model)
+    }, AI_ROUTING_TABLE['job.text'].thinking ? {
+        thinking: AI_ROUTING_TABLE['job.text'].thinking
+    } : {}, AI_ROUTING_TABLE['job.text'].effort ? {
+        effort: AI_ROUTING_TABLE['job.text'].effort
+    } : {}, {
+        stream: false
+    }, signal ? {
+        signal
+    } : {}));
+    if (result.kind === 'refusal') {
+        return {
+            outputs: [],
+            usage: result.usage,
+            estCostUsd: result.estCostUsd,
+            model,
+            stopReason: result.stopReason,
+            refused: true
+        };
+    }
+    const text = result.text.trim();
+    return {
+        outputs: text ? [
+            {
+                resource: 'text',
+                // A text output has no document of its own; the id names the
+                // step within the job so a later step can address it.
+                id: 'draft',
+                hostId: (_job_hostId = job.hostId) != null ? _job_hostId : null,
+                label: 'Draft copy',
+                text
+            }
+        ] : [],
+        usage: result.usage,
+        estCostUsd: result.estCostUsd,
+        model,
+        stopReason: result.stopReason
+    };
+};
+
+//# sourceMappingURL=ai-job-text-step.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-text-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 type { AglynOrgBilling } from '@aglyn/aglyn/foundation/definitions/org-billing.types'\nimport type {\n  AiJob,\n  AiJobOutput,\n  AiJobPlan,\n  AiJobReview,\n} from '../model/ai-jobs.types'\nimport { AI_STEP_TIERS, type AiStepKind } from '../providers/catalog'\nimport { AI_ROUTING_TABLE, aiModelForStep } from '../providers/routing'\nimport { runAiRequest, type AiEffort, type AiSystemBlock } from '../runtime/ai-runtime'\nimport type { AssistTokenUsage } from '../usage/assist-usage'\nimport { aiJobStepBudget } from './ai-job-budget'\n\n/**\n * The `text` step (AGL-2904): a brief in, a short piece of copy out.\n *\n * The one step kind this issue ships for real, so the state machine — the\n * lease, the reservation, the record, the beat — is exercised end to end by\n * something that spends tokens, rather than by a stub that could pass with\n * the meter unplugged. Every other kind refuses until its own issue lands.\n *\n * The balanced tier with adaptive thinking: a brief is open-ended in a way the copy\n * assistant's element mode is not, and the cost is one call per job. The\n * static system block is cached; the brief rides in the user turn, so no\n * per-org byte sits inside the cached prefix (AGL-2352, enforced by the\n * runtime before the request leaves).\n */\n\n/** The model the text step runs on: the routing table's answer for `job.text`. */\nexport function aiJobTextModel(): string {\n  return aiModelForStep('job.text')\n}\n\n/** The text step's answer ceiling, from the routing table. */\nexport const AI_JOB_TEXT_MAX_TOKENS = AI_ROUTING_TABLE['job.text'].maxTokens\n\n/**\n * The text step's time (AGL-3035): ONE request — no re-ask, and no site\n * inventory to look anything up in — at the routing table's ceiling on the\n * tier `job.text` is served from, with the step's reads and writes. That fits\n * an inline door's budget, so a door runs a text job where it is asked for,\n * and the least time is the helper's worst case rather than a figure anyone\n * chose; a slower tier asks less so its worst case still fits.\n */\nexport const AI_JOB_TEXT_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.text'],\n  maxTokens: AI_JOB_TEXT_MAX_TOKENS,\n  attempts: 1,\n  lookups: 0,\n})\n\n/** The least time one text step needs before it starts. */\nexport const AI_JOB_TEXT_STEP_MINIMUM_MS = AI_JOB_TEXT_STEP_BUDGET.minimumMs\n\n/** How much of a brief is sent. Past this a brief is a document, not a brief. */\nexport const AI_JOB_BRIEF_MAX_CHARS = 4_000\n\n/**\n * What a step hands back to the machine. The machine meters `usage` at\n * `model`'s rates, records the step and appends the outputs; a step never\n * touches the job document or the meter itself.\n */\nexport interface AiJobStepOutcome {\n  outputs: AiJobOutput[]\n  /**\n   * The step made progress and has more of the same work to do (AGL-2910):\n   * a site audit works through its pages a batch at a time. The machine\n   * records this pass — its spend and its outputs — and hands the SAME step\n   * back to run again, so every pass is one reservation and one provider\n   * exchange, and the job document says how far it got.\n   */\n  continue?: boolean\n  usage: AssistTokenUsage\n  estCostUsd: number\n  model: string\n  stopReason: string | null\n  /**\n   * The thinking effort the request asked for, recorded on the step\n   * (AGL-2937); absent or `null` when the request named none.\n   */\n  effort?: AiEffort | null\n  /** The model declined the brief (`stop_reason: 'refusal'`). Tokens were spent. */\n  refused?: boolean\n  /**\n   * The model answered and nothing usable came of it — no structured answer\n   * even after the step's own re-ask, say (AGL-2938). Tokens were spent, so\n   * the machine meters the step before it fails the job with this sentence,\n   * which is customer-safe and the only thing a customer reads.\n   */\n  failure?: string\n  /** The plan the plan step proposed, which the machine keeps on the job (AGL-2935). */\n  plan?: AiJobPlan\n  /**\n   * The step stopped for a person (AGL-2935). The machine records what it\n   * spent and parks the job `needs_review`: a `plan` review completes the\n   * step, so confirming runs the next one; a `doctrine` review hands the\n   * step back, so trying again runs the same one.\n   */\n  review?: AiJobReview\n}\n\nexport interface AiJobStepContext {\n  job: AiJob\n  stepIndex: number\n  now: Date\n  /** Aborts the provider call when the runner's budget ends. */\n  signal?: AbortSignal\n  /**\n   * The Admin SDK handle the machine runs on, for a step that reads what it\n   * builds from — a site's theme, say — or writes a draft. A step never\n   * writes the job document, the meter or the lease through it.\n   */\n  firestore: FirebaseFirestore.Firestore\n  /** The org document the machine read for the step's reservation. */\n  org?: Partial<AglynOrgBilling> | null\n  /**\n   * The model a step of this kind runs on for THIS job (AGL-2942): the\n   * creator's pick where the plan and the allotment allowlists allow it,\n   * the routing table otherwise. Absent, a runner asks the table itself.\n   */\n  modelFor?: (kind: AiStepKind) => string | undefined\n}\n\nexport type AiJobStepRunner = (\n  context: AiJobStepContext,\n) => Promise<AiJobStepOutcome>\n\n/**\n * The static block, byte-identical on every request so it caches. The\n * customer's brief and the org's inputs never enter it.\n */\nexport const AI_JOB_TEXT_SYSTEM: AiSystemBlock[] = [\n  {\n    text:\n      'You write short, publishable copy for a website builder. You are ' +\n      'given a brief from the person who owns the site. Answer with the ' +\n      'copy only: no preamble, no headings unless the brief asks for them, ' +\n      'no closing remarks, no markdown fences. Keep to the length the brief ' +\n      'implies; when it implies none, write under 150 words. Write in the ' +\n      'language of the brief. Never invent facts, prices, names or claims ' +\n      'the brief did not give you; where a detail is missing, leave a ' +\n      'clearly marked placeholder in square brackets.',\n    cacheBreakpoint: true,\n  },\n]\n\n/** The brief as the user turn, with the kind-specific inputs stated plainly. */\nexport function aiJobTextPrompt(job: Pick<AiJob, 'brief' | 'inputs'>): string {\n  const brief = job.brief.slice(0, AI_JOB_BRIEF_MAX_CHARS)\n  const tone = typeof job.inputs?.['tone'] === 'string' ? job.inputs['tone'] : ''\n  const audience =\n    typeof job.inputs?.['audience'] === 'string' ? job.inputs['audience'] : ''\n  const lines = [`Brief: ${brief}`]\n  if (tone) lines.push(`Tone: ${tone}`)\n  if (audience) lines.push(`Audience: ${audience}`)\n  return lines.join('\\n')\n}\n\nexport const runAiJobTextStep: AiJobStepRunner = async ({ job, signal, modelFor }) => {\n  const model = modelFor?.('job.text') ?? aiJobTextModel()\n  const result = await runAiRequest({\n    model,\n    system: AI_JOB_TEXT_SYSTEM,\n    messages: [{ role: 'user', content: aiJobTextPrompt(job) }],\n    // The routing ceiling, lowered on a tier too slow to answer it inside the\n    // least time the step registered.\n    maxTokens: AI_JOB_TEXT_STEP_BUDGET.maxTokens(model),\n    ...(AI_ROUTING_TABLE['job.text'].thinking ? { thinking: AI_ROUTING_TABLE['job.text'].thinking } : {}),\n    ...(AI_ROUTING_TABLE['job.text'].effort ? { effort: AI_ROUTING_TABLE['job.text'].effort } : {}),\n    stream: false,\n    ...(signal ? { signal } : {}),\n  })\n  if (result.kind === 'refusal') {\n    return {\n      outputs: [],\n      usage: result.usage,\n      estCostUsd: result.estCostUsd,\n      model,\n      stopReason: result.stopReason,\n      refused: true,\n    }\n  }\n  const text = result.text.trim()\n  return {\n    outputs: text\n      ? [\n          {\n            resource: 'text',\n            // A text output has no document of its own; the id names the\n            // step within the job so a later step can address it.\n            id: 'draft',\n            hostId: job.hostId ?? null,\n            label: 'Draft copy',\n            text,\n          },\n        ]\n      : [],\n    usage: result.usage,\n    estCostUsd: result.estCostUsd,\n    model,\n    stopReason: result.stopReason,\n  }\n}\n"],"names":["AI_STEP_TIERS","AI_ROUTING_TABLE","aiModelForStep","runAiRequest","aiJobStepBudget","aiJobTextModel","AI_JOB_TEXT_MAX_TOKENS","maxTokens","AI_JOB_TEXT_STEP_BUDGET","tier","attempts","lookups","AI_JOB_TEXT_STEP_MINIMUM_MS","minimumMs","AI_JOB_BRIEF_MAX_CHARS","AI_JOB_TEXT_SYSTEM","text","cacheBreakpoint","aiJobTextPrompt","job","brief","slice","tone","inputs","audience","lines","push","join","runAiJobTextStep","signal","modelFor","model","result","system","messages","role","content","thinking","effort","stream","kind","outputs","usage","estCostUsd","stopReason","refused","trim","resource","id","hostId","label"],"mappings":"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"}

package/src/lib/jobs/ai-job-theme-budget.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @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.
+ */
+/**
+ * The time a theme step needs (AGL-3035), kept apart from the step: the
+ * machine registers the theme step as it loads and defers the step itself to
+ * the first theme job, so what it registers must be readable without loading
+ * the theme editor's catalog and the brand reads behind the step.
+ */
+/**
+ * The wall clock brand colors may take: the site logo's colors and a linked
+ * page's, read before the model is asked. A proposal without a page's colors
+ * is better than no proposal, so the reads stop at this bound rather than
+ * spend the step's time.
+ */
+export declare const AI_THEME_BRAND_BUDGET_MS = 8000;
+/**
+ * The theme step's time: its answer and its re-ask at the routing table's
+ * `job.theme` ceiling on the tier the step is served from — a theme builds
+ * from the theme, carries no site inventory and so makes no lookup — with the
+ * brand reads and the step's own reads and writes.
+ */
+export declare const AI_JOB_THEME_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one theme step needs before it starts. */
+export declare const AI_JOB_THEME_STEP_MINIMUM_MS: number;

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

@@ -0,0 +1,43 @@
+/**
+ * @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 { AI_STEP_TIERS } from "../providers/catalog.js";
+import { AI_ROUTING_TABLE } from "../providers/routing.js";
+import { aiJobStepBudget } from "./ai-job-budget.js";
+/**
+ * The time a theme step needs (AGL-3035), kept apart from the step: the
+ * machine registers the theme step as it loads and defers the step itself to
+ * the first theme job, so what it registers must be readable without loading
+ * the theme editor's catalog and the brand reads behind the step.
+ */ /**
+ * The wall clock brand colors may take: the site logo's colors and a linked
+ * page's, read before the model is asked. A proposal without a page's colors
+ * is better than no proposal, so the reads stop at this bound rather than
+ * spend the step's time.
+ */ export const AI_THEME_BRAND_BUDGET_MS = 8000;
+/**
+ * The theme step's time: its answer and its re-ask at the routing table's
+ * `job.theme` ceiling on the tier the step is served from — a theme builds
+ * from the theme, carries no site inventory and so makes no lookup — with the
+ * brand reads and the step's own reads and writes.
+ */ export const AI_JOB_THEME_STEP_BUDGET = aiJobStepBudget({
+    tier: AI_STEP_TIERS['job.theme'],
+    maxTokens: AI_ROUTING_TABLE['job.theme'].maxTokens,
+    lookups: 0,
+    ownReadsMs: AI_THEME_BRAND_BUDGET_MS
+});
+/** The least time one theme step needs before it starts. */ export const AI_JOB_THEME_STEP_MINIMUM_MS = AI_JOB_THEME_STEP_BUDGET.minimumMs;
+
+//# sourceMappingURL=ai-job-theme-budget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-theme-budget.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 { AI_STEP_TIERS } from '../providers/catalog'\nimport { AI_ROUTING_TABLE } from '../providers/routing'\nimport { aiJobStepBudget } from './ai-job-budget'\n\n/**\n * The time a theme step needs (AGL-3035), kept apart from the step: the\n * machine registers the theme step as it loads and defers the step itself to\n * the first theme job, so what it registers must be readable without loading\n * the theme editor's catalog and the brand reads behind the step.\n */\n\n/**\n * The wall clock brand colors may take: the site logo's colors and a linked\n * page's, read before the model is asked. A proposal without a page's colors\n * is better than no proposal, so the reads stop at this bound rather than\n * spend the step's time.\n */\nexport const AI_THEME_BRAND_BUDGET_MS = 8_000\n\n/**\n * The theme step's time: its answer and its re-ask at the routing table's\n * `job.theme` ceiling on the tier the step is served from — a theme builds\n * from the theme, carries no site inventory and so makes no lookup — with the\n * brand reads and the step's own reads and writes.\n */\nexport const AI_JOB_THEME_STEP_BUDGET = aiJobStepBudget({\n  tier: AI_STEP_TIERS['job.theme'],\n  maxTokens: AI_ROUTING_TABLE['job.theme'].maxTokens,\n  lookups: 0,\n  ownReadsMs: AI_THEME_BRAND_BUDGET_MS,\n})\n\n/** The least time one theme step needs before it starts. */\nexport const AI_JOB_THEME_STEP_MINIMUM_MS = AI_JOB_THEME_STEP_BUDGET.minimumMs\n"],"names":["AI_STEP_TIERS","AI_ROUTING_TABLE","aiJobStepBudget","AI_THEME_BRAND_BUDGET_MS","AI_JOB_THEME_STEP_BUDGET","tier","maxTokens","lookups","ownReadsMs","AI_JOB_THEME_STEP_MINIMUM_MS","minimumMs"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,aAAa,QAAQ,0BAAsB;AACpD,SAASC,gBAAgB,QAAQ,0BAAsB;AACvD,SAASC,eAAe,QAAQ,qBAAiB;AAEjD;;;;;CAKC,GAED;;;;;CAKC,GACD,OAAO,MAAMC,2BAA2B,KAAK;AAE7C;;;;;CAKC,GACD,OAAO,MAAMC,2BAA2BF,gBAAgB;IACtDG,MAAML,aAAa,CAAC,YAAY;IAChCM,WAAWL,gBAAgB,CAAC,YAAY,CAACK,SAAS;IAClDC,SAAS;IACTC,YAAYL;AACd,GAAE;AAEF,0DAA0D,GAC1D,OAAO,MAAMM,+BAA+BL,yBAAyBM,SAAS,CAAA"}

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

@@ -0,0 +1,115 @@
+/**
+ * @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 HostThemeSource } from '@aglyn/aglyn/app-utils/marketplace-theme';
+import type { HostTheme } from '@aglyn/shared-data-types';
+import type { AiJob } from '../model/ai-jobs.types';
+import { type AiThemeProposalMode } from '../model/ai-theme-proposal';
+import { type AiCustomGenerationInput, type AiGenerationCheck } from '../runtime/ai-doctrine';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { type AiThemeToolParse } from '../tools/ai-theme-tool';
+import { type AiJobStepRunner } from './ai-job-text-step';
+import { type AiThemeBrandColor } from './ai-theme-brand-inputs';
+/**
+ * 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 declare function aiJobThemeModel(): string;
+/**
+ * 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 declare const AI_JOB_THEME_MAX_TOKENS: number;
+/**
+ * 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 declare function aiJobThemeMaxTokens(model: string): number;
+/** How many of a site's own component override leaves the prompt lists. */
+export declare const AI_JOB_THEME_INVENTORY_LEAVES = 40;
+/** The customer-safe sentences a failed theme step leaves on the job. */
+export declare const AI_JOB_THEME_NO_SITE_COPY = "This theme job names a site this workspace does not have.";
+export declare 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 declare const AI_JOB_THEME_INSTRUCTIONS: AiSystemBlock[];
+/** `create` when the job asked for a whole design; `modify` otherwise. */
+export declare function aiJobThemeMode(inputs: AiJob['inputs'] | undefined): AiThemeProposalMode;
+/**
+ * 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 declare function aiJobThemeInventory(theme: HostTheme | undefined, source: HostThemeSource): string;
+/** The user turn: the mode, the site's theme, its brand colors, and the brief. */
+export declare function aiJobThemePrompt(input: {
+    brief: string;
+    mode: AiThemeProposalMode;
+    theme: HostTheme | undefined;
+    source: HostThemeSource;
+    brand: readonly AiThemeBrandColor[];
+}): string;
+/**
+ * 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 declare const aiJobThemeCheck: AiGenerationCheck<AiThemeToolParse>;
+/** What a theme generation is asked from, once the site and its brand have been read. */
+export interface AiJobThemeRequest {
+    brief: string;
+    mode: AiThemeProposalMode;
+    theme: HostTheme | undefined;
+    source: HostThemeSource;
+    brand: readonly AiThemeBrandColor[];
+    model: string;
+    signal?: AbortSignal;
+}
+/**
+ * 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 declare function aiJobThemeGeneration(request: AiJobThemeRequest): AiCustomGenerationInput<AiThemeToolParse>;
+export declare const runAiJobThemeStep: AiJobStepRunner;