@aglyn/plugins-ai 1.0.0-beta.270 → 1.0.0-beta.271

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-ai",
-  "version": "1.0.0-beta.270",
+  "version": "1.0.0-beta.271",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,22 +25,22 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.270",
-    "@aglyn/shared-data-enums": "1.0.0-beta.270",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.270",
-    "@aglyn/shared-data-types": "1.0.0-beta.270",
-    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.270",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.270",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.270",
-    "@aglyn/shared-ui-theme": "1.0.0-beta.270",
-    "@aglyn/shared-util-email": "1.0.0-beta.270",
-    "@aglyn/shared-util-errors": "1.0.0-beta.270",
-    "@aglyn/shared-util-http": "1.0.0-beta.270",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.270",
-    "@aglyn/shared-util-tools": "1.0.0-beta.270",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.270",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.270",
-    "@aglyn/tenant-runtime": "1.0.0-beta.270",
+    "@aglyn/aglyn": "1.0.0-beta.271",
+    "@aglyn/shared-data-enums": "1.0.0-beta.271",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.271",
+    "@aglyn/shared-data-types": "1.0.0-beta.271",
+    "@aglyn/shared-ui-email-campaigns": "1.0.0-beta.271",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.271",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.271",
+    "@aglyn/shared-ui-theme": "1.0.0-beta.271",
+    "@aglyn/shared-util-email": "1.0.0-beta.271",
+    "@aglyn/shared-util-errors": "1.0.0-beta.271",
+    "@aglyn/shared-util-http": "1.0.0-beta.271",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.271",
+    "@aglyn/shared-util-tools": "1.0.0-beta.271",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.271",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.271",
+    "@aglyn/tenant-runtime": "1.0.0-beta.271",
     "@swc/helpers": "0.5.23"
   },
   "peerDependencies": {

package/src/lib/activity/ai-activity-actions.d.ts

@@ -89,7 +89,7 @@ export declare const AI_ACTIVITY_FILTER_LABEL = "AI";
  * (AGL-2935), or the site is at an allowance its plan sets for what the job
  * writes (AGL-2909).
  */
-export type AiJobNeedsInputReason = 'band' | 'cap' | 'messages' | 'budget' | 'allotment' | 'account' | 'requests' | 'refusals' | 'platform' | 'plan' | 'doctrine' | 'limit';
+export type AiJobNeedsInputReason = 'band' | 'cap' | 'messages' | 'budget' | 'allotment' | 'account' | 'requests' | 'refusals' | 'platform' | 'plan' | 'doctrine' | 'limit' | 'input';
 export declare const AI_JOB_NEEDS_INPUT_REASON_LABELS: Record<AiJobNeedsInputReason, string>;
 /**
  * The feed target types a generation job's output can be filed under: the

package/src/lib/activity/ai-activity-actions.js

@@ -126,6 +126,7 @@ export const AI_JOB_NEEDS_INPUT_REASON_LABELS = {
     plan: 'its plan is ready for review',
     doctrine: 'its answer broke a building rule twice',
     limit: 'the site reached an allowance of its plan',
+    input: 'it needs an ID only the person can give',
     band: 'the included AI band is used up',
     cap: 'the overage ceiling was reached',
     messages: 'the monthly message cap was reached',

package/src/lib/activity/ai-activity-actions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/activity/ai-activity-actions.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\n/**\n * The AI actions an activity log can carry (AGL-2929).\n *\n * Every other action in `orgs/{orgId}/activity` and `hosts/{hostId}/activity`\n * is a prose sentence written at the call site — \"Saved the screen\". The AI\n * rows are CODES instead, because they are read by more than a person: the\n * org feed's \"AI\" chip, the staff audit facet and the actor table all need\n * to recognize an AI row without parsing a sentence, and a sentence that\n * three writers phrase three ways is three rows that look unrelated.\n *\n * One list, so the writers in `ai-activity.ts`, the feed presenter and the\n * staff facet cannot disagree about what counts as AI. A code missing from\n * `AI_ACTIVITY_ACTION_LABELS` fails the type, not the reader.\n */\n\nimport type { AiJobOutputResource } from '../model/ai-jobs.types'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport {\n  pluginStaffAuditActionGroup,\n  pluginStaffAuditActionGroupLabel,\n  registerPluginActivityActions,\n  type PluginActivityScope,\n} from '@aglyn/aglyn/plugin-manager/plugin-activity-actions'\n\n/** The action code each AI writer stores. */\nexport const AI_ACTIVITY_ACTIONS = {\n  jobCreated: 'ai.job.created',\n  jobOutput: 'ai.job.output',\n  jobCanceled: 'ai.job.canceled',\n  jobNeedsInput: 'ai.job.needs_input',\n  editApplied: 'ai.edit.applied',\n  seoApplied: 'ai.seo.applied',\n  assistSection: 'ai.assist.section',\n  overageHardCap: 'ai.overage.hardCap',\n  overageCap: 'ai.overage.cap',\n  allotmentChanged: 'ai.allotment.changed',\n  permissionChanged: 'ai.permission.changed',\n  addonPurchased: 'ai.addon.purchased',\n  addonRemoved: 'ai.addon.removed',\n} as const\n\nexport type AiActivityAction =\n  (typeof AI_ACTIVITY_ACTIONS)[keyof typeof AI_ACTIVITY_ACTIONS]\n\n/** What a person reads for each code, in the feed and the actor table. */\nexport const AI_ACTIVITY_ACTION_LABELS: Record<AiActivityAction, string> = {\n  'ai.job.created': 'Started an AI generation',\n  'ai.job.output': 'AI generated',\n  'ai.job.canceled': 'Canceled an AI generation',\n  'ai.job.needs_input': 'AI generation paused for input',\n  'ai.edit.applied': 'Applied AI edits',\n  'ai.seo.applied': 'Applied AI SEO fixes as drafts',\n  'ai.assist.section': 'AI generated a section',\n  'ai.overage.hardCap': 'AI stop-at-band switch',\n  'ai.overage.cap': 'AI overage ceiling',\n  'ai.allotment.changed': 'AI allotment changed',\n  'ai.permission.changed': 'AI permission changed',\n  'ai.addon.purchased': 'Added the AI add-on',\n  'ai.addon.removed': 'Removed the AI add-on',\n}\n\n/**\n * The codes whose row reads as a sentence about its target (AGL-3660):\n * `{target}` is the target's noun and name, so an output row reads\n * `Created page Home with Aglyn AI` rather than `AI generated` beside a\n * Target cell that had to finish the thought.\n */\nexport const AI_ACTIVITY_ACTION_SENTENCES: Partial<Record<AiActivityAction, string>> = {\n  'ai.job.output': `Created {target} with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.edit.applied': `Applied ${PLATFORM_BRAND_NAME} AI edits to {target}`,\n  'ai.seo.applied': `Applied ${PLATFORM_BRAND_NAME} AI search fixes to {target}`,\n  'ai.assist.section': `Added a section to {target} with ${PLATFORM_BRAND_NAME} AI`,\n}\n\n/**\n * What the staff audit trail reads for each code the AI doors write to\n * `adminAudit` (AGL-3660). `ai.job.output` is spelled out per row by the\n * shared describer, which names the thing made.\n */\nexport const AI_STAFF_AUDIT_LABELS: Readonly<Record<string, string>> = {\n  'ai.job.output': `Created a draft with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.job.cancel': `Canceled an ${PLATFORM_BRAND_NAME} AI job`,\n  'ai.job.resume': `Confirmed an ${PLATFORM_BRAND_NAME} AI plan`,\n  'ai.job.apply': `Applied an ${PLATFORM_BRAND_NAME} AI result`,\n  'ai.generate': `Generated with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.allotments.set': 'Set AI allotments',\n  'ai.credits.giveBack': 'Gave AI credits back',\n  'ai.credits.reset': 'Reset AI credits',\n  'ai.overage.clearCeiling': 'Cleared the AI overage ceiling',\n  'ai.overage.liftPause': 'Lifted the AI pause',\n  'ai.overage.resetStep': 'Reset the AI overage step',\n  'ai.overage.setCeiling': 'Set the AI overage ceiling',\n  'platform.aiFreeSpend.paused': 'Paused free AI for the day',\n  'org.ai-viewed': 'Viewed the organization’s AI usage',\n  'user.ai-usage-viewed': 'Viewed the account’s AI usage',\n  'org.ai-conversations-viewed': `Viewed the organization’s ${PLATFORM_BRAND_NAME} AI requests`,\n  'user.ai-requests-viewed': `Viewed the account’s ${PLATFORM_BRAND_NAME} AI requests`,\n  ...Object.fromEntries(\n    Object.entries(AI_ACTIVITY_ACTION_LABELS).filter(([key]) => key !== 'ai.job.output'),\n  ),\n}\n\n/** A job output's `resource`, as the noun the audit sentence uses. */\nconst AI_OUTPUT_NOUNS: Readonly<Record<string, string>> = {\n  screen: 'page',\n  reusableComponent: 'component',\n  emailScreen: 'email',\n  orgAutomation: 'automation',\n  workflow: 'automation',\n  entry: 'post',\n  text: 'copy',\n  seo: 'search fixes',\n  crm: 'CRM answer',\n  insight: 'insight',\n}\n\n/**\n * An `ai.job.output` audit row in words (AGL-3660), from the `after` the\n * job writer stores — `{ resource, label }`: `Created page Home with Aglyn\n * AI`, and its outcome, a draft.\n */\nexport function aiStaffAuditDescribe(entry: {\n  action: string\n  after: Readonly<Record<string, unknown>>\n}): { action?: string; result?: string } | undefined {\n  if (entry.action !== AI_ACTIVITY_ACTIONS.jobOutput) return undefined\n  const resource = typeof entry.after['resource'] === 'string' ? entry.after['resource'] : ''\n  const label = typeof entry.after['label'] === 'string' ? entry.after['label'].trim() : ''\n  const noun =\n    AI_OUTPUT_NOUNS[resource] ??\n    (resource ? resource.replace(/([a-z])([A-Z])/g, '$1 $2').toLowerCase() : 'draft')\n  return {\n    action: `Created ${noun}${label ? ` ${label}` : ''} with ${PLATFORM_BRAND_NAME} AI`,\n    result: 'Draft created',\n  }\n}\n\n/** Every code, in catalog order — what a filter sends as `isAnyOf`. */\nexport const AI_ACTIVITY_ACTION_LIST: readonly AiActivityAction[] =\n  Object.values(AI_ACTIVITY_ACTIONS)\n\n/** The feed's filter chip and the staff facet's group, by one name. */\nexport const AI_ACTIVITY_FILTER_LABEL = 'AI'\n\n/**\n * Why a generation stopped and asked for a person (AGL-2904): the plan's\n * band ran out, the org's own ceiling refused, the monthly message cap or\n * the job's own token budget did — or, on the Free taste (AGL-2925), one of\n * its own precautions: the account's credits, its daily request cap, a\n * pause after declined briefs, or the platform's day of free spend. Those\n * are the meter's `AssistRefusedBy` less its `null`, so a ceiling the meter\n * can name is one the feed can label. The last three are the job's own: its\n * plan is ready for review, or an answer broke a building rule on its re-ask\n * (AGL-2935), or the site is at an allowance its plan sets for what the job\n * writes (AGL-2909).\n */\nexport type AiJobNeedsInputReason =\n  | 'band'\n  | 'cap'\n  | 'messages'\n  | 'budget'\n  | 'allotment'\n  | 'account'\n  | 'requests'\n  | 'refusals'\n  | 'platform'\n  | 'plan'\n  | 'doctrine'\n  | 'limit'\n\nexport const AI_JOB_NEEDS_INPUT_REASON_LABELS: Record<\n  AiJobNeedsInputReason,\n  string\n> = {\n  plan: 'its plan is ready for review',\n  doctrine: 'its answer broke a building rule twice',\n  limit: 'the site reached an allowance of its plan',\n  band: 'the included AI band is used up',\n  cap: 'the overage ceiling was reached',\n  messages: 'the monthly message cap was reached',\n  budget: 'the job budget was reached',\n  allotment: 'the creator’s or the site’s AI allotment is used up',\n  account: 'the account’s free AI credits are used up',\n  requests: 'the daily free request cap was reached',\n  refusals: 'free generation is paused for the day after declined briefs',\n  platform: 'free AI generation is paused for the day',\n}\n\n/**\n * The feed target types a generation job's output can be filed under: the\n * kinds both activity logs know, so the org row and its host copy share a\n * shape.\n */\nexport type AiOutputTargetType =\n  | 'screen'\n  | 'layout'\n  | 'component'\n  | 'template'\n  | 'workflow'\n  | 'content'\n  | 'theme'\n\n/**\n * Where the feed files each resource kind a job can write (AGL-2904).\n *\n * A job names its output by the resource it wrote, and the activity logs\n * know a narrower set of targets. The map is total, so a resource kind\n * added to the job document must say where the feed shows it before the\n * machine can log it. `reusableComponent` is the feed's `component`; a\n * `text` output is copy, which the feed files as `content`; a `theme`\n * proposal is filed under the site's theme, which the host feed links to the\n * Theme section (AGL-2938); the kinds whose runners have not shipped are\n * content of the site too, and are filed there until a target of their own\n * exists.\n */\nconst AI_OUTPUT_TARGET_TYPES: Record<AiJobOutputResource, AiOutputTargetType> = {\n  screen: 'screen',\n  reusableComponent: 'component',\n  layout: 'layout',\n  template: 'template',\n  form: 'content',\n  emailScreen: 'content',\n  campaign: 'content',\n  product: 'content',\n  experiment: 'content',\n  workflow: 'workflow',\n  // An SEO proposal (AGL-2910) is about the site's content, and is filed there.\n  seo: 'content',\n  text: 'content',\n  theme: 'theme',\n  // An insight answer (AGL-2915) is about the site's figures; the feed row\n  // names it and never what it says.\n  insight: 'content',\n  // A CRM proposal (AGL-2917) writes nothing; the feed files it with content.\n  crm: 'content',\n  // Another plugin's draft a build asked its writer for (AGL-3616).\n  draft: 'content',\n  // A logic proposal (AGL-3603) writes nothing either.\n  logic: 'content',\n  // So does an org automation's (AGL-3603): the editor's Save is the write.\n  orgAutomation: 'content',\n  // A blog post a guided start wrote (AGL-3676) is the site's content.\n  entry: 'content',\n  // A site's settings a build saved (AGL-3748) describe the site, filed with its content.\n  settings: 'content',\n  // Files a build organized in the site's media library (AGL-3752), filed with its content.\n  media: 'content',\n  // A site's tracking tags a build saved (AGL-3751), filed with its settings.\n  tracking: 'content',\n}\n\nexport function aiOutputTargetType(resource: AiJobOutputResource): AiOutputTargetType {\n  return AI_OUTPUT_TARGET_TYPES[resource]\n}\n\n/** Whether a stored action is one of the AI codes above. */\nexport function isAiActivityAction(action: unknown): action is AiActivityAction {\n  return (\n    typeof action === 'string' &&\n    (AI_ACTIVITY_ACTION_LIST as readonly string[]).includes(action)\n  )\n}\n\n/** The readable label for an AI code; `undefined` for any other action. */\nexport function aiActivityActionLabel(action: unknown): string | undefined {\n  return isAiActivityAction(action)\n    ? AI_ACTIVITY_ACTION_LABELS[action]\n    : undefined\n}\n\n/**\n * Staff audit rows that are ABOUT AI without carrying an `ai.` code: the\n * customer's overage controls already write `billing.assistOverage.*`, and\n * the platform's free-spend auto-pause writes `platform.aiFreeSpend.*`\n * (AGL-2925). The audit page's facet folds them under the same group as the\n * codes, because \"what did we do about AI this week\" is one question.\n */\nexport const AI_STAFF_AUDIT_ACTION_PREFIXES: readonly string[] = [\n  'ai.',\n  'billing.assistOverage.',\n  'platform.aiFreeSpend.',\n]\n\n/** The facet group an `adminAudit` action belongs to. */\nexport const STAFF_AUDIT_AI_GROUP = 'ai'\n\n/**\n * Which log each code is written to. The job and edit codes land in both\n * the org feed and the host's copy; the billing and permission codes are\n * org-level facts and land in the org feed alone.\n */\nconst AI_ACTIVITY_ACTION_SCOPES: Record<\n  AiActivityAction,\n  PluginActivityScope | readonly PluginActivityScope[]\n> = {\n  'ai.job.created': ['org', 'host'],\n  'ai.job.output': ['org', 'host'],\n  'ai.job.canceled': ['org', 'host'],\n  'ai.job.needs_input': ['org', 'host'],\n  'ai.edit.applied': ['org', 'host'],\n  'ai.seo.applied': ['org', 'host'],\n  'ai.assist.section': ['org', 'host'],\n  'ai.overage.hardCap': 'org',\n  'ai.overage.cap': 'org',\n  'ai.allotment.changed': 'org',\n  'ai.permission.changed': 'org',\n  'ai.addon.purchased': 'org',\n  'ai.addon.removed': 'org',\n}\n\n/**\n * The catalog, declared through the generic activity-action seam\n * (AGL-2940) so the feed's chip, the actor table's filter and the staff\n * facet read it from the registry beside every other plugin's codes.\n * `registerAiDeclarations` calls it, in both apps and in the browser.\n */\nexport function registerAiActivityActions(): void {\n  registerPluginActivityActions({\n    pluginId: 'ai',\n    group: {\n      id: STAFF_AUDIT_AI_GROUP,\n      label: AI_ACTIVITY_FILTER_LABEL,\n      staffAuditPrefixes: AI_STAFF_AUDIT_ACTION_PREFIXES.filter(\n        (prefix) => prefix !== 'ai.',\n      ),\n      // The staff cards opening on an org (AGL-2930) and on one account\n      // (AGL-2928), which no longer write these, so the rows already in the\n      // log still classify as reads; and a staff member reading what an org\n      // asked Aglyn AI (AGL-3675), which writes one per page.\n      // An account's AI requests on the staff user page (AGL-3660) likewise.\n      staffAuditAccessActions: [\n        'org.ai-viewed',\n        'user.ai-usage-viewed',\n        'org.ai-conversations-viewed',\n        'user.ai-requests-viewed',\n      ],\n      staffAuditLabels: AI_STAFF_AUDIT_LABELS,\n      // The audit trail's words for a job's output, its job collection and\n      // the feed's job rows, read by core's shared describer (AGL-3660).\n      staffAuditDescribe: aiStaffAuditDescribe,\n      staffAuditCollections: { aiJobs: { noun: `${PLATFORM_BRAND_NAME} AI job`, job: true } },\n      jobTargetTypes: ['aiJob'],\n    },\n    actions: AI_ACTIVITY_ACTION_LIST.map((key) => ({\n      key,\n      label: AI_ACTIVITY_ACTION_LABELS[key],\n      ...(AI_ACTIVITY_ACTION_SENTENCES[key] ? { sentence: AI_ACTIVITY_ACTION_SENTENCES[key] } : {}),\n      scope: AI_ACTIVITY_ACTION_SCOPES[key],\n    })),\n    // A generation job (AGL-2904): the org feed names the job, and each of\n    // its outputs names the resource it produced. Filed as `aiJob` since\n    // before plugin target types were namespaced, so the noun is declared\n    // here rather than read off the type (AGL-3080).\n    targetTypes: { aiJob: 'AI generation' },\n  })\n}\n\n/**\n * The group the staff audit facet files an action under: `ai` for every\n * AI row, otherwise the action's leading namespace (`billing`, `org`,\n * `plugins`). Roughly seventy distinct actions write to `adminAudit`, so\n * the facet offers namespaces rather than a seventy-entry menu. Answered\n * by the registry, so every plugin's group is filed the same way.\n */\nexport function staffAuditActionGroup(action: unknown): string {\n  return pluginStaffAuditActionGroup(action)\n}\n\n/** How a facet group reads in the menu: `ai` → `AI`, `billing` → `billing`. */\nexport function staffAuditActionGroupLabel(group: string): string {\n  return pluginStaffAuditActionGroupLabel(group)\n}\n"],"names":["PLATFORM_BRAND_NAME","pluginStaffAuditActionGroup","pluginStaffAuditActionGroupLabel","registerPluginActivityActions","AI_ACTIVITY_ACTIONS","jobCreated","jobOutput","jobCanceled","jobNeedsInput","editApplied","seoApplied","assistSection","overageHardCap","overageCap","allotmentChanged","permissionChanged","addonPurchased","addonRemoved","AI_ACTIVITY_ACTION_LABELS","AI_ACTIVITY_ACTION_SENTENCES","AI_STAFF_AUDIT_LABELS","Object","fromEntries","entries","filter","key","AI_OUTPUT_NOUNS","screen","reusableComponent","emailScreen","orgAutomation","workflow","entry","text","seo","crm","insight","aiStaffAuditDescribe","action","undefined","resource","after","label","trim","noun","replace","toLowerCase","result","AI_ACTIVITY_ACTION_LIST","values","AI_ACTIVITY_FILTER_LABEL","AI_JOB_NEEDS_INPUT_REASON_LABELS","plan","doctrine","limit","band","cap","messages","budget","allotment","account","requests","refusals","platform","AI_OUTPUT_TARGET_TYPES","layout","template","form","campaign","product","experiment","theme","draft","logic","settings","media","tracking","aiOutputTargetType","isAiActivityAction","includes","aiActivityActionLabel","AI_STAFF_AUDIT_ACTION_PREFIXES","STAFF_AUDIT_AI_GROUP","AI_ACTIVITY_ACTION_SCOPES","registerAiActivityActions","pluginId","group","id","staffAuditPrefixes","prefix","staffAuditAccessActions","staffAuditLabels","staffAuditDescribe","staffAuditCollections","aiJobs","job","jobTargetTypes","actions","map","sentence","scope","targetTypes","aiJob","staffAuditActionGroup","staffAuditActionGroupLabel"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/activity/ai-activity-actions.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\n/**\n * The AI actions an activity log can carry (AGL-2929).\n *\n * Every other action in `orgs/{orgId}/activity` and `hosts/{hostId}/activity`\n * is a prose sentence written at the call site — \"Saved the screen\". The AI\n * rows are CODES instead, because they are read by more than a person: the\n * org feed's \"AI\" chip, the staff audit facet and the actor table all need\n * to recognize an AI row without parsing a sentence, and a sentence that\n * three writers phrase three ways is three rows that look unrelated.\n *\n * One list, so the writers in `ai-activity.ts`, the feed presenter and the\n * staff facet cannot disagree about what counts as AI. A code missing from\n * `AI_ACTIVITY_ACTION_LABELS` fails the type, not the reader.\n */\n\nimport type { AiJobOutputResource } from '../model/ai-jobs.types'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport {\n  pluginStaffAuditActionGroup,\n  pluginStaffAuditActionGroupLabel,\n  registerPluginActivityActions,\n  type PluginActivityScope,\n} from '@aglyn/aglyn/plugin-manager/plugin-activity-actions'\n\n/** The action code each AI writer stores. */\nexport const AI_ACTIVITY_ACTIONS = {\n  jobCreated: 'ai.job.created',\n  jobOutput: 'ai.job.output',\n  jobCanceled: 'ai.job.canceled',\n  jobNeedsInput: 'ai.job.needs_input',\n  editApplied: 'ai.edit.applied',\n  seoApplied: 'ai.seo.applied',\n  assistSection: 'ai.assist.section',\n  overageHardCap: 'ai.overage.hardCap',\n  overageCap: 'ai.overage.cap',\n  allotmentChanged: 'ai.allotment.changed',\n  permissionChanged: 'ai.permission.changed',\n  addonPurchased: 'ai.addon.purchased',\n  addonRemoved: 'ai.addon.removed',\n} as const\n\nexport type AiActivityAction =\n  (typeof AI_ACTIVITY_ACTIONS)[keyof typeof AI_ACTIVITY_ACTIONS]\n\n/** What a person reads for each code, in the feed and the actor table. */\nexport const AI_ACTIVITY_ACTION_LABELS: Record<AiActivityAction, string> = {\n  'ai.job.created': 'Started an AI generation',\n  'ai.job.output': 'AI generated',\n  'ai.job.canceled': 'Canceled an AI generation',\n  'ai.job.needs_input': 'AI generation paused for input',\n  'ai.edit.applied': 'Applied AI edits',\n  'ai.seo.applied': 'Applied AI SEO fixes as drafts',\n  'ai.assist.section': 'AI generated a section',\n  'ai.overage.hardCap': 'AI stop-at-band switch',\n  'ai.overage.cap': 'AI overage ceiling',\n  'ai.allotment.changed': 'AI allotment changed',\n  'ai.permission.changed': 'AI permission changed',\n  'ai.addon.purchased': 'Added the AI add-on',\n  'ai.addon.removed': 'Removed the AI add-on',\n}\n\n/**\n * The codes whose row reads as a sentence about its target (AGL-3660):\n * `{target}` is the target's noun and name, so an output row reads\n * `Created page Home with Aglyn AI` rather than `AI generated` beside a\n * Target cell that had to finish the thought.\n */\nexport const AI_ACTIVITY_ACTION_SENTENCES: Partial<Record<AiActivityAction, string>> = {\n  'ai.job.output': `Created {target} with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.edit.applied': `Applied ${PLATFORM_BRAND_NAME} AI edits to {target}`,\n  'ai.seo.applied': `Applied ${PLATFORM_BRAND_NAME} AI search fixes to {target}`,\n  'ai.assist.section': `Added a section to {target} with ${PLATFORM_BRAND_NAME} AI`,\n}\n\n/**\n * What the staff audit trail reads for each code the AI doors write to\n * `adminAudit` (AGL-3660). `ai.job.output` is spelled out per row by the\n * shared describer, which names the thing made.\n */\nexport const AI_STAFF_AUDIT_LABELS: Readonly<Record<string, string>> = {\n  'ai.job.output': `Created a draft with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.job.cancel': `Canceled an ${PLATFORM_BRAND_NAME} AI job`,\n  'ai.job.resume': `Confirmed an ${PLATFORM_BRAND_NAME} AI plan`,\n  'ai.job.apply': `Applied an ${PLATFORM_BRAND_NAME} AI result`,\n  'ai.generate': `Generated with ${PLATFORM_BRAND_NAME} AI`,\n  'ai.allotments.set': 'Set AI allotments',\n  'ai.credits.giveBack': 'Gave AI credits back',\n  'ai.credits.reset': 'Reset AI credits',\n  'ai.overage.clearCeiling': 'Cleared the AI overage ceiling',\n  'ai.overage.liftPause': 'Lifted the AI pause',\n  'ai.overage.resetStep': 'Reset the AI overage step',\n  'ai.overage.setCeiling': 'Set the AI overage ceiling',\n  'platform.aiFreeSpend.paused': 'Paused free AI for the day',\n  'org.ai-viewed': 'Viewed the organization’s AI usage',\n  'user.ai-usage-viewed': 'Viewed the account’s AI usage',\n  'org.ai-conversations-viewed': `Viewed the organization’s ${PLATFORM_BRAND_NAME} AI requests`,\n  'user.ai-requests-viewed': `Viewed the account’s ${PLATFORM_BRAND_NAME} AI requests`,\n  ...Object.fromEntries(\n    Object.entries(AI_ACTIVITY_ACTION_LABELS).filter(([key]) => key !== 'ai.job.output'),\n  ),\n}\n\n/** A job output's `resource`, as the noun the audit sentence uses. */\nconst AI_OUTPUT_NOUNS: Readonly<Record<string, string>> = {\n  screen: 'page',\n  reusableComponent: 'component',\n  emailScreen: 'email',\n  orgAutomation: 'automation',\n  workflow: 'automation',\n  entry: 'post',\n  text: 'copy',\n  seo: 'search fixes',\n  crm: 'CRM answer',\n  insight: 'insight',\n}\n\n/**\n * An `ai.job.output` audit row in words (AGL-3660), from the `after` the\n * job writer stores — `{ resource, label }`: `Created page Home with Aglyn\n * AI`, and its outcome, a draft.\n */\nexport function aiStaffAuditDescribe(entry: {\n  action: string\n  after: Readonly<Record<string, unknown>>\n}): { action?: string; result?: string } | undefined {\n  if (entry.action !== AI_ACTIVITY_ACTIONS.jobOutput) return undefined\n  const resource = typeof entry.after['resource'] === 'string' ? entry.after['resource'] : ''\n  const label = typeof entry.after['label'] === 'string' ? entry.after['label'].trim() : ''\n  const noun =\n    AI_OUTPUT_NOUNS[resource] ??\n    (resource ? resource.replace(/([a-z])([A-Z])/g, '$1 $2').toLowerCase() : 'draft')\n  return {\n    action: `Created ${noun}${label ? ` ${label}` : ''} with ${PLATFORM_BRAND_NAME} AI`,\n    result: 'Draft created',\n  }\n}\n\n/** Every code, in catalog order — what a filter sends as `isAnyOf`. */\nexport const AI_ACTIVITY_ACTION_LIST: readonly AiActivityAction[] =\n  Object.values(AI_ACTIVITY_ACTIONS)\n\n/** The feed's filter chip and the staff facet's group, by one name. */\nexport const AI_ACTIVITY_FILTER_LABEL = 'AI'\n\n/**\n * Why a generation stopped and asked for a person (AGL-2904): the plan's\n * band ran out, the org's own ceiling refused, the monthly message cap or\n * the job's own token budget did — or, on the Free taste (AGL-2925), one of\n * its own precautions: the account's credits, its daily request cap, a\n * pause after declined briefs, or the platform's day of free spend. Those\n * are the meter's `AssistRefusedBy` less its `null`, so a ceiling the meter\n * can name is one the feed can label. The last three are the job's own: its\n * plan is ready for review, or an answer broke a building rule on its re-ask\n * (AGL-2935), or the site is at an allowance its plan sets for what the job\n * writes (AGL-2909).\n */\nexport type AiJobNeedsInputReason =\n  | 'band'\n  | 'cap'\n  | 'messages'\n  | 'budget'\n  | 'allotment'\n  | 'account'\n  | 'requests'\n  | 'refusals'\n  | 'platform'\n  | 'plan'\n  | 'doctrine'\n  | 'limit'\n  | 'input'\n\nexport const AI_JOB_NEEDS_INPUT_REASON_LABELS: Record<\n  AiJobNeedsInputReason,\n  string\n> = {\n  plan: 'its plan is ready for review',\n  doctrine: 'its answer broke a building rule twice',\n  limit: 'the site reached an allowance of its plan',\n  input: 'it needs an ID only the person can give',\n  band: 'the included AI band is used up',\n  cap: 'the overage ceiling was reached',\n  messages: 'the monthly message cap was reached',\n  budget: 'the job budget was reached',\n  allotment: 'the creator’s or the site’s AI allotment is used up',\n  account: 'the account’s free AI credits are used up',\n  requests: 'the daily free request cap was reached',\n  refusals: 'free generation is paused for the day after declined briefs',\n  platform: 'free AI generation is paused for the day',\n}\n\n/**\n * The feed target types a generation job's output can be filed under: the\n * kinds both activity logs know, so the org row and its host copy share a\n * shape.\n */\nexport type AiOutputTargetType =\n  | 'screen'\n  | 'layout'\n  | 'component'\n  | 'template'\n  | 'workflow'\n  | 'content'\n  | 'theme'\n\n/**\n * Where the feed files each resource kind a job can write (AGL-2904).\n *\n * A job names its output by the resource it wrote, and the activity logs\n * know a narrower set of targets. The map is total, so a resource kind\n * added to the job document must say where the feed shows it before the\n * machine can log it. `reusableComponent` is the feed's `component`; a\n * `text` output is copy, which the feed files as `content`; a `theme`\n * proposal is filed under the site's theme, which the host feed links to the\n * Theme section (AGL-2938); the kinds whose runners have not shipped are\n * content of the site too, and are filed there until a target of their own\n * exists.\n */\nconst AI_OUTPUT_TARGET_TYPES: Record<AiJobOutputResource, AiOutputTargetType> = {\n  screen: 'screen',\n  reusableComponent: 'component',\n  layout: 'layout',\n  template: 'template',\n  form: 'content',\n  emailScreen: 'content',\n  campaign: 'content',\n  product: 'content',\n  experiment: 'content',\n  workflow: 'workflow',\n  // An SEO proposal (AGL-2910) is about the site's content, and is filed there.\n  seo: 'content',\n  text: 'content',\n  theme: 'theme',\n  // An insight answer (AGL-2915) is about the site's figures; the feed row\n  // names it and never what it says.\n  insight: 'content',\n  // A CRM proposal (AGL-2917) writes nothing; the feed files it with content.\n  crm: 'content',\n  // Another plugin's draft a build asked its writer for (AGL-3616).\n  draft: 'content',\n  // A logic proposal (AGL-3603) writes nothing either.\n  logic: 'content',\n  // So does an org automation's (AGL-3603): the editor's Save is the write.\n  orgAutomation: 'content',\n  // A blog post a guided start wrote (AGL-3676) is the site's content.\n  entry: 'content',\n  // A site's settings a build saved (AGL-3748) describe the site, filed with its content.\n  settings: 'content',\n  // Files a build organized in the site's media library (AGL-3752), filed with its content.\n  media: 'content',\n  // A site's tracking tags a build saved (AGL-3751), filed with its settings.\n  tracking: 'content',\n}\n\nexport function aiOutputTargetType(resource: AiJobOutputResource): AiOutputTargetType {\n  return AI_OUTPUT_TARGET_TYPES[resource]\n}\n\n/** Whether a stored action is one of the AI codes above. */\nexport function isAiActivityAction(action: unknown): action is AiActivityAction {\n  return (\n    typeof action === 'string' &&\n    (AI_ACTIVITY_ACTION_LIST as readonly string[]).includes(action)\n  )\n}\n\n/** The readable label for an AI code; `undefined` for any other action. */\nexport function aiActivityActionLabel(action: unknown): string | undefined {\n  return isAiActivityAction(action)\n    ? AI_ACTIVITY_ACTION_LABELS[action]\n    : undefined\n}\n\n/**\n * Staff audit rows that are ABOUT AI without carrying an `ai.` code: the\n * customer's overage controls already write `billing.assistOverage.*`, and\n * the platform's free-spend auto-pause writes `platform.aiFreeSpend.*`\n * (AGL-2925). The audit page's facet folds them under the same group as the\n * codes, because \"what did we do about AI this week\" is one question.\n */\nexport const AI_STAFF_AUDIT_ACTION_PREFIXES: readonly string[] = [\n  'ai.',\n  'billing.assistOverage.',\n  'platform.aiFreeSpend.',\n]\n\n/** The facet group an `adminAudit` action belongs to. */\nexport const STAFF_AUDIT_AI_GROUP = 'ai'\n\n/**\n * Which log each code is written to. The job and edit codes land in both\n * the org feed and the host's copy; the billing and permission codes are\n * org-level facts and land in the org feed alone.\n */\nconst AI_ACTIVITY_ACTION_SCOPES: Record<\n  AiActivityAction,\n  PluginActivityScope | readonly PluginActivityScope[]\n> = {\n  'ai.job.created': ['org', 'host'],\n  'ai.job.output': ['org', 'host'],\n  'ai.job.canceled': ['org', 'host'],\n  'ai.job.needs_input': ['org', 'host'],\n  'ai.edit.applied': ['org', 'host'],\n  'ai.seo.applied': ['org', 'host'],\n  'ai.assist.section': ['org', 'host'],\n  'ai.overage.hardCap': 'org',\n  'ai.overage.cap': 'org',\n  'ai.allotment.changed': 'org',\n  'ai.permission.changed': 'org',\n  'ai.addon.purchased': 'org',\n  'ai.addon.removed': 'org',\n}\n\n/**\n * The catalog, declared through the generic activity-action seam\n * (AGL-2940) so the feed's chip, the actor table's filter and the staff\n * facet read it from the registry beside every other plugin's codes.\n * `registerAiDeclarations` calls it, in both apps and in the browser.\n */\nexport function registerAiActivityActions(): void {\n  registerPluginActivityActions({\n    pluginId: 'ai',\n    group: {\n      id: STAFF_AUDIT_AI_GROUP,\n      label: AI_ACTIVITY_FILTER_LABEL,\n      staffAuditPrefixes: AI_STAFF_AUDIT_ACTION_PREFIXES.filter(\n        (prefix) => prefix !== 'ai.',\n      ),\n      // The staff cards opening on an org (AGL-2930) and on one account\n      // (AGL-2928), which no longer write these, so the rows already in the\n      // log still classify as reads; and a staff member reading what an org\n      // asked Aglyn AI (AGL-3675), which writes one per page.\n      // An account's AI requests on the staff user page (AGL-3660) likewise.\n      staffAuditAccessActions: [\n        'org.ai-viewed',\n        'user.ai-usage-viewed',\n        'org.ai-conversations-viewed',\n        'user.ai-requests-viewed',\n      ],\n      staffAuditLabels: AI_STAFF_AUDIT_LABELS,\n      // The audit trail's words for a job's output, its job collection and\n      // the feed's job rows, read by core's shared describer (AGL-3660).\n      staffAuditDescribe: aiStaffAuditDescribe,\n      staffAuditCollections: { aiJobs: { noun: `${PLATFORM_BRAND_NAME} AI job`, job: true } },\n      jobTargetTypes: ['aiJob'],\n    },\n    actions: AI_ACTIVITY_ACTION_LIST.map((key) => ({\n      key,\n      label: AI_ACTIVITY_ACTION_LABELS[key],\n      ...(AI_ACTIVITY_ACTION_SENTENCES[key] ? { sentence: AI_ACTIVITY_ACTION_SENTENCES[key] } : {}),\n      scope: AI_ACTIVITY_ACTION_SCOPES[key],\n    })),\n    // A generation job (AGL-2904): the org feed names the job, and each of\n    // its outputs names the resource it produced. Filed as `aiJob` since\n    // before plugin target types were namespaced, so the noun is declared\n    // here rather than read off the type (AGL-3080).\n    targetTypes: { aiJob: 'AI generation' },\n  })\n}\n\n/**\n * The group the staff audit facet files an action under: `ai` for every\n * AI row, otherwise the action's leading namespace (`billing`, `org`,\n * `plugins`). Roughly seventy distinct actions write to `adminAudit`, so\n * the facet offers namespaces rather than a seventy-entry menu. Answered\n * by the registry, so every plugin's group is filed the same way.\n */\nexport function staffAuditActionGroup(action: unknown): string {\n  return pluginStaffAuditActionGroup(action)\n}\n\n/** How a facet group reads in the menu: `ai` → `AI`, `billing` → `billing`. */\nexport function staffAuditActionGroupLabel(group: string): string {\n  return pluginStaffAuditActionGroupLabel(group)\n}\n"],"names":["PLATFORM_BRAND_NAME","pluginStaffAuditActionGroup","pluginStaffAuditActionGroupLabel","registerPluginActivityActions","AI_ACTIVITY_ACTIONS","jobCreated","jobOutput","jobCanceled","jobNeedsInput","editApplied","seoApplied","assistSection","overageHardCap","overageCap","allotmentChanged","permissionChanged","addonPurchased","addonRemoved","AI_ACTIVITY_ACTION_LABELS","AI_ACTIVITY_ACTION_SENTENCES","AI_STAFF_AUDIT_LABELS","Object","fromEntries","entries","filter","key","AI_OUTPUT_NOUNS","screen","reusableComponent","emailScreen","orgAutomation","workflow","entry","text","seo","crm","insight","aiStaffAuditDescribe","action","undefined","resource","after","label","trim","noun","replace","toLowerCase","result","AI_ACTIVITY_ACTION_LIST","values","AI_ACTIVITY_FILTER_LABEL","AI_JOB_NEEDS_INPUT_REASON_LABELS","plan","doctrine","limit","input","band","cap","messages","budget","allotment","account","requests","refusals","platform","AI_OUTPUT_TARGET_TYPES","layout","template","form","campaign","product","experiment","theme","draft","logic","settings","media","tracking","aiOutputTargetType","isAiActivityAction","includes","aiActivityActionLabel","AI_STAFF_AUDIT_ACTION_PREFIXES","STAFF_AUDIT_AI_GROUP","AI_ACTIVITY_ACTION_SCOPES","registerAiActivityActions","pluginId","group","id","staffAuditPrefixes","prefix","staffAuditAccessActions","staffAuditLabels","staffAuditDescribe","staffAuditCollections","aiJobs","job","jobTargetTypes","actions","map","sentence","scope","targetTypes","aiJob","staffAuditActionGroup","staffAuditActionGroupLabel"],"mappings":"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"}

package/src/lib/components/ai-credits-card.component.d.ts

@@ -23,9 +23,10 @@ export interface AiCreditsCardProps {
  * override, draws no meter — a "0 of 0" meter is not a readout of anything —
  * but says the plan has no credits and links to Billing (AGL-3982), since a
  * missing card reads as AI not existing here. ONE meter for one pool: the
- * add-on widens `assistCreditsPerMonth` rather than opening a second band,
- * so the limit here is already plan plus add-on and the caption under it
- * says how much of that the add-on is.
+ * plan's included credits pay for every AI action, generation included
+ * (AGL-3965), and an Aglyn AI tier widens `assistCreditsPerMonth` rather than
+ * opening a second band, so the limit here is already plan plus tier and the
+ * caption under it says how much of that the tier is.
  *
  * From the server, not from Firestore like the platform's meters:
  * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser

package/src/lib/components/ai-credits-card.component.js

@@ -15,7 +15,7 @@
  * limitations under the License.
  */ 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { AI_ADDON_CREDITS_PER_MONTH, aiAddonName, hasAiAddon, isUnlimitedQuota, resolveEffectivePlan, resolveOrgEntitlements, resolvePlanPricing } from "@aglyn/aglyn";
+import { AI_TIERS, aiAddonName, aiTierName, isUnlimitedQuota, orgCanBuyAiTier, resolveAiTier, resolveOrgEntitlements } from "@aglyn/aglyn";
 import { pluginDocsHelp } from "@aglyn/aglyn/app-utils/docs-help";
 import { CardDisplay } from "@aglyn/shared-ui-jsx";
 import { PrerequisiteNotice } from "@aglyn/shared-ui-jsx/components/prerequisite-notice.component";
@@ -41,9 +41,10 @@ import { useUser } from "@aglyn/tenant-feature-instance";
  * override, draws no meter — a "0 of 0" meter is not a readout of anything —
  * but says the plan has no credits and links to Billing (AGL-3982), since a
  * missing card reads as AI not existing here. ONE meter for one pool: the
- * add-on widens `assistCreditsPerMonth` rather than opening a second band,
- * so the limit here is already plan plus add-on and the caption under it
- * says how much of that the add-on is.
+ * plan's included credits pay for every AI action, generation included
+ * (AGL-3965), and an Aglyn AI tier widens `assistCreditsPerMonth` rather than
+ * opening a second band, so the limit here is already plan plus tier and the
+ * caption under it says how much of that the tier is.
  *
  * From the server, not from Firestore like the platform's meters:
  * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser
@@ -77,7 +78,7 @@ import { useUser } from "@aglyn/tenant-feature-instance";
     const entitlements = resolveOrgEntitlements(org);
     const help = pluginDocsHelp('aiCredits', {
         anchor: '#see-your-credits',
-        excerpt: 'AI credits drawn this month against your included band: your plan’s ' + 'credits plus the AI add-on’s. The band resets on the first of the month.'
+        excerpt: 'AI credits drawn this month against one pool: your plan’s included ' + 'credits plus your AI tier’s, if you have one. Every AI action draws on ' + 'it. The pool resets on the first of the month.'
     });
     // A band of zero (AGL-3982): said, with the way to a plan that has one,
     // rather than a missing card that reads as AI not existing here.
@@ -94,11 +95,10 @@ import { useUser } from "@aglyn/tenant-feature-instance";
             })
         });
     }
-    const plan = resolveEffectivePlan(org);
-    const aiAddonCredits = hasAiAddon(org) ? AI_ADDON_CREDITS_PER_MONTH[plan] : 0;
+    const aiTier = resolveAiTier(org);
     // Sold to THIS workspace, not merely on its plan: a staff comp has no
-    // subscription to add the item to, so its price list sells none (AGL-3034).
-    const aiAddonSold = resolvePlanPricing(org).aiAddonMonthlyUsd != null;
+    // subscription to add the item to, so it sells none (AGL-3034).
+    const tiersSold = orgCanBuyAiTier(org);
     return /*#__PURE__*/ _jsxs(CardDisplay, {
         header: 'AI credits',
         help: help,
@@ -112,7 +112,7 @@ import { useUser } from "@aglyn/tenant-feature-instance";
                 unlimited: isUnlimitedQuota(entitlements.assistCreditsPerMonth),
                 upgradeHref: billingHref ? `${billingHref}#plans` : '#plans'
             }),
-            aiAddonCredits > 0 ? /*#__PURE__*/ _jsx(Typography, {
+            aiTier ? /*#__PURE__*/ _jsx(Typography, {
                 variant: "caption",
                 color: "text.secondary",
                 sx: {
@@ -120,9 +120,9 @@ import { useUser } from "@aglyn/tenant-feature-instance";
                     mt: -1.5,
                     mb: 2
                 },
-                children: `Includes ${aiAddonCredits.toLocaleString()} credits a month from ` + `the ${aiAddonName()} add-on.`
+                children: `Includes ${AI_TIERS[aiTier].credits.toLocaleString()} credits a month ` + `from ${aiTierName(aiTier)}, on top of your plan's.`
             }) : null,
-            !entitlements.features.aiGenerative && aiAddonSold ? /*#__PURE__*/ _jsxs(Typography, {
+            !aiTier && tiersSold ? /*#__PURE__*/ _jsxs(Typography, {
                 variant: "caption",
                 color: "text.secondary",
                 sx: {
@@ -131,14 +131,14 @@ import { useUser } from "@aglyn/tenant-feature-instance";
                     mb: 2
                 },
                 children: [
-                    `Generate pages, emails, campaigns and more with ${aiAddonName()}, ` + `and add ${AI_ADDON_CREDITS_PER_MONTH[plan].toLocaleString()} ` + 'credits a month to this pool: ',
+                    `Need more? An ${aiAddonName()} tier adds ` + `${AI_TIERS.spark.credits.toLocaleString()} to ` + `${AI_TIERS.studio.credits.toLocaleString()} credits a month to this pool: `,
                     /*#__PURE__*/ _jsx(Link, {
                         href: `${billingHref != null ? billingHref : ''}#addons`,
                         color: "primary",
                         underline: "hover",
-                        children: `Add ${aiAddonName()}`
+                        children: 'Choose a tier'
                     }),
-                    ' in Billing → Plans.'
+                    ' in Billing → Plan.'
                 ]
             }) : null
         ]

package/src/lib/components/ai-credits-card.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-credits-card.component.tsx"],"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'use client'\n\nimport {\n  AI_ADDON_CREDITS_PER_MONTH,\n  aiAddonName,\n  hasAiAddon,\n  isUnlimitedQuota,\n  resolveEffectivePlan,\n  resolveOrgEntitlements,\n  resolvePlanPricing,\n  type AglynOrgBilling,\n} from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { PrerequisiteNotice } from '@aglyn/shared-ui-jsx/components/prerequisite-notice.component'\nimport { UsageMeter } from '@aglyn/shared-ui-jsx/components/usage-meter.component'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { Link, Typography } from '@mui/material'\nimport { useEffect, useState } from 'react'\nimport { useUser } from '@aglyn/tenant-feature-instance'\n\nexport interface AiCreditsCardProps {\n  orgId?: string | null\n  /** The billing-merged org doc the Usage page resolved. */\n  org?: Partial<AglynOrgBilling> | null\n  /** The Billing overview's path, for the one caption that points at the add-ons card. */\n  billingHref?: string\n}\n\n/**\n * The AI credits meter (AGL-2899), on the Billing → Usage page's plugin\n * band below the platform's own meters (AGL-2939).\n *\n * Credits, because AI actions differ in cost by up to two orders of\n * magnitude — a question against generating a screen — and a message count\n * would price them the same. The band is refused at the cap, so this\n * readout is the only thing standing between a customer and learning their\n * limit by being turned down mid-build.\n *\n * Rendered only where a band is sold, which since AGL-3203 is every plan\n * row: Free carries the taste and Starter 750, so both render a meter even\n * though neither carries `aiAssist` — the band is credits, not the guided\n * rung. A band of ZERO, which now reaches this component only as a per-org\n * override, draws no meter — a \"0 of 0\" meter is not a readout of anything —\n * but says the plan has no credits and links to Billing (AGL-3982), since a\n * missing card reads as AI not existing here. ONE meter for one pool: the\n * add-on widens `assistCreditsPerMonth` rather than opening a second band,\n * so the limit here is already plan plus add-on and the caption under it\n * says how much of that the add-on is.\n *\n * From the server, not from Firestore like the platform's meters:\n * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser\n * read would fail silently and leave this reading \"not yet metered\" forever.\n * Credits, never dollars: the route is where the one conversion happens.\n */\nexport default function AiCreditsCard(props: AiCreditsCardProps) {\n  const { orgId, org, billingHref } = props\n  const { data: user } = useUser()\n  const [credits, setCredits] = useState<{ used: number; limit: number | null } | null>(null)\n  useEffect(() => {\n    if (!orgId || !user) return undefined\n    let active = true\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          user,\n          `/api/ai/billing/credits?orgId=${encodeURIComponent(orgId)}`,\n        )\n        if (!response.ok) return\n        const result = await response.json()\n        if (active && result?.credits) setCredits(result.credits)\n      } catch {\n        // The meter keeps its \"not yet metered\" state on failure —\n        // deliberately not 0, which reads as \"you have used none\".\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, user])\n\n  const entitlements = resolveOrgEntitlements(org)\n  const help = pluginDocsHelp('aiCredits', {\n    anchor: '#see-your-credits',\n    excerpt:\n      'AI credits drawn this month against your included band: your plan’s ' +\n      'credits plus the AI add-on’s. The band resets on the first of the month.',\n  })\n  // A band of zero (AGL-3982): said, with the way to a plan that has one,\n  // rather than a missing card that reads as AI not existing here.\n  if (entitlements.assistCreditsPerMonth <= 0) {\n    return (\n      <CardDisplay header={'AI credits'} help={help} contentGutterX contentGutterY>\n        <PrerequisiteNotice href={billingHref ? `${billingHref}#plans` : '#plans'} actionLabel=\"See plans\">\n          {'Your plan includes no AI credits. Choose a plan with AI credits in Billing to use the AI features.'}\n        </PrerequisiteNotice>\n      </CardDisplay>\n    )\n  }\n  const plan = resolveEffectivePlan(org)\n  const aiAddonCredits = hasAiAddon(org) ? AI_ADDON_CREDITS_PER_MONTH[plan] : 0\n  // Sold to THIS workspace, not merely on its plan: a staff comp has no\n  // subscription to add the item to, so its price list sells none (AGL-3034).\n  const aiAddonSold = resolvePlanPricing(org).aiAddonMonthlyUsd != null\n  return (\n    <CardDisplay\n      header={'AI credits'}\n      help={help}\n      contentGutterX\n      contentGutterY\n    >\n      {/* An uncapped staff comp (AGL-3049) resolves this band `UNLIMITED`:\n          the meter reads \"Unlimited\" and draws no bar, never \"/ Infinity\". */}\n      <UsageMeter\n        label=\"AI credits (this month)\"\n        used={credits ? credits.used : null}\n        limit={entitlements.assistCreditsPerMonth}\n        unlimited={isUnlimitedQuota(entitlements.assistCreditsPerMonth)}\n        upgradeHref={billingHref ? `${billingHref}#plans` : '#plans'}\n      />\n      {aiAddonCredits > 0 ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Includes ${aiAddonCredits.toLocaleString()} credits a month from ` +\n            `the ${aiAddonName()} add-on.`}\n        </Typography>\n      ) : null}\n      {/* A plan with a band that sells the add-on and has not bought it:\n          the one line on the meters that points at more capacity rather\n          than at an upgrade. */}\n      {!entitlements.features.aiGenerative && aiAddonSold ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Generate pages, emails, campaigns and more with ${aiAddonName()}, ` +\n            `and add ${AI_ADDON_CREDITS_PER_MONTH[plan].toLocaleString()} ` +\n            'credits a month to this pool: '}\n          <Link href={`${billingHref ?? ''}#addons`} color=\"primary\" underline=\"hover\">\n            {`Add ${aiAddonName()}`}\n          </Link>\n          {' in Billing → Plans.'}\n        </Typography>\n      ) : null}\n    </CardDisplay>\n  )\n}\n"],"names":["AI_ADDON_CREDITS_PER_MONTH","aiAddonName","hasAiAddon","isUnlimitedQuota","resolveEffectivePlan","resolveOrgEntitlements","resolvePlanPricing","pluginDocsHelp","CardDisplay","PrerequisiteNotice","UsageMeter","authorizedFetch","Link","Typography","useEffect","useState","useUser","AiCreditsCard","props","orgId","org","billingHref","data","user","credits","setCredits","undefined","active","response","encodeURIComponent","ok","result","json","entitlements","help","anchor","excerpt","assistCreditsPerMonth","header","contentGutterX","contentGutterY","href","actionLabel","plan","aiAddonCredits","aiAddonSold","aiAddonMonthlyUsd","label","used","limit","unlimited","upgradeHref","variant","color","sx","display","mt","mb","toLocaleString","features","aiGenerative","underline"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SACEA,0BAA0B,EAC1BC,WAAW,EACXC,UAAU,EACVC,gBAAgB,EAChBC,oBAAoB,EACpBC,sBAAsB,EACtBC,kBAAkB,QAEb,eAAc;AACrB,SAASC,cAAc,QAAQ,mCAAkC;AACjE,SAASC,WAAW,QAAQ,uBAAsB;AAClD,SAASC,kBAAkB,QAAQ,gEAA+D;AAClG,SAASC,UAAU,QAAQ,wDAAuD;AAClF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,IAAI,EAAEC,UAAU,QAAQ,gBAAe;AAChD,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,OAAO,QAAQ,iCAAgC;AAUxD;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GACD,eAAe,SAASC,cAAcC,KAAyB;IAC7D,MAAM,EAAEC,KAAK,EAAEC,GAAG,EAAEC,WAAW,EAAE,GAAGH;IACpC,MAAM,EAAEI,MAAMC,IAAI,EAAE,GAAGP;IACvB,MAAM,CAACQ,SAASC,WAAW,GAAGV,SAAwD;IACtFD,UAAU;QACR,IAAI,CAACK,SAAS,CAACI,MAAM,OAAOG;QAC5B,IAAIC,SAAS;QACb,KAAK,AAAC,CAAA;YACJ,IAAI;gBACF,MAAMC,WAAW,MAAMjB,gBACrBY,MACA,CAAC,8BAA8B,EAAEM,mBAAmBV,QAAQ;gBAE9D,IAAI,CAACS,SAASE,EAAE,EAAE;gBAClB,MAAMC,SAAS,MAAMH,SAASI,IAAI;gBAClC,IAAIL,WAAUI,0BAAAA,OAAQP,OAAO,GAAEC,WAAWM,OAAOP,OAAO;YAC1D,EAAE,eAAM;YACN,2DAA2D;YAC3D,2DAA2D;YAC7D;QACF,CAAA;QACA,OAAO;YACLG,SAAS;QACX;IACF,GAAG;QAACR;QAAOI;KAAK;IAEhB,MAAMU,eAAe5B,uBAAuBe;IAC5C,MAAMc,OAAO3B,eAAe,aAAa;QACvC4B,QAAQ;QACRC,SACE,yEACA;IACJ;IACA,wEAAwE;IACxE,iEAAiE;IACjE,IAAIH,aAAaI,qBAAqB,IAAI,GAAG;QAC3C,qBACE,KAAC7B;YAAY8B,QAAQ;YAAcJ,MAAMA;YAAMK,cAAc;YAACC,cAAc;sBAC1E,cAAA,KAAC/B;gBAAmBgC,MAAMpB,cAAc,GAAGA,YAAY,MAAM,CAAC,GAAG;gBAAUqB,aAAY;0BACpF;;;IAIT;IACA,MAAMC,OAAOvC,qBAAqBgB;IAClC,MAAMwB,iBAAiB1C,WAAWkB,OAAOpB,0BAA0B,CAAC2C,KAAK,GAAG;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,MAAME,cAAcvC,mBAAmBc,KAAK0B,iBAAiB,IAAI;IACjE,qBACE,MAACtC;QACC8B,QAAQ;QACRJ,MAAMA;QACNK,cAAc;QACdC,cAAc;;0BAId,KAAC9B;gBACCqC,OAAM;gBACNC,MAAMxB,UAAUA,QAAQwB,IAAI,GAAG;gBAC/BC,OAAOhB,aAAaI,qBAAqB;gBACzCa,WAAW/C,iBAAiB8B,aAAaI,qBAAqB;gBAC9Dc,aAAa9B,cAAc,GAAGA,YAAY,MAAM,CAAC,GAAG;;YAErDuB,iBAAiB,kBAChB,KAAC/B;gBACCuC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;0BAEvC,CAAC,SAAS,EAAEb,eAAec,cAAc,GAAG,sBAAsB,CAAC,GAClE,CAAC,IAAI,EAAEzD,cAAc,QAAQ,CAAC;iBAEhC;YAIH,CAACgC,aAAa0B,QAAQ,CAACC,YAAY,IAAIf,4BACtC,MAAChC;gBACCuC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;;oBAEvC,CAAC,gDAAgD,EAAExD,cAAc,EAAE,CAAC,GACnE,CAAC,QAAQ,EAAED,0BAA0B,CAAC2C,KAAK,CAACe,cAAc,GAAG,CAAC,CAAC,GAC/D;kCACF,KAAC9C;wBAAK6B,MAAM,GAAGpB,sBAAAA,cAAe,GAAG,OAAO,CAAC;wBAAEgC,OAAM;wBAAUQ,WAAU;kCAClE,CAAC,IAAI,EAAE5D,eAAe;;oBAExB;;iBAED;;;AAGV"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-credits-card.component.tsx"],"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'use client'\n\nimport {\n  AI_TIERS,\n  aiAddonName,\n  aiTierName,\n  isUnlimitedQuota,\n  orgCanBuyAiTier,\n  resolveAiTier,\n  resolveOrgEntitlements,\n  type AglynOrgBilling,\n} from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { PrerequisiteNotice } from '@aglyn/shared-ui-jsx/components/prerequisite-notice.component'\nimport { UsageMeter } from '@aglyn/shared-ui-jsx/components/usage-meter.component'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { Link, Typography } from '@mui/material'\nimport { useEffect, useState } from 'react'\nimport { useUser } from '@aglyn/tenant-feature-instance'\n\nexport interface AiCreditsCardProps {\n  orgId?: string | null\n  /** The billing-merged org doc the Usage page resolved. */\n  org?: Partial<AglynOrgBilling> | null\n  /** The Billing overview's path, for the one caption that points at the add-ons card. */\n  billingHref?: string\n}\n\n/**\n * The AI credits meter (AGL-2899), on the Billing → Usage page's plugin\n * band below the platform's own meters (AGL-2939).\n *\n * Credits, because AI actions differ in cost by up to two orders of\n * magnitude — a question against generating a screen — and a message count\n * would price them the same. The band is refused at the cap, so this\n * readout is the only thing standing between a customer and learning their\n * limit by being turned down mid-build.\n *\n * Rendered only where a band is sold, which since AGL-3203 is every plan\n * row: Free carries the taste and Starter 750, so both render a meter even\n * though neither carries `aiAssist` — the band is credits, not the guided\n * rung. A band of ZERO, which now reaches this component only as a per-org\n * override, draws no meter — a \"0 of 0\" meter is not a readout of anything —\n * but says the plan has no credits and links to Billing (AGL-3982), since a\n * missing card reads as AI not existing here. ONE meter for one pool: the\n * plan's included credits pay for every AI action, generation included\n * (AGL-3965), and an Aglyn AI tier widens `assistCreditsPerMonth` rather than\n * opening a second band, so the limit here is already plan plus tier and the\n * caption under it says how much of that the tier is.\n *\n * From the server, not from Firestore like the platform's meters:\n * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser\n * read would fail silently and leave this reading \"not yet metered\" forever.\n * Credits, never dollars: the route is where the one conversion happens.\n */\nexport default function AiCreditsCard(props: AiCreditsCardProps) {\n  const { orgId, org, billingHref } = props\n  const { data: user } = useUser()\n  const [credits, setCredits] = useState<{ used: number; limit: number | null } | null>(null)\n  useEffect(() => {\n    if (!orgId || !user) return undefined\n    let active = true\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          user,\n          `/api/ai/billing/credits?orgId=${encodeURIComponent(orgId)}`,\n        )\n        if (!response.ok) return\n        const result = await response.json()\n        if (active && result?.credits) setCredits(result.credits)\n      } catch {\n        // The meter keeps its \"not yet metered\" state on failure —\n        // deliberately not 0, which reads as \"you have used none\".\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, user])\n\n  const entitlements = resolveOrgEntitlements(org)\n  const help = pluginDocsHelp('aiCredits', {\n    anchor: '#see-your-credits',\n    excerpt:\n      'AI credits drawn this month against one pool: your plan’s included ' +\n      'credits plus your AI tier’s, if you have one. Every AI action draws on ' +\n      'it. The pool resets on the first of the month.',\n  })\n  // A band of zero (AGL-3982): said, with the way to a plan that has one,\n  // rather than a missing card that reads as AI not existing here.\n  if (entitlements.assistCreditsPerMonth <= 0) {\n    return (\n      <CardDisplay header={'AI credits'} help={help} contentGutterX contentGutterY>\n        <PrerequisiteNotice href={billingHref ? `${billingHref}#plans` : '#plans'} actionLabel=\"See plans\">\n          {'Your plan includes no AI credits. Choose a plan with AI credits in Billing to use the AI features.'}\n        </PrerequisiteNotice>\n      </CardDisplay>\n    )\n  }\n  const aiTier = resolveAiTier(org)\n  // Sold to THIS workspace, not merely on its plan: a staff comp has no\n  // subscription to add the item to, so it sells none (AGL-3034).\n  const tiersSold = orgCanBuyAiTier(org)\n  return (\n    <CardDisplay\n      header={'AI credits'}\n      help={help}\n      contentGutterX\n      contentGutterY\n    >\n      {/* An uncapped staff comp (AGL-3049) resolves this band `UNLIMITED`:\n          the meter reads \"Unlimited\" and draws no bar, never \"/ Infinity\". */}\n      <UsageMeter\n        label=\"AI credits (this month)\"\n        used={credits ? credits.used : null}\n        limit={entitlements.assistCreditsPerMonth}\n        unlimited={isUnlimitedQuota(entitlements.assistCreditsPerMonth)}\n        upgradeHref={billingHref ? `${billingHref}#plans` : '#plans'}\n      />\n      {aiTier ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Includes ${AI_TIERS[aiTier].credits.toLocaleString()} credits a month ` +\n            `from ${aiTierName(aiTier)}, on top of your plan's.`}\n        </Typography>\n      ) : null}\n      {/* A plan that sells tiers and holds none: the one line on the meters\n          that points at more capacity rather than at an upgrade. */}\n      {!aiTier && tiersSold ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Need more? An ${aiAddonName()} tier adds ` +\n            `${AI_TIERS.spark.credits.toLocaleString()} to ` +\n            `${AI_TIERS.studio.credits.toLocaleString()} credits a month to this pool: `}\n          <Link href={`${billingHref ?? ''}#addons`} color=\"primary\" underline=\"hover\">\n            {'Choose a tier'}\n          </Link>\n          {' in Billing → Plan.'}\n        </Typography>\n      ) : null}\n    </CardDisplay>\n  )\n}\n"],"names":["AI_TIERS","aiAddonName","aiTierName","isUnlimitedQuota","orgCanBuyAiTier","resolveAiTier","resolveOrgEntitlements","pluginDocsHelp","CardDisplay","PrerequisiteNotice","UsageMeter","authorizedFetch","Link","Typography","useEffect","useState","useUser","AiCreditsCard","props","orgId","org","billingHref","data","user","credits","setCredits","undefined","active","response","encodeURIComponent","ok","result","json","entitlements","help","anchor","excerpt","assistCreditsPerMonth","header","contentGutterX","contentGutterY","href","actionLabel","aiTier","tiersSold","label","used","limit","unlimited","upgradeHref","variant","color","sx","display","mt","mb","toLocaleString","spark","studio","underline"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SACEA,QAAQ,EACRC,WAAW,EACXC,UAAU,EACVC,gBAAgB,EAChBC,eAAe,EACfC,aAAa,EACbC,sBAAsB,QAEjB,eAAc;AACrB,SAASC,cAAc,QAAQ,mCAAkC;AACjE,SAASC,WAAW,QAAQ,uBAAsB;AAClD,SAASC,kBAAkB,QAAQ,gEAA+D;AAClG,SAASC,UAAU,QAAQ,wDAAuD;AAClF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,IAAI,EAAEC,UAAU,QAAQ,gBAAe;AAChD,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,OAAO,QAAQ,iCAAgC;AAUxD;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BC,GACD,eAAe,SAASC,cAAcC,KAAyB;IAC7D,MAAM,EAAEC,KAAK,EAAEC,GAAG,EAAEC,WAAW,EAAE,GAAGH;IACpC,MAAM,EAAEI,MAAMC,IAAI,EAAE,GAAGP;IACvB,MAAM,CAACQ,SAASC,WAAW,GAAGV,SAAwD;IACtFD,UAAU;QACR,IAAI,CAACK,SAAS,CAACI,MAAM,OAAOG;QAC5B,IAAIC,SAAS;QACb,KAAK,AAAC,CAAA;YACJ,IAAI;gBACF,MAAMC,WAAW,MAAMjB,gBACrBY,MACA,CAAC,8BAA8B,EAAEM,mBAAmBV,QAAQ;gBAE9D,IAAI,CAACS,SAASE,EAAE,EAAE;gBAClB,MAAMC,SAAS,MAAMH,SAASI,IAAI;gBAClC,IAAIL,WAAUI,0BAAAA,OAAQP,OAAO,GAAEC,WAAWM,OAAOP,OAAO;YAC1D,EAAE,eAAM;YACN,2DAA2D;YAC3D,2DAA2D;YAC7D;QACF,CAAA;QACA,OAAO;YACLG,SAAS;QACX;IACF,GAAG;QAACR;QAAOI;KAAK;IAEhB,MAAMU,eAAe3B,uBAAuBc;IAC5C,MAAMc,OAAO3B,eAAe,aAAa;QACvC4B,QAAQ;QACRC,SACE,wEACA,4EACA;IACJ;IACA,wEAAwE;IACxE,iEAAiE;IACjE,IAAIH,aAAaI,qBAAqB,IAAI,GAAG;QAC3C,qBACE,KAAC7B;YAAY8B,QAAQ;YAAcJ,MAAMA;YAAMK,cAAc;YAACC,cAAc;sBAC1E,cAAA,KAAC/B;gBAAmBgC,MAAMpB,cAAc,GAAGA,YAAY,MAAM,CAAC,GAAG;gBAAUqB,aAAY;0BACpF;;;IAIT;IACA,MAAMC,SAAStC,cAAce;IAC7B,sEAAsE;IACtE,gEAAgE;IAChE,MAAMwB,YAAYxC,gBAAgBgB;IAClC,qBACE,MAACZ;QACC8B,QAAQ;QACRJ,MAAMA;QACNK,cAAc;QACdC,cAAc;;0BAId,KAAC9B;gBACCmC,OAAM;gBACNC,MAAMtB,UAAUA,QAAQsB,IAAI,GAAG;gBAC/BC,OAAOd,aAAaI,qBAAqB;gBACzCW,WAAW7C,iBAAiB8B,aAAaI,qBAAqB;gBAC9DY,aAAa5B,cAAc,GAAGA,YAAY,MAAM,CAAC,GAAG;;YAErDsB,uBACC,KAAC9B;gBACCqC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;0BAEvC,CAAC,SAAS,EAAEvD,QAAQ,CAAC2C,OAAO,CAACnB,OAAO,CAACgC,cAAc,GAAG,iBAAiB,CAAC,GACvE,CAAC,KAAK,EAAEtD,WAAWyC,QAAQ,wBAAwB,CAAC;iBAEtD;YAGH,CAACA,UAAUC,0BACV,MAAC/B;gBACCqC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;;oBAEvC,CAAC,cAAc,EAAEtD,cAAc,WAAW,CAAC,GAC1C,GAAGD,SAASyD,KAAK,CAACjC,OAAO,CAACgC,cAAc,GAAG,IAAI,CAAC,GAChD,GAAGxD,SAAS0D,MAAM,CAAClC,OAAO,CAACgC,cAAc,GAAG,+BAA+B,CAAC;kCAC9E,KAAC5C;wBAAK6B,MAAM,GAAGpB,sBAAAA,cAAe,GAAG,OAAO,CAAC;wBAAE8B,OAAM;wBAAUQ,WAAU;kCAClE;;oBAEF;;iBAED;;;AAGV"}

package/src/lib/components/ai-job-input-form.component.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token';
+import type { AiJobInputRequest, AiJobSummary } from '../model/ai-jobs.types';
+export interface AiJobInputFormProps {
+    job: AiJobSummary & {
+        input: AiJobInputRequest;
+    };
+    orgId: string;
+    user: MaybeTokenSource;
+    /** The job as the door answered: back on its plan card once the answer reads. */
+    onJob: (job: AiJobSummary) => void;
+}
+/**
+ * What a job waiting in `needs_input` for a person asks (AGL-3978) — a
+ * tracking change's Meta pixel ID — as one field per id, each naming its
+ * provider. Continue sends the answers through the resume door, which holds
+ * each to its pattern and answers a refusal by field, shown under it; an
+ * answer that reads returns the job to its plan card. Paused, never failed.
+ * The AI jobs drawer and the Assist build card both draw it.
+ */
+export declare function AiJobInputForm({ job, orgId, user, onJob }: AiJobInputFormProps): JSX.Element;

package/src/lib/components/ai-job-input-form.component.js

@@ -0,0 +1,100 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Button, Stack, TextField } from "@mui/material";
+import { useState } from "react";
+import { aiJobInputKey } from "../model/ai-job-input.js";
+import { resumeAiJobRequest } from "./ai-job-requests.js";
+/**
+ * What a job waiting in `needs_input` for a person asks (AGL-3978) — a
+ * tracking change's Meta pixel ID — as one field per id, each naming its
+ * provider. Continue sends the answers through the resume door, which holds
+ * each to its pattern and answers a refusal by field, shown under it; an
+ * answer that reads returns the job to its plan card. Paused, never failed.
+ * The AI jobs drawer and the Assist build card both draw it.
+ */ export function AiJobInputForm({ job, orgId, user, onJob }) {
+    const [values, setValues] = useState({});
+    const [errors, setErrors] = useState({});
+    const [notice, setNotice] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const submit = async (event)=>{
+        var _decision_fieldErrors;
+        event.preventDefault();
+        setBusy(true);
+        setNotice(null);
+        const decision = await resumeAiJobRequest(user, orgId, job, {
+            input: values
+        });
+        setErrors((_decision_fieldErrors = decision.fieldErrors) != null ? _decision_fieldErrors : {});
+        if (decision.error && !decision.fieldErrors) setNotice(decision.error);
+        if (decision.job) onJob(decision.job);
+        setBusy(false);
+    };
+    return /*#__PURE__*/ _jsx(Alert, {
+        severity: "warning",
+        icon: false,
+        sx: {
+            mt: 0.5
+        },
+        "aria-label": "Waiting for your answer",
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            component: "form",
+            spacing: 1,
+            onSubmit: (event)=>void submit(event),
+            noValidate: true,
+            children: [
+                /*#__PURE__*/ _jsx("span", {
+                    children: `Paused. ${job.input.message} Nothing is built until you answer and confirm the plan.`
+                }),
+                job.input.fields.map((field)=>{
+                    var _values_key, _errors_key;
+                    const key = aiJobInputKey(field);
+                    return /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: field.label,
+                        value: (_values_key = values[key]) != null ? _values_key : '',
+                        onChange: (event)=>setValues((current)=>_extends({}, current, {
+                                    [key]: event.target.value
+                                })),
+                        error: Boolean(errors[key]),
+                        helperText: (_errors_key = errors[key]) != null ? _errors_key : `It looks like ${field.shape}.`,
+                        disabled: busy,
+                        required: true,
+                        fullWidth: true
+                    }, key);
+                }),
+                notice ? /*#__PURE__*/ _jsx("span", {
+                    role: "alert",
+                    children: notice
+                }) : null,
+                /*#__PURE__*/ _jsx(Stack, {
+                    direction: "row",
+                    children: /*#__PURE__*/ _jsx(Button, {
+                        type: "submit",
+                        size: "small",
+                        variant: "contained",
+                        disabled: busy,
+                        children: 'Continue'
+                    })
+                })
+            ]
+        })
+    });
+}
+
+//# sourceMappingURL=ai-job-input-form.component.js.map

package/src/lib/components/ai-job-input-form.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-job-input-form.component.tsx"],"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\n'use client'\n\nimport type { MaybeTokenSource } from '@aglyn/shared-util-http/authorized-token'\nimport { Alert, Button, Stack, TextField } from '@mui/material'\nimport { useState, type FormEvent } from 'react'\nimport { aiJobInputKey } from '../model/ai-job-input'\nimport type { AiJobInputRequest, AiJobSummary } from '../model/ai-jobs.types'\nimport { resumeAiJobRequest } from './ai-job-requests'\n\nexport interface AiJobInputFormProps {\n  job: AiJobSummary & { input: AiJobInputRequest }\n  orgId: string\n  user: MaybeTokenSource\n  /** The job as the door answered: back on its plan card once the answer reads. */\n  onJob: (job: AiJobSummary) => void\n}\n\n/**\n * What a job waiting in `needs_input` for a person asks (AGL-3978) — a\n * tracking change's Meta pixel ID — as one field per id, each naming its\n * provider. Continue sends the answers through the resume door, which holds\n * each to its pattern and answers a refusal by field, shown under it; an\n * answer that reads returns the job to its plan card. Paused, never failed.\n * The AI jobs drawer and the Assist build card both draw it.\n */\nexport function AiJobInputForm({ job, orgId, user, onJob }: AiJobInputFormProps): JSX.Element {\n  const [values, setValues] = useState<Record<string, string>>({})\n  const [errors, setErrors] = useState<Record<string, string>>({})\n  const [notice, setNotice] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n\n  const submit = async (event: FormEvent) => {\n    event.preventDefault()\n    setBusy(true)\n    setNotice(null)\n    const decision = await resumeAiJobRequest(user, orgId, job, { input: values })\n    setErrors(decision.fieldErrors ?? {})\n    if (decision.error && !decision.fieldErrors) setNotice(decision.error)\n    if (decision.job) onJob(decision.job)\n    setBusy(false)\n  }\n\n  return (\n    <Alert severity=\"warning\" icon={false} sx={{ mt: 0.5 }} aria-label=\"Waiting for your answer\">\n      <Stack component=\"form\" spacing={1} onSubmit={(event) => void submit(event)} noValidate>\n        <span>{`Paused. ${job.input.message} Nothing is built until you answer and confirm the plan.`}</span>\n        {job.input.fields.map((field) => {\n          const key = aiJobInputKey(field)\n          return (\n            <TextField\n              key={key}\n              size=\"small\"\n              label={field.label}\n              value={values[key] ?? ''}\n              onChange={(event) => setValues((current) => ({ ...current, [key]: event.target.value }))}\n              error={Boolean(errors[key])}\n              helperText={errors[key] ?? `It looks like ${field.shape}.`}\n              disabled={busy}\n              required\n              fullWidth\n            />\n          )\n        })}\n        {notice ? (\n          <span role=\"alert\">{notice}</span>\n        ) : null}\n        <Stack direction=\"row\">\n          <Button type=\"submit\" size=\"small\" variant=\"contained\" disabled={busy}>\n            {'Continue'}\n          </Button>\n        </Stack>\n      </Stack>\n    </Alert>\n  )\n}\n"],"names":["Alert","Button","Stack","TextField","useState","aiJobInputKey","resumeAiJobRequest","AiJobInputForm","job","orgId","user","onJob","values","setValues","errors","setErrors","notice","setNotice","busy","setBusy","submit","event","decision","preventDefault","input","fieldErrors","error","severity","icon","sx","mt","aria-label","component","spacing","onSubmit","noValidate","span","message","fields","map","field","key","size","label","value","onChange","current","target","Boolean","helperText","shape","disabled","required","fullWidth","role","direction","type","variant"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;AAGA,SAASA,KAAK,EAAEC,MAAM,EAAEC,KAAK,EAAEC,SAAS,QAAQ,gBAAe;AAC/D,SAASC,QAAQ,QAAwB,QAAO;AAChD,SAASC,aAAa,QAAQ,2BAAuB;AAErD,SAASC,kBAAkB,QAAQ,uBAAmB;AAUtD;;;;;;;CAOC,GACD,OAAO,SAASC,eAAe,EAAEC,GAAG,EAAEC,KAAK,EAAEC,IAAI,EAAEC,KAAK,EAAuB;IAC7E,MAAM,CAACC,QAAQC,UAAU,GAAGT,SAAiC,CAAC;IAC9D,MAAM,CAACU,QAAQC,UAAU,GAAGX,SAAiC,CAAC;IAC9D,MAAM,CAACY,QAAQC,UAAU,GAAGb,SAAwB;IACpD,MAAM,CAACc,MAAMC,QAAQ,GAAGf,SAAS;IAEjC,MAAMgB,SAAS,OAAOC;YAKVC;QAJVD,MAAME,cAAc;QACpBJ,QAAQ;QACRF,UAAU;QACV,MAAMK,WAAW,MAAMhB,mBAAmBI,MAAMD,OAAOD,KAAK;YAAEgB,OAAOZ;QAAO;QAC5EG,WAAUO,wBAAAA,SAASG,WAAW,YAApBH,wBAAwB,CAAC;QACnC,IAAIA,SAASI,KAAK,IAAI,CAACJ,SAASG,WAAW,EAAER,UAAUK,SAASI,KAAK;QACrE,IAAIJ,SAASd,GAAG,EAAEG,MAAMW,SAASd,GAAG;QACpCW,QAAQ;IACV;IAEA,qBACE,KAACnB;QAAM2B,UAAS;QAAUC,MAAM;QAAOC,IAAI;YAAEC,IAAI;QAAI;QAAGC,cAAW;kBACjE,cAAA,MAAC7B;YAAM8B,WAAU;YAAOC,SAAS;YAAGC,UAAU,CAACb,QAAU,KAAKD,OAAOC;YAAQc,UAAU;;8BACrF,KAACC;8BAAM,CAAC,QAAQ,EAAE5B,IAAIgB,KAAK,CAACa,OAAO,CAAC,wDAAwD,CAAC;;gBAC5F7B,IAAIgB,KAAK,CAACc,MAAM,CAACC,GAAG,CAAC,CAACC;wBAOV5B,aAGKE;oBAThB,MAAM2B,MAAMpC,cAAcmC;oBAC1B,qBACE,KAACrC;wBAECuC,MAAK;wBACLC,OAAOH,MAAMG,KAAK;wBAClBC,KAAK,GAAEhC,cAAAA,MAAM,CAAC6B,IAAI,YAAX7B,cAAe;wBACtBiC,UAAU,CAACxB,QAAUR,UAAU,CAACiC,UAAa,aAAKA;oCAAS,CAACL,IAAI,EAAEpB,MAAM0B,MAAM,CAACH,KAAK;;wBACpFlB,OAAOsB,QAAQlC,MAAM,CAAC2B,IAAI;wBAC1BQ,UAAU,GAAEnC,cAAAA,MAAM,CAAC2B,IAAI,YAAX3B,cAAe,CAAC,cAAc,EAAE0B,MAAMU,KAAK,CAAC,CAAC,CAAC;wBAC1DC,UAAUjC;wBACVkC,QAAQ;wBACRC,SAAS;uBATJZ;gBAYX;gBACCzB,uBACC,KAACoB;oBAAKkB,MAAK;8BAAStC;qBAClB;8BACJ,KAACd;oBAAMqD,WAAU;8BACf,cAAA,KAACtD;wBAAOuD,MAAK;wBAASd,MAAK;wBAAQe,SAAQ;wBAAYN,UAAUjC;kCAC9D;;;;;;AAMb"}

package/src/lib/components/ai-job-requests.d.ts

@@ -26,6 +26,8 @@ export interface AiJobDecision {
      * inline (AGL-3722): what the plan just spent, so the strip moves with it.
      */
     meter?: unknown;
+    /** Why each answer a `needs_input` job asked for cannot be used, by field (AGL-3978). */
+    fieldErrors?: Record<string, string> | null;
 }
 /**
  * What a resume asks beyond confirming (AGL-3616): a build's plan confirmed
@@ -38,6 +40,8 @@ export interface AiJobResumeOptions {
     creditsConfirmed?: boolean;
     /** "Build the home page first" (AGL-3722): the plan narrowed to its home page and what it needs. */
     reduce?: 'first-page';
+    /** The answers a job waiting in `needs_input` asks for (AGL-3978), by `aiJobInputKey`. */
+    input?: Record<string, string>;
 }
 /**
  * Confirms a plan, or tries again a step whose answer broke a building rule

package/src/lib/components/ai-job-requests.js

@@ -41,6 +41,8 @@ import { publishAiJob } from "./ai-jobs-store.js";
                 creditsConfirmed: true
             } : {}, options.reduce ? {
                 reduce: options.reduce
+            } : {}, options.input ? {
+                input: options.input
             } : {}))
         });
         const payload = await response.json().catch(()=>null);
@@ -52,6 +54,8 @@ import { publishAiJob } from "./ai-jobs-store.js";
             error: response.ok ? null : String((_ref2 = payload == null ? void 0 : payload.error) != null ? _ref2 : 'The job could not be resumed — try again.')
         }, credits ? {
             credits
+        } : {}, (payload == null ? void 0 : payload.fieldErrors) ? {
+            fieldErrors: payload.fieldErrors
         } : {});
     } catch (unused) {
         return {