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

package/src/lib/model/ai-job-failure-copy.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { AiJobKind, AiJobSummary } from './ai-jobs.types';
+import type { AiJobKind, AiJobStatus, AiJobSummary } from './ai-jobs.types';
 /**
  * What a member reads when a plan could not be made (AGL-3594): one plain
  * sentence and one thing to do, never a rule number or a validator's words.
@@ -57,6 +57,25 @@ export declare function aiPlanRetryRefusal(input: {
     creditsLeft: number;
     planCredits: number;
 }): string | null;
+/**
+ * What a guided site start that failed on our side says (AGL-3596): one plain
+ * sentence, never a rule. Whether its credits came back is said beside it, from
+ * the job's own record (`aiJobRefundCopy`).
+ */
+export declare const AI_SITE_GUIDED_BUILD_FAILED_COPY = "Something went wrong building your site, and it was not built.";
+/** What a person's own cancel says about its credits: they paid for what ran until then. */
+export declare const AI_JOB_CANCELED_CREDITS_COPY = "You paid for what was spent up to then.";
+/**
+ * What every surface that shows a stopped job says about its credits
+ * (AGL-3596), read off the job's RECORDED give-back (`refundedCredits`),
+ * never worked out again: a failure on our side that gave its credits back
+ * says so plainly, and a person's own cancel says they paid for what ran.
+ * `null` where there is nothing to say — a job still working, done, or one
+ * that stopped without a give-back.
+ */
+export declare function aiJobRefundCopy(job: {
+    status: AiJobStatus;
+} & Partial<Pick<AiJobSummary, 'refundedCredits' | 'creditsSpent'>>): string | null;
 /** The guided start's way back to the starter (AGL-3594). */
 export declare const AI_SITE_STARTER_FALLBACK_LABEL = "Use the starter site instead";
 /**

package/src/lib/model/ai-job-failure-copy.js

@@ -60,6 +60,32 @@
     if (left >= input.planCredits) return null;
     return `You have ${left} AI ${left === 1 ? 'credit' : 'credits'} left this month, and a plan needs up to ${input.planCredits}. Your credits refresh next month, or upgrade for more.`;
 }
+/**
+ * What a guided site start that failed on our side says (AGL-3596): one plain
+ * sentence, never a rule. Whether its credits came back is said beside it, from
+ * the job's own record (`aiJobRefundCopy`).
+ */ export const AI_SITE_GUIDED_BUILD_FAILED_COPY = 'Something went wrong building your site, and it was not built.';
+/** What a person's own cancel says about its credits: they paid for what ran until then. */ export const AI_JOB_CANCELED_CREDITS_COPY = 'You paid for what was spent up to then.';
+/**
+ * What every surface that shows a stopped job says about its credits
+ * (AGL-3596), read off the job's RECORDED give-back (`refundedCredits`),
+ * never worked out again: a failure on our side that gave its credits back
+ * says so plainly, and a person's own cancel says they paid for what ran.
+ * `null` where there is nothing to say — a job still working, done, or one
+ * that stopped without a give-back.
+ */ export function aiJobRefundCopy(job) {
+    var _job_refundedCredits, _job_creditsSpent;
+    const refunded = Math.max(0, Math.floor((_job_refundedCredits = job.refundedCredits) != null ? _job_refundedCredits : 0));
+    if (refunded > 0) {
+        var _job_creditsSpent1;
+        const credits = `${refunded} ${refunded === 1 ? 'credit' : 'credits'}`;
+        const back = refunded === 1 ? 'is' : 'are';
+        const whole = refunded >= Math.floor((_job_creditsSpent1 = job.creditsSpent) != null ? _job_creditsSpent1 : 0);
+        return whole ? `This one’s on us — you weren’t charged. The ${credits} it used ${back} back in your AI credits.` : `This one’s on us — you weren’t charged for the part that failed. The ${credits} it used ${back} back in your AI credits.`;
+    }
+    if (job.status === 'canceled' && ((_job_creditsSpent = job.creditsSpent) != null ? _job_creditsSpent : 0) > 0) return AI_JOB_CANCELED_CREDITS_COPY;
+    return null;
+}
 /** The guided start's way back to the starter (AGL-3594). */ export const AI_SITE_STARTER_FALLBACK_LABEL = 'Use the starter site instead';
 /**
  * Whether a job is a guided start that did not work out and can still be
@@ -70,7 +96,8 @@
  */ export function aiSiteStarterFallbackOffered(job) {
     var _job_review;
     if (job.kind !== 'site' || !job.hostId) return false;
-    if (job.outputs.length > 0) return false;
+    // The site's listing proposal rides out with the first unit and builds nothing (AGL-3596).
+    if (job.outputs.some((output)=>output.resource !== 'seo')) return false;
     if (job.status === 'failed' || job.status === 'canceled') return true;
     return job.status === 'needs_review' && ((_job_review = job.review) == null ? void 0 : _job_review.reason) === 'doctrine';
 }

package/src/lib/model/ai-job-failure-copy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-failure-copy.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 { AiJobKind, AiJobSummary } from './ai-jobs.types'\n\n/**\n * What a member reads when a plan could not be made (AGL-3594): one plain\n * sentence and one thing to do, never a rule number or a validator's words.\n *\n * The plan step's own checks refuse an answer in the doctrine's vocabulary —\n * \"Rule 10 (Navigation and SEO travel with a page): A page reuses an\n * address…\" — which is what the one re-ask is told and what staff read to\n * tell a rule that should bend from a model that ignored it. Shown to the\n * person who asked for a site, the same words read as the product breaking.\n * So the review a refused plan stops for carries this sentence as its\n * `message`, and the doctrine's sentence and findings ride beside it as\n * `detail` and `findings`, which the job document keeps and only staff are\n * shown.\n *\n * Pure: no React, no Admin SDK. The drawer's plan card and the plan step read\n * the same words.\n */\n\n/** The violation code the Free wall refuses a plan with. */\nexport const AI_PLAN_FREE_WALL_CODE = 'plan-over-free-wall'\n\n/** What the plan was for, as the sentence names it. */\nfunction planningWhat(kind: AiJobKind | string): string {\n  switch (kind) {\n    case 'site':\n      return 'your site'\n    case 'page':\n      return 'this page'\n    default:\n      return 'this'\n  }\n}\n\nexport interface AiPlanFailureCopyInput {\n  /** The job kind whose plan was refused. */\n  kind: AiJobKind | string\n  /** The codes of the violations its last answer broke. */\n  codes: readonly string[]\n  /** The step's credits went back to the Free allowance (AGL-3594). */\n  refunded: boolean\n}\n\n/**\n * The sentence a refused plan stops its job with. Over the Free wall, the way\n * out is fewer pages or a paid plan; anything else is ours to have got wrong,\n * and the way out is trying again — said to cost nothing only when it did.\n */\nexport function aiPlanFailureCopy(input: AiPlanFailureCopyInput): string {\n  const spent = input.refunded ? ', and it did not use any of your AI credits' : ''\n  if (input.codes.includes(AI_PLAN_FREE_WALL_CODE)) {\n    return `We couldn't fit this plan into your Free AI credits${spent}. Try fewer pages, or upgrade for more.`\n  }\n  return `Something went wrong planning ${planningWhat(input.kind)}${spent}. Try again.`\n}\n\n/**\n * Why trying a refused plan again cannot work yet, or `null` when it can: the\n * Free allowance left this month is less than a plan of this kind can cost at\n * its worst. Said with the figures, and with the two ways out.\n */\nexport function aiPlanRetryRefusal(input: { creditsLeft: number; planCredits: number }): string | null {\n  const left = Math.max(0, Math.floor(input.creditsLeft))\n  if (left >= input.planCredits) return null\n  return `You have ${left} AI ${left === 1 ? 'credit' : 'credits'} left this month, and a plan needs up to ${input.planCredits}. Your credits refresh next month, or upgrade for more.`\n}\n\n/** The guided start's way back to the starter (AGL-3594). */\nexport const AI_SITE_STARTER_FALLBACK_LABEL = 'Use the starter site instead'\n\n/**\n * Whether a job is a guided start that did not work out and can still be\n * traded for the starter (AGL-3594): a site job that failed, was canceled, or\n * stopped for a person on a refused step — never one waiting on its plan,\n * which is a plan to confirm — and that has built nothing, since the starter\n * is written only to a site with no page or layout.\n */\nexport function aiSiteStarterFallbackOffered(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'hostId' | 'outputs' | 'review'>,\n): boolean {\n  if (job.kind !== 'site' || !job.hostId) return false\n  if (job.outputs.length > 0) return false\n  if (job.status === 'failed' || job.status === 'canceled') return true\n  return job.status === 'needs_review' && job.review?.reason === 'doctrine'\n}\n"],"names":["AI_PLAN_FREE_WALL_CODE","planningWhat","kind","aiPlanFailureCopy","input","spent","refunded","codes","includes","aiPlanRetryRefusal","left","Math","max","floor","creditsLeft","planCredits","AI_SITE_STARTER_FALLBACK_LABEL","aiSiteStarterFallbackOffered","job","hostId","outputs","length","status","review","reason"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;;;CAgBC,GAED,0DAA0D,GAC1D,OAAO,MAAMA,yBAAyB,sBAAqB;AAE3D,qDAAqD,GACrD,SAASC,aAAaC,IAAwB;IAC5C,OAAQA;QACN,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT;YACE,OAAO;IACX;AACF;AAWA;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,MAAMC,QAAQD,MAAME,QAAQ,GAAG,gDAAgD;IAC/E,IAAIF,MAAMG,KAAK,CAACC,QAAQ,CAACR,yBAAyB;QAChD,OAAO,CAAC,mDAAmD,EAAEK,MAAM,uCAAuC,CAAC;IAC7G;IACA,OAAO,CAAC,8BAA8B,EAAEJ,aAAaG,MAAMF,IAAI,IAAIG,MAAM,YAAY,CAAC;AACxF;AAEA;;;;CAIC,GACD,OAAO,SAASI,mBAAmBL,KAAmD;IACpF,MAAMM,OAAOC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACT,MAAMU,WAAW;IACrD,IAAIJ,QAAQN,MAAMW,WAAW,EAAE,OAAO;IACtC,OAAO,CAAC,SAAS,EAAEL,KAAK,IAAI,EAAEA,SAAS,IAAI,WAAW,UAAU,yCAAyC,EAAEN,MAAMW,WAAW,CAAC,uDAAuD,CAAC;AACvL;AAEA,2DAA2D,GAC3D,OAAO,MAAMC,iCAAiC,+BAA8B;AAE5E;;;;;;CAMC,GACD,OAAO,SAASC,6BACdC,GAA4E;QAKpCA;IAHxC,IAAIA,IAAIhB,IAAI,KAAK,UAAU,CAACgB,IAAIC,MAAM,EAAE,OAAO;IAC/C,IAAID,IAAIE,OAAO,CAACC,MAAM,GAAG,GAAG,OAAO;IACnC,IAAIH,IAAII,MAAM,KAAK,YAAYJ,IAAII,MAAM,KAAK,YAAY,OAAO;IACjE,OAAOJ,IAAII,MAAM,KAAK,kBAAkBJ,EAAAA,cAAAA,IAAIK,MAAM,qBAAVL,YAAYM,MAAM,MAAK;AACjE"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-failure-copy.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 { AiJobKind, AiJobStatus, AiJobSummary } from './ai-jobs.types'\n\n/**\n * What a member reads when a plan could not be made (AGL-3594): one plain\n * sentence and one thing to do, never a rule number or a validator's words.\n *\n * The plan step's own checks refuse an answer in the doctrine's vocabulary —\n * \"Rule 10 (Navigation and SEO travel with a page): A page reuses an\n * address…\" — which is what the one re-ask is told and what staff read to\n * tell a rule that should bend from a model that ignored it. Shown to the\n * person who asked for a site, the same words read as the product breaking.\n * So the review a refused plan stops for carries this sentence as its\n * `message`, and the doctrine's sentence and findings ride beside it as\n * `detail` and `findings`, which the job document keeps and only staff are\n * shown.\n *\n * Pure: no React, no Admin SDK. The drawer's plan card and the plan step read\n * the same words.\n */\n\n/** The violation code the Free wall refuses a plan with. */\nexport const AI_PLAN_FREE_WALL_CODE = 'plan-over-free-wall'\n\n/** What the plan was for, as the sentence names it. */\nfunction planningWhat(kind: AiJobKind | string): string {\n  switch (kind) {\n    case 'site':\n      return 'your site'\n    case 'page':\n      return 'this page'\n    default:\n      return 'this'\n  }\n}\n\nexport interface AiPlanFailureCopyInput {\n  /** The job kind whose plan was refused. */\n  kind: AiJobKind | string\n  /** The codes of the violations its last answer broke. */\n  codes: readonly string[]\n  /** The step's credits went back to the Free allowance (AGL-3594). */\n  refunded: boolean\n}\n\n/**\n * The sentence a refused plan stops its job with. Over the Free wall, the way\n * out is fewer pages or a paid plan; anything else is ours to have got wrong,\n * and the way out is trying again — said to cost nothing only when it did.\n */\nexport function aiPlanFailureCopy(input: AiPlanFailureCopyInput): string {\n  const spent = input.refunded ? ', and it did not use any of your AI credits' : ''\n  if (input.codes.includes(AI_PLAN_FREE_WALL_CODE)) {\n    return `We couldn't fit this plan into your Free AI credits${spent}. Try fewer pages, or upgrade for more.`\n  }\n  return `Something went wrong planning ${planningWhat(input.kind)}${spent}. Try again.`\n}\n\n/**\n * Why trying a refused plan again cannot work yet, or `null` when it can: the\n * Free allowance left this month is less than a plan of this kind can cost at\n * its worst. Said with the figures, and with the two ways out.\n */\nexport function aiPlanRetryRefusal(input: { creditsLeft: number; planCredits: number }): string | null {\n  const left = Math.max(0, Math.floor(input.creditsLeft))\n  if (left >= input.planCredits) return null\n  return `You have ${left} AI ${left === 1 ? 'credit' : 'credits'} left this month, and a plan needs up to ${input.planCredits}. Your credits refresh next month, or upgrade for more.`\n}\n\n/**\n * What a guided site start that failed on our side says (AGL-3596): one plain\n * sentence, never a rule. Whether its credits came back is said beside it, from\n * the job's own record (`aiJobRefundCopy`).\n */\nexport const AI_SITE_GUIDED_BUILD_FAILED_COPY = 'Something went wrong building your site, and it was not built.'\n\n/** What a person's own cancel says about its credits: they paid for what ran until then. */\nexport const AI_JOB_CANCELED_CREDITS_COPY = 'You paid for what was spent up to then.'\n\n/**\n * What every surface that shows a stopped job says about its credits\n * (AGL-3596), read off the job's RECORDED give-back (`refundedCredits`),\n * never worked out again: a failure on our side that gave its credits back\n * says so plainly, and a person's own cancel says they paid for what ran.\n * `null` where there is nothing to say — a job still working, done, or one\n * that stopped without a give-back.\n */\nexport function aiJobRefundCopy(\n  job: { status: AiJobStatus } & Partial<Pick<AiJobSummary, 'refundedCredits' | 'creditsSpent'>>,\n): string | null {\n  const refunded = Math.max(0, Math.floor(job.refundedCredits ?? 0))\n  if (refunded > 0) {\n    const credits = `${refunded} ${refunded === 1 ? 'credit' : 'credits'}`\n    const back = refunded === 1 ? 'is' : 'are'\n    const whole = refunded >= Math.floor(job.creditsSpent ?? 0)\n    return whole\n      ? `This one’s on us — you weren’t charged. The ${credits} it used ${back} back in your AI credits.`\n      : `This one’s on us — you weren’t charged for the part that failed. The ${credits} it used ${back} back in your AI credits.`\n  }\n  if (job.status === 'canceled' && (job.creditsSpent ?? 0) > 0) return AI_JOB_CANCELED_CREDITS_COPY\n  return null\n}\n\n/** The guided start's way back to the starter (AGL-3594). */\nexport const AI_SITE_STARTER_FALLBACK_LABEL = 'Use the starter site instead'\n\n/**\n * Whether a job is a guided start that did not work out and can still be\n * traded for the starter (AGL-3594): a site job that failed, was canceled, or\n * stopped for a person on a refused step — never one waiting on its plan,\n * which is a plan to confirm — and that has built nothing, since the starter\n * is written only to a site with no page or layout.\n */\nexport function aiSiteStarterFallbackOffered(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'hostId' | 'outputs' | 'review'>,\n): boolean {\n  if (job.kind !== 'site' || !job.hostId) return false\n  // The site's listing proposal rides out with the first unit and builds nothing (AGL-3596).\n  if (job.outputs.some((output) => output.resource !== 'seo')) return false\n  if (job.status === 'failed' || job.status === 'canceled') return true\n  return job.status === 'needs_review' && job.review?.reason === 'doctrine'\n}\n"],"names":["AI_PLAN_FREE_WALL_CODE","planningWhat","kind","aiPlanFailureCopy","input","spent","refunded","codes","includes","aiPlanRetryRefusal","left","Math","max","floor","creditsLeft","planCredits","AI_SITE_GUIDED_BUILD_FAILED_COPY","AI_JOB_CANCELED_CREDITS_COPY","aiJobRefundCopy","job","refundedCredits","credits","back","whole","creditsSpent","status","AI_SITE_STARTER_FALLBACK_LABEL","aiSiteStarterFallbackOffered","hostId","outputs","some","output","resource","review","reason"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;;;;;;;;;;CAgBC,GAED,0DAA0D,GAC1D,OAAO,MAAMA,yBAAyB,sBAAqB;AAE3D,qDAAqD,GACrD,SAASC,aAAaC,IAAwB;IAC5C,OAAQA;QACN,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT;YACE,OAAO;IACX;AACF;AAWA;;;;CAIC,GACD,OAAO,SAASC,kBAAkBC,KAA6B;IAC7D,MAAMC,QAAQD,MAAME,QAAQ,GAAG,gDAAgD;IAC/E,IAAIF,MAAMG,KAAK,CAACC,QAAQ,CAACR,yBAAyB;QAChD,OAAO,CAAC,mDAAmD,EAAEK,MAAM,uCAAuC,CAAC;IAC7G;IACA,OAAO,CAAC,8BAA8B,EAAEJ,aAAaG,MAAMF,IAAI,IAAIG,MAAM,YAAY,CAAC;AACxF;AAEA;;;;CAIC,GACD,OAAO,SAASI,mBAAmBL,KAAmD;IACpF,MAAMM,OAAOC,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,CAACT,MAAMU,WAAW;IACrD,IAAIJ,QAAQN,MAAMW,WAAW,EAAE,OAAO;IACtC,OAAO,CAAC,SAAS,EAAEL,KAAK,IAAI,EAAEA,SAAS,IAAI,WAAW,UAAU,yCAAyC,EAAEN,MAAMW,WAAW,CAAC,uDAAuD,CAAC;AACvL;AAEA;;;;CAIC,GACD,OAAO,MAAMC,mCAAmC,iEAAgE;AAEhH,0FAA0F,GAC1F,OAAO,MAAMC,+BAA+B,0CAAyC;AAErF;;;;;;;CAOC,GACD,OAAO,SAASC,gBACdC,GAA8F;QAEtDA,sBASNA;IATlC,MAAMb,WAAWK,KAAKC,GAAG,CAAC,GAAGD,KAAKE,KAAK,EAACM,uBAAAA,IAAIC,eAAe,YAAnBD,uBAAuB;IAC/D,IAAIb,WAAW,GAAG;YAGqBa;QAFrC,MAAME,UAAU,GAAGf,SAAS,CAAC,EAAEA,aAAa,IAAI,WAAW,WAAW;QACtE,MAAMgB,OAAOhB,aAAa,IAAI,OAAO;QACrC,MAAMiB,QAAQjB,YAAYK,KAAKE,KAAK,EAACM,qBAAAA,IAAIK,YAAY,YAAhBL,qBAAoB;QACzD,OAAOI,QACH,CAAC,4CAA4C,EAAEF,QAAQ,SAAS,EAAEC,KAAK,yBAAyB,CAAC,GACjG,CAAC,qEAAqE,EAAED,QAAQ,SAAS,EAAEC,KAAK,yBAAyB,CAAC;IAChI;IACA,IAAIH,IAAIM,MAAM,KAAK,cAAc,EAACN,oBAAAA,IAAIK,YAAY,YAAhBL,oBAAoB,KAAK,GAAG,OAAOF;IACrE,OAAO;AACT;AAEA,2DAA2D,GAC3D,OAAO,MAAMS,iCAAiC,+BAA8B;AAE5E;;;;;;CAMC,GACD,OAAO,SAASC,6BACdR,GAA4E;QAMpCA;IAJxC,IAAIA,IAAIjB,IAAI,KAAK,UAAU,CAACiB,IAAIS,MAAM,EAAE,OAAO;IAC/C,2FAA2F;IAC3F,IAAIT,IAAIU,OAAO,CAACC,IAAI,CAAC,CAACC,SAAWA,OAAOC,QAAQ,KAAK,QAAQ,OAAO;IACpE,IAAIb,IAAIM,MAAM,KAAK,YAAYN,IAAIM,MAAM,KAAK,YAAY,OAAO;IACjE,OAAON,IAAIM,MAAM,KAAK,kBAAkBN,EAAAA,cAAAA,IAAIc,MAAM,qBAAVd,YAAYe,MAAM,MAAK;AACjE"}

package/src/lib/model/ai-job-notice.d.ts

@@ -41,6 +41,9 @@ export interface AiJobNoticeSource {
     error?: string | null;
     /** What a guided site start put live (AGL-3596); absent on every other job. */
     sitePublish?: Pick<AiJobSitePublish, 'published' | 'drafts'> | null;
+    /** What the job spent, and gave back for a failure on our side (AGL-3596). */
+    creditsSpent?: number;
+    refundedCredits?: number;
 }
 export type AiJobNotice = Pick<AglynNotification, 'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'>;
 /**

package/src/lib/model/ai-job-notice.js

@@ -15,6 +15,7 @@
  * limitations under the License.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { aiJobKindNoun } from "./ai-job-activity.js";
+import { aiJobRefundCopy } from "./ai-job-failure-copy.js";
 /** The besigner segment each versioned resource lives under. */ export const AI_JOB_BESIGNER_SEGMENT = {
     screen: 'screens',
     reusableComponent: 'components',
@@ -29,6 +30,14 @@ import { aiJobKindNoun } from "./ai-job-activity.js";
  * (AGL-3593): the Assist panel reads it on arrival.
  */ export const AI_JOB_LINK_PARAM = 'aiJob';
 /** Where a site's "Building your site" page lives, under the site (AGL-3594). */ export const AI_SITE_BUILD_HREF = '/ai-jobs';
+/** A stopped job's sentence with what became of its credits, from the job's recorded give-back (AGL-3596). */ function withRefund(job, text, status) {
+    const refund = aiJobRefundCopy({
+        status,
+        refundedCredits: job.refundedCredits,
+        creditsSpent: job.creditsSpent
+    });
+    return refund ? `${text} ${refund}` : text;
+}
 /**
  * Where a notice's link goes, in the stored form the console rewrites when it
  * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,
@@ -84,7 +93,7 @@ import { aiJobKindNoun } from "./ai-job-activity.js";
             type: 'content.aiJobNeedsYou',
             level: 'warning',
             title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,
-            body: ((_job_review1 = job.review) == null ? void 0 : _job_review1.message) || job.error || 'It stopped for your decision. It waits in AI jobs.',
+            body: withRefund(job, ((_job_review1 = job.review) == null ? void 0 : _job_review1.message) || job.error || 'It stopped for your decision. It waits in AI jobs.', 'needs_review'),
             link
         }, scope);
     }
@@ -121,7 +130,7 @@ import { aiJobKindNoun } from "./ai-job-activity.js";
         type: 'content.aiJobFailed',
         level: 'warning',
         title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,
-        body: job.error || 'It stopped before it finished.',
+        body: withRefund(job, job.error || 'It stopped before it finished.', 'failed'),
         link
     }, scope);
 }

package/src/lib/model/ai-job-notice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-notice.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 { AglynNotification } from '@aglyn/aglyn/app-utils/notifications'\nimport { aiJobKindNoun } from './ai-job-activity'\nimport type { AiJobKind, AiJobOutput, AiJobReviewReason, AiJobSitePublish } from './ai-jobs.types'\n\n/** The besigner segment each versioned resource lives under. */\nexport const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resource'], string>> = {\n  screen: 'screens',\n  reusableComponent: 'components',\n  layout: 'layouts',\n  template: 'templates',\n  // An email design is a screen: it opens in the screen besigner, as the\n  // Emails page's own Edit design does.\n  emailScreen: 'screens',\n}\n\n/**\n * The query parameter a console address carries to open AI jobs on one job\n * (AGL-3593): the Assist panel reads it on arrival.\n */\nexport const AI_JOB_LINK_PARAM = 'aiJob'\n\n/** Where a site's \"Building your site\" page lives, under the site (AGL-3594). */\nexport const AI_SITE_BUILD_HREF = '/ai-jobs'\n\n/** A change the person who started a job is told about. */\nexport type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed'\n\n/** The fields of a stored job a notice is written from. */\nexport interface AiJobNoticeSource {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  review?: { reason: AiJobReviewReason; message?: string | null } | null\n  outputs?: readonly AiJobOutput[] | null\n  error?: string | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: Pick<AiJobSitePublish, 'published' | 'drafts'> | null\n}\n\nexport type AiJobNotice = Pick<\n  AglynNotification,\n  'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'\n>\n\n/**\n * Where a notice's link goes, in the stored form the console rewrites when it\n * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,\n * `/org…` for a job of the workspace's.\n *\n * A job that is done leads to what it built (AGL-3593): several pages of the\n * job's site open that site's Pages list, one versioned output opens in the\n * editor on the version the job wrote. Everything else — a plan to confirm, a\n * job that stopped, a done job with nothing of its own to open — opens AI\n * jobs on the job.\n */\nexport function aiJobNoticeLink(job: AiJobNoticeSource, to: AiJobNoticeTransition): string {\n  const base = job.hostId ? `/${job.hostId}` : '/org'\n  // A site job's every notice opens its \"Building your site\" page (AGL-3594),\n  // which leads with the next step whatever the job's state.\n  if (job.kind === 'site' && job.hostId) return `${base}${AI_SITE_BUILD_HREF}/${encodeURIComponent(job.$id)}`\n  if (to === 'done' && job.hostId) {\n    const own = (job.outputs ?? []).filter((output) => output.hostId === job.hostId)\n    const screens = own.filter((output) => output.resource === 'screen')\n    if (screens.length > 1) return `${base}/screens`\n    const versioned = own.find(\n      (output) => AI_JOB_BESIGNER_SEGMENT[output.resource] && output.versionId,\n    )\n    if (own.length === 1 && versioned) {\n      const segment = AI_JOB_BESIGNER_SEGMENT[versioned.resource]\n      return `${base}/${segment}/${versioned.id}/versions/${versioned.versionId}/besigner`\n    }\n  }\n  return `${base}?${AI_JOB_LINK_PARAM}=${encodeURIComponent(job.$id)}`\n}\n\n/**\n * The in-app notification for one change of one job (AGL-3593), for the\n * person who created it. Customer-safe throughout: a stopped job's sentence is\n * the job's own `error`, which the machine writes as a fixed sentence.\n */\nexport function aiJobNotice(job: AiJobNoticeSource, to: AiJobNoticeTransition): AiJobNotice {\n  const noun = aiJobKindNoun(job.kind)\n  const scope = { orgId: job.orgId, ...(job.hostId ? { hostId: job.hostId } : {}) }\n  const link = aiJobNoticeLink(job, to)\n  if (to === 'needs-review') {\n    if (job.review?.reason === 'plan') {\n      return {\n        type: 'content.aiJobNeedsYou',\n        level: 'warning',\n        title:\n          noun === 'AI job'\n            ? 'Your plan is ready: confirm it to build'\n            : `Your ${noun} plan is ready: confirm it to build`,\n        body: 'Nothing is built until you confirm the plan. It waits in AI jobs.',\n        link,\n        ...scope,\n      }\n    }\n    return {\n      type: 'content.aiJobNeedsYou',\n      level: 'warning',\n      title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,\n      body: job.review?.message || job.error || 'It stopped for your decision. It waits in AI jobs.',\n      link,\n      ...scope,\n    }\n  }\n  if (to === 'done') {\n    // A guided site start publishes its pages when it finishes (AGL-3596):\n    // with one live, the site is, and the build page lists any that stayed\n    // drafts with the reason for each.\n    const live = job.kind === 'site' ? (job.sitePublish?.published.length ?? 0) : 0\n    if (live > 0) {\n      const drafts = job.sitePublish?.drafts.length ?? 0\n      return {\n        type: 'content.aiJobDone',\n        level: 'success',\n        title: 'Your site is live',\n        body:\n          drafts > 0\n            ? `Your pages are published, except ${drafts === 1 ? 'one that stayed a draft' : `${drafts} that stayed drafts`}. Open it to see why.`\n            : 'Your pages are published. Open it to view your site or edit your pages.',\n        link,\n        ...scope,\n      }\n    }\n    const pages = (job.outputs ?? []).filter((output) => output.resource === 'screen').length\n    const title =\n      job.kind === 'site' || pages > 1\n        ? 'Your site’s draft pages are ready'\n        : job.kind === 'page'\n          ? 'Your draft page is ready'\n          : noun === 'AI job'\n            ? 'Your AI job finished'\n            : `Your ${noun} is ready`\n    return {\n      type: 'content.aiJobDone',\n      level: 'success',\n      title,\n      body:\n        job.kind === 'insight' || job.kind === 'text'\n          ? 'Open AI jobs to read it.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n      link,\n      ...scope,\n    }\n  }\n  return {\n    type: 'content.aiJobFailed',\n    level: 'warning',\n    title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,\n    body: job.error || 'It stopped before it finished.',\n    link,\n    ...scope,\n  }\n}\n"],"names":["aiJobKindNoun","AI_JOB_BESIGNER_SEGMENT","screen","reusableComponent","layout","template","emailScreen","AI_JOB_LINK_PARAM","AI_SITE_BUILD_HREF","aiJobNoticeLink","job","to","base","hostId","kind","encodeURIComponent","$id","own","outputs","filter","output","screens","resource","length","versioned","find","versionId","segment","id","aiJobNotice","noun","scope","orgId","link","review","reason","type","level","title","body","message","error","live","sitePublish","published","drafts","pages"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-notice.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 { AglynNotification } from '@aglyn/aglyn/app-utils/notifications'\nimport { aiJobKindNoun } from './ai-job-activity'\nimport { aiJobRefundCopy } from './ai-job-failure-copy'\nimport type { AiJobKind, AiJobOutput, AiJobReviewReason, AiJobSitePublish } from './ai-jobs.types'\n\n/** The besigner segment each versioned resource lives under. */\nexport const AI_JOB_BESIGNER_SEGMENT: Partial<Record<AiJobOutput['resource'], string>> = {\n  screen: 'screens',\n  reusableComponent: 'components',\n  layout: 'layouts',\n  template: 'templates',\n  // An email design is a screen: it opens in the screen besigner, as the\n  // Emails page's own Edit design does.\n  emailScreen: 'screens',\n}\n\n/**\n * The query parameter a console address carries to open AI jobs on one job\n * (AGL-3593): the Assist panel reads it on arrival.\n */\nexport const AI_JOB_LINK_PARAM = 'aiJob'\n\n/** Where a site's \"Building your site\" page lives, under the site (AGL-3594). */\nexport const AI_SITE_BUILD_HREF = '/ai-jobs'\n\n/** A change the person who started a job is told about. */\nexport type AiJobNoticeTransition = 'needs-review' | 'done' | 'failed'\n\n/** The fields of a stored job a notice is written from. */\nexport interface AiJobNoticeSource {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  review?: { reason: AiJobReviewReason; message?: string | null } | null\n  outputs?: readonly AiJobOutput[] | null\n  error?: string | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: Pick<AiJobSitePublish, 'published' | 'drafts'> | null\n  /** What the job spent, and gave back for a failure on our side (AGL-3596). */\n  creditsSpent?: number\n  refundedCredits?: number\n}\n\n/** A stopped job's sentence with what became of its credits, from the job's recorded give-back (AGL-3596). */\nfunction withRefund(job: AiJobNoticeSource, text: string, status: 'failed' | 'needs_review'): string {\n  const refund = aiJobRefundCopy({ status, refundedCredits: job.refundedCredits, creditsSpent: job.creditsSpent })\n  return refund ? `${text} ${refund}` : text\n}\n\nexport type AiJobNotice = Pick<\n  AglynNotification,\n  'type' | 'title' | 'body' | 'link' | 'orgId' | 'hostId' | 'level'\n>\n\n/**\n * Where a notice's link goes, in the stored form the console rewrites when it\n * is followed (`normalizeNotificationLink`): `/{hostId}/…` for the job's site,\n * `/org…` for a job of the workspace's.\n *\n * A job that is done leads to what it built (AGL-3593): several pages of the\n * job's site open that site's Pages list, one versioned output opens in the\n * editor on the version the job wrote. Everything else — a plan to confirm, a\n * job that stopped, a done job with nothing of its own to open — opens AI\n * jobs on the job.\n */\nexport function aiJobNoticeLink(job: AiJobNoticeSource, to: AiJobNoticeTransition): string {\n  const base = job.hostId ? `/${job.hostId}` : '/org'\n  // A site job's every notice opens its \"Building your site\" page (AGL-3594),\n  // which leads with the next step whatever the job's state.\n  if (job.kind === 'site' && job.hostId) return `${base}${AI_SITE_BUILD_HREF}/${encodeURIComponent(job.$id)}`\n  if (to === 'done' && job.hostId) {\n    const own = (job.outputs ?? []).filter((output) => output.hostId === job.hostId)\n    const screens = own.filter((output) => output.resource === 'screen')\n    if (screens.length > 1) return `${base}/screens`\n    const versioned = own.find(\n      (output) => AI_JOB_BESIGNER_SEGMENT[output.resource] && output.versionId,\n    )\n    if (own.length === 1 && versioned) {\n      const segment = AI_JOB_BESIGNER_SEGMENT[versioned.resource]\n      return `${base}/${segment}/${versioned.id}/versions/${versioned.versionId}/besigner`\n    }\n  }\n  return `${base}?${AI_JOB_LINK_PARAM}=${encodeURIComponent(job.$id)}`\n}\n\n/**\n * The in-app notification for one change of one job (AGL-3593), for the\n * person who created it. Customer-safe throughout: a stopped job's sentence is\n * the job's own `error`, which the machine writes as a fixed sentence.\n */\nexport function aiJobNotice(job: AiJobNoticeSource, to: AiJobNoticeTransition): AiJobNotice {\n  const noun = aiJobKindNoun(job.kind)\n  const scope = { orgId: job.orgId, ...(job.hostId ? { hostId: job.hostId } : {}) }\n  const link = aiJobNoticeLink(job, to)\n  if (to === 'needs-review') {\n    if (job.review?.reason === 'plan') {\n      return {\n        type: 'content.aiJobNeedsYou',\n        level: 'warning',\n        title:\n          noun === 'AI job'\n            ? 'Your plan is ready: confirm it to build'\n            : `Your ${noun} plan is ready: confirm it to build`,\n        body: 'Nothing is built until you confirm the plan. It waits in AI jobs.',\n        link,\n        ...scope,\n      }\n    }\n    return {\n      type: 'content.aiJobNeedsYou',\n      level: 'warning',\n      title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} needs you`,\n      body: withRefund(job, job.review?.message || job.error || 'It stopped for your decision. It waits in AI jobs.', 'needs_review'),\n      link,\n      ...scope,\n    }\n  }\n  if (to === 'done') {\n    // A guided site start publishes its pages when it finishes (AGL-3596):\n    // with one live, the site is, and the build page lists any that stayed\n    // drafts with the reason for each.\n    const live = job.kind === 'site' ? (job.sitePublish?.published.length ?? 0) : 0\n    if (live > 0) {\n      const drafts = job.sitePublish?.drafts.length ?? 0\n      return {\n        type: 'content.aiJobDone',\n        level: 'success',\n        title: 'Your site is live',\n        body:\n          drafts > 0\n            ? `Your pages are published, except ${drafts === 1 ? 'one that stayed a draft' : `${drafts} that stayed drafts`}. Open it to see why.`\n            : 'Your pages are published. Open it to view your site or edit your pages.',\n        link,\n        ...scope,\n      }\n    }\n    const pages = (job.outputs ?? []).filter((output) => output.resource === 'screen').length\n    const title =\n      job.kind === 'site' || pages > 1\n        ? 'Your site’s draft pages are ready'\n        : job.kind === 'page'\n          ? 'Your draft page is ready'\n          : noun === 'AI job'\n            ? 'Your AI job finished'\n            : `Your ${noun} is ready`\n    return {\n      type: 'content.aiJobDone',\n      level: 'success',\n      title,\n      body:\n        job.kind === 'insight' || job.kind === 'text'\n          ? 'Open AI jobs to read it.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n      link,\n      ...scope,\n    }\n  }\n  return {\n    type: 'content.aiJobFailed',\n    level: 'warning',\n    title: `Your ${noun === 'AI job' ? 'AI job' : `${noun} job`} stopped`,\n    body: withRefund(job, job.error || 'It stopped before it finished.', 'failed'),\n    link,\n    ...scope,\n  }\n}\n"],"names":["aiJobKindNoun","aiJobRefundCopy","AI_JOB_BESIGNER_SEGMENT","screen","reusableComponent","layout","template","emailScreen","AI_JOB_LINK_PARAM","AI_SITE_BUILD_HREF","withRefund","job","text","status","refund","refundedCredits","creditsSpent","aiJobNoticeLink","to","base","hostId","kind","encodeURIComponent","$id","own","outputs","filter","output","screens","resource","length","versioned","find","versionId","segment","id","aiJobNotice","noun","scope","orgId","link","review","reason","type","level","title","body","message","error","live","sitePublish","published","drafts","pages"],"mappings":"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"}

package/src/lib/model/ai-jobs.types.d.ts

@@ -462,4 +462,11 @@ export interface AiJobSummary {
     } | null;
     /** What a guided site start put live (AGL-3596); absent on every other job. */
     sitePublish?: AiJobSitePublish | null;
+    /**
+     * A site job's answers (AGL-3596): the guided start's questions as the person
+     * answered them, so a failed start's Try again reopens them filled in. The
+     * scalar site inputs only, never anything else a job's inputs carry; absent
+     * on every other kind.
+     */
+    siteInputs?: Record<string, unknown> | null;
 }

package/src/lib/model/ai-jobs.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-jobs.types.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 { ITimestamp } from '@aglyn/shared-util-timestamp'\nimport type { AiEffort } from '../providers/contract'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiBuildPlan } from './ai-build-plan'\n\n/**\n * AI generation jobs (AGL-2904).\n *\n * A job is one customer brief carried through one or more model steps by a\n * Firestore state machine, so that work longer than a request can survive\n * the request: the console route runs what it can inline, and the platform\n * job beat resumes whatever is left. The document is the whole state — no\n * process holds anything the next beat cannot read back.\n *\n * ── Outputs are drafts, never a publish ──────────────────────────────────\n *\n * Every output a job produces is a NEW draft or a new unpublished version of\n * an existing resource. A job never flips a version pointer, never registers\n * a route and never sends anything; a person opens the draft the job names\n * and publishes it through the door that already exists for that resource.\n * That is what lets a job run with no visitor, no session and no confirm\n * gate — the thing it writes cannot be seen by anyone but the workspace\n * until a member chooses otherwise.\n *\n * ── The lease ────────────────────────────────────────────────────────────\n *\n * A step runs under a lease: an owner id and an `until` instant. Two beats\n * fire a minute apart against a 120 s function timeout, and a console route\n * may still be running the first step when the first beat looks, so the\n * lease is what stops the same step being run — and metered — twice. A\n * claim is a transaction that refuses while another owner's lease is live;\n * an expired lease is simply claimable, which is also how a step abandoned\n * by a frozen process is recovered.\n */\n\n/**\n * What a job produces. `text` and `theme` have runners; every other kind is\n * registered and refuses with \"not available yet\" until its own issue lands,\n * so a kind's presence in the union says the job model accepts it, not that\n * a runner exists.\n */\nexport type AiJobKind =\n  | 'page'\n  | 'component'\n  | 'layout'\n  | 'template'\n  | 'edit'\n  | 'seo'\n  | 'site'\n  | 'email'\n  | 'campaign'\n  | 'form'\n  | 'experiment'\n  | 'insight'\n  | 'products'\n  | 'crm'\n  | 'onboarding'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n\n/** The union as a value, so a route can validate a body against it. */\nexport const AI_JOB_KINDS: readonly AiJobKind[] = [\n  'page',\n  'component',\n  'layout',\n  'template',\n  'edit',\n  'seo',\n  'site',\n  'email',\n  'campaign',\n  'form',\n  'experiment',\n  'insight',\n  'products',\n  'crm',\n  'onboarding',\n  'workflow',\n  'text',\n  'theme',\n]\n\n/**\n * `queued` — waiting for a runner; `running` — a step holds the lease;\n * `needs_input` — the job stopped for something only the workspace can\n * change (credits, a cap, a switch), and the beat tries it again once that\n * may have changed; `needs_review` — the job stopped for a person's decision\n * (AGL-2935): its plan is ready to confirm, or an answer broke a building\n * rule on its re-ask. No timer can make that decision, so neither the beat\n * nor anything but that person resumes it. The last three are terminal.\n */\nexport type AiJobStatus =\n  | 'queued'\n  | 'running'\n  | 'needs_input'\n  | 'needs_review'\n  | 'done'\n  | 'failed'\n  | 'canceled'\n\nexport const AI_JOB_TERMINAL_STATUSES: readonly AiJobStatus[] = [\n  'done',\n  'failed',\n  'canceled',\n]\n\nexport type AiJobStepStatus = 'pending' | 'running' | 'done' | 'failed'\n\n/** The step a planned kind runs first (AGL-2935): its plan, before anything is built. */\nexport const AI_JOB_PLAN_STEP = 'plan'\n\nexport interface AiJobStep {\n  /** Stable within the job (`plan`, `draft`, `generate`), unique per job. */\n  name: string\n  status: AiJobStepStatus\n  startedAt?: ITimestamp | null\n  endedAt?: ITimestamp | null\n  /** Credits this step has actually cost, at the plan's credit rate. */\n  creditsSpent: number\n  /** Customer-safe only; provider detail goes to the server log. */\n  error?: string | null\n  /**\n   * How many times a runner has been handed this step. A retryable provider\n   * failure hands the step back as `pending`; the count is what stops a\n   * provider outage re-running a step forever.\n   */\n  attempts?: number\n  /**\n   * Passes of a step that works through a list (AGL-2910): each one a\n   * recorded, metered exchange that asked to continue. Attempts count again\n   * from zero after a pass; this count is what bounds the step.\n   */\n  passes?: number\n  /**\n   * What the step's model calls cost in tokens and time (AGL-2937), summed\n   * over every run that reached the provider. Absent on a step none has.\n   */\n  tokens?: AiJobStepTokens\n  /**\n   * The ids the step writes its drafts under, by draft (AGL-3079): minted\n   * when the job is created, so every run of the step names the same drafts.\n   * Absent on a step that writes none; a step that records none names its\n   * drafts by the job's own id.\n   */\n  draftIds?: Partial<Record<AiJobDraftSlot, string>>\n}\n\n/**\n * A draft a job's kind always writes (AGL-3079): a screen, layout, template,\n * form or component; an email design; a campaign; an automation.\n */\nexport type AiJobDraftSlot =\n  | 'screen'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'component'\n  | 'email'\n  | 'campaign'\n  | 'workflow'\n\n/**\n * A step's measure (AGL-2937): the four token counts the meter prices, the\n * time spent in the runner, and the model and thinking effort of the last\n * run. The machine writes it beside `creditsSpent`, so what a kind of step\n * costs in tokens is read off the job rather than inferred from the month.\n */\nexport interface AiJobStepTokens {\n  /** Prompt tokens sent uncached. */\n  input: number\n  /** Prompt tokens read from the prompt cache. */\n  cachedRead: number\n  /** Prompt tokens written to the prompt cache. */\n  cacheWrite: number\n  /** Tokens generated, thinking included. */\n  output: number\n  /** The model the last run was served by. */\n  model: string | null\n  /** The thinking effort the last run asked for; `null` when it named none. */\n  effort: AiEffort | null\n  /** Milliseconds spent in the runner, summed over runs. */\n  latencyMs: number\n  /** Runs that reached the provider. */\n  runs: number\n  /**\n   * Why the step's latest runs stopped (AGL-3042), oldest first and the last\n   * run last: each run's stop reason and the tokens it generated, so a pass\n   * cut off at its ceiling reads off the job rather than out of the sums. At\n   * most `AI_JOB_STEP_LAST_RUNS` are kept; absent on a step measured before.\n   */\n  lastRuns?: AiJobStepRunStop[]\n}\n\n/** One run of a step, by why it stopped (AGL-3042). */\nexport interface AiJobStepRunStop {\n  /**\n   * The stop reason of the run's last model call — `tool_use` or `end_turn`\n   * for an answer, `max_tokens` for one cut off at its ceiling, `refusal` —\n   * and `null` when the provider named none.\n   */\n  stopReason: string | null\n  /** Tokens the run generated, over every model call it made. */\n  output: number\n}\n\nexport type AiJobOutputResource =\n  | 'screen'\n  | 'reusableComponent'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'emailScreen'\n  | 'campaign'\n  | 'product'\n  | 'experiment'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n  | 'seo'\n  | 'insight'\n  | 'crm'\n\n/**\n * One thing a job wrote. Addressed by resource and id so the console can\n * build the \"open draft\" link without knowing what the runner did; `text`\n * has no document of its own, so its body rides on the output itself.\n *\n * A `theme` output is a proposal rather than a document (AGL-2938). A site's\n * theme is fields on its host document, and writing those fields is the save\n * the Theme section's editor performs, which a job never does. So the change\n * set rides on the output as `proposal`, and a person puts it in the editor\n * and saves it there, or does not.\n *\n * An `seo` output is a proposal rather than a document (AGL-2910): search\n * listing values for a page or a product, or a site audit's findings and\n * fixes. A screen's listing is served from the screen document itself, so a\n * job never writes it; the values ride on the output as `proposal`, a person\n * puts them in the editor and saves them there, and an audit's content fixes\n * become new versions only when a person applies them.\n *\n * A `crm` output is a proposal too (AGL-2917): a record's summary and next\n * step, an email draft, or an import's column matches. The CRM's own task\n * form, stage route, composer and import drawer are the writes, and a person\n * makes each of them, or does not.\n */\nexport interface AiJobOutput {\n  resource: AiJobOutputResource\n  id: string\n  /** The unpublished version the job created, where the resource has versions. */\n  versionId?: string | null\n  /** `null` for an output that belongs to the org rather than one site. */\n  hostId: string | null\n  /**\n   * The site's subdomain, which is what a console URL names a site by: the\n   * `[host]` segment resolves by subdomain, so a link built from `hostId`\n   * names no site the console can open.\n   */\n  hostSubdomain?: string | null\n  label: string\n  /** The body of a `text` output. Absent on every other resource. */\n  text?: string\n  /**\n   * The change set of an output a person applies rather than opens — a\n   * `theme` or `seo` proposal — in the shape its job kind's runner defines.\n   */\n  proposal?: Record<string, unknown>\n  /**\n   * What the person decides next about this output, in customer-safe words:\n   * a routing the draft could not store, or part of the brief it could not\n   * build. Absent when there is nothing to decide.\n   */\n  note?: string | null\n  /**\n   * What a first visit is estimated to transfer, as the doctrine measured\n   * the generated document (AGL-2935) — the weight the proposal shows before\n   * anything is applied. Absent where the output is not a page's document.\n   */\n  load?: AiLoadEstimate | null\n}\n\nexport interface AiJobLease {\n  /** The process that holds the step: a route request id or a beat id. */\n  owner: string\n  until: ITimestamp\n}\n\n/** Why a job stopped for a person (AGL-2935). */\nexport type AiJobReviewReason =\n  /** The plan step proposed a plan; generation waits for it to be confirmed. */\n  | 'plan'\n  /** An answer broke a building rule, and so did the answer to the re-ask. */\n  | 'doctrine'\n  /**\n   * The site is at an allowance its plan sets for what the step writes, such\n   * as its shared layouts or its templates (AGL-2909). Freeing one, or a plan\n   * that holds more, is the member's decision; trying again runs the step\n   * again.\n   */\n  | 'limit'\n\n/**\n * A building rule an answer broke, as the job keeps it: the number, the code,\n * the sentence, and where in the answer it was broken (AGL-3078).\n */\nexport interface AiJobRuleFinding {\n  rule: number | null\n  code: string\n  /** Customer-safe. */\n  message: string\n  /** The nodes the finding names, by the ids the refused answer gave them. Absent when it names none. */\n  nodeIds?: string[]\n  /** The plan entries or answer fields it names, as `screens[0].sections[2]`. Absent when it names none. */\n  paths?: string[]\n}\n\n/**\n * One node of the parts of a refused answer its findings name (AGL-3078), as\n * the review keeps it: the node's place, its element and the names of what it\n * sets, and never its copy. A Grid keeps the values of its layout props as\n * they were written, so a review can tell a shape the rules refuse from one\n * the model was asked to mend and did not.\n */\nexport interface AiJobReviewOutlineNode {\n  /** The node's id, as the refused answer wrote it. */\n  id: string\n  /** How far below a node a finding names it sits: 0 for that node. */\n  depth: number\n  componentId: string\n  /** The props it sets, by name only. */\n  props: string[]\n  /** The `sx` keys it sets, by name only; absent when it sets none. */\n  sx?: string[]\n  /** A Grid's layout props, `container`, `size`, `direction`, `spacing` and the rest, as written. */\n  grid?: Record<string, string | number | boolean | null>\n  /** Its children's element ids, in order. */\n  children: string[]\n}\n\nexport interface AiJobReview {\n  reason: AiJobReviewReason\n  /** Customer-safe: what the person is asked to decide. */\n  message: string\n  /** The rules the last answer broke; empty for a plan. */\n  findings: AiJobRuleFinding[]\n  /**\n   * The parts of the refused answer its findings name, each node with the\n   * nodes below it (AGL-3078); absent when they name none. Kept with the job\n   * for diagnosis, and shown to staff.\n   */\n  outline?: AiJobReviewOutlineNode[]\n  /**\n   * The checks' own sentence, where `message` was written for the member\n   * instead (AGL-3594): rule numbers and all, for staff. Its presence is what\n   * tells the drawer the findings are staff reading too.\n   */\n  detail?: string\n  /**\n   * Why trying again cannot work yet (AGL-3594) — the Free allowance left is\n   * less than the step can cost — or absent when it can. The button is drawn\n   * disabled with this beside it.\n   */\n  retryRefusal?: string\n}\n\nexport type AiJobPlanStatus = 'proposed' | 'confirmed'\n\n/** The plan a job builds from, as the job keeps it once its plan step proposed it. */\nexport interface AiJobPlan extends AiBuildPlan {\n  status: AiJobPlanStatus\n  /** Names for the inventory ids the plan references, read when it was made. */\n  labels: Record<string, string>\n  proposedAt: ITimestamp\n  confirmedAt: ITimestamp | null\n  /** The member who confirmed it. */\n  confirmedBy: string | null\n  /**\n   * A digest of the whole request that produced this plan (AGL-2937): the\n   * job's kind, site, brief and scalar inputs, the model that answered, and\n   * the prompt as it was rendered — the site inventory included. A later job\n   * whose request hashes the same reuses this plan rather than paying for the\n   * same answer again. A hash of the request, never of the answer, and no\n   * part of the brief is recoverable from it.\n   */\n  key?: string\n  /** The job this plan was reused from, when it was not asked for again. */\n  reusedFrom?: string\n}\n\nexport interface AiJob {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  /** The customer's brief, verbatim. Expires with the document. */\n  brief: string\n  /** Kind-specific inputs the runner reads (a screen id to edit, a tone). */\n  inputs: Record<string, unknown>\n  /**\n   * The model the creator picked for the job's steps (AGL-2942), or `null`\n   * for Auto. Each step honors it only where the plan and the allotment\n   * allowlists allow it, and runs on the routing table otherwise.\n   */\n  model?: string | null\n  steps: AiJobStep[]\n  outputs: AiJobOutput[]\n  /**\n   * The nominal credit figure held against the job while steps are\n   * outstanding. The meter's real bound is the per-step message reservation\n   * and the org's monthly ceiling; this is the number the console shows so\n   * a running job is not read as free.\n   */\n  creditsReserved: number\n  creditsSpent: number\n  /**\n   * Credits the job gave back because it failed on our side (AGL-3594),\n   * summed over its give-backs; absent when it gave none. `creditsSpent`\n   * stays what ran, so what the job cost is the one less the other.\n   */\n  refundedCredits?: number\n  /** Why the latest give-back was made (`AiJobRefundReason`). */\n  refundReason?: string\n  /** How many give-backs the job has had: the next one's key. */\n  refunds?: number\n  createdBy: string\n  createdAt: ITimestamp\n  updatedAt: ITimestamp\n  /** TTL — the brief is verbatim customer text and expires like an exchange. */\n  expiresAt: ITimestamp\n  /** Customer-safe only. */\n  error?: string | null\n  lease?: AiJobLease | null\n  /** The plan the job builds from, once its plan step proposed one. */\n  plan?: AiJobPlan | null\n  /** What the person is asked to decide while the job is `needs_review`. */\n  review?: AiJobReview | null\n  /**\n   * What a person applied from the job's outputs (AGL-2910). Written by the\n   * door that applied them, never by a step runner, and absent until then.\n   */\n  applied?: AiJobApplied | null\n  /**\n   * What a guided site start put live when it finished (AGL-3596): written\n   * once by the site step's last pass, never by a person. Absent on every\n   * other job, which leaves its pages as drafts.\n   */\n  sitePublish?: AiJobSitePublish | null\n}\n\n/**\n * A guided site start's publish (AGL-3596): the pages that went live, with\n * the address each answers, and the pages that stayed drafts, each with the\n * plain sentence for why. A page that stayed a draft never fails the job.\n */\nexport interface AiJobSitePublish {\n  /** The site's live address, `https://<subdomain>.aglyn.app/`; `null` when the site has no subdomain. */\n  liveUrl: string | null\n  published: Array<{ id: string; label: string; path: string }>\n  drafts: Array<{ id: string; label: string; reason: string }>\n}\n\n/**\n * The record of an apply (AGL-2910): what became a new unpublished version,\n * and what waits in its editor for a person to save.\n */\nexport interface AiJobApplied {\n  at: ITimestamp\n  /** The member who applied. */\n  by: string\n  /** The new version opened for each resource, by resource id. */\n  versions: Record<string, string>\n  /** Resource ids whose proposed values wait in their editor, unsaved. */\n  staged: string[]\n}\n\n/** The plan on the wire: every instant an ISO string. */\nexport interface AiJobPlanSummary extends AiBuildPlan {\n  status: AiJobPlanStatus\n  labels: Record<string, string>\n  proposedAt: string | null\n  confirmedAt: string | null\n  confirmedBy: string | null\n  key?: string\n  reusedFrom?: string\n}\n\n/**\n * The wire form the console reads: every instant an ISO string, the lease\n * reduced to whether a runner holds the job. The brief and the outputs\n * travel as they are — the reader is a member of the org that wrote them.\n */\nexport interface AiJobSummary {\n  id: string\n  orgId: string\n  hostId: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  brief: string\n  /**\n   * The batch a door created this job as one of (AGL-2911), read off the\n   * job's inputs; `null` for a job created on its own. The console groups a\n   * run of jobs by it, which is the one thing it cannot do from a list whose\n   * rows carry no inputs — and the only input the wire form carries, because\n   * a batch id names nothing the member wrote.\n   */\n  batch: string | null\n  steps: Array<{\n    name: string\n    status: AiJobStepStatus\n    startedAt: string | null\n    endedAt: string | null\n    creditsSpent: number\n    error: string | null\n  }>\n  outputs: AiJobOutput[]\n  creditsReserved: number\n  creditsSpent: number\n  /** Credits given back for a failure on our side (AGL-3594); 0 when none. */\n  refundedCredits?: number\n  createdBy: string\n  createdAt: string\n  updatedAt: string\n  error: string | null\n  running: boolean\n  plan: AiJobPlanSummary | null\n  review: AiJobReview | null\n  /** What a person applied from the outputs (AGL-2910); instants as ISO strings. */\n  applied?: {\n    at: string | null\n    by: string\n    versions: Record<string, string>\n    staged: string[]\n  } | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: AiJobSitePublish | null\n}\n"],"names":["AI_JOB_KINDS","AI_JOB_TERMINAL_STATUSES","AI_JOB_PLAN_STEP"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GA+DD,qEAAqE,GACrE,OAAO,MAAMA,eAAqC;IAChD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAoBD,OAAO,MAAMC,2BAAmD;IAC9D;IACA;IACA;CACD,CAAA;AAID,uFAAuF,GACvF,OAAO,MAAMC,mBAAmB,OAAM"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-jobs.types.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 { ITimestamp } from '@aglyn/shared-util-timestamp'\nimport type { AiEffort } from '../providers/contract'\nimport type { AiLoadEstimate } from '../runtime/ai-palette'\nimport type { AiBuildPlan } from './ai-build-plan'\n\n/**\n * AI generation jobs (AGL-2904).\n *\n * A job is one customer brief carried through one or more model steps by a\n * Firestore state machine, so that work longer than a request can survive\n * the request: the console route runs what it can inline, and the platform\n * job beat resumes whatever is left. The document is the whole state — no\n * process holds anything the next beat cannot read back.\n *\n * ── Outputs are drafts, never a publish ──────────────────────────────────\n *\n * Every output a job produces is a NEW draft or a new unpublished version of\n * an existing resource. A job never flips a version pointer, never registers\n * a route and never sends anything; a person opens the draft the job names\n * and publishes it through the door that already exists for that resource.\n * That is what lets a job run with no visitor, no session and no confirm\n * gate — the thing it writes cannot be seen by anyone but the workspace\n * until a member chooses otherwise.\n *\n * ── The lease ────────────────────────────────────────────────────────────\n *\n * A step runs under a lease: an owner id and an `until` instant. Two beats\n * fire a minute apart against a 120 s function timeout, and a console route\n * may still be running the first step when the first beat looks, so the\n * lease is what stops the same step being run — and metered — twice. A\n * claim is a transaction that refuses while another owner's lease is live;\n * an expired lease is simply claimable, which is also how a step abandoned\n * by a frozen process is recovered.\n */\n\n/**\n * What a job produces. `text` and `theme` have runners; every other kind is\n * registered and refuses with \"not available yet\" until its own issue lands,\n * so a kind's presence in the union says the job model accepts it, not that\n * a runner exists.\n */\nexport type AiJobKind =\n  | 'page'\n  | 'component'\n  | 'layout'\n  | 'template'\n  | 'edit'\n  | 'seo'\n  | 'site'\n  | 'email'\n  | 'campaign'\n  | 'form'\n  | 'experiment'\n  | 'insight'\n  | 'products'\n  | 'crm'\n  | 'onboarding'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n\n/** The union as a value, so a route can validate a body against it. */\nexport const AI_JOB_KINDS: readonly AiJobKind[] = [\n  'page',\n  'component',\n  'layout',\n  'template',\n  'edit',\n  'seo',\n  'site',\n  'email',\n  'campaign',\n  'form',\n  'experiment',\n  'insight',\n  'products',\n  'crm',\n  'onboarding',\n  'workflow',\n  'text',\n  'theme',\n]\n\n/**\n * `queued` — waiting for a runner; `running` — a step holds the lease;\n * `needs_input` — the job stopped for something only the workspace can\n * change (credits, a cap, a switch), and the beat tries it again once that\n * may have changed; `needs_review` — the job stopped for a person's decision\n * (AGL-2935): its plan is ready to confirm, or an answer broke a building\n * rule on its re-ask. No timer can make that decision, so neither the beat\n * nor anything but that person resumes it. The last three are terminal.\n */\nexport type AiJobStatus =\n  | 'queued'\n  | 'running'\n  | 'needs_input'\n  | 'needs_review'\n  | 'done'\n  | 'failed'\n  | 'canceled'\n\nexport const AI_JOB_TERMINAL_STATUSES: readonly AiJobStatus[] = [\n  'done',\n  'failed',\n  'canceled',\n]\n\nexport type AiJobStepStatus = 'pending' | 'running' | 'done' | 'failed'\n\n/** The step a planned kind runs first (AGL-2935): its plan, before anything is built. */\nexport const AI_JOB_PLAN_STEP = 'plan'\n\nexport interface AiJobStep {\n  /** Stable within the job (`plan`, `draft`, `generate`), unique per job. */\n  name: string\n  status: AiJobStepStatus\n  startedAt?: ITimestamp | null\n  endedAt?: ITimestamp | null\n  /** Credits this step has actually cost, at the plan's credit rate. */\n  creditsSpent: number\n  /** Customer-safe only; provider detail goes to the server log. */\n  error?: string | null\n  /**\n   * How many times a runner has been handed this step. A retryable provider\n   * failure hands the step back as `pending`; the count is what stops a\n   * provider outage re-running a step forever.\n   */\n  attempts?: number\n  /**\n   * Passes of a step that works through a list (AGL-2910): each one a\n   * recorded, metered exchange that asked to continue. Attempts count again\n   * from zero after a pass; this count is what bounds the step.\n   */\n  passes?: number\n  /**\n   * What the step's model calls cost in tokens and time (AGL-2937), summed\n   * over every run that reached the provider. Absent on a step none has.\n   */\n  tokens?: AiJobStepTokens\n  /**\n   * The ids the step writes its drafts under, by draft (AGL-3079): minted\n   * when the job is created, so every run of the step names the same drafts.\n   * Absent on a step that writes none; a step that records none names its\n   * drafts by the job's own id.\n   */\n  draftIds?: Partial<Record<AiJobDraftSlot, string>>\n}\n\n/**\n * A draft a job's kind always writes (AGL-3079): a screen, layout, template,\n * form or component; an email design; a campaign; an automation.\n */\nexport type AiJobDraftSlot =\n  | 'screen'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'component'\n  | 'email'\n  | 'campaign'\n  | 'workflow'\n\n/**\n * A step's measure (AGL-2937): the four token counts the meter prices, the\n * time spent in the runner, and the model and thinking effort of the last\n * run. The machine writes it beside `creditsSpent`, so what a kind of step\n * costs in tokens is read off the job rather than inferred from the month.\n */\nexport interface AiJobStepTokens {\n  /** Prompt tokens sent uncached. */\n  input: number\n  /** Prompt tokens read from the prompt cache. */\n  cachedRead: number\n  /** Prompt tokens written to the prompt cache. */\n  cacheWrite: number\n  /** Tokens generated, thinking included. */\n  output: number\n  /** The model the last run was served by. */\n  model: string | null\n  /** The thinking effort the last run asked for; `null` when it named none. */\n  effort: AiEffort | null\n  /** Milliseconds spent in the runner, summed over runs. */\n  latencyMs: number\n  /** Runs that reached the provider. */\n  runs: number\n  /**\n   * Why the step's latest runs stopped (AGL-3042), oldest first and the last\n   * run last: each run's stop reason and the tokens it generated, so a pass\n   * cut off at its ceiling reads off the job rather than out of the sums. At\n   * most `AI_JOB_STEP_LAST_RUNS` are kept; absent on a step measured before.\n   */\n  lastRuns?: AiJobStepRunStop[]\n}\n\n/** One run of a step, by why it stopped (AGL-3042). */\nexport interface AiJobStepRunStop {\n  /**\n   * The stop reason of the run's last model call — `tool_use` or `end_turn`\n   * for an answer, `max_tokens` for one cut off at its ceiling, `refusal` —\n   * and `null` when the provider named none.\n   */\n  stopReason: string | null\n  /** Tokens the run generated, over every model call it made. */\n  output: number\n}\n\nexport type AiJobOutputResource =\n  | 'screen'\n  | 'reusableComponent'\n  | 'layout'\n  | 'template'\n  | 'form'\n  | 'emailScreen'\n  | 'campaign'\n  | 'product'\n  | 'experiment'\n  | 'workflow'\n  | 'text'\n  | 'theme'\n  | 'seo'\n  | 'insight'\n  | 'crm'\n\n/**\n * One thing a job wrote. Addressed by resource and id so the console can\n * build the \"open draft\" link without knowing what the runner did; `text`\n * has no document of its own, so its body rides on the output itself.\n *\n * A `theme` output is a proposal rather than a document (AGL-2938). A site's\n * theme is fields on its host document, and writing those fields is the save\n * the Theme section's editor performs, which a job never does. So the change\n * set rides on the output as `proposal`, and a person puts it in the editor\n * and saves it there, or does not.\n *\n * An `seo` output is a proposal rather than a document (AGL-2910): search\n * listing values for a page or a product, or a site audit's findings and\n * fixes. A screen's listing is served from the screen document itself, so a\n * job never writes it; the values ride on the output as `proposal`, a person\n * puts them in the editor and saves them there, and an audit's content fixes\n * become new versions only when a person applies them.\n *\n * A `crm` output is a proposal too (AGL-2917): a record's summary and next\n * step, an email draft, or an import's column matches. The CRM's own task\n * form, stage route, composer and import drawer are the writes, and a person\n * makes each of them, or does not.\n */\nexport interface AiJobOutput {\n  resource: AiJobOutputResource\n  id: string\n  /** The unpublished version the job created, where the resource has versions. */\n  versionId?: string | null\n  /** `null` for an output that belongs to the org rather than one site. */\n  hostId: string | null\n  /**\n   * The site's subdomain, which is what a console URL names a site by: the\n   * `[host]` segment resolves by subdomain, so a link built from `hostId`\n   * names no site the console can open.\n   */\n  hostSubdomain?: string | null\n  label: string\n  /** The body of a `text` output. Absent on every other resource. */\n  text?: string\n  /**\n   * The change set of an output a person applies rather than opens — a\n   * `theme` or `seo` proposal — in the shape its job kind's runner defines.\n   */\n  proposal?: Record<string, unknown>\n  /**\n   * What the person decides next about this output, in customer-safe words:\n   * a routing the draft could not store, or part of the brief it could not\n   * build. Absent when there is nothing to decide.\n   */\n  note?: string | null\n  /**\n   * What a first visit is estimated to transfer, as the doctrine measured\n   * the generated document (AGL-2935) — the weight the proposal shows before\n   * anything is applied. Absent where the output is not a page's document.\n   */\n  load?: AiLoadEstimate | null\n}\n\nexport interface AiJobLease {\n  /** The process that holds the step: a route request id or a beat id. */\n  owner: string\n  until: ITimestamp\n}\n\n/** Why a job stopped for a person (AGL-2935). */\nexport type AiJobReviewReason =\n  /** The plan step proposed a plan; generation waits for it to be confirmed. */\n  | 'plan'\n  /** An answer broke a building rule, and so did the answer to the re-ask. */\n  | 'doctrine'\n  /**\n   * The site is at an allowance its plan sets for what the step writes, such\n   * as its shared layouts or its templates (AGL-2909). Freeing one, or a plan\n   * that holds more, is the member's decision; trying again runs the step\n   * again.\n   */\n  | 'limit'\n\n/**\n * A building rule an answer broke, as the job keeps it: the number, the code,\n * the sentence, and where in the answer it was broken (AGL-3078).\n */\nexport interface AiJobRuleFinding {\n  rule: number | null\n  code: string\n  /** Customer-safe. */\n  message: string\n  /** The nodes the finding names, by the ids the refused answer gave them. Absent when it names none. */\n  nodeIds?: string[]\n  /** The plan entries or answer fields it names, as `screens[0].sections[2]`. Absent when it names none. */\n  paths?: string[]\n}\n\n/**\n * One node of the parts of a refused answer its findings name (AGL-3078), as\n * the review keeps it: the node's place, its element and the names of what it\n * sets, and never its copy. A Grid keeps the values of its layout props as\n * they were written, so a review can tell a shape the rules refuse from one\n * the model was asked to mend and did not.\n */\nexport interface AiJobReviewOutlineNode {\n  /** The node's id, as the refused answer wrote it. */\n  id: string\n  /** How far below a node a finding names it sits: 0 for that node. */\n  depth: number\n  componentId: string\n  /** The props it sets, by name only. */\n  props: string[]\n  /** The `sx` keys it sets, by name only; absent when it sets none. */\n  sx?: string[]\n  /** A Grid's layout props, `container`, `size`, `direction`, `spacing` and the rest, as written. */\n  grid?: Record<string, string | number | boolean | null>\n  /** Its children's element ids, in order. */\n  children: string[]\n}\n\nexport interface AiJobReview {\n  reason: AiJobReviewReason\n  /** Customer-safe: what the person is asked to decide. */\n  message: string\n  /** The rules the last answer broke; empty for a plan. */\n  findings: AiJobRuleFinding[]\n  /**\n   * The parts of the refused answer its findings name, each node with the\n   * nodes below it (AGL-3078); absent when they name none. Kept with the job\n   * for diagnosis, and shown to staff.\n   */\n  outline?: AiJobReviewOutlineNode[]\n  /**\n   * The checks' own sentence, where `message` was written for the member\n   * instead (AGL-3594): rule numbers and all, for staff. Its presence is what\n   * tells the drawer the findings are staff reading too.\n   */\n  detail?: string\n  /**\n   * Why trying again cannot work yet (AGL-3594) — the Free allowance left is\n   * less than the step can cost — or absent when it can. The button is drawn\n   * disabled with this beside it.\n   */\n  retryRefusal?: string\n}\n\nexport type AiJobPlanStatus = 'proposed' | 'confirmed'\n\n/** The plan a job builds from, as the job keeps it once its plan step proposed it. */\nexport interface AiJobPlan extends AiBuildPlan {\n  status: AiJobPlanStatus\n  /** Names for the inventory ids the plan references, read when it was made. */\n  labels: Record<string, string>\n  proposedAt: ITimestamp\n  confirmedAt: ITimestamp | null\n  /** The member who confirmed it. */\n  confirmedBy: string | null\n  /**\n   * A digest of the whole request that produced this plan (AGL-2937): the\n   * job's kind, site, brief and scalar inputs, the model that answered, and\n   * the prompt as it was rendered — the site inventory included. A later job\n   * whose request hashes the same reuses this plan rather than paying for the\n   * same answer again. A hash of the request, never of the answer, and no\n   * part of the brief is recoverable from it.\n   */\n  key?: string\n  /** The job this plan was reused from, when it was not asked for again. */\n  reusedFrom?: string\n}\n\nexport interface AiJob {\n  $id: string\n  orgId: string\n  hostId?: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  /** The customer's brief, verbatim. Expires with the document. */\n  brief: string\n  /** Kind-specific inputs the runner reads (a screen id to edit, a tone). */\n  inputs: Record<string, unknown>\n  /**\n   * The model the creator picked for the job's steps (AGL-2942), or `null`\n   * for Auto. Each step honors it only where the plan and the allotment\n   * allowlists allow it, and runs on the routing table otherwise.\n   */\n  model?: string | null\n  steps: AiJobStep[]\n  outputs: AiJobOutput[]\n  /**\n   * The nominal credit figure held against the job while steps are\n   * outstanding. The meter's real bound is the per-step message reservation\n   * and the org's monthly ceiling; this is the number the console shows so\n   * a running job is not read as free.\n   */\n  creditsReserved: number\n  creditsSpent: number\n  /**\n   * Credits the job gave back because it failed on our side (AGL-3594),\n   * summed over its give-backs; absent when it gave none. `creditsSpent`\n   * stays what ran, so what the job cost is the one less the other.\n   */\n  refundedCredits?: number\n  /** Why the latest give-back was made (`AiJobRefundReason`). */\n  refundReason?: string\n  /** How many give-backs the job has had: the next one's key. */\n  refunds?: number\n  createdBy: string\n  createdAt: ITimestamp\n  updatedAt: ITimestamp\n  /** TTL — the brief is verbatim customer text and expires like an exchange. */\n  expiresAt: ITimestamp\n  /** Customer-safe only. */\n  error?: string | null\n  lease?: AiJobLease | null\n  /** The plan the job builds from, once its plan step proposed one. */\n  plan?: AiJobPlan | null\n  /** What the person is asked to decide while the job is `needs_review`. */\n  review?: AiJobReview | null\n  /**\n   * What a person applied from the job's outputs (AGL-2910). Written by the\n   * door that applied them, never by a step runner, and absent until then.\n   */\n  applied?: AiJobApplied | null\n  /**\n   * What a guided site start put live when it finished (AGL-3596): written\n   * once by the site step's last pass, never by a person. Absent on every\n   * other job, which leaves its pages as drafts.\n   */\n  sitePublish?: AiJobSitePublish | null\n}\n\n/**\n * A guided site start's publish (AGL-3596): the pages that went live, with\n * the address each answers, and the pages that stayed drafts, each with the\n * plain sentence for why. A page that stayed a draft never fails the job.\n */\nexport interface AiJobSitePublish {\n  /** The site's live address, `https://<subdomain>.aglyn.app/`; `null` when the site has no subdomain. */\n  liveUrl: string | null\n  published: Array<{ id: string; label: string; path: string }>\n  drafts: Array<{ id: string; label: string; reason: string }>\n}\n\n/**\n * The record of an apply (AGL-2910): what became a new unpublished version,\n * and what waits in its editor for a person to save.\n */\nexport interface AiJobApplied {\n  at: ITimestamp\n  /** The member who applied. */\n  by: string\n  /** The new version opened for each resource, by resource id. */\n  versions: Record<string, string>\n  /** Resource ids whose proposed values wait in their editor, unsaved. */\n  staged: string[]\n}\n\n/** The plan on the wire: every instant an ISO string. */\nexport interface AiJobPlanSummary extends AiBuildPlan {\n  status: AiJobPlanStatus\n  labels: Record<string, string>\n  proposedAt: string | null\n  confirmedAt: string | null\n  confirmedBy: string | null\n  key?: string\n  reusedFrom?: string\n}\n\n/**\n * The wire form the console reads: every instant an ISO string, the lease\n * reduced to whether a runner holds the job. The brief and the outputs\n * travel as they are — the reader is a member of the org that wrote them.\n */\nexport interface AiJobSummary {\n  id: string\n  orgId: string\n  hostId: string | null\n  kind: AiJobKind\n  status: AiJobStatus\n  brief: string\n  /**\n   * The batch a door created this job as one of (AGL-2911), read off the\n   * job's inputs; `null` for a job created on its own. The console groups a\n   * run of jobs by it, which is the one thing it cannot do from a list whose\n   * rows carry no inputs — and the only input the wire form carries, because\n   * a batch id names nothing the member wrote.\n   */\n  batch: string | null\n  steps: Array<{\n    name: string\n    status: AiJobStepStatus\n    startedAt: string | null\n    endedAt: string | null\n    creditsSpent: number\n    error: string | null\n  }>\n  outputs: AiJobOutput[]\n  creditsReserved: number\n  creditsSpent: number\n  /** Credits given back for a failure on our side (AGL-3594); 0 when none. */\n  refundedCredits?: number\n  createdBy: string\n  createdAt: string\n  updatedAt: string\n  error: string | null\n  running: boolean\n  plan: AiJobPlanSummary | null\n  review: AiJobReview | null\n  /** What a person applied from the outputs (AGL-2910); instants as ISO strings. */\n  applied?: {\n    at: string | null\n    by: string\n    versions: Record<string, string>\n    staged: string[]\n  } | null\n  /** What a guided site start put live (AGL-3596); absent on every other job. */\n  sitePublish?: AiJobSitePublish | null\n  /**\n   * A site job's answers (AGL-3596): the guided start's questions as the person\n   * answered them, so a failed start's Try again reopens them filled in. The\n   * scalar site inputs only, never anything else a job's inputs carry; absent\n   * on every other kind.\n   */\n  siteInputs?: Record<string, unknown> | null\n}\n"],"names":["AI_JOB_KINDS","AI_JOB_TERMINAL_STATUSES","AI_JOB_PLAN_STEP"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GA+DD,qEAAqE,GACrE,OAAO,MAAMA,eAAqC;IAChD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAoBD,OAAO,MAAMC,2BAAmD;IAC9D;IACA;IACA;CACD,CAAA;AAID,uFAAuF,GACvF,OAAO,MAAMC,mBAAmB,OAAM"}

package/src/lib/model/ai-site-build-progress.d.ts

@@ -36,6 +36,14 @@ export interface AiSiteBuildRow {
 /** Where the whole job stands, as the page's header and actions read it. */
 export type AiSiteBuildPhase = 'working' | 'done' | 'stopped' | 'failed' | 'canceled';
 export declare function aiSiteBuildPhase(job: Pick<AiJobSummary, 'status'>): AiSiteBuildPhase;
+/**
+ * One row a stage: planning, then each creation the plan builds before its
+ * pages — the colors, the layout, the form — then each page (AGL-3596). A
+ * scaffold builds them in that order and reports each as an output when it
+ * is written, so the first row without its output is where the build is, and
+ * where a failure stopped it: a layout that broke is the layout's row, never
+ * the first page's.
+ */
 export declare function aiSiteBuildRows(job: Pick<AiJobSummary, 'status' | 'steps' | 'plan' | 'outputs' | 'review'>): AiSiteBuildRow[];
 /**
  * The job's one price (AGL-3594), never a plan's on its own: what it has used

package/src/lib/model/ai-site-build-progress.js

@@ -14,6 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { aiJobKindNoun } from "./ai-job-activity.js";
+import { aiJobRefundCopy } from "./ai-job-failure-copy.js";
 export function aiSiteBuildPhase(job) {
     switch(job.status){
         case 'done':
@@ -29,32 +30,82 @@ export function aiSiteBuildPhase(job) {
             return 'working';
     }
 }
-export function aiSiteBuildRows(job) {
-    var _ref;
+/** The creations a scaffold builds before its pages, in its build order, and what each row says. */ const CREATION_ROWS = [
+    {
+        kind: 'theme-change',
+        resource: 'theme',
+        label: ()=>'Choosing your colors'
+    },
+    {
+        kind: 'layout',
+        resource: 'layout',
+        label: (name)=>`Building the header and footer: ${name}`
+    },
+    {
+        kind: 'form',
+        resource: 'form',
+        label: (name)=>`Building the form: ${name}`
+    }
+];
+/**
+ * One row a stage: planning, then each creation the plan builds before its
+ * pages — the colors, the layout, the form — then each page (AGL-3596). A
+ * scaffold builds them in that order and reports each as an output when it
+ * is written, so the first row without its output is where the build is, and
+ * where a failure stopped it: a layout that broke is the layout's row, never
+ * the first page's.
+ */ export function aiSiteBuildRows(job) {
+    var _built_get, _ref;
     var _job_plan;
     const phase = aiSiteBuildPhase(job);
     const planStep = job.steps.find((step)=>step.name === 'plan');
     const planDone = (planStep == null ? void 0 : planStep.status) === 'done' || Boolean(job.plan);
-    const stoppedHere = (active)=>(phase === 'failed' || phase === 'stopped') && active;
-    const planActive = !planDone;
+    const stopped = phase === 'failed' || phase === 'stopped';
     const rows = [
         {
             id: 'plan',
             label: 'Planning your pages',
-            state: planDone ? 'done' : stoppedHere(planActive) ? 'failed' : phase === 'working' ? 'active' : 'waiting'
+            state: planDone ? 'done' : stopped ? 'failed' : phase === 'working' ? 'active' : 'waiting'
         }
     ];
+    const built = new Map();
+    for (const output of job.outputs)built.set(output.resource, ((_built_get = built.get(output.resource)) != null ? _built_get : 0) + 1);
+    const take = (resource)=>{
+        var _built_get;
+        const left = (_built_get = built.get(resource)) != null ? _built_get : 0;
+        if (left <= 0) return false;
+        built.set(resource, left - 1);
+        return true;
+    };
+    const stages = [];
+    for (const row of CREATION_ROWS){
+        var _job_plan1;
+        const creation = (_job_plan1 = job.plan) == null ? void 0 : _job_plan1.create.find((entry)=>entry.kind === row.kind);
+        if (creation) stages.push({
+            id: row.resource,
+            label: row.label(creation.name),
+            resource: row.resource
+        });
+    }
     const pages = (_ref = (_job_plan = job.plan) == null ? void 0 : _job_plan.screens) != null ? _ref : [];
-    const written = job.outputs.filter((output)=>output.resource === 'screen').length;
     pages.forEach((page, index)=>{
-        const done = index < written || phase === 'done';
-        const current = !done && index === written && planDone;
-        rows.push({
+        stages.push({
             id: `page-${index}`,
             label: `Writing page ${index + 1} of ${pages.length}: ${page.title}`,
-            state: done ? 'done' : stoppedHere(current) ? 'failed' : current && phase === 'working' ? 'active' : 'waiting'
+            resource: 'screen'
         });
     });
+    let reached = false;
+    for (const stage of stages){
+        const done = phase === 'done' || take(stage.resource);
+        const current = !done && !reached && planDone;
+        if (current) reached = true;
+        rows.push({
+            id: stage.id,
+            label: stage.label,
+            state: done ? 'done' : current && stopped ? 'failed' : current && phase === 'working' ? 'active' : 'waiting'
+        });
+    }
     return rows;
 }
 /**
@@ -69,10 +120,13 @@ export function aiSiteBuildRows(job) {
     const phase = aiSiteBuildPhase(job);
     // What the job made, by its kind; a job that names none is a site's.
     const subject = !job.kind || job.kind === 'site' ? 'This site' : aiJobKindNoun(job.kind) === 'AI job' ? 'This AI job' : `This ${aiJobKindNoun(job.kind)}`;
-    if (refunded > 0 && net === 0) return `Nothing was charged — we refunded ${refunded} credits.`;
+    // A failure on our side says so in the words every surface uses (AGL-3596),
+    // from the job's recorded give-back.
+    const refund = phase === 'working' || phase === 'done' ? null : aiJobRefundCopy(job);
+    if (refund && refunded > 0) return refund;
     if (phase === 'done') return `${subject} used ${net} credits.`;
     if (phase === 'working') return `Credits used so far: ${net}`;
-    if (refunded > 0) return `${subject} used ${net} credits — we refunded ${refunded}.`;
+    if (refund) return `${subject} used ${net} credits. ${refund}`;
     return net > 0 ? `${subject} used ${net} credits.` : null;
 }
 /**

package/src/lib/model/ai-site-build-progress.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-build-progress.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 { aiJobKindNoun } from './ai-job-activity'\nimport type { AiJobSummary } from './ai-jobs.types'\n\n/**\n * What the \"Building your site\" page shows of a site job (AGL-3594): one row\n * a stage — planning the pages, then each page — with its state, the state\n * the whole job is in, and the job's one price.\n *\n * Read off the job summary every surface already follows: the plan step's\n * status, the plan's pages, and the pages the build has reported as outputs.\n * A scaffold builds its units in plan order and reports each page when it is\n * written, so the pages written so far are the first pages of the plan.\n *\n * Pure: no React, no request. The page and its spec read the same rows.\n */\n\nexport type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed'\n\nexport interface AiSiteBuildRow {\n  id: string\n  label: string\n  state: AiSiteBuildRowState\n}\n\n/** Where the whole job stands, as the page's header and actions read it. */\nexport type AiSiteBuildPhase = 'working' | 'done' | 'stopped' | 'failed' | 'canceled'\n\nexport function aiSiteBuildPhase(job: Pick<AiJobSummary, 'status'>): AiSiteBuildPhase {\n  switch (job.status) {\n    case 'done':\n      return 'done'\n    case 'failed':\n      return 'failed'\n    case 'canceled':\n      return 'canceled'\n    case 'needs_review':\n    case 'needs_input':\n      return 'stopped'\n    default:\n      return 'working'\n  }\n}\n\nexport function aiSiteBuildRows(\n  job: Pick<AiJobSummary, 'status' | 'steps' | 'plan' | 'outputs' | 'review'>,\n): AiSiteBuildRow[] {\n  const phase = aiSiteBuildPhase(job)\n  const planStep = job.steps.find((step) => step.name === 'plan')\n  const planDone = planStep?.status === 'done' || Boolean(job.plan)\n  const stoppedHere = (active: boolean) => (phase === 'failed' || phase === 'stopped') && active\n  const planActive = !planDone\n  const rows: AiSiteBuildRow[] = [\n    {\n      id: 'plan',\n      label: 'Planning your pages',\n      state: planDone ? 'done' : stoppedHere(planActive) ? 'failed' : phase === 'working' ? 'active' : 'waiting',\n    },\n  ]\n  const pages = job.plan?.screens ?? []\n  const written = job.outputs.filter((output) => output.resource === 'screen').length\n  pages.forEach((page, index) => {\n    const done = index < written || phase === 'done'\n    const current = !done && index === written && planDone\n    rows.push({\n      id: `page-${index}`,\n      label: `Writing page ${index + 1} of ${pages.length}: ${page.title}`,\n      state: done ? 'done' : stoppedHere(current) ? 'failed' : current && phase === 'working' ? 'active' : 'waiting',\n    })\n  })\n  return rows\n}\n\n/**\n * The job's one price (AGL-3594), never a plan's on its own: what it has used\n * so far while it works, what it used once done, and, on a failure we gave\n * back, that nothing was charged.\n */\nexport function aiSiteBuildCreditsLine(\n  job: Pick<AiJobSummary, 'status' | 'creditsSpent' | 'refundedCredits'> & Partial<Pick<AiJobSummary, 'kind'>>,\n): string | null {\n  const spent = Math.max(0, job.creditsSpent ?? 0)\n  const refunded = Math.max(0, job.refundedCredits ?? 0)\n  const net = Math.max(0, spent - refunded)\n  const phase = aiSiteBuildPhase(job)\n  // What the job made, by its kind; a job that names none is a site's.\n  const subject = !job.kind || job.kind === 'site' ? 'This site' : aiJobKindNoun(job.kind) === 'AI job' ? 'This AI job' : `This ${aiJobKindNoun(job.kind)}`\n  if (refunded > 0 && net === 0) return `Nothing was charged — we refunded ${refunded} credits.`\n  if (phase === 'done') return `${subject} used ${net} credits.`\n  if (phase === 'working') return `Credits used so far: ${net}`\n  if (refunded > 0) return `${subject} used ${net} credits — we refunded ${refunded}.`\n  return net > 0 ? `${subject} used ${net} credits.` : null\n}\n\n/** The heading and the sentence under it, for one job's page in its current phase. */\nexport interface AiJobPageCopy {\n  heading: string\n  lede: string\n}\n\n/**\n * What one job's page says at the top (AGL-3594, AGL-3596). A site job reads\n * as \"Building your site\"; any other kind names what it makes — \"Building\n * your page\" — or, for a kind with no noun, the job itself.\n *\n * A guided site start publishes its pages when it finishes, and says so\n * (`sitePublish`): with a page live the heading is \"Your site is live\". A\n * done site job without that record — an older job, or one that was not a\n * guided start — built drafts, and says that instead.\n */\nexport function aiJobPageCopy(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish'>>,\n  brand: string,\n): AiJobPageCopy {\n  const phase = aiSiteBuildPhase(job)\n  const noun = job.kind === 'site' ? 'site' : aiJobKindNoun(job.kind)\n  const generic = noun === 'AI job'\n  // `products` is the one plural noun.\n  const isAre = noun.endsWith('s') ? 'are' : 'is'\n  const why = job.review?.message ?? job.error ?? null\n  if (phase === 'working') {\n    return {\n      heading: generic ? 'Your AI job is running' : `Building your ${noun}`,\n      lede:\n        job.kind === 'site'\n          ? `${brand} AI is planning your pages and writing each one. You can leave this page; it keeps going.`\n          : `${brand} AI is working on it. You can leave this page; it keeps going.`,\n    }\n  }\n  if (phase === 'done') {\n    const published = job.sitePublish?.published.length ?? 0\n    if (job.kind === 'site' && published > 0) {\n      return {\n        heading: 'Your site is live',\n        lede: job.sitePublish?.drafts.length\n          ? 'Your pages are published, except the ones listed below, which stayed drafts.'\n          : 'Your pages are published, and anyone can visit your site now.',\n      }\n    }\n    if (job.kind === 'site' && job.sitePublish) {\n      return {\n        heading: 'Your site is ready',\n        lede: 'None of your new pages could be published, so they are drafts. The reasons are below.',\n      }\n    }\n    return {\n      heading: generic ? 'Your AI job finished' : `Your ${noun} ${isAre} ready`,\n      lede:\n        job.kind === 'site'\n          ? 'Your new pages are drafts. Publish them when you’re happy.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n    }\n  }\n  if (phase === 'canceled') {\n    return { heading: generic ? 'Your AI job was canceled' : `Your ${noun} was not built`, lede: 'The job was canceled.' }\n  }\n  return {\n    heading: generic ? 'Your AI job stopped' : `Your ${noun} ${noun.endsWith('s') ? 'were' : 'was'} not built`,\n    lede: why ?? (generic ? 'Something went wrong running this job.' : `Something went wrong building your ${noun}.`),\n  }\n}\n"],"names":["aiJobKindNoun","aiSiteBuildPhase","job","status","aiSiteBuildRows","phase","planStep","steps","find","step","name","planDone","Boolean","plan","stoppedHere","active","planActive","rows","id","label","state","pages","screens","written","outputs","filter","output","resource","length","forEach","page","index","done","current","push","title","aiSiteBuildCreditsLine","spent","Math","max","creditsSpent","refunded","refundedCredits","net","subject","kind","aiJobPageCopy","brand","noun","generic","isAre","endsWith","why","review","message","error","heading","lede","published","sitePublish","drafts"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-site-build-progress.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 { aiJobKindNoun } from './ai-job-activity'\nimport { aiJobRefundCopy } from './ai-job-failure-copy'\nimport type { AiJobSummary } from './ai-jobs.types'\n\n/**\n * What the \"Building your site\" page shows of a site job (AGL-3594): one row\n * a stage — planning the pages, then each page — with its state, the state\n * the whole job is in, and the job's one price.\n *\n * Read off the job summary every surface already follows: the plan step's\n * status, the plan's pages, and the pages the build has reported as outputs.\n * A scaffold builds its units in plan order and reports each page when it is\n * written, so the pages written so far are the first pages of the plan.\n *\n * Pure: no React, no request. The page and its spec read the same rows.\n */\n\nexport type AiSiteBuildRowState = 'done' | 'active' | 'waiting' | 'failed'\n\nexport interface AiSiteBuildRow {\n  id: string\n  label: string\n  state: AiSiteBuildRowState\n}\n\n/** Where the whole job stands, as the page's header and actions read it. */\nexport type AiSiteBuildPhase = 'working' | 'done' | 'stopped' | 'failed' | 'canceled'\n\nexport function aiSiteBuildPhase(job: Pick<AiJobSummary, 'status'>): AiSiteBuildPhase {\n  switch (job.status) {\n    case 'done':\n      return 'done'\n    case 'failed':\n      return 'failed'\n    case 'canceled':\n      return 'canceled'\n    case 'needs_review':\n    case 'needs_input':\n      return 'stopped'\n    default:\n      return 'working'\n  }\n}\n\n/** The creations a scaffold builds before its pages, in its build order, and what each row says. */\nconst CREATION_ROWS: ReadonlyArray<{ kind: string; resource: string; label: (name: string) => string }> = [\n  { kind: 'theme-change', resource: 'theme', label: () => 'Choosing your colors' },\n  { kind: 'layout', resource: 'layout', label: (name) => `Building the header and footer: ${name}` },\n  { kind: 'form', resource: 'form', label: (name) => `Building the form: ${name}` },\n]\n\n/**\n * One row a stage: planning, then each creation the plan builds before its\n * pages — the colors, the layout, the form — then each page (AGL-3596). A\n * scaffold builds them in that order and reports each as an output when it\n * is written, so the first row without its output is where the build is, and\n * where a failure stopped it: a layout that broke is the layout's row, never\n * the first page's.\n */\nexport function aiSiteBuildRows(\n  job: Pick<AiJobSummary, 'status' | 'steps' | 'plan' | 'outputs' | 'review'>,\n): AiSiteBuildRow[] {\n  const phase = aiSiteBuildPhase(job)\n  const planStep = job.steps.find((step) => step.name === 'plan')\n  const planDone = planStep?.status === 'done' || Boolean(job.plan)\n  const stopped = phase === 'failed' || phase === 'stopped'\n  const rows: AiSiteBuildRow[] = [\n    {\n      id: 'plan',\n      label: 'Planning your pages',\n      state: planDone ? 'done' : stopped ? 'failed' : phase === 'working' ? 'active' : 'waiting',\n    },\n  ]\n  const built = new Map<string, number>()\n  for (const output of job.outputs) built.set(output.resource, (built.get(output.resource) ?? 0) + 1)\n  const take = (resource: string): boolean => {\n    const left = built.get(resource) ?? 0\n    if (left <= 0) return false\n    built.set(resource, left - 1)\n    return true\n  }\n  const stages: Array<{ id: string; label: string; resource: string }> = []\n  for (const row of CREATION_ROWS) {\n    const creation = job.plan?.create.find((entry) => entry.kind === row.kind)\n    if (creation) stages.push({ id: row.resource, label: row.label(creation.name), resource: row.resource })\n  }\n  const pages = job.plan?.screens ?? []\n  pages.forEach((page, index) => {\n    stages.push({ id: `page-${index}`, label: `Writing page ${index + 1} of ${pages.length}: ${page.title}`, resource: 'screen' })\n  })\n  let reached = false\n  for (const stage of stages) {\n    const done = phase === 'done' || take(stage.resource)\n    const current = !done && !reached && planDone\n    if (current) reached = true\n    rows.push({\n      id: stage.id,\n      label: stage.label,\n      state: done ? 'done' : current && stopped ? 'failed' : current && phase === 'working' ? 'active' : 'waiting',\n    })\n  }\n  return rows\n}\n\n/**\n * The job's one price (AGL-3594), never a plan's on its own: what it has used\n * so far while it works, what it used once done, and, on a failure we gave\n * back, that nothing was charged.\n */\nexport function aiSiteBuildCreditsLine(\n  job: Pick<AiJobSummary, 'status' | 'creditsSpent' | 'refundedCredits'> & Partial<Pick<AiJobSummary, 'kind'>>,\n): string | null {\n  const spent = Math.max(0, job.creditsSpent ?? 0)\n  const refunded = Math.max(0, job.refundedCredits ?? 0)\n  const net = Math.max(0, spent - refunded)\n  const phase = aiSiteBuildPhase(job)\n  // What the job made, by its kind; a job that names none is a site's.\n  const subject = !job.kind || job.kind === 'site' ? 'This site' : aiJobKindNoun(job.kind) === 'AI job' ? 'This AI job' : `This ${aiJobKindNoun(job.kind)}`\n  // A failure on our side says so in the words every surface uses (AGL-3596),\n  // from the job's recorded give-back.\n  const refund = phase === 'working' || phase === 'done' ? null : aiJobRefundCopy(job)\n  if (refund && refunded > 0) return refund\n  if (phase === 'done') return `${subject} used ${net} credits.`\n  if (phase === 'working') return `Credits used so far: ${net}`\n  if (refund) return `${subject} used ${net} credits. ${refund}`\n  return net > 0 ? `${subject} used ${net} credits.` : null\n}\n\n/** The heading and the sentence under it, for one job's page in its current phase. */\nexport interface AiJobPageCopy {\n  heading: string\n  lede: string\n}\n\n/**\n * What one job's page says at the top (AGL-3594, AGL-3596). A site job reads\n * as \"Building your site\"; any other kind names what it makes — \"Building\n * your page\" — or, for a kind with no noun, the job itself.\n *\n * A guided site start publishes its pages when it finishes, and says so\n * (`sitePublish`): with a page live the heading is \"Your site is live\". A\n * done site job without that record — an older job, or one that was not a\n * guided start — built drafts, and says that instead.\n */\nexport function aiJobPageCopy(\n  job: Pick<AiJobSummary, 'kind' | 'status' | 'review' | 'error'> & Partial<Pick<AiJobSummary, 'sitePublish'>>,\n  brand: string,\n): AiJobPageCopy {\n  const phase = aiSiteBuildPhase(job)\n  const noun = job.kind === 'site' ? 'site' : aiJobKindNoun(job.kind)\n  const generic = noun === 'AI job'\n  // `products` is the one plural noun.\n  const isAre = noun.endsWith('s') ? 'are' : 'is'\n  const why = job.review?.message ?? job.error ?? null\n  if (phase === 'working') {\n    return {\n      heading: generic ? 'Your AI job is running' : `Building your ${noun}`,\n      lede:\n        job.kind === 'site'\n          ? `${brand} AI is planning your pages and writing each one. You can leave this page; it keeps going.`\n          : `${brand} AI is working on it. You can leave this page; it keeps going.`,\n    }\n  }\n  if (phase === 'done') {\n    const published = job.sitePublish?.published.length ?? 0\n    if (job.kind === 'site' && published > 0) {\n      return {\n        heading: 'Your site is live',\n        lede: job.sitePublish?.drafts.length\n          ? 'Your pages are published, except the ones listed below, which stayed drafts.'\n          : 'Your pages are published, and anyone can visit your site now.',\n      }\n    }\n    if (job.kind === 'site' && job.sitePublish) {\n      return {\n        heading: 'Your site is ready',\n        lede: 'None of your new pages could be published, so they are drafts. The reasons are below.',\n      }\n    }\n    return {\n      heading: generic ? 'Your AI job finished' : `Your ${noun} ${isAre} ready`,\n      lede:\n        job.kind === 'site'\n          ? 'Your new pages are drafts. Publish them when you’re happy.'\n          : 'Everything it built is an unpublished draft until you publish it.',\n    }\n  }\n  if (phase === 'canceled') {\n    return { heading: generic ? 'Your AI job was canceled' : `Your ${noun} was not built`, lede: 'The job was canceled.' }\n  }\n  return {\n    heading: generic ? 'Your AI job stopped' : `Your ${noun} ${noun.endsWith('s') ? 'were' : 'was'} not built`,\n    lede: why ?? (generic ? 'Something went wrong running this job.' : `Something went wrong building your ${noun}.`),\n  }\n}\n"],"names":["aiJobKindNoun","aiJobRefundCopy","aiSiteBuildPhase","job","status","CREATION_ROWS","kind","resource","label","name","aiSiteBuildRows","built","phase","planStep","steps","find","step","planDone","Boolean","plan","stopped","rows","id","state","Map","output","outputs","set","get","take","left","stages","row","creation","create","entry","push","pages","screens","forEach","page","index","length","title","reached","stage","done","current","aiSiteBuildCreditsLine","spent","Math","max","creditsSpent","refunded","refundedCredits","net","subject","refund","aiJobPageCopy","brand","noun","generic","isAre","endsWith","why","review","message","error","heading","lede","published","sitePublish","drafts"],"mappings":"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"}

package/src/lib/model/ai-site-start-seo.d.ts

@@ -94,6 +94,22 @@ export declare function aiSiteSeoTitle(input: {
     subject: string;
     city?: string;
 }): string;
+/**
+ * The site's search description (AGL-3596): what the site is, then who it is
+ * for, composed WITHIN the description cap at phrase boundaries rather than
+ * cut at it. Cut at 155 characters, "…for dog owners in Hillside and nearby
+ * towns who want a calm, gentle" went out as a site's description. So the
+ * longest whole composition that fits wins: all of both; the audience without
+ * its trailing clauses; what the site is alone; then what the site is, cut
+ * back the same way. Only when not even the subject fits is it clipped at a
+ * word, never on a dangling one.
+ */
+export declare function aiSiteSeoDescription(input: {
+    name: string;
+    subject: string;
+    about: string;
+    audience: string;
+}): string;
 /**
  * What the listing is built from: either answer may be missing, because the
  * guided start requires only the first of them.