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

package/README.md

@@ -18,14 +18,14 @@ Peer dependencies: `react`, `next`, `@mui/material`, `@mui/x-data-grid`, `fireba
 
 - The assistant, drawn in the console dock (`consoleDock`) and a provider the shell mounts around every console page for the Besigner copy assistant, with controls in the `besignerToolbar` and `besignerInspector` slots.
 - The AI jobs indicator in the console's top bar (`consoleTopBar`): what the workspace's jobs are doing, and the way to them.
-- "Create with AI" entry points and cards on a site's pages list and its components, layouts, templates, forms, theme, SEO and automations pages (`hostScreens`, `hostComponents`, `hostLayouts`, `hostTemplates`, `hostForms`, `hostTheme`, `hostSeo`, `seoFields`, `hostAutomations`, `automationEditor`, `automationRun`, `hostFirstRun`, `orgSites`).
-- Cards in zones other plugins host: product copy, import and the products hub (`productEditor`, `productImport`, `productsHub`), record insights, email drafts and import column matching (`recordInsights`, `recordEmail`, `importMapping`), and A/B test variants and results (`experimentVariants`, `experimentResult`).
+- "Create with AI" entry points and cards on a site's pages list and its components, layouts, templates, forms, email templates, products, theme, SEO, automations and Functions & Variables pages (`hostScreens`, `hostComponents`, `hostLayouts`, `hostTemplates`, `hostForms`, `hostEmailTemplates`, `productsCreate`, `hostTheme`, `hostSeo`, `seoFields`, `hostAutomations`, `automationEditor`, `automationRun`, `hostLogic`, `logicFunctionEditor`, `logicReferenceIssue`, `hostFirstRun`, `orgSites`).
+- Cards in zones other plugins host: product copy, import and the products hub (`productEditor`, `productImport`, `productsHub`), record insights, email drafts and import column matching (`recordInsights`, `recordEmail`, `importMapping`), A/B test variants and results (`experimentVariants`, `experimentResult`), overlay copy and new overlays on the Marketing page (`overlayEditor`, `hostOverlays`), a campaign from a brief on its Campaigns section (`hostCampaigns`), the figures in words on its Conversions section and campaign reports (`marketingInsights`), and a funnel drafted from a description and its results explained (`funnelsCreate`, `funnelInsight`).
 - Usage and access: credit and usage cards on billing (`orgBillingUsage`), per-member cards and columns (`orgMember`, `orgMembersListColumn`, `hostMembers`), and staff cards, columns and one staff page (`staffOrg`, `staffUser`, `staffOrgsListColumn`, `staffOrgUsageColumn`).
 
 **Server** (`registerAiConsoleApi`, the `consoleApi` registrar, exported from `@aglyn/plugins-ai/server`). It registers the first-party providers, every job kind, and the routes under the `ai` and `assist` prefixes with `registerPluginApiRoute`:
 
 - Assistant: `assist/chat`, `assist/feedback`, `assist/edit-applied`, `ai/assist`.
-- Jobs: `ai/jobs`, `ai/jobs/batch`, `ai/jobs/:jobId/cancel`, `ai/jobs/:jobId/resume`, `ai/jobs/:jobId/events`, the scheduled jobs beat, `ai/insights/:jobId`, `ai/crm/:jobId`, `ai/seo/apply`, `ai/generate/component`.
+- Jobs: `ai/jobs`, `ai/jobs/batch`, `ai/jobs/:jobId/cancel`, `ai/jobs/:jobId/resume`, `ai/jobs/:jobId/events`, the scheduled jobs beat, `ai/insights/:jobId`, `ai/crm/:jobId`, `ai/seo/apply`, `ai/experiments/versions`, `ai/generate/component`.
 - Usage and access: `ai/usage`, `ai/allotments`, `ai/models`, `ai/host-permissions`, `ai/billing/credits`, `ai/billing/overage`.
 - Staff: `ai/admin/org`, `ai/admin/orgs-spend`, `ai/admin/user`, `ai/admin/signals`, `ai/admin/overage`, `ai/admin/credits`.
 

package/package.json

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

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

@@ -104,7 +104,13 @@ export const AI_JOB_NEEDS_INPUT_REASON_LABELS = {
     // names it and never what it says.
     insight: 'content',
     // A CRM proposal (AGL-2917) writes nothing; the feed files it with content.
-    crm: 'content'
+    crm: 'content',
+    // Another plugin's draft a build asked its writer for (AGL-3616).
+    draft: 'content',
+    // A logic proposal (AGL-3603) writes nothing either.
+    logic: 'content',
+    // So does an org automation's (AGL-3603): the editor's Save is the write.
+    orgAutomation: 'content'
 };
 export function aiOutputTargetType(resource) {
     return AI_OUTPUT_TARGET_TYPES[resource];

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 {\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/** 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}\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). Neither writes these any more; the rows already in the\n      // log still classify as reads rather than changes.\n      staffAuditAccessActions: ['org.ai-viewed', 'user.ai-usage-viewed'],\n    },\n    actions: AI_ACTIVITY_ACTION_LIST.map((key) => ({\n      key,\n      label: AI_ACTIVITY_ACTION_LABELS[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":["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_LIST","Object","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","screen","reusableComponent","layout","template","form","emailScreen","campaign","product","experiment","workflow","seo","text","theme","insight","crm","aiOutputTargetType","resource","isAiActivityAction","action","includes","aiActivityActionLabel","undefined","AI_STAFF_AUDIT_ACTION_PREFIXES","STAFF_AUDIT_AI_GROUP","AI_ACTIVITY_ACTION_SCOPES","registerAiActivityActions","pluginId","group","id","label","staffAuditPrefixes","filter","prefix","staffAuditAccessActions","actions","map","key","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 {\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/** 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}\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). Neither writes these any more; the rows already in the\n      // log still classify as reads rather than changes.\n      staffAuditAccessActions: ['org.ai-viewed', 'user.ai-usage-viewed'],\n    },\n    actions: AI_ACTIVITY_ACTION_LIST.map((key) => ({\n      key,\n      label: AI_ACTIVITY_ACTION_LABELS[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":["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_LIST","Object","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","screen","reusableComponent","layout","template","form","emailScreen","campaign","product","experiment","workflow","seo","text","theme","insight","crm","draft","logic","orgAutomation","aiOutputTargetType","resource","isAiActivityAction","action","includes","aiActivityActionLabel","undefined","AI_STAFF_AUDIT_ACTION_PREFIXES","STAFF_AUDIT_AI_GROUP","AI_ACTIVITY_ACTION_SCOPES","registerAiActivityActions","pluginId","group","id","label","staffAuditPrefixes","filter","prefix","staffAuditAccessActions","actions","map","key","scope","targetTypes","aiJob","staffAuditActionGroup","staffAuditActionGroupLabel"],"mappings":"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"}

package/src/lib/components/ai-automation-zones.d.ts

@@ -51,6 +51,11 @@ export interface ConsoleAutomationEditorZoneProps {
     orgId: string | undefined;
     /** The automation the editor has open, as it is stored. */
     target: ConsoleAutomationTarget;
+    /**
+     * Opens a listed action in the Actions editor in place of this one; `false`
+     * when the list has not read it yet. Handed by the Actions editor only.
+     */
+    openAction?: (actionId: string) => boolean;
 }
 /** What the `automationRun` zone hands a widget. */
 export interface ConsoleAutomationRunZoneProps {
@@ -61,3 +66,36 @@ export interface ConsoleAutomationRunZoneProps {
     /** The run's entry in the site's activity log. */
     runId: string;
 }
+/**
+ * What the `orgAutomations` zone hands a widget (AGL-3603): the workflows
+ * plugin's Org automations section, in its card's header, drawn for a member
+ * who may write the workspace's automations.
+ */
+export interface ConsoleOrgAutomationsZoneProps {
+    orgId: string;
+    /** The host events an org automation may start on, as that plugin lists them. */
+    triggers: readonly string[];
+    /** The step types an org automation may hold, as that plugin lists them. */
+    steps: readonly string[];
+    /**
+     * Opens an automation in the section's editor as a NEW one, unsaved and
+     * switched off, for the person to place on sites and save. `false` when the
+     * editor could not take it — the plan lacks the actions builder, or it is
+     * not an automation the section can hold.
+     */
+    propose: (automation: {
+        name: string;
+        trigger: {
+            event: string;
+            conditions?: ReadonlyArray<{
+                field: string;
+                op: string;
+                value?: string;
+            }>;
+            combinator?: 'and' | 'or';
+        };
+        steps: ReadonlyArray<Record<string, unknown> & {
+            type: string;
+        }>;
+    }) => boolean;
+}

package/src/lib/components/ai-automation-zones.js

@@ -26,6 +26,10 @@
  * member below is one the host documents in the injection zones reference.
  *
  * Types only: nothing here reaches a bundle.
- */ /** What the `hostAutomations` zone hands a widget. */ /** What the `automationRun` zone hands a widget. */ export { };
+ */ /** What the `hostAutomations` zone hands a widget. */ /**
+ * What the `orgAutomations` zone hands a widget (AGL-3603): the workflows
+ * plugin's Org automations section, in its card's header, drawn for a member
+ * who may write the workspace's automations.
+ */ export { };
 
 //# sourceMappingURL=ai-automation-zones.js.map

package/src/lib/components/ai-automation-zones.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-automation-zones.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 * What the workflows plugin's Automation page zones hand this plugin's\n * widgets.\n *\n * `hostAutomations`, `automationEditor` and `automationRun` are zones the\n * workflows plugin hosts and declares (`registerPluginZone`), with their props\n * on its own zone tokens. A plugin never imports another plugin, so the\n * widgets registered there read the props through the shapes restated here —\n * the zone's props as the host documents them, by the same names. A widget is\n * handed whatever the host passes, so this restates what the host SENDS; every\n * member below is one the host documents in the injection zones reference.\n *\n * Types only: nothing here reaches a bundle.\n */\n\n/** What the `hostAutomations` zone hands a widget. */\nexport interface ConsoleHostAutomationsZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` while it resolves. */\n  orgId: string | undefined\n  /**\n   * Opens the Actions editor on a listed action. `false` when the id names no\n   * action the list has read yet.\n   */\n  openAction: (actionId: string) => boolean\n}\n\n/** One automation on the Automation page: an action, or a workflow. */\nexport interface ConsoleAutomationTarget {\n  type: 'action' | 'workflow'\n  id: string\n  name: string\n}\n\n/** What the `automationEditor` zone hands a widget. */\nexport interface ConsoleAutomationEditorZoneProps {\n  hostId: string\n  orgId: string | undefined\n  /** The automation the editor has open, as it is stored. */\n  target: ConsoleAutomationTarget\n}\n\n/** What the `automationRun` zone hands a widget. */\nexport interface ConsoleAutomationRunZoneProps {\n  hostId: string\n  orgId: string | undefined\n  /** The automation the run belongs to. */\n  target: ConsoleAutomationTarget\n  /** The run's entry in the site's activity log. */\n  runId: string\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;CAaC,GAED,oDAAoD,GA2BpD,kDAAkD,GAClD,WAOC"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-automation-zones.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 * What the workflows plugin's Automation page zones hand this plugin's\n * widgets.\n *\n * `hostAutomations`, `automationEditor` and `automationRun` are zones the\n * workflows plugin hosts and declares (`registerPluginZone`), with their props\n * on its own zone tokens. A plugin never imports another plugin, so the\n * widgets registered there read the props through the shapes restated here —\n * the zone's props as the host documents them, by the same names. A widget is\n * handed whatever the host passes, so this restates what the host SENDS; every\n * member below is one the host documents in the injection zones reference.\n *\n * Types only: nothing here reaches a bundle.\n */\n\n/** What the `hostAutomations` zone hands a widget. */\nexport interface ConsoleHostAutomationsZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` while it resolves. */\n  orgId: string | undefined\n  /**\n   * Opens the Actions editor on a listed action. `false` when the id names no\n   * action the list has read yet.\n   */\n  openAction: (actionId: string) => boolean\n}\n\n/** One automation on the Automation page: an action, or a workflow. */\nexport interface ConsoleAutomationTarget {\n  type: 'action' | 'workflow'\n  id: string\n  name: string\n}\n\n/** What the `automationEditor` zone hands a widget. */\nexport interface ConsoleAutomationEditorZoneProps {\n  hostId: string\n  orgId: string | undefined\n  /** The automation the editor has open, as it is stored. */\n  target: ConsoleAutomationTarget\n  /**\n   * Opens a listed action in the Actions editor in place of this one; `false`\n   * when the list has not read it yet. Handed by the Actions editor only.\n   */\n  openAction?: (actionId: string) => boolean\n}\n\n/** What the `automationRun` zone hands a widget. */\nexport interface ConsoleAutomationRunZoneProps {\n  hostId: string\n  orgId: string | undefined\n  /** The automation the run belongs to. */\n  target: ConsoleAutomationTarget\n  /** The run's entry in the site's activity log. */\n  runId: string\n}\n\n/**\n * What the `orgAutomations` zone hands a widget (AGL-3603): the workflows\n * plugin's Org automations section, in its card's header, drawn for a member\n * who may write the workspace's automations.\n */\nexport interface ConsoleOrgAutomationsZoneProps {\n  orgId: string\n  /** The host events an org automation may start on, as that plugin lists them. */\n  triggers: readonly string[]\n  /** The step types an org automation may hold, as that plugin lists them. */\n  steps: readonly string[]\n  /**\n   * Opens an automation in the section's editor as a NEW one, unsaved and\n   * switched off, for the person to place on sites and save. `false` when the\n   * editor could not take it — the plan lacks the actions builder, or it is\n   * not an automation the section can hold.\n   */\n  propose: (automation: {\n    name: string\n    trigger: { event: string; conditions?: ReadonlyArray<{ field: string; op: string; value?: string }>; combinator?: 'and' | 'or' }\n    steps: ReadonlyArray<Record<string, unknown> & { type: string }>\n  }) => boolean\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;CAaC,GAED,oDAAoD,GA0CpD;;;;CAIC,GACD,WAiBC"}

package/src/lib/components/ai-brief-dialog.component.d.ts

@@ -1,9 +1,10 @@
 import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import type { AiEmailType } from '../jobs/ai-job-email-step';
 import type { AiJobKind } from '../model/ai-jobs.types';
 import { type AiPageType } from '../model/ai-page-job';
 import { type AiTemplateSubject } from '../model/ai-template-subjects';
 /** The job kinds a member describes from a console page. */
-export type AiBriefKind = Extract<AiJobKind, 'page' | 'template' | 'layout' | 'form' | 'component'>;
+export type AiBriefKind = Extract<AiJobKind, 'page' | 'template' | 'layout' | 'form' | 'component' | 'email' | 'campaign'>;
 /** What the dialog says for one kind. */
 export interface AiBriefCopy {
     title: string;
@@ -20,6 +21,12 @@ export interface AiBriefCopy {
     failed: string;
 }
 export declare const AI_BRIEF_COPY: Readonly<Record<AiBriefKind, AiBriefCopy>>;
+/**
+ * The kinds of email a member picks from, as their chips name them. The jobs'
+ * own catalog (`AI_EMAIL_TYPES`) also holds `reply`, which only a job the
+ * platform composes sets, so it is not offered here.
+ */
+export declare const AI_EMAIL_TYPE_LABELS: Readonly<Record<Exclude<AiEmailType, 'reply'>, string>>;
 /** Each template subject as its chip names it: what one page is drawn for. */
 export declare const AI_TEMPLATE_SUBJECT_LABELS: Readonly<Record<AiTemplateSubject, string>>;
 /** What a member picked beside the brief; each kind reads only its own. */
@@ -30,15 +37,26 @@ export interface AiBriefChoice {
     subject: AiTemplateSubject | null;
     /** A collection entry template's collection, or `null` until one is picked. */
     collectionId: string | null;
+    /** An email's or a campaign's kind of email; `null` or absent for none. */
+    emailType?: Exclude<AiEmailType, 'reply'> | null;
+    /** An email's door only: also draft the campaign that would send it. */
+    withCampaign?: boolean;
 }
 export declare const AI_BRIEF_NO_CHOICE: AiBriefChoice;
+/**
+ * The job the door starts: its own kind, except an email that also asked for
+ * its campaign, which is a `campaign` job — the campaign step writes the same
+ * design and drafts the campaign around it.
+ */
+export declare function aiBriefJobKind(kind: AiBriefKind, choice: AiBriefChoice): AiBriefKind;
 /**
  * The job's `inputs` for what the member picked, or `null` while the kind's
  * door would refuse them.
  *
  * A template's are read by the parser its door reads, so the dialog cannot
  * send a subject the door does not know or an entry page with no collection.
- * A page's type is optional. A layout, a form and a component read no inputs
+ * A page's type is optional, and so is an email's or a campaign's kind of
+ * email (`inputs.emailType`, which both steps read). A layout, a form and a component read no inputs
  * at all (AGL-2909, AGL-2913, AGL-2908), so theirs are empty.
  */
 export declare function aiBriefJobInputs(kind: AiBriefKind, choice: AiBriefChoice): Record<string, string> | null;

package/src/lib/components/ai-brief-dialog.component.js

@@ -18,7 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * limitations under the License.
  */ import { lockdownRefusalText, parseLockdownRefusal } from "@aglyn/aglyn";
 import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
-import { Alert, Button, Chip, Dialog, DialogActions, DialogContent, DialogTitle, Stack, TextField, Typography } from "@mui/material";
+import { Alert, Button, Checkbox, Chip, Dialog, DialogActions, DialogContent, DialogTitle, FormControlLabel, Stack, TextField, Typography } from "@mui/material";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { AI_PAGE_TYPES } from "../model/ai-page-job.js";
 import { AI_TEMPLATE_SUBJECTS, parseAiTemplateJobInputs } from "../model/ai-template-subjects.js";
@@ -28,13 +28,19 @@ import { AiTemplateCollectionField } from "./ai-template-collection-field.compon
 /**
  * The brief dialog every "Create with AI" opens (AGL-2907, AGL-3043, AGL-3051):
  * a page from the Screens page and from the Assist panel's AI jobs, a page
- * template from Templates, a layout from Layouts, a form from Forms and a
- * reusable component from Components.
+ * template from Templates, a layout from Layouts, a form from Forms, a
+ * reusable component from Components, and an email design from the Emails
+ * page's templates (AGL-3596). The `campaign` kind is the job an email's door
+ * starts when the campaign is asked for too; the Campaigns section's own door
+ * is a dialog of its own (`ai-campaign-create.component`, AGL-3603).
  *
  * One text box, and whatever the kind's door reads beside it, start one job of
  * that kind: a page's optional page type; a template's subject and, for a
  * collection entry's page, its collection. A layout, a form and a component
- * read nothing but the brief and the site. The job plans first; once it
+ * read nothing but the brief and the site. An email's reads the optional
+ * kind of email, and its door also offers to draft the
+ * campaign that would send it, which starts a `campaign` job instead — the
+ * same design, plus a draft campaign aimed at nobody. The job plans first; once it
  * exists the dialog follows it live (AGL-3593) — planning, the plan with its
  * Confirm, building, then the draft to open — and "Open AI jobs" follows it
  * anywhere else in the console. Nothing here builds or writes anything until
@@ -85,8 +91,37 @@ export const AI_BRIEF_COPY = {
         submit: 'Plan the component',
         started: 'The component is being planned. Review the plan here or in AI jobs, and confirm it ' + 'to build. The component is built as a draft, and no page shows it until you insert ' + 'it.',
         failed: 'The component could not be started. Try again.'
+    },
+    email: {
+        title: 'Describe an email',
+        briefLabel: 'What is the email for?',
+        placeholder: 'Announce the autumn menu to our regulars, and point them at the class page to book ' + 'the Tuesday bread class',
+        next: 'A plan comes first, and nothing is built until you confirm it. The email is built ' + 'from email blocks, with three subject lines and three preheaders to choose from. ' + 'Nothing is sent or scheduled.',
+        submit: 'Plan the email',
+        started: 'The email is being planned. Review the plan here or in AI jobs, and confirm it to ' + 'build. The email is saved as a draft template, and nothing sends it until a ' + 'campaign does.',
+        failed: 'The email could not be started. Try again.'
+    },
+    campaign: {
+        title: 'Describe a campaign',
+        briefLabel: 'What is the campaign’s email for?',
+        placeholder: 'Announce the autumn menu to our regulars, and point them at the class page to book ' + 'the Tuesday bread class',
+        next: 'A plan comes first, and nothing is built until you confirm it. The job writes the ' + 'email and a draft campaign that would send it. The campaign is aimed at nobody and ' + 'sends nothing until you pick who receives it and schedule it.',
+        submit: 'Plan the campaign',
+        started: 'The campaign is being planned. Review the plan here or in AI jobs, and confirm it ' + 'to build. The email and the campaign are saved as drafts, and nothing is sent.',
+        failed: 'The campaign could not be started. Try again.'
     }
 };
+/**
+ * The kinds of email a member picks from, as their chips name them. The jobs'
+ * own catalog (`AI_EMAIL_TYPES`) also holds `reply`, which only a job the
+ * platform composes sets, so it is not offered here.
+ */ export const AI_EMAIL_TYPE_LABELS = {
+    welcome: 'Welcome',
+    newsletter: 'Newsletter',
+    launch: 'Launch',
+    abandonedCart: 'Cart reminder',
+    eventReminder: 'Event reminder'
+};
 /** Each template subject as its chip names it: what one page is drawn for. */ export const AI_TEMPLATE_SUBJECT_LABELS = {
     entry: 'Collection entry',
     product: 'Product',
@@ -95,20 +130,35 @@ export const AI_BRIEF_COPY = {
 export const AI_BRIEF_NO_CHOICE = {
     pageType: null,
     subject: null,
-    collectionId: null
+    collectionId: null,
+    emailType: null,
+    withCampaign: false
 };
+/**
+ * The job the door starts: its own kind, except an email that also asked for
+ * its campaign, which is a `campaign` job — the campaign step writes the same
+ * design and drafts the campaign around it.
+ */ export function aiBriefJobKind(kind, choice) {
+    return kind === 'email' && choice.withCampaign ? 'campaign' : kind;
+}
 /**
  * The job's `inputs` for what the member picked, or `null` while the kind's
  * door would refuse them.
  *
  * A template's are read by the parser its door reads, so the dialog cannot
  * send a subject the door does not know or an entry page with no collection.
- * A page's type is optional. A layout, a form and a component read no inputs
+ * A page's type is optional, and so is an email's or a campaign's kind of
+ * email (`inputs.emailType`, which both steps read). A layout, a form and a component read no inputs
  * at all (AGL-2909, AGL-2913, AGL-2908), so theirs are empty.
  */ export function aiBriefJobInputs(kind, choice) {
     if (kind === 'page') return choice.pageType ? {
         pageType: choice.pageType
     } : {};
+    if (kind === 'email' || kind === 'campaign') {
+        return choice.emailType ? {
+            emailType: choice.emailType
+        } : {};
+    }
     if (kind === 'template') {
         const inputs = parseAiTemplateJobInputs({
             subject: choice.subject,
@@ -125,7 +175,7 @@ export const AI_BRIEF_NO_CHOICE = {
     return {};
 }
 export function AiBriefDialog({ kind, open, onClose, orgId, hostId, user, orgSlug, isStaff }) {
-    const copy = AI_BRIEF_COPY[kind];
+    var _choice_emailType;
     // Held in a ref so the request reads WHO is signed in, and nothing keys on
     // the identity of the object that says so.
     const userRef = useRef(user);
@@ -135,6 +185,10 @@ export function AiBriefDialog({ kind, open, onClose, orgId, hostId, user, orgSlu
     const [busy, setBusy] = useState(false);
     const [notice, setNotice] = useState(null);
     /** The job the brief started, as the create door answered with it. */ const [started, setStarted] = useState(null);
+    // An email that asked for its campaign is said as the campaign it starts,
+    // and a started job as the kind it is (the choice is cleared once it starts).
+    const shownKind = started && (started.kind === 'email' || started.kind === 'campaign') ? started.kind : aiBriefJobKind(kind, choice);
+    const copy = AI_BRIEF_COPY[shownKind];
     useEffect(()=>{
         if (!open) return;
         setNotice(null);
@@ -146,6 +200,7 @@ export function AiBriefDialog({ kind, open, onClose, orgId, hostId, user, orgSlu
     const ready = aiBriefJobInputs(kind, choice) !== null;
     const start = useCallback(async ()=>{
         const inputs = aiBriefJobInputs(kind, choice);
+        const jobKind = aiBriefJobKind(kind, choice);
         if (!orgId || !brief.trim() || !inputs) return;
         setBusy(true);
         setNotice(null);
@@ -159,7 +214,7 @@ export function AiBriefDialog({ kind, open, onClose, orgId, hostId, user, orgSlu
                 body: JSON.stringify({
                     orgId,
                     hostId,
-                    kind,
+                    kind: jobKind,
                     brief: brief.trim(),
                     inputs
                 })
@@ -244,6 +299,30 @@ export function AiBriefDialog({ kind, open, onClose, orgId, hostId, user, orgSlu
                                 }),
                             disabled: busy
                         }) : null,
+                        kind === 'email' || kind === 'campaign' ? /*#__PURE__*/ _jsx(ChipGroup, {
+                            id: "ai-email-type-label",
+                            label: "Kind of email (optional)",
+                            options: Object.entries(AI_EMAIL_TYPE_LABELS).map(([id, label])=>({
+                                    id,
+                                    label
+                                })),
+                            value: (_choice_emailType = choice.emailType) != null ? _choice_emailType : null,
+                            // Optional: pressing the pressed kind again sends none.
+                            onPress: (id)=>pick({
+                                    emailType: choice.emailType === id ? null : id
+                                }),
+                            disabled: busy
+                        }) : null,
+                        kind === 'email' ? /*#__PURE__*/ _jsx(FormControlLabel, {
+                            control: /*#__PURE__*/ _jsx(Checkbox, {
+                                checked: Boolean(choice.withCampaign),
+                                onChange: (event)=>pick({
+                                        withCampaign: event.target.checked
+                                    }),
+                                disabled: busy
+                            }),
+                            label: "Also draft a campaign that sends it"
+                        }) : null,
                         kind === 'template' ? /*#__PURE__*/ _jsxs(_Fragment, {
                             children: [
                                 /*#__PURE__*/ _jsx(ChipGroup, {