@aglyn/plugins-ai 1.0.0-beta.229 → 1.0.0-beta.231

package/src/lib/jobs/ai-build-unit-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-build-unit-outcome.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 { aiBuildItemDelivered, type AiBuildUnit } from '../model/ai-build-job'\nimport type { AiJobItemLedger, AiJobOutput } from '../model/ai-jobs.types'\nimport { AiUpstreamError } from '../runtime/ai-runtime'\nimport type { AiSiteBuiltRef } from './ai-job-site-step'\nimport type { AiJobItemOutcome, AiJobStepOutcome } from './ai-job-text-step'\n\n/**\n * One delegated unit's pass as an ITEM of a job settled item by item\n * (AGL-3616) — a `build`, and a site scaffold, which is the build's preset.\n * The runner's spend is the pass's; what the runner came to is the item's\n * row: still running, built (or built without something that failed),\n * failed on our side, or failed on the model's or the workspace's.\n *\n * Shared by both steps, and importing neither, so neither imports the other.\n */\n\n/** What a unit says when it finished without reporting anything. */\nexport const AI_BUILD_UNIT_EMPTY_COPY = 'It could not be built this time.'\n\n/** What a unit's model declining the request says. */\nexport const AI_BUILD_UNIT_REFUSED_COPY = 'The AI declined to build this one.'\n\n/** A runner's outcome narrowed to its spend: no plan, no review, nothing the delegating job keeps. */\nexport function aiUnitSpend(outcome: AiJobStepOutcome): AiJobStepOutcome {\n  return {\n    outputs: outcome.outputs,\n    usage: outcome.usage,\n    estCostUsd: outcome.estCostUsd,\n    model: outcome.model,\n    stopReason: outcome.stopReason,\n    ...(outcome.effort ? { effort: outcome.effort } : {}),\n  }\n}\n\n/**\n * What a runner's outcome comes to for its item; `null` when the unit\n * reported what it built and the caller decides whether that counts.\n */\nexport function aiUnitFailure(slot: string, outcome: AiJobStepOutcome): AiJobItemOutcome | null {\n  const outputs = outcome.outputs.map((output) => output.id)\n  if (outcome.refused) {\n    return { slot, status: 'failed', failure: { ours: false, reason: 'refused', message: AI_BUILD_UNIT_REFUSED_COPY }, outputs }\n  }\n  if (outcome.review) {\n    // A building rule still broken after its re-ask is ours (AGL-3596); a\n    // site at an allowance is the workspace's to change.\n    const ours = outcome.review.reason === 'doctrine'\n    return {\n      slot,\n      status: 'failed',\n      failure: {\n        ours,\n        reason: ours ? 'doctrine-refused' : 'review',\n        message: outcome.review.message || AI_BUILD_UNIT_EMPTY_COPY,\n        ...(outcome.review.detail ? { detail: outcome.review.detail } : {}),\n      },\n      outputs,\n    }\n  }\n  if (outcome.failure) {\n    return { slot, status: 'failed', failure: { ours: true, reason: 'step-failure', message: outcome.failure }, outputs }\n  }\n  if (outcome.continue) return { slot, status: 'running', outputs }\n  if (!outcome.outputs.length) {\n    return { slot, status: 'failed', failure: { ours: true, reason: 'step-failure', message: AI_BUILD_UNIT_EMPTY_COPY } }\n  }\n  return null\n}\n\n/**\n * Whether an error a unit's runner threw is the machine's to retry — a\n * provider that will answer later, or a budget that ended — rather than this\n * item's failure.\n */\nexport function aiUnitErrorRetryable(error: unknown): boolean {\n  if (error instanceof AiUpstreamError && error.retryable) return true\n  const name = (error as { name?: string } | null)?.name\n  return name === 'AbortError' || name === 'TimeoutError'\n}\n\n/**\n * What the build has created that a later unit can name: each delivered\n * creation's record, by its plan name. A creation's first output is the\n * record it wrote.\n */\nexport function aiBuildBuiltRefs(\n  units: readonly AiBuildUnit[],\n  ledger: readonly AiJobItemLedger[],\n  outputs: readonly Pick<AiJobOutput, 'id' | 'label'>[],\n): Map<string, AiSiteBuiltRef> {\n  const rows = new Map(ledger.map((row) => [row.slot, row]))\n  const built = new Map<string, AiSiteBuiltRef>()\n  for (const unit of units) {\n    const creation = unit.creation\n    const row = rows.get(unit.slot)\n    if (!creation || !row || !aiBuildItemDelivered(row) || !row.outputs.length) continue\n    if (creation.kind !== 'layout' && creation.kind !== 'form' && creation.kind !== 'component') continue\n    const id = row.outputs[0]\n    const label = outputs.find((output) => output.id === id)?.label || creation.name\n    built.set(creation.name.toLowerCase(), { id, label, kind: creation.kind })\n  }\n  return built\n}\n"],"names":["aiBuildItemDelivered","AiUpstreamError","AI_BUILD_UNIT_EMPTY_COPY","AI_BUILD_UNIT_REFUSED_COPY","aiUnitSpend","outcome","outputs","usage","estCostUsd","model","stopReason","effort","aiUnitFailure","slot","map","output","id","refused","status","failure","ours","reason","message","review","detail","continue","length","aiUnitErrorRetryable","error","retryable","name","aiBuildBuiltRefs","units","ledger","rows","Map","row","built","unit","creation","get","kind","label","find","set","toLowerCase"],"mappings":"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"}

package/src/lib/jobs/ai-job-auto-confirm.d.ts

@@ -44,6 +44,14 @@ export declare function aiJobAutoConfirms(job: Pick<AiJob, 'kind' | 'inputs'>):
  * A job's inputs as the create door stores them: `autoConfirm` kept only on a
  * `site` job for a site that publishes nothing of the owner's yet, and dropped
  * from every other request, which then waits for a person as it always has.
+ *
+ * A `site` job that names no business is given its site's own name
+ * (AGL-3596). The guided start asks what the site is for, never what it is
+ * called — the person named it when they created it — and a plan, a header
+ * and a footer told no name invented one. Filled here, on the click, from the
+ * one read of the site the confirmation already makes, so every door that
+ * creates a site job carries it and nothing is read while the guided start
+ * renders. A name the request gave — an agency batch's — is kept.
  */
 export declare function aiJobAdmittedInputs(firestore: FirebaseFirestore.Firestore, request: {
     kind: string;

package/src/lib/jobs/ai-job-auto-confirm.js

@@ -17,7 +17,7 @@ import { _ as _to_property_key } from "@swc/helpers/_/_to_property_key";
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { isFirstPublishedRoute } from "@aglyn/aglyn/app-utils/analytics-events";
-import { AI_JOB_AUTO_CONFIRM_INPUT } from "../model/ai-site-job.js";
+import { AI_JOB_AUTO_CONFIRM_INPUT, AI_SITE_INPUT_MAX_CHARS } from "../model/ai-site-job.js";
 /**
  * A guided site start confirms its own plan (AGL-3594).
  *
@@ -46,17 +46,41 @@ import { AI_JOB_AUTO_CONFIRM_INPUT } from "../model/ai-site-job.js";
  * A job's inputs as the create door stores them: `autoConfirm` kept only on a
  * `site` job for a site that publishes nothing of the owner's yet, and dropped
  * from every other request, which then waits for a person as it always has.
+ *
+ * A `site` job that names no business is given its site's own name
+ * (AGL-3596). The guided start asks what the site is for, never what it is
+ * called — the person named it when they created it — and a plan, a header
+ * and a footer told no name invented one. Filled here, on the click, from the
+ * one read of the site the confirmation already makes, so every door that
+ * creates a site job carries it and nothing is read while the guided start
+ * renders. A name the request gave — an agency batch's — is kept.
  */ export async function aiJobAdmittedInputs(firestore, request) {
-    if (!(AI_JOB_AUTO_CONFIRM_INPUT in request.inputs)) return request.inputs;
+    const askedToConfirm = AI_JOB_AUTO_CONFIRM_INPUT in request.inputs;
+    const unnamedSite = request.kind === 'site' && !!request.hostId && !aiSiteJobNamed(request.inputs);
+    if (!askedToConfirm && !unnamedSite) return request.inputs;
     const _request_inputs = request.inputs, { [AI_JOB_AUTO_CONFIRM_INPUT]: asked } = _request_inputs, rest = _object_without_properties_loose(_request_inputs, [
         _to_property_key(AI_JOB_AUTO_CONFIRM_INPUT)
     ]);
-    if (request.kind !== 'site' || asked !== true || !request.hostId) return rest;
+    const mayConfirm = request.kind === 'site' && asked === true && !!request.hostId;
+    if (!mayConfirm && !unnamedSite) return rest;
     const host = await firestore.collection('hosts').doc(request.hostId).get();
-    const blank = host.exists && isFirstPublishedRoute(host.get('screens'), host.get('defaultHomeScreenId'));
-    return blank ? _extends({}, rest, {
+    const blank = mayConfirm && host.exists && isFirstPublishedRoute(host.get('screens'), host.get('defaultHomeScreenId'));
+    const name = unnamedSite && host.exists ? aiSiteJobNameOf(host.get('displayName')) : '';
+    // A request that asked nothing of this door, for a site with no name to give, is passed through untouched.
+    if (!askedToConfirm && !name) return request.inputs;
+    return _extends({}, rest, name ? {
+        businessName: name
+    } : {}, blank ? {
         [AI_JOB_AUTO_CONFIRM_INPUT]: true
-    }) : rest;
+    } : {});
+}
+/** Whether a site job's inputs already name the business. */ function aiSiteJobNamed(inputs) {
+    const name = inputs['businessName'];
+    return typeof name === 'string' && name.trim() !== '';
+}
+/** A site's display name as a site job's `businessName`: one line, within what the job admits. */ function aiSiteJobNameOf(value) {
+    if (typeof value !== 'string') return '';
+    return value.replace(/\s+/g, ' ').trim().slice(0, AI_SITE_INPUT_MAX_CHARS).trim();
 }
 
 //# sourceMappingURL=ai-job-auto-confirm.js.map

package/src/lib/jobs/ai-job-auto-confirm.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-auto-confirm.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 { isFirstPublishedRoute } from '@aglyn/aglyn/app-utils/analytics-events'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport { AI_JOB_AUTO_CONFIRM_INPUT } from '../model/ai-site-job'\n\n/**\n * A guided site start confirms its own plan (AGL-3594).\n *\n * Every planned job stops after its plan for a person to read and confirm it.\n * For the guided start on a new site that stop read as a step nobody knew they\n * had to take: a person who had just answered \"what is your site?\" was shown a\n * plan to approve, and a site nobody approved was a site never built. So the\n * guided start asks for its plan to be confirmed for it, with this input, and\n * the machine confirms it the moment the plan step keeps a plan — the same\n * confirmation the resume door makes, by the job's creator, with the same\n * hold on what the plan is estimated to cost.\n *\n * Honored only where it is safe to skip the read: a `site` job, on a site\n * that has published nothing of its own yet — the site the guided start is\n * offered on. Everywhere else the create door drops it, so a page, a form or\n * a site job on an established site still waits for a person. What bounds the\n * spend is unchanged: the plan step's own checks (the Free page cap and the\n * Free wall among them), the plan's admission, and the reservation each step\n * takes.\n */\n\n/** The job input the guided start sets. */\nexport { AI_JOB_AUTO_CONFIRM_INPUT }\n\n/** Whether a job's plan is confirmed for it when the plan step keeps one. */\nexport function aiJobAutoConfirms(job: Pick<AiJob, 'kind' | 'inputs'>): boolean {\n  return job.kind === 'site' && (job.inputs ?? {})[AI_JOB_AUTO_CONFIRM_INPUT] === true\n}\n\n/**\n * A job's inputs as the create door stores them: `autoConfirm` kept only on a\n * `site` job for a site that publishes nothing of the owner's yet, and dropped\n * from every other request, which then waits for a person as it always has.\n */\nexport async function aiJobAdmittedInputs(\n  firestore: FirebaseFirestore.Firestore,\n  request: { kind: string; hostId: string | null; inputs: Record<string, unknown> },\n): Promise<Record<string, unknown>> {\n  if (!(AI_JOB_AUTO_CONFIRM_INPUT in request.inputs)) return request.inputs\n  const { [AI_JOB_AUTO_CONFIRM_INPUT]: asked, ...rest } = request.inputs\n  if (request.kind !== 'site' || asked !== true || !request.hostId) return rest\n  const host = await firestore.collection('hosts').doc(request.hostId).get()\n  const blank =\n    host.exists &&\n    isFirstPublishedRoute(\n      host.get('screens') as Record<string, unknown> | undefined,\n      host.get('defaultHomeScreenId') as string | undefined,\n    )\n  return blank ? { ...rest, [AI_JOB_AUTO_CONFIRM_INPUT]: true } : rest\n}\n"],"names":["isFirstPublishedRoute","AI_JOB_AUTO_CONFIRM_INPUT","aiJobAutoConfirms","job","kind","inputs","aiJobAdmittedInputs","firestore","request","asked","rest","hostId","host","collection","doc","get","blank","exists"],"mappings":";;;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,qBAAqB,QAAQ,0CAAyC;AAE/E,SAASC,yBAAyB,QAAQ,0BAAsB;AAEhE;;;;;;;;;;;;;;;;;;;CAmBC,GAED,yCAAyC,GACzC,SAASA,yBAAyB,GAAE;AAEpC,2EAA2E,GAC3E,OAAO,SAASC,kBAAkBC,GAAmC;QACpCA;IAA/B,OAAOA,IAAIC,IAAI,KAAK,UAAU,EAACD,cAAAA,IAAIE,MAAM,YAAVF,cAAc,CAAC,EAAE,CAACF,0BAA0B,KAAK;AAClF;AAEA;;;;CAIC,GACD,OAAO,eAAeK,oBACpBC,SAAsC,EACtCC,OAAiF;IAEjF,IAAI,CAAEP,CAAAA,6BAA6BO,QAAQH,MAAM,AAAD,GAAI,OAAOG,QAAQH,MAAM;IACzE,MAAwDG,kBAAAA,QAAQH,MAAM,EAAhE,EAAE,CAACJ,0BAA0B,EAAEQ,KAAK,EAAW,GAAGD,iBAATE,wCAASF;yBAA/CP;;IACT,IAAIO,QAAQJ,IAAI,KAAK,UAAUK,UAAU,QAAQ,CAACD,QAAQG,MAAM,EAAE,OAAOD;IACzE,MAAME,OAAO,MAAML,UAAUM,UAAU,CAAC,SAASC,GAAG,CAACN,QAAQG,MAAM,EAAEI,GAAG;IACxE,MAAMC,QACJJ,KAAKK,MAAM,IACXjB,sBACEY,KAAKG,GAAG,CAAC,YACTH,KAAKG,GAAG,CAAC;IAEb,OAAOC,QAAQ,aAAKN;QAAM,CAACT,0BAA0B,EAAE;SAASS;AAClE"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-auto-confirm.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 { isFirstPublishedRoute } from '@aglyn/aglyn/app-utils/analytics-events'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport { AI_JOB_AUTO_CONFIRM_INPUT, AI_SITE_INPUT_MAX_CHARS } from '../model/ai-site-job'\n\n/**\n * A guided site start confirms its own plan (AGL-3594).\n *\n * Every planned job stops after its plan for a person to read and confirm it.\n * For the guided start on a new site that stop read as a step nobody knew they\n * had to take: a person who had just answered \"what is your site?\" was shown a\n * plan to approve, and a site nobody approved was a site never built. So the\n * guided start asks for its plan to be confirmed for it, with this input, and\n * the machine confirms it the moment the plan step keeps a plan — the same\n * confirmation the resume door makes, by the job's creator, with the same\n * hold on what the plan is estimated to cost.\n *\n * Honored only where it is safe to skip the read: a `site` job, on a site\n * that has published nothing of its own yet — the site the guided start is\n * offered on. Everywhere else the create door drops it, so a page, a form or\n * a site job on an established site still waits for a person. What bounds the\n * spend is unchanged: the plan step's own checks (the Free page cap and the\n * Free wall among them), the plan's admission, and the reservation each step\n * takes.\n */\n\n/** The job input the guided start sets. */\nexport { AI_JOB_AUTO_CONFIRM_INPUT }\n\n/** Whether a job's plan is confirmed for it when the plan step keeps one. */\nexport function aiJobAutoConfirms(job: Pick<AiJob, 'kind' | 'inputs'>): boolean {\n  return job.kind === 'site' && (job.inputs ?? {})[AI_JOB_AUTO_CONFIRM_INPUT] === true\n}\n\n/**\n * A job's inputs as the create door stores them: `autoConfirm` kept only on a\n * `site` job for a site that publishes nothing of the owner's yet, and dropped\n * from every other request, which then waits for a person as it always has.\n *\n * A `site` job that names no business is given its site's own name\n * (AGL-3596). The guided start asks what the site is for, never what it is\n * called — the person named it when they created it — and a plan, a header\n * and a footer told no name invented one. Filled here, on the click, from the\n * one read of the site the confirmation already makes, so every door that\n * creates a site job carries it and nothing is read while the guided start\n * renders. A name the request gave — an agency batch's — is kept.\n */\nexport async function aiJobAdmittedInputs(\n  firestore: FirebaseFirestore.Firestore,\n  request: { kind: string; hostId: string | null; inputs: Record<string, unknown> },\n): Promise<Record<string, unknown>> {\n  const askedToConfirm = AI_JOB_AUTO_CONFIRM_INPUT in request.inputs\n  const unnamedSite = request.kind === 'site' && !!request.hostId && !aiSiteJobNamed(request.inputs)\n  if (!askedToConfirm && !unnamedSite) return request.inputs\n  const { [AI_JOB_AUTO_CONFIRM_INPUT]: asked, ...rest } = request.inputs\n  const mayConfirm = request.kind === 'site' && asked === true && !!request.hostId\n  if (!mayConfirm && !unnamedSite) return rest\n  const host = await firestore.collection('hosts').doc(request.hostId as string).get()\n  const blank =\n    mayConfirm &&\n    host.exists &&\n    isFirstPublishedRoute(\n      host.get('screens') as Record<string, unknown> | undefined,\n      host.get('defaultHomeScreenId') as string | undefined,\n    )\n  const name = unnamedSite && host.exists ? aiSiteJobNameOf(host.get('displayName')) : ''\n  // A request that asked nothing of this door, for a site with no name to give, is passed through untouched.\n  if (!askedToConfirm && !name) return request.inputs\n  return {\n    ...rest,\n    ...(name ? { businessName: name } : {}),\n    ...(blank ? { [AI_JOB_AUTO_CONFIRM_INPUT]: true } : {}),\n  }\n}\n\n/** Whether a site job's inputs already name the business. */\nfunction aiSiteJobNamed(inputs: Readonly<Record<string, unknown>>): boolean {\n  const name = inputs['businessName']\n  return typeof name === 'string' && name.trim() !== ''\n}\n\n/** A site's display name as a site job's `businessName`: one line, within what the job admits. */\nfunction aiSiteJobNameOf(value: unknown): string {\n  if (typeof value !== 'string') return ''\n  return value.replace(/\\s+/g, ' ').trim().slice(0, AI_SITE_INPUT_MAX_CHARS).trim()\n}\n"],"names":["isFirstPublishedRoute","AI_JOB_AUTO_CONFIRM_INPUT","AI_SITE_INPUT_MAX_CHARS","aiJobAutoConfirms","job","kind","inputs","aiJobAdmittedInputs","firestore","request","askedToConfirm","unnamedSite","hostId","aiSiteJobNamed","asked","rest","mayConfirm","host","collection","doc","get","blank","exists","name","aiSiteJobNameOf","businessName","trim","value","replace","slice"],"mappings":";;;AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,qBAAqB,QAAQ,0CAAyC;AAE/E,SAASC,yBAAyB,EAAEC,uBAAuB,QAAQ,0BAAsB;AAEzF;;;;;;;;;;;;;;;;;;;CAmBC,GAED,yCAAyC,GACzC,SAASD,yBAAyB,GAAE;AAEpC,2EAA2E,GAC3E,OAAO,SAASE,kBAAkBC,GAAmC;QACpCA;IAA/B,OAAOA,IAAIC,IAAI,KAAK,UAAU,EAACD,cAAAA,IAAIE,MAAM,YAAVF,cAAc,CAAC,EAAE,CAACH,0BAA0B,KAAK;AAClF;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,eAAeM,oBACpBC,SAAsC,EACtCC,OAAiF;IAEjF,MAAMC,iBAAiBT,6BAA6BQ,QAAQH,MAAM;IAClE,MAAMK,cAAcF,QAAQJ,IAAI,KAAK,UAAU,CAAC,CAACI,QAAQG,MAAM,IAAI,CAACC,eAAeJ,QAAQH,MAAM;IACjG,IAAI,CAACI,kBAAkB,CAACC,aAAa,OAAOF,QAAQH,MAAM;IAC1D,MAAwDG,kBAAAA,QAAQH,MAAM,EAAhE,EAAE,CAACL,0BAA0B,EAAEa,KAAK,EAAW,GAAGL,iBAATM,wCAASN;yBAA/CR;;IACT,MAAMe,aAAaP,QAAQJ,IAAI,KAAK,UAAUS,UAAU,QAAQ,CAAC,CAACL,QAAQG,MAAM;IAChF,IAAI,CAACI,cAAc,CAACL,aAAa,OAAOI;IACxC,MAAME,OAAO,MAAMT,UAAUU,UAAU,CAAC,SAASC,GAAG,CAACV,QAAQG,MAAM,EAAYQ,GAAG;IAClF,MAAMC,QACJL,cACAC,KAAKK,MAAM,IACXtB,sBACEiB,KAAKG,GAAG,CAAC,YACTH,KAAKG,GAAG,CAAC;IAEb,MAAMG,OAAOZ,eAAeM,KAAKK,MAAM,GAAGE,gBAAgBP,KAAKG,GAAG,CAAC,kBAAkB;IACrF,2GAA2G;IAC3G,IAAI,CAACV,kBAAkB,CAACa,MAAM,OAAOd,QAAQH,MAAM;IACnD,OAAO,aACFS,MACCQ,OAAO;QAAEE,cAAcF;IAAK,IAAI,CAAC,GACjCF,QAAQ;QAAE,CAACpB,0BAA0B,EAAE;IAAK,IAAI,CAAC;AAEzD;AAEA,2DAA2D,GAC3D,SAASY,eAAeP,MAAyC;IAC/D,MAAMiB,OAAOjB,MAAM,CAAC,eAAe;IACnC,OAAO,OAAOiB,SAAS,YAAYA,KAAKG,IAAI,OAAO;AACrD;AAEA,gGAAgG,GAChG,SAASF,gBAAgBG,KAAc;IACrC,IAAI,OAAOA,UAAU,UAAU,OAAO;IACtC,OAAOA,MAAMC,OAAO,CAAC,QAAQ,KAAKF,IAAI,GAAGG,KAAK,CAAC,GAAG3B,yBAAyBwB,IAAI;AACjF"}

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

@@ -0,0 +1,144 @@
+/**
+ * @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 { resolveOrgIdForHost } from '@aglyn/tenant-data-admin/server/organizations';
+import { type AiBuildOps, type AiBuildUnit } from '../model/ai-build-job';
+import type { AiJob, AiJobItemLedger, AiJobKind } from '../model/ai-jobs.types';
+import { type AiBuildOpsContext } from './ai-build-capabilities';
+import { aiJobAdmissionRefusal, type AiJobAdmission } from './ai-job-admission';
+import { readAiDraftNodes } from './ai-job-drafts';
+import { aiPluginDraftAdmissionRefusal, type AiPluginDraftWriterLookup } from './ai-job-plugin-drafts';
+import { type AiJobStepRunner } from './ai-job-text-step';
+import { aiPublishGuidedSite } from './ai-site-publish';
+import { aiJobStepRunnerFor } from './ai-jobs';
+/**
+ * The build step (AGL-3616): the generation step of a `build` job, run once
+ * the member confirmed the plan their request produced.
+ *
+ * Like the site scaffold it generalizes, it builds nothing itself and asks no
+ * model of its own. Each pass takes the next unit in dependency order and
+ * hands it to what builds that kind of thing — a page, layout, form,
+ * component, email design or template to this plugin's own step, under a job
+ * derived for the unit; another plugin's resource to that plugin's writer on
+ * the resource-draft seam, with the content the owner's capability derives
+ * from the item's arguments. One unit, one pass, one recorded spend.
+ *
+ * ── Settled item by item ────────────────────────────────────────────────
+ *
+ * Where a unit stands is read from the job's ITEM LEDGER, never from counting
+ * outputs: the machine writes each pass's row in the transaction that
+ * records its spend (`recordStep`). A unit that fails is a FAILED ROW, not a
+ * failed job: the pass reports it, the machine gives back that item's spend
+ * where the failure was ours, and the next pass builds the next unit. What
+ * depended on it is built without it, or skipped where it cannot stand
+ * without it (`aiBuildDegradation`). The machine ends the job when nothing is
+ * left: `done` when anything was delivered, `failed` — its planning given
+ * back too — when nothing was.
+ *
+ * ── Drafts, unless asked and confirmed ───────────────────────────────────
+ *
+ * Every unit writes the draft its own kind writes, which nothing publishes.
+ * Only a build whose request asked to publish AND whose member ticked the
+ * plan card's box puts its built pages live, once, on its last pass, through
+ * the guided start's publish.
+ */
+/** What a build answers with no confirmed plan to build. */
+export declare const AI_BUILD_NO_PLAN_COPY = "This build has no confirmed plan to build.";
+/** What a unit says when nothing on this site builds its operation any more. */
+export declare const aiBuildUnavailableCopy: (noun: string) => string;
+/** What a page that was reported built but holds none of its plan says. */
+export declare const AI_BUILD_PAGE_NOT_WRITTEN_COPY = "The page was not written from its plan.";
+/**
+ * The most passes a build's step may take: every unit at a page's worst — its
+ * sections and its listing — so a runner that never finishes is still
+ * bounded while the largest plan is not. Try again starts the count over.
+ */
+export declare const AI_BUILD_MAX_PASSES: number;
+/** The job kind a unit is built by, where an AI runner builds it. */
+export declare function aiBuildUnitJobKind(unit: AiBuildUnit, ops: AiBuildOps): AiJobKind | null;
+/** The id a unit's job, and so its draft, is named by. */
+export declare function aiBuildUnitJobId(job: Pick<AiJob, '$id'>, unit: AiBuildUnit): string;
+/**
+ * The job a unit is built under (generalizing `aiSiteUnitJob`): this job's
+ * org, site, creator and model; the kind that builds the unit; a plan
+ * narrowed to the unit, its `new:` references resolved to what was built and
+ * the failed ones left out; and a brief that says what the unit is, what it
+ * is built without, and which blocks its sections place.
+ */
+export declare function aiBuildUnitJob(job: AiJob, unit: AiBuildUnit, context: {
+    kind: AiJobKind;
+    units: readonly AiBuildUnit[];
+    ledger: readonly AiJobItemLedger[];
+    ops: AiBuildOps;
+    briefLines?: readonly string[];
+}): AiJob;
+export interface AiJobBuildStepDeps {
+    /** The runner registry; specs hand in fakes. */
+    runnerFor?: typeof aiJobStepRunnerFor;
+    /** The draft writer registry; specs hand in fakes. */
+    writerFor?: AiPluginDraftWriterLookup;
+    /** The operations this site may use; the registry and its gates otherwise. */
+    opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>;
+    /** A runner kind's own admission, asked before its item runs; the registry's otherwise. */
+    admissionFor?: typeof aiJobAdmissionRefusal;
+    /** Another plugin's admission for its writer; the seam's otherwise. */
+    pluginAdmission?: typeof aiPluginDraftAdmissionRefusal;
+    /** The draft reader a built page is checked through. */
+    readNodes?: typeof readAiDraftNodes;
+    /** The publish a build asked for and confirmed. */
+    publish?: typeof aiPublishGuidedSite;
+}
+/** Whether a build's workspace spends the Free taste. */
+export declare function aiBuildFreeTaste(org: object | null | undefined): boolean;
+export declare function createAiJobBuildStep(deps?: AiJobBuildStepDeps): AiJobStepRunner;
+export declare const runAiJobBuildStep: AiJobStepRunner;
+/**
+ * The least time a build's next pass needs: what the step that builds its
+ * next unit registers for the job derived for it; a page pass's when the
+ * next unit is another plugin's draft, which asks no model.
+ */
+export declare function aiBuildJobRunMinimumMs(job: AiJob): number;
+/**
+ * Why a Free build cannot be confirmed: its estimate is more than the owner's
+ * Free allowance has left this month. Read off the account month the meter
+ * writes, net of give-backs; a read that fails admits, since the reservation
+ * still refuses at the wall.
+ */
+export declare function aiBuildFreeBalanceRefusal(input: {
+    firestore: FirebaseFirestore.Firestore;
+    org: object | null;
+    estimate: number;
+    now: Date;
+}): Promise<string | null>;
+export interface AiBuildAdmissionDeps {
+    opsFor?: (context: AiBuildOpsContext) => Promise<AiBuildOps>;
+    freeBalanceRefusal?: typeof aiBuildFreeBalanceRefusal;
+    ownerOf?: typeof resolveOrgIdForHost;
+    now?: () => Date;
+}
+/**
+ * A build is admitted for a site of the job's own org where a page can be
+ * built; and confirmed only for a plan it can build here — its shape, its
+ * operations as this site has them, and on the Free taste an estimate the
+ * month's Free credits still cover.
+ */
+export declare function createAiBuildJobAdmission(deps?: AiBuildAdmissionDeps): AiJobAdmission;
+export declare const aiBuildJobAdmission: AiJobAdmission;
+/**
+ * Registers the build with the least time a pass needs, the time its next
+ * pass needs, the passes its largest plan may take, and its admission.
+ */
+export declare function registerAiBuildJob(): void;