@aglyn/plugins-ai 1.0.0-beta.219 → 1.0.0-beta.220

package/src/lib/jobs/ai-workflow-records.js

@@ -15,11 +15,10 @@
  * limitations under the License.
  */ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { actionRunResult } from "@aglyn/aglyn/app-utils/activity-presenter";
-import { datasetDisplayName } from "@aglyn/aglyn/app-utils/datasets";
 import { isFormArchived } from "@aglyn/aglyn/app-utils/forms";
 import { pluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
-import { campaignPlacedOnHost } from "@aglyn/shared-ui-email-campaigns/model/campaign-container";
-import { scopedToHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { visibleToHost } from "@aglyn/aglyn/app-utils/scope-tokens";
+import { listOrgContainers } from "@aglyn/tenant-data-admin/server/org-containers";
 /** Records of one kind a lookup reads: the Actions editor's picker window. */ export const AI_WORKFLOW_RECORDS_WINDOW = 100;
 /** Pipelines a stage lookup reads. */ export const AI_WORKFLOW_PIPELINES_WINDOW = 20;
 function text(value) {
@@ -39,16 +38,22 @@ async function named(query, fields, keep, nameOf) {
         })).filter((record)=>record.name);
 }
 const live = (data)=>data['deletedAt'] == null;
+/** The org's live campaigns placed on the site, named, in the editor's window. */ async function placedCampaigns(firestore, orgId, hostId) {
+    const containers = await listOrgContainers(firestore, 'campaign', orgId, AI_WORKFLOW_RECORDS_WINDOW);
+    return containers.filter((container)=>container.live && container.name && visibleToHost(container.visibleTo, hostId)).map((container)=>({
+            id: container.id,
+            name: container.name
+        }));
+}
 /**
  * The live records of a kind another plugin keeps, through its index, in the
  * editor's window; none where no plugin keeps the kind here.
- */ async function indexed(kind, hostId, keep = ()=>true) {
+ */ async function indexed(kind, scope, keep = ()=>true) {
     const owner = pluginRecordIndex(kind);
     if (!owner) return [];
-    const { records } = await owner.index.list({
-        hostId,
+    const { records } = await owner.index.list(_extends({}, scope, {
         limit: AI_WORKFLOW_RECORDS_WINDOW
-    });
+    }));
     return records.filter(keep).map(({ id, name })=>({
             id,
             name
@@ -81,28 +86,27 @@ const live = (data)=>data['deletedAt'] == null;
     const none = Promise.resolve([]);
     const [forms, datasets, lists, campaigns, workflows, webhooks, stages] = await Promise.all([
         !wanted('forms') ? Promise.resolve([]) : readForms(host),
-        !wanted('datasets') ? none : named(scopedToHost(org.collection('datasets'), input.hostId), [
-            'displayName',
-            'name',
-            'deletedAt'
-        ], live, (data, id)=>datasetDisplayName(data) || id),
+        // The org's datasets shared with this site, as the data plugin indexes them.
+        !wanted('datasets') ? none : indexed('dataset', {
+            orgId: input.orgId,
+            hostId: input.hostId
+        }),
         !wanted('lists') ? none : named(org.collection('lists'), [
             'name',
             'deletedAt'
         ], live, (data)=>text(data['name'])),
         // The org's campaigns placed on this site: the set the automation's
-        // `assignCampaign` step accepts when it runs here.
-        !wanted('campaigns') ? none : named(org.collection('emailCampaigns'), [
-            'name',
-            'deletedAt',
-            'visibleTo'
-        ], (data)=>live(data) && campaignPlacedOnHost({
-                visibleTo: data['visibleTo']
-            }, input.hostId), (data)=>text(data['name'])),
-        !wanted('workflows') ? none : indexed('workflow', input.hostId),
+        // `assignCampaign` step accepts when it runs here. Read as the `campaign`
+        // container kind, where its declaration says the containers are stored.
+        !wanted('campaigns') ? none : placedCampaigns(firestore, input.orgId, input.hostId),
+        !wanted('workflows') ? none : indexed('workflow', {
+            hostId: input.hostId
+        }),
         // Only a webhook that posts OUT is a step's target; an inbound one is an
         // endpoint that runs a workflow.
-        !wanted('webhooks') ? none : indexed('webhook', input.hostId, (record)=>record.facts['direction'] === 'outbound'),
+        !wanted('webhooks') ? none : indexed('webhook', {
+            hostId: input.hostId
+        }, (record)=>record.facts['direction'] === 'outbound'),
         input.crm && wanted('stages') ? readStages(input.orgId, input.hostId) : none
     ]);
     return {

package/src/lib/jobs/ai-workflow-records.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-workflow-records.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 { HostAction } from '@aglyn/aglyn/app-utils/actions'\nimport { actionRunResult } from '@aglyn/aglyn/app-utils/activity-presenter'\nimport { datasetDisplayName } from '@aglyn/aglyn/app-utils/datasets'\nimport { isFormArchived } from '@aglyn/aglyn/app-utils/forms'\nimport {\n  pluginRecordIndex,\n  type PluginIndexedRecord,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { campaignPlacedOnHost } from '@aglyn/shared-ui-email-campaigns/model/campaign-container'\nimport { scopedToHost } from '@aglyn/tenant-data-admin/server/organizations'\nimport type {\n  AiAutomationForm,\n  AiAutomationNamedRecord,\n  AiAutomationRecords,\n} from '../model/ai-automation-draft'\nimport type { AiIndexedWorkflow, AiRunRecord } from '../model/ai-automation-outline'\nimport type { AiWorkflowTargetType } from '../model/ai-workflow-job'\n\n/**\n * What a `workflow` job reads (AGL-2919), scoped to the job's own site and\n * org: the records a drafted automation's words are looked up among, the\n * automation an explanation reads, and the run it explains. Every read is\n * windowed the way the Actions editor's pickers are, so a lookup never reads\n * more than the editor would offer.\n *\n * The site's workflows, webhooks and saved actions are the workflows plugin's\n * records, so they are read through the indexes that plugin publishes\n * (`workflow`, `webhook`, `action` — AGL-3080), never from its collections:\n * where no plugin keeps a kind, there are none to name. The rest are read\n * through the Admin SDK as projections of the fields named here.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Data = Record<string, unknown>\n\n/** Records of one kind a lookup reads: the Actions editor's picker window. */\nexport const AI_WORKFLOW_RECORDS_WINDOW = 100\n\n/** Pipelines a stage lookup reads. */\nexport const AI_WORKFLOW_PIPELINES_WINDOW = 20\n\nfunction text(value: unknown): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\nasync function named(\n  query: FirebaseFirestore.Query,\n  fields: string[],\n  keep: (data: Data) => boolean,\n  nameOf: (data: Data, id: string) => string,\n): Promise<AiAutomationNamedRecord[]> {\n  const snapshot = await query\n    .select(...fields)\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .map((doc) => ({ data: (doc.data() ?? {}) as Data, id: doc.id }))\n    .filter(({ data }) => keep(data))\n    .map(({ data, id }) => ({ id, name: nameOf(data, id) }))\n    .filter((record) => record.name)\n}\n\nconst live = (data: Data) => data['deletedAt'] == null\n\n/**\n * The live records of a kind another plugin keeps, through its index, in the\n * editor's window; none where no plugin keeps the kind here.\n */\nasync function indexed(\n  kind: string,\n  hostId: string,\n  keep: (record: PluginIndexedRecord) => boolean = () => true,\n): Promise<AiAutomationNamedRecord[]> {\n  const owner = pluginRecordIndex(kind)\n  if (!owner) return []\n  const { records } = await owner.index.list({ hostId, limit: AI_WORKFLOW_RECORDS_WINDOW })\n  return records.filter(keep).map(({ id, name }) => ({ id, name }))\n}\n\n/** The site's forms that are not archived, with the field names their submissions carry. */\nasync function readForms(host: FirebaseFirestore.DocumentReference): Promise<AiAutomationForm[]> {\n  const snapshot = await host\n    .collection('forms')\n    .select('displayName', 'slug', 'fields', 'archivedAt')\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .filter((doc) => !isFormArchived((doc.data() ?? {}) as { archivedAt?: unknown }))\n    .map((doc) => {\n      const data = (doc.data() ?? {}) as Data\n      return {\n        id: doc.id,\n        name: text(data['displayName']) || text(data['slug']) || doc.id,\n        fields: (Array.isArray(data['fields']) ? (data['fields'] as Data[]) : [])\n          .map((field) => text(field?.['fieldName']))\n          .filter(Boolean),\n      }\n    })\n}\n\n/**\n * The site's records a drafted automation may name. Stages are read only for\n * a workspace with the CRM, whose pipelines they are; a site without it has\n * no stage a condition could name. `only`, when given, names the kinds to\n * read, and every other kind is answered empty without a read.\n */\nexport async function readAiAutomationRecords(\n  firestore: Firestore,\n  input: { orgId: string; hostId: string; crm: boolean; only?: ReadonlyArray<keyof AiAutomationRecords> },\n): Promise<AiAutomationRecords> {\n  const host = firestore.collection('hosts').doc(input.hostId)\n  const org = firestore.collection('orgs').doc(input.orgId)\n  const wanted = (kind: keyof AiAutomationRecords) => !input.only || input.only.includes(kind)\n  const none = Promise.resolve([] as AiAutomationNamedRecord[])\n  const [forms, datasets, lists, campaigns, workflows, webhooks, stages] = await Promise.all([\n    !wanted('forms') ? Promise.resolve([] as AiAutomationForm[]) : readForms(host),\n    !wanted('datasets')\n      ? none\n      : named(\n          scopedToHost(org.collection('datasets'), input.hostId),\n          ['displayName', 'name', 'deletedAt'],\n          live,\n          (data, id) => datasetDisplayName(data) || id,\n        ),\n    !wanted('lists') ? none : named(org.collection('lists'), ['name', 'deletedAt'], live, (data) => text(data['name'])),\n    // The org's campaigns placed on this site: the set the automation's\n    // `assignCampaign` step accepts when it runs here.\n    !wanted('campaigns')\n      ? none\n      : named(\n          org.collection('emailCampaigns'),\n          ['name', 'deletedAt', 'visibleTo'],\n          (data) =>\n            live(data) &&\n            campaignPlacedOnHost({ visibleTo: data['visibleTo'] as string[] | undefined }, input.hostId),\n          (data) => text(data['name']),\n        ),\n    !wanted('workflows') ? none : indexed('workflow', input.hostId),\n    // Only a webhook that posts OUT is a step's target; an inbound one is an\n    // endpoint that runs a workflow.\n    !wanted('webhooks')\n      ? none\n      : indexed('webhook', input.hostId, (record) => record.facts['direction'] === 'outbound'),\n    input.crm && wanted('stages') ? readStages(input.orgId, input.hostId) : none,\n  ])\n  return { forms, datasets, lists, campaigns, workflows, webhooks, stages }\n}\n\n/**\n * The stages of the pipelines the site can see, asked of the plugin that keeps\n * pipelines (its `pipeline` record index), never read from its collection. No\n * index means no plugin keeps pipelines in this process: no stage to name.\n */\nasync function readStages(orgId: string, hostId: string): Promise<AiAutomationNamedRecord[]> {\n  const pipelines = pluginRecordIndex('pipeline')\n  if (!pipelines) return []\n  const { records } = await pipelines.index.list({ orgId, hostId, limit: AI_WORKFLOW_PIPELINES_WINDOW })\n  return records\n    .flatMap((record) => (Array.isArray(record.facts['stages']) ? (record.facts['stages'] as Data[]) : []))\n    .map((stage) => ({ id: text(stage?.['id']), name: text(stage?.['name']) }))\n    .filter((stage) => stage.id && stage.name)\n}\n\n/** The site's functions, for a workflow outline that says which of its calls still resolve. */\nexport async function readAiWorkflowFunctions(\n  firestore: Firestore,\n  hostId: string,\n): Promise<AiAutomationNamedRecord[]> {\n  return named(\n    firestore.collection('hosts').doc(hostId).collection('functions'),\n    ['name', 'deletedAt'],\n    live,\n    (data) => text(data['name']),\n  )\n}\n\nexport type AiWorkflowTarget =\n  | { type: 'action'; id: string; name: string; action: HostAction }\n  | { type: 'workflow'; id: string; name: string; workflow: AiIndexedWorkflow }\n\n/**\n * A saved automation of the site, read through the index of the plugin that\n * keeps it, or `null` for one that does not exist, was deleted, or that no\n * plugin here keeps.\n */\nexport async function readAiWorkflowTarget(\n  input: { hostId: string; type: AiWorkflowTargetType; id: string },\n): Promise<AiWorkflowTarget | null> {\n  const owner = pluginRecordIndex(input.type)\n  const record = owner ? await owner.index.get({ hostId: input.hostId, id: input.id }) : null\n  if (!record) return null\n  const stored = { name: record.name, ...record.facts }\n  return input.type === 'action'\n    ? { type: 'action', id: record.id, name: record.name, action: stored as unknown as HostAction }\n    : { type: 'workflow', id: record.id, name: record.name, workflow: stored as unknown as AiIndexedWorkflow }\n}\n\nexport type AiWorkflowRunRead =\n  | { ok: true; run: AiRunRecord }\n  | { ok: false; reason: 'gone' | 'not-failed' }\n\n/**\n * One run of an automation, as the site's activity log recorded it: gone when\n * there is no such entry or it belongs to another automation, and refused\n * when it did not fail. Only what the run history shows is read — never the\n * event's payload.\n */\nexport async function readAiWorkflowRun(\n  firestore: Firestore,\n  input: { hostId: string; targetId: string; runId: string },\n): Promise<AiWorkflowRunRead> {\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(input.hostId)\n    .collection('activity')\n    .doc(input.runId)\n    .get()\n  const data = snapshot.exists ? ((snapshot.data() ?? {}) as Data) : null\n  const target = data?.['target'] as { id?: unknown } | undefined\n  if (!data || target?.id !== input.targetId) return { ok: false, reason: 'gone' }\n  const run: AiRunRecord = {\n    result: data['result'],\n    trigger: data['trigger'],\n    summary: data['summary'],\n    action: data['action'],\n    createdAt: data['createdAt'],\n  }\n  return actionRunResult(run as never) === 'failed' ? { ok: true, run } : { ok: false, reason: 'not-failed' }\n}\n"],"names":["actionRunResult","datasetDisplayName","isFormArchived","pluginRecordIndex","campaignPlacedOnHost","scopedToHost","AI_WORKFLOW_RECORDS_WINDOW","AI_WORKFLOW_PIPELINES_WINDOW","text","value","trim","named","query","fields","keep","nameOf","snapshot","select","limit","get","docs","map","doc","data","id","filter","name","record","live","indexed","kind","hostId","owner","records","index","list","readForms","host","collection","Array","isArray","field","Boolean","readAiAutomationRecords","firestore","input","org","orgId","wanted","only","includes","none","Promise","resolve","forms","datasets","lists","campaigns","workflows","webhooks","stages","all","visibleTo","facts","crm","readStages","pipelines","flatMap","stage","readAiWorkflowFunctions","readAiWorkflowTarget","type","stored","action","workflow","readAiWorkflowRun","runId","exists","target","targetId","ok","reason","run","result","trigger","summary","createdAt"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-workflow-records.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 { HostAction } from '@aglyn/aglyn/app-utils/actions'\nimport { actionRunResult } from '@aglyn/aglyn/app-utils/activity-presenter'\nimport { isFormArchived } from '@aglyn/aglyn/app-utils/forms'\nimport {\n  pluginRecordIndex,\n  type PluginIndexedRecord,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { visibleToHost } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport { listOrgContainers } from '@aglyn/tenant-data-admin/server/org-containers'\nimport type {\n  AiAutomationForm,\n  AiAutomationNamedRecord,\n  AiAutomationRecords,\n} from '../model/ai-automation-draft'\nimport type { AiIndexedWorkflow, AiRunRecord } from '../model/ai-automation-outline'\nimport type { AiWorkflowTargetType } from '../model/ai-workflow-job'\n\n/**\n * What a `workflow` job reads (AGL-2919), scoped to the job's own site and\n * org: the records a drafted automation's words are looked up among, the\n * automation an explanation reads, and the run it explains. Every read is\n * windowed the way the Actions editor's pickers are, so a lookup never reads\n * more than the editor would offer.\n *\n * The site's workflows, webhooks and saved actions are the workflows plugin's\n * records, and the org's datasets the data plugin's, so they are read through\n * the indexes those plugins publish (`workflow`, `webhook`, `action`,\n * `dataset` — AGL-3080), never from their collections: where no plugin keeps a\n * kind, there are none to name. The rest are read through the Admin SDK as\n * projections of the fields named here.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Data = Record<string, unknown>\n\n/** Records of one kind a lookup reads: the Actions editor's picker window. */\nexport const AI_WORKFLOW_RECORDS_WINDOW = 100\n\n/** Pipelines a stage lookup reads. */\nexport const AI_WORKFLOW_PIPELINES_WINDOW = 20\n\nfunction text(value: unknown): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\nasync function named(\n  query: FirebaseFirestore.Query,\n  fields: string[],\n  keep: (data: Data) => boolean,\n  nameOf: (data: Data, id: string) => string,\n): Promise<AiAutomationNamedRecord[]> {\n  const snapshot = await query\n    .select(...fields)\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .map((doc) => ({ data: (doc.data() ?? {}) as Data, id: doc.id }))\n    .filter(({ data }) => keep(data))\n    .map(({ data, id }) => ({ id, name: nameOf(data, id) }))\n    .filter((record) => record.name)\n}\n\nconst live = (data: Data) => data['deletedAt'] == null\n\n/** The org's live campaigns placed on the site, named, in the editor's window. */\nasync function placedCampaigns(\n  firestore: Firestore,\n  orgId: string,\n  hostId: string,\n): Promise<AiAutomationNamedRecord[]> {\n  const containers = await listOrgContainers(firestore, 'campaign', orgId, AI_WORKFLOW_RECORDS_WINDOW)\n  return containers\n    .filter((container) => container.live && container.name && visibleToHost(container.visibleTo, hostId))\n    .map((container) => ({ id: container.id, name: container.name }))\n}\n\n/**\n * The live records of a kind another plugin keeps, through its index, in the\n * editor's window; none where no plugin keeps the kind here.\n */\nasync function indexed(\n  kind: string,\n  scope: { orgId?: string; hostId: string },\n  keep: (record: PluginIndexedRecord) => boolean = () => true,\n): Promise<AiAutomationNamedRecord[]> {\n  const owner = pluginRecordIndex(kind)\n  if (!owner) return []\n  const { records } = await owner.index.list({ ...scope, limit: AI_WORKFLOW_RECORDS_WINDOW })\n  return records.filter(keep).map(({ id, name }) => ({ id, name }))\n}\n\n/** The site's forms that are not archived, with the field names their submissions carry. */\nasync function readForms(host: FirebaseFirestore.DocumentReference): Promise<AiAutomationForm[]> {\n  const snapshot = await host\n    .collection('forms')\n    .select('displayName', 'slug', 'fields', 'archivedAt')\n    .limit(AI_WORKFLOW_RECORDS_WINDOW)\n    .get()\n  return snapshot.docs\n    .filter((doc) => !isFormArchived((doc.data() ?? {}) as { archivedAt?: unknown }))\n    .map((doc) => {\n      const data = (doc.data() ?? {}) as Data\n      return {\n        id: doc.id,\n        name: text(data['displayName']) || text(data['slug']) || doc.id,\n        fields: (Array.isArray(data['fields']) ? (data['fields'] as Data[]) : [])\n          .map((field) => text(field?.['fieldName']))\n          .filter(Boolean),\n      }\n    })\n}\n\n/**\n * The site's records a drafted automation may name. Stages are read only for\n * a workspace with the CRM, whose pipelines they are; a site without it has\n * no stage a condition could name. `only`, when given, names the kinds to\n * read, and every other kind is answered empty without a read.\n */\nexport async function readAiAutomationRecords(\n  firestore: Firestore,\n  input: { orgId: string; hostId: string; crm: boolean; only?: ReadonlyArray<keyof AiAutomationRecords> },\n): Promise<AiAutomationRecords> {\n  const host = firestore.collection('hosts').doc(input.hostId)\n  const org = firestore.collection('orgs').doc(input.orgId)\n  const wanted = (kind: keyof AiAutomationRecords) => !input.only || input.only.includes(kind)\n  const none = Promise.resolve([] as AiAutomationNamedRecord[])\n  const [forms, datasets, lists, campaigns, workflows, webhooks, stages] = await Promise.all([\n    !wanted('forms') ? Promise.resolve([] as AiAutomationForm[]) : readForms(host),\n    // The org's datasets shared with this site, as the data plugin indexes them.\n    !wanted('datasets') ? none : indexed('dataset', { orgId: input.orgId, hostId: input.hostId }),\n    !wanted('lists') ? none : named(org.collection('lists'), ['name', 'deletedAt'], live, (data) => text(data['name'])),\n    // The org's campaigns placed on this site: the set the automation's\n    // `assignCampaign` step accepts when it runs here. Read as the `campaign`\n    // container kind, where its declaration says the containers are stored.\n    !wanted('campaigns') ? none : placedCampaigns(firestore, input.orgId, input.hostId),\n    !wanted('workflows') ? none : indexed('workflow', { hostId: input.hostId }),\n    // Only a webhook that posts OUT is a step's target; an inbound one is an\n    // endpoint that runs a workflow.\n    !wanted('webhooks')\n      ? none\n      : indexed('webhook', { hostId: input.hostId }, (record) => record.facts['direction'] === 'outbound'),\n    input.crm && wanted('stages') ? readStages(input.orgId, input.hostId) : none,\n  ])\n  return { forms, datasets, lists, campaigns, workflows, webhooks, stages }\n}\n\n/**\n * The stages of the pipelines the site can see, asked of the plugin that keeps\n * pipelines (its `pipeline` record index), never read from its collection. No\n * index means no plugin keeps pipelines in this process: no stage to name.\n */\nasync function readStages(orgId: string, hostId: string): Promise<AiAutomationNamedRecord[]> {\n  const pipelines = pluginRecordIndex('pipeline')\n  if (!pipelines) return []\n  const { records } = await pipelines.index.list({ orgId, hostId, limit: AI_WORKFLOW_PIPELINES_WINDOW })\n  return records\n    .flatMap((record) => (Array.isArray(record.facts['stages']) ? (record.facts['stages'] as Data[]) : []))\n    .map((stage) => ({ id: text(stage?.['id']), name: text(stage?.['name']) }))\n    .filter((stage) => stage.id && stage.name)\n}\n\n/** The site's functions, for a workflow outline that says which of its calls still resolve. */\nexport async function readAiWorkflowFunctions(\n  firestore: Firestore,\n  hostId: string,\n): Promise<AiAutomationNamedRecord[]> {\n  return named(\n    firestore.collection('hosts').doc(hostId).collection('functions'),\n    ['name', 'deletedAt'],\n    live,\n    (data) => text(data['name']),\n  )\n}\n\nexport type AiWorkflowTarget =\n  | { type: 'action'; id: string; name: string; action: HostAction }\n  | { type: 'workflow'; id: string; name: string; workflow: AiIndexedWorkflow }\n\n/**\n * A saved automation of the site, read through the index of the plugin that\n * keeps it, or `null` for one that does not exist, was deleted, or that no\n * plugin here keeps.\n */\nexport async function readAiWorkflowTarget(\n  input: { hostId: string; type: AiWorkflowTargetType; id: string },\n): Promise<AiWorkflowTarget | null> {\n  const owner = pluginRecordIndex(input.type)\n  const record = owner ? await owner.index.get({ hostId: input.hostId, id: input.id }) : null\n  if (!record) return null\n  const stored = { name: record.name, ...record.facts }\n  return input.type === 'action'\n    ? { type: 'action', id: record.id, name: record.name, action: stored as unknown as HostAction }\n    : { type: 'workflow', id: record.id, name: record.name, workflow: stored as unknown as AiIndexedWorkflow }\n}\n\nexport type AiWorkflowRunRead =\n  | { ok: true; run: AiRunRecord }\n  | { ok: false; reason: 'gone' | 'not-failed' }\n\n/**\n * One run of an automation, as the site's activity log recorded it: gone when\n * there is no such entry or it belongs to another automation, and refused\n * when it did not fail. Only what the run history shows is read — never the\n * event's payload.\n */\nexport async function readAiWorkflowRun(\n  firestore: Firestore,\n  input: { hostId: string; targetId: string; runId: string },\n): Promise<AiWorkflowRunRead> {\n  const snapshot = await firestore\n    .collection('hosts')\n    .doc(input.hostId)\n    .collection('activity')\n    .doc(input.runId)\n    .get()\n  const data = snapshot.exists ? ((snapshot.data() ?? {}) as Data) : null\n  const target = data?.['target'] as { id?: unknown } | undefined\n  if (!data || target?.id !== input.targetId) return { ok: false, reason: 'gone' }\n  const run: AiRunRecord = {\n    result: data['result'],\n    trigger: data['trigger'],\n    summary: data['summary'],\n    action: data['action'],\n    createdAt: data['createdAt'],\n  }\n  return actionRunResult(run as never) === 'failed' ? { ok: true, run } : { ok: false, reason: 'not-failed' }\n}\n"],"names":["actionRunResult","isFormArchived","pluginRecordIndex","visibleToHost","listOrgContainers","AI_WORKFLOW_RECORDS_WINDOW","AI_WORKFLOW_PIPELINES_WINDOW","text","value","trim","named","query","fields","keep","nameOf","snapshot","select","limit","get","docs","map","doc","data","id","filter","name","record","live","placedCampaigns","firestore","orgId","hostId","containers","container","visibleTo","indexed","kind","scope","owner","records","index","list","readForms","host","collection","Array","isArray","field","Boolean","readAiAutomationRecords","input","org","wanted","only","includes","none","Promise","resolve","forms","datasets","lists","campaigns","workflows","webhooks","stages","all","facts","crm","readStages","pipelines","flatMap","stage","readAiWorkflowFunctions","readAiWorkflowTarget","type","stored","action","workflow","readAiWorkflowRun","runId","exists","target","targetId","ok","reason","run","result","trigger","summary","createdAt"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SAASA,eAAe,QAAQ,4CAA2C;AAC3E,SAASC,cAAc,QAAQ,+BAA8B;AAC7D,SACEC,iBAAiB,QAEZ,kDAAiD;AACxD,SAASC,aAAa,QAAQ,sCAAqC;AACnE,SAASC,iBAAiB,QAAQ,iDAAgD;AA2BlF,4EAA4E,GAC5E,OAAO,MAAMC,6BAA6B,IAAG;AAE7C,oCAAoC,GACpC,OAAO,MAAMC,+BAA+B,GAAE;AAE9C,SAASC,KAAKC,KAAc;IAC1B,OAAO,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;AACpD;AAEA,eAAeC,MACbC,KAA8B,EAC9BC,MAAgB,EAChBC,IAA6B,EAC7BC,MAA0C;IAE1C,MAAMC,WAAW,MAAMJ,MACpBK,MAAM,IAAIJ,QACVK,KAAK,CAACZ,4BACNa,GAAG;IACN,OAAOH,SAASI,IAAI,CACjBC,GAAG,CAAC,CAACC;YAAkBA;eAAT;YAAEC,IAAI,GAAGD,YAAAA,IAAIC,IAAI,cAARD,YAAc,CAAC;YAAYE,IAAIF,IAAIE,EAAE;QAAC;OAC7DC,MAAM,CAAC,CAAC,EAAEF,IAAI,EAAE,GAAKT,KAAKS,OAC1BF,GAAG,CAAC,CAAC,EAAEE,IAAI,EAAEC,EAAE,EAAE,GAAM,CAAA;YAAEA;YAAIE,MAAMX,OAAOQ,MAAMC;QAAI,CAAA,GACpDC,MAAM,CAAC,CAACE,SAAWA,OAAOD,IAAI;AACnC;AAEA,MAAME,OAAO,CAACL,OAAeA,IAAI,CAAC,YAAY,IAAI;AAElD,gFAAgF,GAChF,eAAeM,gBACbC,SAAoB,EACpBC,KAAa,EACbC,MAAc;IAEd,MAAMC,aAAa,MAAM5B,kBAAkByB,WAAW,YAAYC,OAAOzB;IACzE,OAAO2B,WACJR,MAAM,CAAC,CAACS,YAAcA,UAAUN,IAAI,IAAIM,UAAUR,IAAI,IAAItB,cAAc8B,UAAUC,SAAS,EAAEH,SAC7FX,GAAG,CAAC,CAACa,YAAe,CAAA;YAAEV,IAAIU,UAAUV,EAAE;YAAEE,MAAMQ,UAAUR,IAAI;QAAC,CAAA;AAClE;AAEA;;;CAGC,GACD,eAAeU,QACbC,IAAY,EACZC,KAAyC,EACzCxB,OAAiD,IAAM,IAAI;IAE3D,MAAMyB,QAAQpC,kBAAkBkC;IAChC,IAAI,CAACE,OAAO,OAAO,EAAE;IACrB,MAAM,EAAEC,OAAO,EAAE,GAAG,MAAMD,MAAME,KAAK,CAACC,IAAI,CAAC,aAAKJ;QAAOpB,OAAOZ;;IAC9D,OAAOkC,QAAQf,MAAM,CAACX,MAAMO,GAAG,CAAC,CAAC,EAAEG,EAAE,EAAEE,IAAI,EAAE,GAAM,CAAA;YAAEF;YAAIE;QAAK,CAAA;AAChE;AAEA,0FAA0F,GAC1F,eAAeiB,UAAUC,IAAyC;IAChE,MAAM5B,WAAW,MAAM4B,KACpBC,UAAU,CAAC,SACX5B,MAAM,CAAC,eAAe,QAAQ,UAAU,cACxCC,KAAK,CAACZ,4BACNa,GAAG;IACN,OAAOH,SAASI,IAAI,CACjBK,MAAM,CAAC,CAACH;YAAyBA;eAAjB,CAACpB,gBAAgBoB,YAAAA,IAAIC,IAAI,cAARD,YAAc,CAAC;OAChDD,GAAG,CAAC,CAACC;YACUA;QAAd,MAAMC,QAAQD,YAAAA,IAAIC,IAAI,cAARD,YAAc,CAAC;QAC7B,OAAO;YACLE,IAAIF,IAAIE,EAAE;YACVE,MAAMlB,KAAKe,IAAI,CAAC,cAAc,KAAKf,KAAKe,IAAI,CAAC,OAAO,KAAKD,IAAIE,EAAE;YAC/DX,QAAQ,AAACiC,CAAAA,MAAMC,OAAO,CAACxB,IAAI,CAAC,SAAS,IAAKA,IAAI,CAAC,SAAS,GAAc,EAAE,AAAD,EACpEF,GAAG,CAAC,CAAC2B,QAAUxC,KAAKwC,yBAAAA,KAAO,CAAC,YAAY,GACxCvB,MAAM,CAACwB;QACZ;IACF;AACJ;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,wBACpBpB,SAAoB,EACpBqB,KAAuG;IAEvG,MAAMP,OAAOd,UAAUe,UAAU,CAAC,SAASvB,GAAG,CAAC6B,MAAMnB,MAAM;IAC3D,MAAMoB,MAAMtB,UAAUe,UAAU,CAAC,QAAQvB,GAAG,CAAC6B,MAAMpB,KAAK;IACxD,MAAMsB,SAAS,CAAChB,OAAoC,CAACc,MAAMG,IAAI,IAAIH,MAAMG,IAAI,CAACC,QAAQ,CAAClB;IACvF,MAAMmB,OAAOC,QAAQC,OAAO,CAAC,EAAE;IAC/B,MAAM,CAACC,OAAOC,UAAUC,OAAOC,WAAWC,WAAWC,UAAUC,OAAO,GAAG,MAAMR,QAAQS,GAAG,CAAC;QACzF,CAACb,OAAO,WAAWI,QAAQC,OAAO,CAAC,EAAE,IAA0Bf,UAAUC;QACzE,6EAA6E;QAC7E,CAACS,OAAO,cAAcG,OAAOpB,QAAQ,WAAW;YAAEL,OAAOoB,MAAMpB,KAAK;YAAEC,QAAQmB,MAAMnB,MAAM;QAAC;QAC3F,CAACqB,OAAO,WAAWG,OAAO7C,MAAMyC,IAAIP,UAAU,CAAC,UAAU;YAAC;YAAQ;SAAY,EAAEjB,MAAM,CAACL,OAASf,KAAKe,IAAI,CAAC,OAAO;QACjH,oEAAoE;QACpE,0EAA0E;QAC1E,wEAAwE;QACxE,CAAC8B,OAAO,eAAeG,OAAO3B,gBAAgBC,WAAWqB,MAAMpB,KAAK,EAAEoB,MAAMnB,MAAM;QAClF,CAACqB,OAAO,eAAeG,OAAOpB,QAAQ,YAAY;YAAEJ,QAAQmB,MAAMnB,MAAM;QAAC;QACzE,yEAAyE;QACzE,iCAAiC;QACjC,CAACqB,OAAO,cACJG,OACApB,QAAQ,WAAW;YAAEJ,QAAQmB,MAAMnB,MAAM;QAAC,GAAG,CAACL,SAAWA,OAAOwC,KAAK,CAAC,YAAY,KAAK;QAC3FhB,MAAMiB,GAAG,IAAIf,OAAO,YAAYgB,WAAWlB,MAAMpB,KAAK,EAAEoB,MAAMnB,MAAM,IAAIwB;KACzE;IACD,OAAO;QAAEG;QAAOC;QAAUC;QAAOC;QAAWC;QAAWC;QAAUC;IAAO;AAC1E;AAEA;;;;CAIC,GACD,eAAeI,WAAWtC,KAAa,EAAEC,MAAc;IACrD,MAAMsC,YAAYnE,kBAAkB;IACpC,IAAI,CAACmE,WAAW,OAAO,EAAE;IACzB,MAAM,EAAE9B,OAAO,EAAE,GAAG,MAAM8B,UAAU7B,KAAK,CAACC,IAAI,CAAC;QAAEX;QAAOC;QAAQd,OAAOX;IAA6B;IACpG,OAAOiC,QACJ+B,OAAO,CAAC,CAAC5C,SAAYmB,MAAMC,OAAO,CAACpB,OAAOwC,KAAK,CAAC,SAAS,IAAKxC,OAAOwC,KAAK,CAAC,SAAS,GAAc,EAAE,EACpG9C,GAAG,CAAC,CAACmD,QAAW,CAAA;YAAEhD,IAAIhB,KAAKgE,yBAAAA,KAAO,CAAC,KAAK;YAAG9C,MAAMlB,KAAKgE,yBAAAA,KAAO,CAAC,OAAO;QAAE,CAAA,GACvE/C,MAAM,CAAC,CAAC+C,QAAUA,MAAMhD,EAAE,IAAIgD,MAAM9C,IAAI;AAC7C;AAEA,6FAA6F,GAC7F,OAAO,eAAe+C,wBACpB3C,SAAoB,EACpBE,MAAc;IAEd,OAAOrB,MACLmB,UAAUe,UAAU,CAAC,SAASvB,GAAG,CAACU,QAAQa,UAAU,CAAC,cACrD;QAAC;QAAQ;KAAY,EACrBjB,MACA,CAACL,OAASf,KAAKe,IAAI,CAAC,OAAO;AAE/B;AAMA;;;;CAIC,GACD,OAAO,eAAemD,qBACpBvB,KAAiE;IAEjE,MAAMZ,QAAQpC,kBAAkBgD,MAAMwB,IAAI;IAC1C,MAAMhD,SAASY,QAAQ,MAAMA,MAAME,KAAK,CAACtB,GAAG,CAAC;QAAEa,QAAQmB,MAAMnB,MAAM;QAAER,IAAI2B,MAAM3B,EAAE;IAAC,KAAK;IACvF,IAAI,CAACG,QAAQ,OAAO;IACpB,MAAMiD,SAAS;QAAElD,MAAMC,OAAOD,IAAI;OAAKC,OAAOwC,KAAK;IACnD,OAAOhB,MAAMwB,IAAI,KAAK,WAClB;QAAEA,MAAM;QAAUnD,IAAIG,OAAOH,EAAE;QAAEE,MAAMC,OAAOD,IAAI;QAAEmD,QAAQD;IAAgC,IAC5F;QAAED,MAAM;QAAYnD,IAAIG,OAAOH,EAAE;QAAEE,MAAMC,OAAOD,IAAI;QAAEoD,UAAUF;IAAuC;AAC7G;AAMA;;;;;CAKC,GACD,OAAO,eAAeG,kBACpBjD,SAAoB,EACpBqB,KAA0D;QAQzBnC;IANjC,MAAMA,WAAW,MAAMc,UACpBe,UAAU,CAAC,SACXvB,GAAG,CAAC6B,MAAMnB,MAAM,EAChBa,UAAU,CAAC,YACXvB,GAAG,CAAC6B,MAAM6B,KAAK,EACf7D,GAAG;IACN,MAAMI,OAAOP,SAASiE,MAAM,IAAKjE,iBAAAA,SAASO,IAAI,cAAbP,iBAAmB,CAAC,IAAc;IACnE,MAAMkE,SAAS3D,wBAAAA,IAAM,CAAC,SAAS;IAC/B,IAAI,CAACA,QAAQ2D,CAAAA,0BAAAA,OAAQ1D,EAAE,MAAK2B,MAAMgC,QAAQ,EAAE,OAAO;QAAEC,IAAI;QAAOC,QAAQ;IAAO;IAC/E,MAAMC,MAAmB;QACvBC,QAAQhE,IAAI,CAAC,SAAS;QACtBiE,SAASjE,IAAI,CAAC,UAAU;QACxBkE,SAASlE,IAAI,CAAC,UAAU;QACxBsD,QAAQtD,IAAI,CAAC,SAAS;QACtBmE,WAAWnE,IAAI,CAAC,YAAY;IAC9B;IACA,OAAOtB,gBAAgBqF,SAAkB,WAAW;QAAEF,IAAI;QAAME;IAAI,IAAI;QAAEF,IAAI;QAAOC,QAAQ;IAAa;AAC5G"}

package/src/lib/model/ai-allotments.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type AssistRefusedBy } from '@aglyn/aglyn/app-utils/assist-credits';
+import { type AssistRefusedBy } from '../usage/assist-credits';
 /**
  * AI ALLOTMENTS (AGL-2942): the pure half.
  *
@@ -45,7 +45,7 @@ import { type AssistRefusedBy } from '@aglyn/aglyn/app-utils/assist-credits';
  *
  * A HARD allotment refuses the request that finds the subject at or past it.
  * A SOFT one admits it and tells the subject and the workspace's billing
- * contacts at 80% and again at 100%. Both are measured against what the
+ * contacts at 75, 80, 90 and 100%. Both are measured against what the
  * subject already drew this month, before the request — the same shape the
  * band is measured in, so a request that starts under the line may finish
  * past it, and the next one is the one refused.
@@ -202,14 +202,27 @@ export declare function aiAllotmentRefusalText(scope: AiCreditAllotmentScope | n
 /**
  * The words a soft allotment's alert carries, for BOTH channels — the
  * console notification and the email — so the two cannot say different
- * things about one crossing. `name` is the member's name or the site's.
+ * things about one crossing.
+ *
+ * The email is plain text with no heading, so the body opens by saying whose
+ * AI credits, how many of how many, and in which workspace (and on which site,
+ * for a collaborator): a figure on its own reads as a bill. The managers'
+ * copy says how to stop the subject at the line; the person's own copy does
+ * not, because they cannot open Billing.
  */
 export declare function aiAllotmentAlertCopy(input: {
     scope: AiCreditAllotmentScope;
     threshold: AiAllotmentThreshold;
     used: number;
     credits: number;
+    /** The member's name, or the site's for a site allotment. */
     name: string;
+    /** The workspace the allotment is drawn from. */
+    workspace: string;
+    /** The site a collaborator's allotment is on. */
+    site?: string;
+    /** The workspace's managers (the default), or the person it is for. */
+    reader?: 'managers' | 'subject';
 }): {
     title: string;
     body: string;

package/src/lib/model/ai-allotments.js

@@ -13,7 +13,7 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ import { ASSIST_HARD_CAP_CONTROL_LOCATION } from "@aglyn/aglyn/app-utils/assist-credits";
+ */ import { ASSIST_HARD_CAP_CONTROL_LOCATION } from "../usage/assist-credits.js";
 import { ORG_PERMISSIONS } from "@aglyn/aglyn/app-utils/org-permissions";
 /**
  * AI ALLOTMENTS (AGL-2942): the pure half.
@@ -45,7 +45,7 @@ import { ORG_PERMISSIONS } from "@aglyn/aglyn/app-utils/org-permissions";
  *
  * A HARD allotment refuses the request that finds the subject at or past it.
  * A SOFT one admits it and tells the subject and the workspace's billing
- * contacts at 80% and again at 100%. Both are measured against what the
+ * contacts at 75, 80, 90 and 100%. Both are measured against what the
  * subject already drew this month, before the request — the same shape the
  * band is measured in, so a request that starts under the line may finish
  * past it, and the next one is the one refused.
@@ -265,21 +265,44 @@ const scopeRank = (scope)=>SCOPE_ORDER.indexOf(scope);
 /**
  * The words a soft allotment's alert carries, for BOTH channels — the
  * console notification and the email — so the two cannot say different
- * things about one crossing. `name` is the member's name or the site's.
+ * things about one crossing.
+ *
+ * The email is plain text with no heading, so the body opens by saying whose
+ * AI credits, how many of how many, and in which workspace (and on which site,
+ * for a collaborator): a figure on its own reads as a bill. The managers'
+ * copy says how to stop the subject at the line; the person's own copy does
+ * not, because they cannot open Billing.
  */ export function aiAllotmentAlertCopy(input) {
-    const who = input.scope === 'host' ? `The ${input.name} site` : input.name;
-    const whose = input.scope === 'host' ? 'its' : 'their';
-    const where = input.scope === 'collab' ? ' on its site' : '';
-    const figures = `${input.used.toLocaleString('en-US')} of ` + `${input.credits.toLocaleString('en-US')} credits used this month.`;
-    if (input.threshold >= 100) {
+    const { scope, threshold, name, workspace } = input;
+    const used = input.used.toLocaleString('en-US');
+    const credits = input.credits.toLocaleString('en-US');
+    const reached = threshold >= 100;
+    const onSite = scope === 'collab' && input.site ? ` on the ${input.site} site` : '';
+    const amount = reached ? `all ${credits} AI credits` : `${used} of the ${credits} AI credits`;
+    const tail = reached ? ` this month (${used} so far).` : ` this month, past the ${threshold}% mark.`;
+    if (input.reader === 'subject' && scope !== 'host') {
+        const where = scope === 'collab' ? onSite : ` in ${workspace}`;
+        const whoCanChange = scope === 'collab' ? 'The site’s admin or a workspace admin can raise or change it.' : 'A workspace admin can raise or change it.';
+        return {
+            title: reached ? `You’ve used your whole AI allotment${where}` : `You’re past ${threshold}% of your AI allotment${where}`,
+            body: `You’ve used ${amount} ${workspace} allotted you${onSite}${tail} ` + 'It’s a soft allotment, so it does not stop your AI requests.' + (reached ? ` ${whoCanChange}` : '')
+        };
+    }
+    const who = scope === 'host' ? `The ${name} site` : name;
+    const whose = scope === 'host' ? 'its' : 'their';
+    const them = scope === 'host' ? 'it' : 'them';
+    const requests = scope === 'host' ? 'AI requests on the site' : `${name}’s AI requests`;
+    const where = scope === 'collab' ? onSite : scope === 'member' ? ` in ${workspace}` : '';
+    const opening = `${who} has used ${amount} allotted to ${them}${onSite} in ${workspace}${tail}`;
+    if (reached) {
         return {
             title: `${who} has used ${whose} whole AI allotment${where}`,
-            body: `${figures} The allotment is soft, so requests keep working and ` + 'draw on the workspace’s pool. Raise it or make it hard under ' + `${ASSIST_HARD_CAP_CONTROL_LOCATION}.`
+            body: `${opening} It’s a soft allotment, so it does not stop ${requests}; ` + 'they keep drawing on the workspace’s AI credits, and crossing it ' + `charges nothing by itself. To stop ${them} at the line, make it hard ` + `under ${ASSIST_HARD_CAP_CONTROL_LOCATION}; to give ${them} more, ` + 'raise it there.'
         };
     }
     return {
-        title: `${who} is past ${input.threshold}% of ${whose} AI allotment${where}`,
-        body: `${figures} The allotment is soft, so nothing stops at the line.`
+        title: `${who} is past ${threshold}% of ${whose} AI allotment${where}`,
+        body: `${opening} It’s a soft allotment, so it does not stop ${requests}; ` + 'they draw on the workspace’s AI credits like everyone else’s.'
     };
 }
 

package/src/lib/model/ai-allotments.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-allotments.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ASSIST_HARD_CAP_CONTROL_LOCATION,\n  type AssistRefusedBy,\n} from '@aglyn/aglyn/app-utils/assist-credits'\nimport { ORG_PERMISSIONS } from '@aglyn/aglyn/app-utils/org-permissions'\n\n/**\n * AI ALLOTMENTS (AGL-2942): the pure half.\n *\n * The workspace's AI pool is one band. An allotment is a manager's decision\n * about how much of that band one SUBJECT may draw in a calendar month (UTC),\n * so one client site, one contractor or one teammate cannot spend what the\n * others were counting on:\n *\n *   orgs/{orgId}/aiAllotments/{subject}\n *     { subject, scope, uid, hostId, credits, mode, models, setBy,\n *       updatedAt, alerted }\n *\n * where `subject` is one of\n *\n *   member:{uid}           a team member, across every site\n *   collab:{hostId}:{uid}  a site collaborator, on that site\n *   host:{hostId}          a whole site, across everyone who works on it\n *   org                    the org-wide model restriction (no credits)\n *\n * ## An allotment never grants\n *\n * The org band stays the outer wall: the reservation decides the workspace's\n * own ceilings first and consults an allotment only once they admitted the\n * request. So an allotment larger than the band is not an error and not a\n * grant — it is a line the workspace reaches after the band.\n *\n * ## Hard and soft\n *\n * A HARD allotment refuses the request that finds the subject at or past it.\n * A SOFT one admits it and tells the subject and the workspace's billing\n * contacts at 80% and again at 100%. Both are measured against what the\n * subject already drew this month, before the request — the same shape the\n * band is measured in, so a request that starts under the line may finish\n * past it, and the next one is the one refused.\n *\n * Everything here is dependency-light so the gate, the routes and the console\n * cards read one definition of a subject, a standing and a refusal sentence.\n */\n\n/** `orgs/{orgId}/{this}/{subject}`. */\nexport const AI_ALLOTMENTS_COLLECTION = 'aiAllotments'\n\n/** The subject id of the org-wide model restriction. */\nexport const AI_ALLOTMENT_ORG_SUBJECT = 'org'\n\nexport type AiAllotmentMode = 'hard' | 'soft'\n\nexport type AiAllotmentScope = 'member' | 'collab' | 'host' | 'org'\n\n/** The scopes an allotment of CREDITS can have; `org` carries models only. */\nexport type AiCreditAllotmentScope = Exclude<AiAllotmentScope, 'org'>\n\n/**\n * Why a reservation refused: the meter's own ceilings, and an allotment.\n *\n * Widened here rather than in core's `AssistRefusedBy`, because an allotment\n * is the plugin's rung: core names the ceilings core's billing sells.\n */\nexport type AiRefusedBy = AssistRefusedBy | 'allotment'\n\n/**\n * The steps a soft allotment announces — the same 75, 80, 90 and 100 every\n * usage quota steps through (AGL-3431). Only the highest step reached is\n * sent, each once a month.\n */\nexport const AI_ALLOTMENT_ALERT_BANDS = [75, 80, 90, 100] as const\nexport type AiAllotmentThreshold = (typeof AI_ALLOTMENT_ALERT_BANDS)[number]\n\n/** The share of an allotment at which the strip warns and a soft one alerts. */\nexport const AI_ALLOTMENT_WARN_SHARE = 0.8\n\n/**\n * The largest monthly allotment a write may carry. A bound on a typing\n * mistake, not a product limit: a billion credits is a million dollars of\n * provider spend, far past any band the platform sells.\n */\nexport const AI_ALLOTMENT_MAX_CREDITS = 1_000_000_000\n\n/** The most catalog ids one allowlist may name. */\nexport const AI_ALLOTMENT_MAX_MODELS = 20\n\nconst ID_SEGMENT = /^[A-Za-z0-9_-]{1,128}$/\n\nexport interface AiAllotmentSubject {\n  id: string\n  scope: AiAllotmentScope\n  uid: string | null\n  hostId: string | null\n}\n\nexport type AiAllotmentSubjectInput =\n  | { scope: 'member'; uid: string }\n  | { scope: 'collab'; hostId: string; uid: string }\n  | { scope: 'host'; hostId: string }\n  | { scope: 'org' }\n\n/** The document id for a subject. Throws on a segment that is not an id. */\nexport function aiAllotmentSubjectId(input: AiAllotmentSubjectInput): string {\n  const segment = (value: string): string => {\n    if (!ID_SEGMENT.test(value)) throw new Error(`not an id segment: ${value}`)\n    return value\n  }\n  switch (input.scope) {\n    case 'member':\n      return `member:${segment(input.uid)}`\n    case 'collab':\n      return `collab:${segment(input.hostId)}:${segment(input.uid)}`\n    case 'host':\n      return `host:${segment(input.hostId)}`\n    default:\n      return AI_ALLOTMENT_ORG_SUBJECT\n  }\n}\n\n/** A subject id read back, or `null` for anything that is not one. */\nexport function parseAiAllotmentSubject(value: unknown): AiAllotmentSubject | null {\n  if (typeof value !== 'string') return null\n  if (value === AI_ALLOTMENT_ORG_SUBJECT) {\n    return { id: value, scope: 'org', uid: null, hostId: null }\n  }\n  const parts = value.split(':')\n  if (parts.some((part) => !ID_SEGMENT.test(part))) return null\n  if (parts.length === 2 && parts[0] === 'member') {\n    return { id: value, scope: 'member', uid: parts[1], hostId: null }\n  }\n  if (parts.length === 2 && parts[0] === 'host') {\n    return { id: value, scope: 'host', uid: null, hostId: parts[1] }\n  }\n  if (parts.length === 3 && parts[0] === 'collab') {\n    return { id: value, scope: 'collab', uid: parts[2], hostId: parts[1] }\n  }\n  return null\n}\n\n/** One allotment as every reader hands it on. */\nexport interface AiAllotment {\n  subject: string\n  scope: AiAllotmentScope\n  uid: string | null\n  hostId: string | null\n  /**\n   * Credits a month, or `null` for an allotment that bounds models alone —\n   * and always `null` on the org-wide restriction.\n   */\n  credits: number | null\n  mode: AiAllotmentMode\n  /** Catalog ids the subject may run on, or `null` for no restriction. */\n  models: string[] | null\n  setBy: string | null\n  /** The last threshold announced, and the month it was announced in. */\n  alerted: { month: string; threshold: AiAllotmentThreshold } | null\n}\n\n/** A finite positive whole number of credits, else `null`. */\nexport function aiAllotmentCredits(value: unknown): number | null {\n  const parsed = typeof value === 'number' ? value : Number.NaN\n  if (!Number.isFinite(parsed) || parsed <= 0) return null\n  return Math.min(AI_ALLOTMENT_MAX_CREDITS, Math.floor(parsed))\n}\n\n/** An allowlist read back: unique strings, bounded; empty reads as none. */\nexport function aiAllotmentModels(value: unknown): string[] | null {\n  if (!Array.isArray(value)) return null\n  const models = [\n    ...new Set(\n      value\n        .filter((entry): entry is string => typeof entry === 'string')\n        .map((entry) => entry.trim())\n        .filter(Boolean),\n    ),\n  ].slice(0, AI_ALLOTMENT_MAX_MODELS)\n  return models.length ? models : null\n}\n\n/**\n * A stored allotment as a complete record, or `null` when the id is not a\n * subject. The scope, uid and site are read off the ID, never off the\n * fields: the id is what the gate addresses, so it is the only claim about\n * who the document is for that can be trusted.\n *\n * `mode` defaults to `hard`: a document whose mode was lost is a cap, which\n * is the reading that cannot spend more than a manager set.\n */\nexport function aiAllotmentFrom(\n  raw: Record<string, unknown> | null | undefined,\n  id: string,\n): AiAllotment | null {\n  const subject = parseAiAllotmentSubject(id)\n  if (!subject || !raw) return null\n  const alertedRaw = raw['alerted'] as { month?: unknown; threshold?: unknown } | null\n  const threshold = Number(alertedRaw?.threshold)\n  return {\n    subject: subject.id,\n    scope: subject.scope,\n    uid: subject.uid,\n    hostId: subject.hostId,\n    credits: subject.scope === 'org' ? null : aiAllotmentCredits(raw['credits']),\n    mode: raw['mode'] === 'soft' ? 'soft' : 'hard',\n    models: aiAllotmentModels(raw['models']),\n    setBy: typeof raw['setBy'] === 'string' ? (raw['setBy'] as string) : null,\n    alerted:\n      typeof alertedRaw?.month === 'string' && (threshold === 80 || threshold === 100)\n        ? { month: alertedRaw.month, threshold }\n        : null,\n  }\n}\n\n/** One allotment of credits measured against what its subject drew. */\nexport interface AiAllotmentStanding {\n  subject: string\n  scope: AiCreditAllotmentScope\n  uid: string | null\n  hostId: string | null\n  credits: number\n  /** Credits drawn this month before the request being decided. */\n  used: number\n  mode: AiAllotmentMode\n}\n\nexport type AiAllotmentState = 'ok' | 'warn' | 'reached'\n\n/** `reached` at or past the allotment, `warn` from 80% of it. */\nexport function aiAllotmentState(used: number, credits: number): AiAllotmentState {\n  if (!(credits > 0)) return 'ok'\n  if (used >= credits) return 'reached'\n  if (used >= credits * AI_ALLOTMENT_WARN_SHARE) return 'warn'\n  return 'ok'\n}\n\n/**\n * The highest step a standing has reached, for the alert pipeline — compared\n * as `used × 100 ≥ step × credits`, so 9 of 10 is exactly 90%.\n */\nexport function aiAllotmentThreshold(\n  used: number,\n  credits: number,\n): AiAllotmentThreshold | null {\n  if (!(credits > 0) || !Number.isFinite(used) || used < 0) return null\n  for (let index = AI_ALLOTMENT_ALERT_BANDS.length - 1; index >= 0; index -= 1) {\n    const band = AI_ALLOTMENT_ALERT_BANDS[index]\n    if (used * 100 >= band * credits) return band\n  }\n  return null\n}\n\n/**\n * Whether a standing admits a request.\n *\n * A soft allotment always does. A hard one admits while the subject is under\n * it — and, for a caller that knows what the request will cost before it\n * starts (a job's estimate), while the estimate still fits: a 100-credit job\n * at 0 of 100 is admitted, one at 1 of 100 is not.\n */\nexport function aiAllotmentAdmits(\n  standing: Pick<AiAllotmentStanding, 'credits' | 'used' | 'mode'>,\n  estimateCredits = 0,\n): boolean {\n  if (standing.mode === 'soft') return true\n  const estimate = Number.isFinite(estimateCredits) && estimateCredits > 0 ? estimateCredits : 0\n  return estimate > 0\n    ? standing.used + estimate <= standing.credits\n    : standing.used < standing.credits\n}\n\n/**\n * Which subject a refusal names when more than one allotment is spent: the\n * narrowest first — the person on this site, then the person, then the site.\n */\nconst SCOPE_ORDER: readonly AiCreditAllotmentScope[] = ['collab', 'member', 'host']\n\nconst scopeRank = (scope: AiCreditAllotmentScope): number => SCOPE_ORDER.indexOf(scope)\n\nexport interface AiAllotmentVerdict {\n  /** The hard allotment that refuses the request, or `null`. */\n  refusal: AiAllotmentStanding | null\n  /** The allotment with the least left, for the usage strip; `null` for none. */\n  binding: AiAllotmentStanding | null\n  /** Soft allotments at a threshold, for the alert pipeline. */\n  alerts: Array<{ standing: AiAllotmentStanding; threshold: AiAllotmentThreshold }>\n}\n\n/** The verdict over every allotment that applies to one request. */\nexport function aiAllotmentVerdict(\n  standings: readonly AiAllotmentStanding[],\n  estimateCredits = 0,\n): AiAllotmentVerdict {\n  const ordered = [...standings].sort((a, b) => scopeRank(a.scope) - scopeRank(b.scope))\n  const refusal =\n    ordered.find((standing) => !aiAllotmentAdmits(standing, estimateCredits)) ?? null\n  let binding: AiAllotmentStanding | null = null\n  for (const standing of ordered) {\n    if (!binding || standing.credits - standing.used < binding.credits - binding.used) {\n      binding = standing\n    }\n  }\n  const alerts = ordered.flatMap((standing) => {\n    if (standing.mode !== 'soft') return []\n    const threshold = aiAllotmentThreshold(standing.used, standing.credits)\n    return threshold ? [{ standing, threshold }] : []\n  })\n  return { refusal, binding, alerts }\n}\n\n/**\n * The allowlists that apply to a request, intersected — `null` when none of\n * the allotments names one. An empty result is a real answer: two lists that\n * share no model leave nothing to pick, and the model choice falls back to\n * the routing table rather than turning AI off for a mistake in a list.\n */\nexport function aiAllotmentModelsAllowed(\n  allotments: ReadonlyArray<Pick<AiAllotment, 'models'> | null | undefined>,\n): string[] | null {\n  const lists = allotments\n    .map((allotment) => allotment?.models)\n    .filter((models): models is string[] => Array.isArray(models) && models.length > 0)\n  if (!lists.length) return null\n  return lists.reduce((kept, list) => kept.filter((id) => list.includes(id)))\n}\n\n/** The catalog label for `billing.manage`, the word a sentence names it by. */\nexport function billingManageLabel(): string {\n  return (\n    ORG_PERMISSIONS.find((definition) => definition.key === 'billing.manage')?.label ??\n    'Manage billing'\n  )\n}\n\n/**\n * The sentence a refused request is told, naming who can raise the\n * allotment and where. No figures: the strip beside it carries those, and a\n * refusal that quoted a count would be stale the moment someone raised it.\n */\nexport function aiAllotmentRefusalText(\n  scope: AiCreditAllotmentScope | null | undefined,\n): string {\n  const managers = `an organization admin with the \"${billingManageLabel()}\" permission`\n  switch (scope) {\n    case 'collab':\n      return (\n        'You have used your AI allotment on this site for this month. ' +\n        `The site's admin, or ${managers}, can raise it on the site's Users card.`\n      )\n    case 'host':\n      return (\n        'This site has used its AI allotment for this month. ' +\n        `Ask ${managers} to raise it under ${ASSIST_HARD_CAP_CONTROL_LOCATION}.`\n      )\n    default:\n      return (\n        'You have used your AI allotment for this month. ' +\n        `Ask ${managers} to raise it under ${ASSIST_HARD_CAP_CONTROL_LOCATION}.`\n      )\n  }\n}\n\n/**\n * The words a soft allotment's alert carries, for BOTH channels — the\n * console notification and the email — so the two cannot say different\n * things about one crossing. `name` is the member's name or the site's.\n */\nexport function aiAllotmentAlertCopy(input: {\n  scope: AiCreditAllotmentScope\n  threshold: AiAllotmentThreshold\n  used: number\n  credits: number\n  name: string\n}): { title: string; body: string } {\n  const who =\n    input.scope === 'host' ? `The ${input.name} site` : input.name\n  const whose = input.scope === 'host' ? 'its' : 'their'\n  const where = input.scope === 'collab' ? ' on its site' : ''\n  const figures =\n    `${input.used.toLocaleString('en-US')} of ` +\n    `${input.credits.toLocaleString('en-US')} credits used this month.`\n  if (input.threshold >= 100) {\n    return {\n      title: `${who} has used ${whose} whole AI allotment${where}`,\n      body:\n        `${figures} The allotment is soft, so requests keep working and ` +\n        'draw on the workspace’s pool. Raise it or make it hard under ' +\n        `${ASSIST_HARD_CAP_CONTROL_LOCATION}.`,\n    }\n  }\n  return {\n    title: `${who} is past ${input.threshold}% of ${whose} AI allotment${where}`,\n    body: `${figures} The allotment is soft, so nothing stops at the line.`,\n  }\n}\n"],"names":["ASSIST_HARD_CAP_CONTROL_LOCATION","ORG_PERMISSIONS","AI_ALLOTMENTS_COLLECTION","AI_ALLOTMENT_ORG_SUBJECT","AI_ALLOTMENT_ALERT_BANDS","AI_ALLOTMENT_WARN_SHARE","AI_ALLOTMENT_MAX_CREDITS","AI_ALLOTMENT_MAX_MODELS","ID_SEGMENT","aiAllotmentSubjectId","input","segment","value","test","Error","scope","uid","hostId","parseAiAllotmentSubject","id","parts","split","some","part","length","aiAllotmentCredits","parsed","Number","NaN","isFinite","Math","min","floor","aiAllotmentModels","Array","isArray","models","Set","filter","entry","map","trim","Boolean","slice","aiAllotmentFrom","raw","subject","alertedRaw","threshold","credits","mode","setBy","alerted","month","aiAllotmentState","used","aiAllotmentThreshold","index","band","aiAllotmentAdmits","standing","estimateCredits","estimate","SCOPE_ORDER","scopeRank","indexOf","aiAllotmentVerdict","standings","ordered","sort","a","b","refusal","find","binding","alerts","flatMap","aiAllotmentModelsAllowed","allotments","lists","allotment","reduce","kept","list","includes","billingManageLabel","definition","key","label","aiAllotmentRefusalText","managers","aiAllotmentAlertCopy","who","name","whose","where","figures","toLocaleString","title","body"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-allotments.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ASSIST_HARD_CAP_CONTROL_LOCATION,\n  type AssistRefusedBy,\n} from '../usage/assist-credits'\nimport { ORG_PERMISSIONS } from '@aglyn/aglyn/app-utils/org-permissions'\n\n/**\n * AI ALLOTMENTS (AGL-2942): the pure half.\n *\n * The workspace's AI pool is one band. An allotment is a manager's decision\n * about how much of that band one SUBJECT may draw in a calendar month (UTC),\n * so one client site, one contractor or one teammate cannot spend what the\n * others were counting on:\n *\n *   orgs/{orgId}/aiAllotments/{subject}\n *     { subject, scope, uid, hostId, credits, mode, models, setBy,\n *       updatedAt, alerted }\n *\n * where `subject` is one of\n *\n *   member:{uid}           a team member, across every site\n *   collab:{hostId}:{uid}  a site collaborator, on that site\n *   host:{hostId}          a whole site, across everyone who works on it\n *   org                    the org-wide model restriction (no credits)\n *\n * ## An allotment never grants\n *\n * The org band stays the outer wall: the reservation decides the workspace's\n * own ceilings first and consults an allotment only once they admitted the\n * request. So an allotment larger than the band is not an error and not a\n * grant — it is a line the workspace reaches after the band.\n *\n * ## Hard and soft\n *\n * A HARD allotment refuses the request that finds the subject at or past it.\n * A SOFT one admits it and tells the subject and the workspace's billing\n * contacts at 75, 80, 90 and 100%. Both are measured against what the\n * subject already drew this month, before the request — the same shape the\n * band is measured in, so a request that starts under the line may finish\n * past it, and the next one is the one refused.\n *\n * Everything here is dependency-light so the gate, the routes and the console\n * cards read one definition of a subject, a standing and a refusal sentence.\n */\n\n/** `orgs/{orgId}/{this}/{subject}`. */\nexport const AI_ALLOTMENTS_COLLECTION = 'aiAllotments'\n\n/** The subject id of the org-wide model restriction. */\nexport const AI_ALLOTMENT_ORG_SUBJECT = 'org'\n\nexport type AiAllotmentMode = 'hard' | 'soft'\n\nexport type AiAllotmentScope = 'member' | 'collab' | 'host' | 'org'\n\n/** The scopes an allotment of CREDITS can have; `org` carries models only. */\nexport type AiCreditAllotmentScope = Exclude<AiAllotmentScope, 'org'>\n\n/**\n * Why a reservation refused: the meter's own ceilings, and an allotment.\n *\n * Widened here rather than in core's `AssistRefusedBy`, because an allotment\n * is the plugin's rung: core names the ceilings core's billing sells.\n */\nexport type AiRefusedBy = AssistRefusedBy | 'allotment'\n\n/**\n * The steps a soft allotment announces — the same 75, 80, 90 and 100 every\n * usage quota steps through (AGL-3431). Only the highest step reached is\n * sent, each once a month.\n */\nexport const AI_ALLOTMENT_ALERT_BANDS = [75, 80, 90, 100] as const\nexport type AiAllotmentThreshold = (typeof AI_ALLOTMENT_ALERT_BANDS)[number]\n\n/** The share of an allotment at which the strip warns and a soft one alerts. */\nexport const AI_ALLOTMENT_WARN_SHARE = 0.8\n\n/**\n * The largest monthly allotment a write may carry. A bound on a typing\n * mistake, not a product limit: a billion credits is a million dollars of\n * provider spend, far past any band the platform sells.\n */\nexport const AI_ALLOTMENT_MAX_CREDITS = 1_000_000_000\n\n/** The most catalog ids one allowlist may name. */\nexport const AI_ALLOTMENT_MAX_MODELS = 20\n\nconst ID_SEGMENT = /^[A-Za-z0-9_-]{1,128}$/\n\nexport interface AiAllotmentSubject {\n  id: string\n  scope: AiAllotmentScope\n  uid: string | null\n  hostId: string | null\n}\n\nexport type AiAllotmentSubjectInput =\n  | { scope: 'member'; uid: string }\n  | { scope: 'collab'; hostId: string; uid: string }\n  | { scope: 'host'; hostId: string }\n  | { scope: 'org' }\n\n/** The document id for a subject. Throws on a segment that is not an id. */\nexport function aiAllotmentSubjectId(input: AiAllotmentSubjectInput): string {\n  const segment = (value: string): string => {\n    if (!ID_SEGMENT.test(value)) throw new Error(`not an id segment: ${value}`)\n    return value\n  }\n  switch (input.scope) {\n    case 'member':\n      return `member:${segment(input.uid)}`\n    case 'collab':\n      return `collab:${segment(input.hostId)}:${segment(input.uid)}`\n    case 'host':\n      return `host:${segment(input.hostId)}`\n    default:\n      return AI_ALLOTMENT_ORG_SUBJECT\n  }\n}\n\n/** A subject id read back, or `null` for anything that is not one. */\nexport function parseAiAllotmentSubject(value: unknown): AiAllotmentSubject | null {\n  if (typeof value !== 'string') return null\n  if (value === AI_ALLOTMENT_ORG_SUBJECT) {\n    return { id: value, scope: 'org', uid: null, hostId: null }\n  }\n  const parts = value.split(':')\n  if (parts.some((part) => !ID_SEGMENT.test(part))) return null\n  if (parts.length === 2 && parts[0] === 'member') {\n    return { id: value, scope: 'member', uid: parts[1], hostId: null }\n  }\n  if (parts.length === 2 && parts[0] === 'host') {\n    return { id: value, scope: 'host', uid: null, hostId: parts[1] }\n  }\n  if (parts.length === 3 && parts[0] === 'collab') {\n    return { id: value, scope: 'collab', uid: parts[2], hostId: parts[1] }\n  }\n  return null\n}\n\n/** One allotment as every reader hands it on. */\nexport interface AiAllotment {\n  subject: string\n  scope: AiAllotmentScope\n  uid: string | null\n  hostId: string | null\n  /**\n   * Credits a month, or `null` for an allotment that bounds models alone —\n   * and always `null` on the org-wide restriction.\n   */\n  credits: number | null\n  mode: AiAllotmentMode\n  /** Catalog ids the subject may run on, or `null` for no restriction. */\n  models: string[] | null\n  setBy: string | null\n  /** The last threshold announced, and the month it was announced in. */\n  alerted: { month: string; threshold: AiAllotmentThreshold } | null\n}\n\n/** A finite positive whole number of credits, else `null`. */\nexport function aiAllotmentCredits(value: unknown): number | null {\n  const parsed = typeof value === 'number' ? value : Number.NaN\n  if (!Number.isFinite(parsed) || parsed <= 0) return null\n  return Math.min(AI_ALLOTMENT_MAX_CREDITS, Math.floor(parsed))\n}\n\n/** An allowlist read back: unique strings, bounded; empty reads as none. */\nexport function aiAllotmentModels(value: unknown): string[] | null {\n  if (!Array.isArray(value)) return null\n  const models = [\n    ...new Set(\n      value\n        .filter((entry): entry is string => typeof entry === 'string')\n        .map((entry) => entry.trim())\n        .filter(Boolean),\n    ),\n  ].slice(0, AI_ALLOTMENT_MAX_MODELS)\n  return models.length ? models : null\n}\n\n/**\n * A stored allotment as a complete record, or `null` when the id is not a\n * subject. The scope, uid and site are read off the ID, never off the\n * fields: the id is what the gate addresses, so it is the only claim about\n * who the document is for that can be trusted.\n *\n * `mode` defaults to `hard`: a document whose mode was lost is a cap, which\n * is the reading that cannot spend more than a manager set.\n */\nexport function aiAllotmentFrom(\n  raw: Record<string, unknown> | null | undefined,\n  id: string,\n): AiAllotment | null {\n  const subject = parseAiAllotmentSubject(id)\n  if (!subject || !raw) return null\n  const alertedRaw = raw['alerted'] as { month?: unknown; threshold?: unknown } | null\n  const threshold = Number(alertedRaw?.threshold)\n  return {\n    subject: subject.id,\n    scope: subject.scope,\n    uid: subject.uid,\n    hostId: subject.hostId,\n    credits: subject.scope === 'org' ? null : aiAllotmentCredits(raw['credits']),\n    mode: raw['mode'] === 'soft' ? 'soft' : 'hard',\n    models: aiAllotmentModels(raw['models']),\n    setBy: typeof raw['setBy'] === 'string' ? (raw['setBy'] as string) : null,\n    alerted:\n      typeof alertedRaw?.month === 'string' && (threshold === 80 || threshold === 100)\n        ? { month: alertedRaw.month, threshold }\n        : null,\n  }\n}\n\n/** One allotment of credits measured against what its subject drew. */\nexport interface AiAllotmentStanding {\n  subject: string\n  scope: AiCreditAllotmentScope\n  uid: string | null\n  hostId: string | null\n  credits: number\n  /** Credits drawn this month before the request being decided. */\n  used: number\n  mode: AiAllotmentMode\n}\n\nexport type AiAllotmentState = 'ok' | 'warn' | 'reached'\n\n/** `reached` at or past the allotment, `warn` from 80% of it. */\nexport function aiAllotmentState(used: number, credits: number): AiAllotmentState {\n  if (!(credits > 0)) return 'ok'\n  if (used >= credits) return 'reached'\n  if (used >= credits * AI_ALLOTMENT_WARN_SHARE) return 'warn'\n  return 'ok'\n}\n\n/**\n * The highest step a standing has reached, for the alert pipeline — compared\n * as `used × 100 ≥ step × credits`, so 9 of 10 is exactly 90%.\n */\nexport function aiAllotmentThreshold(\n  used: number,\n  credits: number,\n): AiAllotmentThreshold | null {\n  if (!(credits > 0) || !Number.isFinite(used) || used < 0) return null\n  for (let index = AI_ALLOTMENT_ALERT_BANDS.length - 1; index >= 0; index -= 1) {\n    const band = AI_ALLOTMENT_ALERT_BANDS[index]\n    if (used * 100 >= band * credits) return band\n  }\n  return null\n}\n\n/**\n * Whether a standing admits a request.\n *\n * A soft allotment always does. A hard one admits while the subject is under\n * it — and, for a caller that knows what the request will cost before it\n * starts (a job's estimate), while the estimate still fits: a 100-credit job\n * at 0 of 100 is admitted, one at 1 of 100 is not.\n */\nexport function aiAllotmentAdmits(\n  standing: Pick<AiAllotmentStanding, 'credits' | 'used' | 'mode'>,\n  estimateCredits = 0,\n): boolean {\n  if (standing.mode === 'soft') return true\n  const estimate = Number.isFinite(estimateCredits) && estimateCredits > 0 ? estimateCredits : 0\n  return estimate > 0\n    ? standing.used + estimate <= standing.credits\n    : standing.used < standing.credits\n}\n\n/**\n * Which subject a refusal names when more than one allotment is spent: the\n * narrowest first — the person on this site, then the person, then the site.\n */\nconst SCOPE_ORDER: readonly AiCreditAllotmentScope[] = ['collab', 'member', 'host']\n\nconst scopeRank = (scope: AiCreditAllotmentScope): number => SCOPE_ORDER.indexOf(scope)\n\nexport interface AiAllotmentVerdict {\n  /** The hard allotment that refuses the request, or `null`. */\n  refusal: AiAllotmentStanding | null\n  /** The allotment with the least left, for the usage strip; `null` for none. */\n  binding: AiAllotmentStanding | null\n  /** Soft allotments at a threshold, for the alert pipeline. */\n  alerts: Array<{ standing: AiAllotmentStanding; threshold: AiAllotmentThreshold }>\n}\n\n/** The verdict over every allotment that applies to one request. */\nexport function aiAllotmentVerdict(\n  standings: readonly AiAllotmentStanding[],\n  estimateCredits = 0,\n): AiAllotmentVerdict {\n  const ordered = [...standings].sort((a, b) => scopeRank(a.scope) - scopeRank(b.scope))\n  const refusal =\n    ordered.find((standing) => !aiAllotmentAdmits(standing, estimateCredits)) ?? null\n  let binding: AiAllotmentStanding | null = null\n  for (const standing of ordered) {\n    if (!binding || standing.credits - standing.used < binding.credits - binding.used) {\n      binding = standing\n    }\n  }\n  const alerts = ordered.flatMap((standing) => {\n    if (standing.mode !== 'soft') return []\n    const threshold = aiAllotmentThreshold(standing.used, standing.credits)\n    return threshold ? [{ standing, threshold }] : []\n  })\n  return { refusal, binding, alerts }\n}\n\n/**\n * The allowlists that apply to a request, intersected — `null` when none of\n * the allotments names one. An empty result is a real answer: two lists that\n * share no model leave nothing to pick, and the model choice falls back to\n * the routing table rather than turning AI off for a mistake in a list.\n */\nexport function aiAllotmentModelsAllowed(\n  allotments: ReadonlyArray<Pick<AiAllotment, 'models'> | null | undefined>,\n): string[] | null {\n  const lists = allotments\n    .map((allotment) => allotment?.models)\n    .filter((models): models is string[] => Array.isArray(models) && models.length > 0)\n  if (!lists.length) return null\n  return lists.reduce((kept, list) => kept.filter((id) => list.includes(id)))\n}\n\n/** The catalog label for `billing.manage`, the word a sentence names it by. */\nexport function billingManageLabel(): string {\n  return (\n    ORG_PERMISSIONS.find((definition) => definition.key === 'billing.manage')?.label ??\n    'Manage billing'\n  )\n}\n\n/**\n * The sentence a refused request is told, naming who can raise the\n * allotment and where. No figures: the strip beside it carries those, and a\n * refusal that quoted a count would be stale the moment someone raised it.\n */\nexport function aiAllotmentRefusalText(\n  scope: AiCreditAllotmentScope | null | undefined,\n): string {\n  const managers = `an organization admin with the \"${billingManageLabel()}\" permission`\n  switch (scope) {\n    case 'collab':\n      return (\n        'You have used your AI allotment on this site for this month. ' +\n        `The site's admin, or ${managers}, can raise it on the site's Users card.`\n      )\n    case 'host':\n      return (\n        'This site has used its AI allotment for this month. ' +\n        `Ask ${managers} to raise it under ${ASSIST_HARD_CAP_CONTROL_LOCATION}.`\n      )\n    default:\n      return (\n        'You have used your AI allotment for this month. ' +\n        `Ask ${managers} to raise it under ${ASSIST_HARD_CAP_CONTROL_LOCATION}.`\n      )\n  }\n}\n\n/**\n * The words a soft allotment's alert carries, for BOTH channels — the\n * console notification and the email — so the two cannot say different\n * things about one crossing.\n *\n * The email is plain text with no heading, so the body opens by saying whose\n * AI credits, how many of how many, and in which workspace (and on which site,\n * for a collaborator): a figure on its own reads as a bill. The managers'\n * copy says how to stop the subject at the line; the person's own copy does\n * not, because they cannot open Billing.\n */\nexport function aiAllotmentAlertCopy(input: {\n  scope: AiCreditAllotmentScope\n  threshold: AiAllotmentThreshold\n  used: number\n  credits: number\n  /** The member's name, or the site's for a site allotment. */\n  name: string\n  /** The workspace the allotment is drawn from. */\n  workspace: string\n  /** The site a collaborator's allotment is on. */\n  site?: string\n  /** The workspace's managers (the default), or the person it is for. */\n  reader?: 'managers' | 'subject'\n}): { title: string; body: string } {\n  const { scope, threshold, name, workspace } = input\n  const used = input.used.toLocaleString('en-US')\n  const credits = input.credits.toLocaleString('en-US')\n  const reached = threshold >= 100\n  const onSite = scope === 'collab' && input.site ? ` on the ${input.site} site` : ''\n  const amount = reached\n    ? `all ${credits} AI credits`\n    : `${used} of the ${credits} AI credits`\n  const tail = reached ? ` this month (${used} so far).` : ` this month, past the ${threshold}% mark.`\n\n  if (input.reader === 'subject' && scope !== 'host') {\n    const where = scope === 'collab' ? onSite : ` in ${workspace}`\n    const whoCanChange =\n      scope === 'collab'\n        ? 'The site’s admin or a workspace admin can raise or change it.'\n        : 'A workspace admin can raise or change it.'\n    return {\n      title: reached\n        ? `You’ve used your whole AI allotment${where}`\n        : `You’re past ${threshold}% of your AI allotment${where}`,\n      body:\n        `You’ve used ${amount} ${workspace} allotted you${onSite}${tail} ` +\n        'It’s a soft allotment, so it does not stop your AI requests.' +\n        (reached ? ` ${whoCanChange}` : ''),\n    }\n  }\n\n  const who = scope === 'host' ? `The ${name} site` : name\n  const whose = scope === 'host' ? 'its' : 'their'\n  const them = scope === 'host' ? 'it' : 'them'\n  const requests = scope === 'host' ? 'AI requests on the site' : `${name}’s AI requests`\n  const where = scope === 'collab' ? onSite : scope === 'member' ? ` in ${workspace}` : ''\n  const opening =\n    `${who} has used ${amount} allotted to ${them}${onSite} in ${workspace}${tail}`\n  if (reached) {\n    return {\n      title: `${who} has used ${whose} whole AI allotment${where}`,\n      body:\n        `${opening} It’s a soft allotment, so it does not stop ${requests}; ` +\n        'they keep drawing on the workspace’s AI credits, and crossing it ' +\n        `charges nothing by itself. To stop ${them} at the line, make it hard ` +\n        `under ${ASSIST_HARD_CAP_CONTROL_LOCATION}; to give ${them} more, ` +\n        'raise it there.',\n    }\n  }\n  return {\n    title: `${who} is past ${threshold}% of ${whose} AI allotment${where}`,\n    body:\n      `${opening} It’s a soft allotment, so it does not stop ${requests}; ` +\n      'they draw on the workspace’s AI credits like everyone else’s.',\n  }\n}\n"],"names":["ASSIST_HARD_CAP_CONTROL_LOCATION","ORG_PERMISSIONS","AI_ALLOTMENTS_COLLECTION","AI_ALLOTMENT_ORG_SUBJECT","AI_ALLOTMENT_ALERT_BANDS","AI_ALLOTMENT_WARN_SHARE","AI_ALLOTMENT_MAX_CREDITS","AI_ALLOTMENT_MAX_MODELS","ID_SEGMENT","aiAllotmentSubjectId","input","segment","value","test","Error","scope","uid","hostId","parseAiAllotmentSubject","id","parts","split","some","part","length","aiAllotmentCredits","parsed","Number","NaN","isFinite","Math","min","floor","aiAllotmentModels","Array","isArray","models","Set","filter","entry","map","trim","Boolean","slice","aiAllotmentFrom","raw","subject","alertedRaw","threshold","credits","mode","setBy","alerted","month","aiAllotmentState","used","aiAllotmentThreshold","index","band","aiAllotmentAdmits","standing","estimateCredits","estimate","SCOPE_ORDER","scopeRank","indexOf","aiAllotmentVerdict","standings","ordered","sort","a","b","refusal","find","binding","alerts","flatMap","aiAllotmentModelsAllowed","allotments","lists","allotment","reduce","kept","list","includes","billingManageLabel","definition","key","label","aiAllotmentRefusalText","managers","aiAllotmentAlertCopy","name","workspace","toLocaleString","reached","onSite","site","amount","tail","reader","where","whoCanChange","title","body","who","whose","them","requests","opening"],"mappings":"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"}

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

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { AiBuildPlan, AiBuildPlanCreate, AiBuildPlanCreateKind } from './ai-build-plan';
+import type { AiJobKind } from './ai-jobs.types';
+/**
+ * What a job that builds ONE record builds of the rest of its plan
+ * (AGL-3143 §15): a template, a layout, a component, a form or an email
+ * design.
+ *
+ * Each of those steps builds the first creation of its own kind and nothing
+ * else, so a plan that also created something left it unbuilt and the job
+ * still reported `Done`. Measured live on 2026-10-01 (job `2xD9Y7NayF`): a
+ * template plan the member confirmed read "Creates the component
+ * related-article-card", and no such component was ever made.
+ *
+ * Such a job now builds the other creations the way a page job does
+ * (AGL-3031): each before its own record, one a pass, by the step that builds
+ * that kind, and then its own record against what was built. It builds only
+ * what its own record can PLACE — a component instance or a saved form, on
+ * the trees that admit one — because a creation nothing places is the same
+ * broken promise one step later. A form's tree and an email's place neither,
+ * so those two build only their own. The plan step is told this list before it
+ * answers, and the plan rules refuse a creation outside it with the one
+ * re-ask every rule gets.
+ *
+ * Model only: this module imports nothing at runtime, so the plan step, the
+ * doors, the estimate and the proposal read one list.
+ */
+export declare const AI_JOB_CREATE_KINDS: Readonly<Partial<Record<AiJobKind, readonly AiBuildPlanCreateKind[]>>>;
+/** A job of each of those kinds as a refusal names it: "a template job". */
+export declare const AI_JOB_CREATE_NOUNS: Readonly<Partial<Record<AiJobKind, string>>>;
+/**
+ * The creations a job of `kind` builds before its own record: every creation
+ * the plan names that the kind builds, less the one the kind's step builds
+ * itself — the first of the kind's own — in plan order. Empty for a kind that
+ * builds only its own record.
+ */
+export declare function aiJobOtherCreations(kind: AiJobKind, plan: Pick<AiBuildPlan, 'create'>): Array<{
+    creation: AiBuildPlanCreate;
+    index: number;
+}>;

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

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * What a job that builds ONE record builds of the rest of its plan
+ * (AGL-3143 §15): a template, a layout, a component, a form or an email
+ * design.
+ *
+ * Each of those steps builds the first creation of its own kind and nothing
+ * else, so a plan that also created something left it unbuilt and the job
+ * still reported `Done`. Measured live on 2026-10-01 (job `2xD9Y7NayF`): a
+ * template plan the member confirmed read "Creates the component
+ * related-article-card", and no such component was ever made.
+ *
+ * Such a job now builds the other creations the way a page job does
+ * (AGL-3031): each before its own record, one a pass, by the step that builds
+ * that kind, and then its own record against what was built. It builds only
+ * what its own record can PLACE — a component instance or a saved form, on
+ * the trees that admit one — because a creation nothing places is the same
+ * broken promise one step later. A form's tree and an email's place neither,
+ * so those two build only their own. The plan step is told this list before it
+ * answers, and the plan rules refuse a creation outside it with the one
+ * re-ask every rule gets.
+ *
+ * Model only: this module imports nothing at runtime, so the plan step, the
+ * doors, the estimate and the proposal read one list.
+ */ export const AI_JOB_CREATE_KINDS = {
+    template: [
+        'template',
+        'form',
+        'component'
+    ],
+    layout: [
+        'layout',
+        'form',
+        'component'
+    ],
+    component: [
+        'component',
+        'form'
+    ],
+    form: [
+        'form'
+    ],
+    email: [
+        'email'
+    ]
+};
+/** A job of each of those kinds as a refusal names it: "a template job". */ export const AI_JOB_CREATE_NOUNS = {
+    template: 'a template job',
+    layout: 'a layout job',
+    component: 'a component job',
+    form: 'a form job',
+    email: 'an email job'
+};
+/**
+ * The creations a job of `kind` builds before its own record: every creation
+ * the plan names that the kind builds, less the one the kind's step builds
+ * itself — the first of the kind's own — in plan order. Empty for a kind that
+ * builds only its own record.
+ */ export function aiJobOtherCreations(kind, plan) {
+    const creates = AI_JOB_CREATE_KINDS[kind];
+    if (!creates) return [];
+    const own = plan.create.findIndex((entry)=>entry.kind === kind);
+    return plan.create.flatMap((creation, index)=>index !== own && creates.includes(creation.kind) ? [
+            {
+                creation,
+                index
+            }
+        ] : []);
+}
+
+//# sourceMappingURL=ai-job-creations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-job-creations.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 { AiBuildPlan, AiBuildPlanCreate, AiBuildPlanCreateKind } from './ai-build-plan'\nimport type { AiJobKind } from './ai-jobs.types'\n\n/**\n * What a job that builds ONE record builds of the rest of its plan\n * (AGL-3143 §15): a template, a layout, a component, a form or an email\n * design.\n *\n * Each of those steps builds the first creation of its own kind and nothing\n * else, so a plan that also created something left it unbuilt and the job\n * still reported `Done`. Measured live on 2026-10-01 (job `2xD9Y7NayF`): a\n * template plan the member confirmed read \"Creates the component\n * related-article-card\", and no such component was ever made.\n *\n * Such a job now builds the other creations the way a page job does\n * (AGL-3031): each before its own record, one a pass, by the step that builds\n * that kind, and then its own record against what was built. It builds only\n * what its own record can PLACE — a component instance or a saved form, on\n * the trees that admit one — because a creation nothing places is the same\n * broken promise one step later. A form's tree and an email's place neither,\n * so those two build only their own. The plan step is told this list before it\n * answers, and the plan rules refuse a creation outside it with the one\n * re-ask every rule gets.\n *\n * Model only: this module imports nothing at runtime, so the plan step, the\n * doors, the estimate and the proposal read one list.\n */\nexport const AI_JOB_CREATE_KINDS: Readonly<Partial<Record<AiJobKind, readonly AiBuildPlanCreateKind[]>>> = {\n  template: ['template', 'form', 'component'],\n  layout: ['layout', 'form', 'component'],\n  component: ['component', 'form'],\n  form: ['form'],\n  email: ['email'],\n}\n\n/** A job of each of those kinds as a refusal names it: \"a template job\". */\nexport const AI_JOB_CREATE_NOUNS: Readonly<Partial<Record<AiJobKind, string>>> = {\n  template: 'a template job',\n  layout: 'a layout job',\n  component: 'a component job',\n  form: 'a form job',\n  email: 'an email job',\n}\n\n/**\n * The creations a job of `kind` builds before its own record: every creation\n * the plan names that the kind builds, less the one the kind's step builds\n * itself — the first of the kind's own — in plan order. Empty for a kind that\n * builds only its own record.\n */\nexport function aiJobOtherCreations(\n  kind: AiJobKind,\n  plan: Pick<AiBuildPlan, 'create'>,\n): Array<{ creation: AiBuildPlanCreate; index: number }> {\n  const creates = AI_JOB_CREATE_KINDS[kind]\n  if (!creates) return []\n  const own = plan.create.findIndex((entry) => entry.kind === kind)\n  return plan.create.flatMap((creation, index) =>\n    index !== own && creates.includes(creation.kind) ? [{ creation, index }] : [],\n  )\n}\n"],"names":["AI_JOB_CREATE_KINDS","template","layout","component","form","email","AI_JOB_CREATE_NOUNS","aiJobOtherCreations","kind","plan","creates","own","create","findIndex","entry","flatMap","creation","index","includes"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAKD;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GACD,OAAO,MAAMA,sBAA8F;IACzGC,UAAU;QAAC;QAAY;QAAQ;KAAY;IAC3CC,QAAQ;QAAC;QAAU;QAAQ;KAAY;IACvCC,WAAW;QAAC;QAAa;KAAO;IAChCC,MAAM;QAAC;KAAO;IACdC,OAAO;QAAC;KAAQ;AAClB,EAAC;AAED,0EAA0E,GAC1E,OAAO,MAAMC,sBAAoE;IAC/EL,UAAU;IACVC,QAAQ;IACRC,WAAW;IACXC,MAAM;IACNC,OAAO;AACT,EAAC;AAED;;;;;CAKC,GACD,OAAO,SAASE,oBACdC,IAAe,EACfC,IAAiC;IAEjC,MAAMC,UAAUV,mBAAmB,CAACQ,KAAK;IACzC,IAAI,CAACE,SAAS,OAAO,EAAE;IACvB,MAAMC,MAAMF,KAAKG,MAAM,CAACC,SAAS,CAAC,CAACC,QAAUA,MAAMN,IAAI,KAAKA;IAC5D,OAAOC,KAAKG,MAAM,CAACG,OAAO,CAAC,CAACC,UAAUC,QACpCA,UAAUN,OAAOD,QAAQQ,QAAQ,CAACF,SAASR,IAAI,IAAI;YAAC;gBAAEQ;gBAAUC;YAAM;SAAE,GAAG,EAAE;AAEjF"}

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

@@ -87,6 +87,7 @@ export declare function aiPagePlanRefusal(plan: AiBuildPlan): string | null;
  * in a sentence a member reads when confirming it: what the workspace's plan
  * does not include, or what the site has no room left for. The plan step was
  * told what could be created, so this is the site changing between the plan
- * and its confirmation.
+ * and its confirmation. `noun` names what the job builds, for a template,
+ * layout, component, form or email job held the same way (AGL-3143 §15).
  */
-export declare function aiPageCreationRefusal(refused: readonly AiPlanUncreatable[]): string | null;
+export declare function aiPageCreationRefusal(refused: readonly AiPlanUncreatable[], noun?: string): string | null;

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

@@ -148,12 +148,13 @@ const PAGE_TYPE_BY_ID = new Map(AI_PAGE_TYPES.map((type)=>[
  * in a sentence a member reads when confirming it: what the workspace's plan
  * does not include, or what the site has no room left for. The plan step was
  * told what could be created, so this is the site changing between the plan
- * and its confirmation.
- */ export function aiPageCreationRefusal(refused) {
+ * and its confirmation. `noun` names what the job builds, for a template,
+ * layout, component, form or email job held the same way (AGL-3143 §15).
+ */ export function aiPageCreationRefusal(refused, noun = 'page') {
     if (!refused.length) return null;
     const parts = refused.map(({ kind, name, reason })=>`the ${AI_BUILD_PLAN_CREATION_NOUNS[kind].noun} “${name}”, because ${reason}`);
     const listed = parts.length === 1 ? parts[0] : `${parts.slice(0, -1).join('; ')}; and ${parts[parts.length - 1]}`;
-    return `This page cannot be built as planned: it creates ${listed}. Describe the page again.`;
+    return `This ${noun} cannot be built as planned: it creates ${listed}. Describe the ${noun} again.`;
 }
 
 //# sourceMappingURL=ai-page-job.js.map