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

package/src/lib/plugin.js

@@ -14,44 +14,87 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ import { PLATFORM_BRAND_NAME, registerConsoleExtension } from "@aglyn/aglyn";
-import { AiCollaboratorPermissionsCell } from "./components/ai-collaborator-permissions-column.component.js";
-import { AiSaveAsComponent } from "./components/ai-save-as-component.component.js";
-import { AiGenerateSectionControl, AiRewriteControl } from "./components/besigner-ai-controls.component.js";
-import { AiAssistProviderOnHost, AssistPanelOnHost } from "./components/ai-permissions-on-host.component.js";
-import AiCreditsCard from "./components/ai-credits-card.component.js";
-import AiJobsTopBarIndicator from "./components/ai-jobs-indicator.component.js";
-import { AiCollaboratorCreditsCell, AiCollaboratorCreditsHeader, AiMemberCreditsCell, AiMemberCreditsHeader } from "./components/ai-credits-columns.component.js";
-import { AssistSignalsPage } from "./components/assist-signals-page.component.js";
-import BillingAssistOverageCard from "./components/billing-assist-overage-card.component.js";
-import { AiTopUsersCard } from "./components/billing-ai-top-users.component.js";
-import { AiAllotmentsCard } from "./components/billing-ai-allotments.component.js";
-import { AiCollaboratorAllotmentCell, AiCollaboratorAllotmentHeader, AiSiteAllotmentCard } from "./components/host-ai-allotments.component.js";
-import MemberAiAllotmentCard from "./components/member-ai-allotment-card.component.js";
-import MemberAiUsageCard from "./components/member-ai-usage-card.component.js";
-import AiThemeProposalCard from "./components/ai-theme-proposal-card.component.js";
-import StaffOrgAiCard from "./components/staff-org-ai-card.component.js";
-import { StaffOrgUsageAiCreditsCell, StaffOrgUsageAiOverageCell, StaffOrgUsageAiPool, StaffOrgUsageAssistCell } from "./components/staff-org-usage-ai-columns.component.js";
-import { StaffOrgsAiSpendCell, StaffOrgsAiSpendHeader } from "./components/staff-orgs-ai-spend-column.component.js";
-import StaffUserAiUsageCard from "./components/staff-user-ai-usage-card.component.js";
-import AiSeoAuditCard from "./components/ai-seo-audit-card.component.js";
-import AiSiteBatchCard from "./components/ai-site-batch-card.component.js";
-import AiSiteSeoStartCard from "./components/ai-site-seo-start-card.component.js";
-import AiSiteStartCard from "./components/ai-site-start-card.component.js";
-import AiSeoFieldsCard from "./components/ai-seo-fields-card.component.js";
-import AiDescribeAutomationButton from "./components/ai-describe-automation.component.js";
-import AiCrmEmailDraft from "./components/ai-crm-email-draft.component.js";
-import AiCrmImportMapping from "./components/ai-crm-import-mapping.component.js";
-import AiCrmRecordCard from "./components/ai-crm-record-card.component.js";
-import AiDescribePageButton from "./components/ai-describe-page.component.js";
-import { AiDescribeComponentButton, AiDescribeFormButton, AiDescribeLayoutButton, AiDescribeTemplateButton } from "./components/ai-describe-button.component.js";
-import { AiExperimentResultCard, AiExperimentVariantsCard } from "./components/ai-experiment-cards.component.js";
-import { AiExplainAutomation, AiExplainRunFailure } from "./components/ai-explain-automation.component.js";
-import AiProductCopyCard from "./components/ai-product-copy-card.component.js";
-import AiProductImportOption from "./components/ai-product-import-option.component.js";
-import AiProductsHubCard from "./components/ai-products-hub-card.component.js";
-import AiJobsPage from "./components/ai-jobs-page.component.js";
+import { LinearProgress } from "@mui/material";
+import { createElement } from "react";
+import { AiAssistProviderOnHost } from "./components/ai-assist-provider-on-host.component.js";
 import { AI_PLUGIN_ID } from "./constants.js";
 import { registerAiDeclarations } from "./declarations.js";
+import { lazyWidget } from "./lazy-widget.js";
+/*
+ * Every component below is registered by name and loaded the first time the
+ * shell draws it (AGL-3649); see `lazyWidget`. The console loads this plugin
+ * on every screen, so a static import of a component here is downloaded by
+ * every reader of every page, staff cards included.
+ */ /** What a page shows while its code arrives. */ const PAGE_LOADING = createElement(LinearProgress, {
+    'aria-label': 'Loading'
+});
+const AiCollaboratorPermissionsCell = lazyWidget('AiCollaboratorPermissionsCell', ()=>import("./components/ai-collaborator-permissions-column.component.js").then((m)=>m.AiCollaboratorPermissionsCell));
+const AiSaveAsComponent = lazyWidget('AiSaveAsComponent', ()=>import("./components/ai-save-as-component.component.js").then((m)=>m.AiSaveAsComponent));
+const AiGenerateSectionControl = lazyWidget('AiGenerateSectionControl', ()=>import("./components/besigner-ai-controls.component.js").then((m)=>m.AiGenerateSectionControl));
+const AiRewriteControl = lazyWidget('AiRewriteControl', ()=>import("./components/besigner-ai-controls.component.js").then((m)=>m.AiRewriteControl));
+const AssistPanelOnHost = lazyWidget('AssistPanelOnHost', ()=>import("./components/ai-permissions-on-host.component.js").then((m)=>m.AssistPanelOnHost));
+const AiCreditsCard = lazyWidget('AiCreditsCard', ()=>import("./components/ai-credits-card.component.js").then((m)=>m.default));
+const AiJobsTopBarIndicator = lazyWidget('AiJobsTopBarIndicator', ()=>import("./components/ai-jobs-indicator.component.js").then((m)=>m.default));
+const AiCollaboratorCreditsCell = lazyWidget('AiCollaboratorCreditsCell', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiCollaboratorCreditsCell));
+const AiCollaboratorCreditsHeader = lazyWidget('AiCollaboratorCreditsHeader', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiCollaboratorCreditsHeader));
+const AiMemberCreditsCell = lazyWidget('AiMemberCreditsCell', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiMemberCreditsCell));
+const AiMemberCreditsHeader = lazyWidget('AiMemberCreditsHeader', ()=>import("./components/ai-credits-columns.component.js").then((m)=>m.AiMemberCreditsHeader));
+const AssistSignalsPage = lazyWidget('AssistSignalsPage', ()=>import("./components/assist-signals-page.component.js").then((m)=>m.AssistSignalsPage), PAGE_LOADING);
+const BillingAssistOverageCard = lazyWidget('BillingAssistOverageCard', ()=>import("./components/billing-assist-overage-card.component.js").then((m)=>m.default));
+const AiTopUsersCard = lazyWidget('AiTopUsersCard', ()=>import("./components/billing-ai-top-users.component.js").then((m)=>m.AiTopUsersCard));
+const AiAllotmentsCard = lazyWidget('AiAllotmentsCard', ()=>import("./components/billing-ai-allotments.component.js").then((m)=>m.AiAllotmentsCard));
+const AiCollaboratorAllotmentCell = lazyWidget('AiCollaboratorAllotmentCell', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiCollaboratorAllotmentCell));
+const AiCollaboratorAllotmentHeader = lazyWidget('AiCollaboratorAllotmentHeader', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiCollaboratorAllotmentHeader));
+const AiSiteAllotmentCard = lazyWidget('AiSiteAllotmentCard', ()=>import("./components/host-ai-allotments.component.js").then((m)=>m.AiSiteAllotmentCard));
+const MemberAiAllotmentCard = lazyWidget('MemberAiAllotmentCard', ()=>import("./components/member-ai-allotment-card.component.js").then((m)=>m.default));
+const MemberAiUsageCard = lazyWidget('MemberAiUsageCard', ()=>import("./components/member-ai-usage-card.component.js").then((m)=>m.default));
+const AiThemeProposalCard = lazyWidget('AiThemeProposalCard', ()=>import("./components/ai-theme-proposal-card.component.js").then((m)=>m.default));
+const StaffOrgAiCard = lazyWidget('StaffOrgAiCard', ()=>import("./components/staff-org-ai-card.component.js").then((m)=>m.default));
+const StaffOrgUsageAiCreditsCell = lazyWidget('StaffOrgUsageAiCreditsCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiCreditsCell));
+const StaffOrgUsageAiOverageCell = lazyWidget('StaffOrgUsageAiOverageCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiOverageCell));
+const StaffOrgUsageAiPool = lazyWidget('StaffOrgUsageAiPool', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAiPool));
+const StaffOrgUsageAssistCell = lazyWidget('StaffOrgUsageAssistCell', ()=>import("./components/staff-org-usage-ai-columns.component.js").then((m)=>m.StaffOrgUsageAssistCell));
+const StaffOrgsAiSpendCell = lazyWidget('StaffOrgsAiSpendCell', ()=>import("./components/staff-orgs-ai-spend-column.component.js").then((m)=>m.StaffOrgsAiSpendCell));
+const StaffOrgsAiSpendHeader = lazyWidget('StaffOrgsAiSpendHeader', ()=>import("./components/staff-orgs-ai-spend-column.component.js").then((m)=>m.StaffOrgsAiSpendHeader));
+const StaffUserAiUsageCard = lazyWidget('StaffUserAiUsageCard', ()=>import("./components/staff-user-ai-usage-card.component.js").then((m)=>m.default));
+const AiSeoAuditCard = lazyWidget('AiSeoAuditCard', ()=>import("./components/ai-seo-audit-card.component.js").then((m)=>m.default));
+const AiSiteBatchCard = lazyWidget('AiSiteBatchCard', ()=>import("./components/ai-site-batch-card.component.js").then((m)=>m.default));
+const AiSiteSeoStartCard = lazyWidget('AiSiteSeoStartCard', ()=>import("./components/ai-site-seo-start-card.component.js").then((m)=>m.default));
+const AiSiteStartCard = lazyWidget('AiSiteStartCard', ()=>import("./components/ai-site-start-card.component.js").then((m)=>m.default));
+const AiSeoFieldsCard = lazyWidget('AiSeoFieldsCard', ()=>import("./components/ai-seo-fields-card.component.js").then((m)=>m.default));
+const AiDescribeAutomationButton = lazyWidget('AiDescribeAutomationButton', ()=>import("./components/ai-describe-automation.component.js").then((m)=>m.default));
+const AiReviseAutomation = lazyWidget('AiReviseAutomation', ()=>import("./components/ai-revise-automation.component.js").then((m)=>m.default));
+const AiDescribeOrgAutomationButton = lazyWidget('AiDescribeOrgAutomationButton', ()=>import("./components/ai-describe-org-automation.component.js").then((m)=>m.default));
+const AiInsightHostCard = lazyWidget('AiInsightHostCard', ()=>import("./components/ai-insight-card.component.js").then((m)=>m.AiInsightHostCard));
+const AiInsightOrgCard = lazyWidget('AiInsightOrgCard', ()=>import("./components/ai-insight-card.component.js").then((m)=>m.AiInsightOrgCard));
+const AiLogicCreateButton = lazyWidget('AiLogicCreateButton', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicCreateButton));
+const AiLogicFixReference = lazyWidget('AiLogicFixReference', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicFixReference));
+const AiLogicFunctionTools = lazyWidget('AiLogicFunctionTools', ()=>import("./components/ai-logic.component.js").then((m)=>m.AiLogicFunctionTools));
+const AiFunnelAskButton = lazyWidget('AiFunnelAskButton', ()=>import("./components/ai-funnel-zones.component.js").then((m)=>m.AiFunnelAskButton));
+const AiFunnelCreateButton = lazyWidget('AiFunnelCreateButton', ()=>import("./components/ai-funnel-zones.component.js").then((m)=>m.AiFunnelCreateButton));
+const AiCrmEmailDraft = lazyWidget('AiCrmEmailDraft', ()=>import("./components/ai-crm-email-draft.component.js").then((m)=>m.default));
+const AiCrmImportMapping = lazyWidget('AiCrmImportMapping', ()=>import("./components/ai-crm-import-mapping.component.js").then((m)=>m.default));
+const AiCrmRecordCard = lazyWidget('AiCrmRecordCard', ()=>import("./components/ai-crm-record-card.component.js").then((m)=>m.default));
+const AiDescribePageButton = lazyWidget('AiDescribePageButton', ()=>import("./components/ai-describe-page.component.js").then((m)=>m.default));
+const AiMediaCreateButton = lazyWidget('AiMediaCreateButton', ()=>import("./components/ai-media-create.component.js").then((m)=>m.default));
+const AiDescribeComponentButton = lazyWidget('AiDescribeComponentButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeComponentButton));
+const AiDescribeFormButton = lazyWidget('AiDescribeFormButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeFormButton));
+const AiDescribeLayoutButton = lazyWidget('AiDescribeLayoutButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeLayoutButton));
+const AiDescribeTemplateButton = lazyWidget('AiDescribeTemplateButton', ()=>import("./components/ai-describe-button.component.js").then((m)=>m.AiDescribeTemplateButton));
+const AiDescribeEmailButton = lazyWidget('AiDescribeEmailButton', ()=>import("./components/ai-describe-email.component.js").then((m)=>m.AiDescribeEmailButton));
+const AiExperimentResultCard = lazyWidget('AiExperimentResultCard', ()=>import("./components/ai-experiment-cards.component.js").then((m)=>m.AiExperimentResultCard));
+const AiExperimentVariantsCard = lazyWidget('AiExperimentVariantsCard', ()=>import("./components/ai-experiment-cards.component.js").then((m)=>m.AiExperimentVariantsCard));
+const AiExplainAutomation = lazyWidget('AiExplainAutomation', ()=>import("./components/ai-explain-automation.component.js").then((m)=>m.AiExplainAutomation));
+const AiExplainRunFailure = lazyWidget('AiExplainRunFailure', ()=>import("./components/ai-explain-automation.component.js").then((m)=>m.AiExplainRunFailure));
+const AiCreateCampaignButton = lazyWidget('AiCreateCampaignButton', ()=>import("./components/ai-campaign-create.component.js").then((m)=>m.default));
+const AiMarketingInsightButton = lazyWidget('AiMarketingInsightButton', ()=>import("./components/ai-marketing-insight.component.js").then((m)=>m.default));
+const AiCreateOverlayButton = lazyWidget('AiCreateOverlayButton', ()=>import("./components/ai-overlay-cards.component.js").then((m)=>m.AiCreateOverlayButton));
+const AiOverlayEditorCard = lazyWidget('AiOverlayEditorCard', ()=>import("./components/ai-overlay-cards.component.js").then((m)=>m.AiOverlayEditorCard));
+const AiProductCopyCard = lazyWidget('AiProductCopyCard', ()=>import("./components/ai-product-copy-card.component.js").then((m)=>m.default));
+const AiProductImportOption = lazyWidget('AiProductImportOption', ()=>import("./components/ai-product-import-option.component.js").then((m)=>m.default));
+const AiProductsHubCard = lazyWidget('AiProductsHubCard', ()=>import("./components/ai-products-hub-card.component.js").then((m)=>m.default));
+const AiCreateProductsButton = lazyWidget('AiCreateProductsButton', ()=>import("./components/ai-products-create-button.component.js").then((m)=>m.default));
+const AiJobsPage = lazyWidget('AiJobsPage', ()=>import("./components/ai-jobs-page.component.js").then((m)=>m.default), PAGE_LOADING);
 /**
  * The Aglyn AI plugin's console half (AGL-2939): the assistant dock, the
  * besigner copy assistant's provider, the billing, member and staff cards,
@@ -351,26 +394,33 @@ import { registerAiDeclarations } from "./declarations.js";
                 Component: AiSeoAuditCard
             },
             // A page from a brief (AGL-2907): "Create with AI" beside Templates and
-            // Create New Screen. Gated as the other generative widgets are, and it
-            // asks the jobs route about the release flag before it shows anything.
+            // Create New Screen. Gated as the other generative widgets are.
+            // On a plan that could buy the AI add-on and has not, each "Create with
+            // AI" entry here is mounted anyway (`showWhenNotEntitled`) and opens
+            // the add-on's dialog instead of the brief (AGL-3601). The shell holds
+            // each behind `release_ai_generative` too, so an entry draws at once
+            // and asks the jobs route nothing until its brief is sent.
             {
                 slot: 'hostScreens',
                 widgetId: 'ai-describe-page',
                 title: 'Describe a page',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribePageButton
             },
             // The same entry for a page template, a layout and a form (AGL-3043),
             // beside the create action of the page that lists each: the same
-            // dialog, the same gates, and the same question to the jobs route
-            // before it shows anything.
+            // dialog and the same gates.
             {
                 slot: 'hostTemplates',
                 widgetId: 'ai-describe-template',
                 title: 'Describe a page template',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeTemplateButton
             },
             {
@@ -379,6 +429,8 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Describe a layout',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeLayoutButton
             },
             {
@@ -387,47 +439,186 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Describe a form',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeFormButton
             },
             // And a reusable component from a brief (AGL-3051), beside Templates
             // and Create Component: the component job's first entry point, which
             // had none in the console.
+            // Pictures from a description (AGL-3602): "Create with AI" beside Upload
+            // media in the media library, and in its empty state. Gated as the
+            // other generative widgets are, by the shell alone: it asks nothing of
+            // a server until someone creates a picture, and the door decides then.
+            {
+                slot: 'mediaLibrary',
+                widgetId: 'ai-media-create',
+                title: 'Create images with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                Component: AiMediaCreateButton
+            },
             {
                 slot: 'hostComponents',
                 widgetId: 'ai-describe-component',
                 title: 'Describe a reusable component',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeComponentButton
             },
+            // An email design from a brief (AGL-3596), beside New template on a
+            // site's email templates — the zone the email plugin hosts. Its dialog
+            // also offers the draft campaign that would send it; the Campaigns
+            // section's own door is `ai-create-campaign`, below.
+            {
+                slot: 'hostEmailTemplates',
+                widgetId: 'ai-describe-email',
+                title: 'Describe an email',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiDescribeEmailButton
+            },
             // Automations by AI (AGL-2919), in the zones the workflows plugin hosts
             // on its Automation page: "Create with AI" beside Add action and Recipes,
             // "Explain it" in the editor of a saved automation, and "Why did this
-            // fail?" on a failed run. Gated as the other generative widgets are;
-            // each asks the jobs route about the release flag before it shows
-            // anything, and none of them changes an automation.
+            // fail?" on a failed run. Gated as the other generative widgets are,
+            // the release flag included, by the shell alone (AGL-3601): none asks
+            // the jobs route anything until it is used, and none of them changes an
+            // automation.
             {
                 slot: 'hostAutomations',
                 widgetId: 'ai-describe-automation',
                 title: 'Describe an automation',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
                 Component: AiDescribeAutomationButton
             },
+            // Funnels by AI (AGL-3605), in the zones the funnels plugin hosts on
+            // its card: a draft from a description, and its results explained.
+            {
+                slot: 'funnelsCreate',
+                widgetId: 'ai-describe-funnel',
+                title: 'Describe a funnel',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiFunnelCreateButton
+            },
+            {
+                slot: 'funnelInsight',
+                widgetId: 'ai-explain-funnel',
+                title: 'Ask AI about this funnel',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiFunnelAskButton
+            },
             {
                 slot: 'automationEditor',
                 widgetId: 'ai-explain-automation',
                 title: 'Explain this automation',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExplainAutomation
             },
+            // "Change with AI" and "Fix with AI" in a saved action's editor
+            // (AGL-3603): a changed copy drafted OFF beside it, never the saved
+            // action written in place.
+            {
+                slot: 'automationEditor',
+                widgetId: 'ai-revise-automation',
+                title: 'Change this automation with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiReviseAutomation
+            },
+            // "Create with AI" on the workspace's Org automations (AGL-3603): one
+            // of the workspace's automations drafted from a description and opened
+            // in that section's editor, unsaved and switched off.
+            {
+                slot: 'orgAutomations',
+                widgetId: 'ai-describe-org-automation',
+                title: 'Describe an org automation',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiDescribeOrgAutomationButton
+            },
+            // "Ask AI about these numbers" (AGL-3603): a tile on a site's
+            // dashboard and Analytics page, which both draw `hostDashboard`, and on
+            // the workspace's sites page. It opens the insight dialog the Assist
+            // panel opens, gated as every generative widget is.
+            {
+                slot: 'hostDashboard',
+                widgetId: 'ai-insight-ask',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiInsightHostCard
+            },
+            {
+                slot: 'orgDashboard',
+                widgetId: 'ai-insight-ask',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiInsightOrgCard
+            },
+            // Logic by AI (AGL-3603), in the zones the logic plugin hosts on its
+            // Functions & Variables page: Create with AI in the Functions and
+            // Variables card headers, Explain / Change / Fix in a saved function's
+            // editor, and Fix with AI on a broken reference an automation holds.
+            // Each proposal opens unsaved in the logic editor; none is saved here.
+            {
+                slot: 'hostLogic',
+                widgetId: 'ai-describe-logic',
+                title: 'Describe a function or variable',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicCreateButton
+            },
+            {
+                slot: 'logicFunctionEditor',
+                widgetId: 'ai-logic-function',
+                title: 'This function with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicFunctionTools
+            },
+            {
+                slot: 'logicReferenceIssue',
+                widgetId: 'ai-logic-fix-reference',
+                title: 'Fix this reference with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiLogicFixReference
+            },
             {
                 slot: 'automationRun',
                 widgetId: 'ai-explain-run-failure',
                 title: 'Why did this run fail?',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExplainRunFailure
             },
             // CRM by AI (AGL-2917): a record's summary and next step on its page,
@@ -504,8 +695,9 @@ import { registerAiDeclarations } from "./declarations.js";
             // Commerce by AI (AGL-2916): product copy in the product editor, the
             // catalog, categories and discounts on the products hub, and copy for
             // an import as it lands. The commerce plugin hosts the zones and makes
-            // every write; each card asks the jobs route about the release flag
-            // before it shows anything.
+            // every write. The shell holds the release flag; the products hub card
+            // reads its recent proposals before it draws its own controls, but
+            // offers the "Create with AI" door's brief from the moment it mounts.
             {
                 slot: 'productEditor',
                 widgetId: 'ai-product-copy',
@@ -520,8 +712,22 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Build your catalog with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiProductsHubCard
             },
+            // "Create with AI" beside Add product and in the empty catalog
+            // (AGL-3596): a door to the card's Propose products brief, shown only
+            // while that card is on the page to take it.
+            {
+                slot: 'productsCreate',
+                widgetId: 'ai-products-create',
+                title: 'Propose products',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateProductsButton
+            },
             {
                 slot: 'productImport',
                 widgetId: 'ai-product-import',
@@ -534,8 +740,8 @@ import { registerAiDeclarations } from "./declarations.js";
             // editor, and one test's result read in plain words below its figures.
             // The A/B testing card hosts both zones, so they are drawn only where
             // that card is and only on a site with A/B testing; the shell holds the
-            // plan band and `ai.generate`, and each card asks the jobs route about
-            // the release flag before it shows anything. Neither writes: the
+            // plan band, `ai.generate` and the release flag, and neither card asks
+            // the jobs route anything until it is used (AGL-3601). Neither writes: the
             // experiment editor's Save is the only write, and an explanation has
             // nothing to apply.
             {
@@ -544,6 +750,7 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Write variants with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExperimentVariantsCard
             },
             {
@@ -552,7 +759,61 @@ import { registerAiDeclarations } from "./declarations.js";
                 title: 'Explain this result with AI',
                 featureFlag: 'aiGenerative',
                 permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
                 Component: AiExperimentResultCard
+            },
+            // Overlays by AI (AGL-3603), in the zones the marketing plugin's
+            // overlays list hosts: "Create with AI" beside New bar and New popup,
+            // and "Write with AI" among the overlay editor's fields. Both start a
+            // `text` job asked for overlay copy; neither writes — the list saves a
+            // created overlay switched off, and the editor's Save is the write.
+            {
+                slot: 'hostOverlays',
+                widgetId: 'ai-create-overlay',
+                title: 'Create an overlay with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateOverlayButton
+            },
+            {
+                slot: 'overlayEditor',
+                widgetId: 'ai-overlay-copy',
+                title: 'Write overlay copy with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                releaseFlag: 'release_ai_generative',
+                Component: AiOverlayEditorCard
+            },
+            // A campaign from a brief (AGL-3603), beside Create campaign on the
+            // Campaigns section the marketing plugin hosts: the `campaign` job's
+            // first console door, or the `email` job's where the plan sends no
+            // campaign email. Both write drafts that are aimed at nobody and sent
+            // by nobody until a member does.
+            {
+                slot: 'hostCampaigns',
+                widgetId: 'ai-create-campaign',
+                title: 'Create a campaign with AI',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiCreateCampaignButton
+            },
+            // The figures in words (AGL-3603), in the header of the Conversions
+            // section and of one campaign's report: the insight dialog the Assist
+            // panel opens, on the Marketing surface, for the site the figures are.
+            // It reads and cites; it changes nothing.
+            {
+                slot: 'marketingInsights',
+                widgetId: 'ai-marketing-insight',
+                title: 'Ask AI about these numbers',
+                featureFlag: 'aiGenerative',
+                permission: 'ai.generate',
+                showWhenNotEntitled: true,
+                releaseFlag: 'release_ai_generative',
+                Component: AiMarketingInsightButton
             }
         ]
     });