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

package/src/lib/server.js

@@ -30,7 +30,10 @@ import { registerAiProductsJob } from "./jobs/ai-job-products-step.js";
 import { registerAiEmailJob } from "./jobs/ai-job-email-step.js";
 import { registerAiCampaignJob } from "./jobs/ai-job-campaign-step.js";
 import { registerAiSiteJob } from "./jobs/ai-job-site-step.js";
+import { registerAiBuildJob } from "./jobs/ai-job-build-step.js";
+import { registerAiBuildCapabilities } from "./jobs/ai-build-capabilities.js";
 import { registerAiWorkflowJob } from "./jobs/ai-job-workflow-step.js";
+import { registerAiLogicJob } from "./jobs/ai-job-logic-step.js";
 import { registerAiInsightJob } from "./jobs/ai-job-insight-step.js";
 import { registerAiFigureReaders } from "./insights/ai-figure-readers.js";
 import { registerAiTextGenerator } from "./server/plugin-text-generation.js";
@@ -45,7 +48,9 @@ import { POST as createAiSiteBatch } from "./server/ai-jobs-batch.js";
 import { GET as listAiJobs, POST as createAiJob } from "./server/ai-jobs-route.js";
 import { POST as resumeAiJob } from "./server/ai-jobs-resume.js";
 import { POST as aiGenerateComponent } from "./server/ai-generate-component.js";
+import { POST as createAiMediaImages } from "./server/ai-media-image.js";
 import { POST as applyAiSeoAudit } from "./server/ai-seo-apply.js";
+import { POST as createAiExperimentVersions } from "./server/ai-experiment-versions.js";
 import { POST as assistChat } from "./server/assist-chat.js";
 import { POST as assistEditApplied } from "./server/assist-edit-applied.js";
 import { POST as assistFeedback } from "./server/assist-feedback.js";
@@ -111,12 +116,21 @@ export * from "./runtime/ai-runtime.js";
     // Automations drafted from a description, and explained, whose drafts the
     // workflows plugin writes on the resource-draft seam (AGL-2919).
     registerAiWorkflowJob();
+    // Site functions and variables proposed from a description, and functions
+    // explained, as proposals the logic editor opens unsaved (AGL-3603).
+    registerAiLogicJob();
     // Product copy, and a store's products, categories and discounts from a
     // brief, as proposals the commerce plugin's surfaces apply (AGL-2916).
     registerAiProductsJob();
     // The site scaffold, which builds a whole site through the steps above
     // (AGL-2911).
     registerAiSiteJob();
+    // A build from one request (AGL-3616): pages, creations and other
+    // plugins' drafts, through the steps above and the writers those plugins
+    // register, settled item by item. What this plugin lets a build make is
+    // registered on the core's capability contract like any plugin's.
+    registerAiBuildCapabilities();
+    registerAiBuildJob();
     // Insights (AGL-2915): a question about a site's figures, answered from
     // tables the figure readers return, and the weekly digest. The readers for
     // the platform's own records — page views, forms, datasets — are this
@@ -226,12 +240,24 @@ export * from "./runtime/ai-runtime.js";
     registerPluginApiRoute('ai/seo/apply', {
         web: applyAiSeoAudit
     });
+    // A page's or a section's A/B variants as draft versions (AGL-3603): the
+    // published version copied once per proposed variant, the variant's copy
+    // put in, stored unpublished for the experiment editor to pin.
+    registerPluginApiRoute('ai/experiments/versions', {
+        web: createAiExperimentVersions
+    });
     // Save the selection as a reusable component, with AI (AGL-2908): the
     // second entry point of the component job, from the besigner's Attributes
     // panel. It proposes, and the person's Apply writes.
     registerPluginApiRoute('ai/generate/component', {
         web: aiGenerateComponent
     });
+    // Pictures from a description, in Media (AGL-3602): photos and SVG
+    // illustrations, stored through the media upload route. POST only — the
+    // button draws from the shell's gates and asks nothing until it is used.
+    registerPluginApiRoute('ai/media/images', {
+        web: createAiMediaImages
+    });
     registerPluginApiRoute('ai/billing/credits', {
         web: billingCredits
     });

package/src/lib/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { registerPluginApiRoute } from '@aglyn/aglyn/server'\nimport { registerAiDeclarations } from './declarations'\nimport { AI_JOBS_BEAT_PATH } from './jobs/ai-jobs-beat'\nimport { registerAiJobPlan } from './jobs/ai-job-plan-step'\nimport { registerAiJobsPause } from './jobs/ai-jobs-pause'\nimport { registerAiJobsNotify } from './jobs/ai-jobs-notify'\nimport { registerAiComponentJob } from './jobs/ai-job-component-step'\nimport { registerAiCrmJob } from './jobs/ai-job-crm-step'\nimport { registerAiLayoutJob } from './jobs/ai-job-layout-step'\nimport { registerAiTemplateJob } from './jobs/ai-job-template-step'\nimport { registerAiExperimentJob } from './jobs/ai-job-experiment-step'\nimport { registerAiFormJob } from './jobs/ai-job-form-step'\nimport { registerAiPageJob } from './jobs/ai-job-page-step'\nimport { registerAiProductsJob } from './jobs/ai-job-products-step'\nimport { registerAiEmailJob } from './jobs/ai-job-email-step'\nimport { registerAiCampaignJob } from './jobs/ai-job-campaign-step'\nimport { registerAiSiteJob } from './jobs/ai-job-site-step'\nimport { registerAiWorkflowJob } from './jobs/ai-job-workflow-step'\nimport { registerAiInsightJob } from './jobs/ai-job-insight-step'\nimport { registerAiFigureReaders } from './insights/ai-figure-readers'\nimport { registerAiTextGenerator } from './server/plugin-text-generation'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { ensureFirstPartyAiProviders } from './providers/registry'\nimport { aiAssistHandler } from './server/ai-assist'\nimport { GET as aiCrmAnswer } from './server/ai-crm-answer'\nimport { POST as runAiJobsBeat } from './server/ai-jobs-beat-route'\nimport { POST as cancelAiJob } from './server/ai-jobs-cancel'\nimport { GET as aiJobEvents } from './server/ai-jobs-events-route'\nimport { POST as createAiSiteBatch } from './server/ai-jobs-batch'\nimport { GET as listAiJobs, POST as createAiJob } from './server/ai-jobs-route'\nimport { POST as resumeAiJob } from './server/ai-jobs-resume'\nimport { POST as aiGenerateComponent } from './server/ai-generate-component'\nimport { POST as applyAiSeoAudit } from './server/ai-seo-apply'\nimport { POST as assistChat } from './server/assist-chat'\nimport { POST as assistEditApplied } from './server/assist-edit-applied'\nimport { POST as assistFeedback } from './server/assist-feedback'\nimport { PATCH as aiHostPermissions } from './server/ai-host-permissions'\nimport { GET as aiAdminOrg } from './server/ai-admin-org'\nimport { GET as aiAdminOrgsSpend } from './server/ai-admin-orgs-spend'\nimport { GET as aiAdminSignals } from './server/ai-admin-signals'\nimport { GET as aiAdminUser } from './server/ai-admin-user'\nimport { POST as aiAdminOverage } from './server/ai-admin-overage'\nimport { POST as aiAdminCredits } from './server/ai-admin-credits'\nimport { GET as aiUsage } from './server/ai-usage'\nimport { GET as aiAllotments } from './server/ai-allotments'\nimport { GET as aiInsightAnswer } from './server/ai-insight-answer'\nimport { POST as runAiInsightsDigest } from './server/ai-insight-digest-route'\nimport { AI_INSIGHTS_DIGEST_PATH } from './insights/ai-insight-digest'\nimport { GET as aiModels } from './server/ai-models'\nimport { GET as billingCredits } from './server/billing-credits'\nimport { POST as billingOverage } from './server/billing-overage'\n\nexport * from './providers/contract'\nexport * from './providers/catalog'\nexport * from './providers/registry'\nexport * from './providers/routing'\nexport * from './runtime/ai-runtime'\n\n/**\n * The two first-party adapters, registered once per process. A marketplace\n * plugin registers its own against `AI_PROVIDER_CONTRACT` from its own\n * entry and never touches this.\n */\nconst registerFirstPartyProviders = ensureFirstPartyAiProviders\n\n/**\n * Every job kind this plugin runs beyond the three the machine registers\n * itself (AGL-3025). Each is a CALL, never an import made for what the\n * module does as it loads: this package declares only this file\n * effect-ful, so a bundler honoring `sideEffects` deletes an import whose\n * exports go unused — and a step registered that way ran in every spec and\n * in neither app. `registrations-survive-a-bundler.spec.ts` holds this.\n *\n * The console surface is the only caller (AGL-3026): its doors run a job's\n * first step inline, and its beat runs every step after it. The tenant app\n * loads no server surface of this plugin at all, so nothing that serves a\n * published site can reach a provider.\n */\nfunction registerAiJobKinds(): void {\n  // The workspace AI pause the machine asks before it claims any step, so a\n  // paused workspace's queued jobs spend nothing (AGL-3037).\n  registerAiJobsPause()\n  // The person who started a job is told when it needs them, finishes or\n  // stops (AGL-3593), from the write that changed it.\n  registerAiJobsNotify()\n  // The plan step every planned kind runs first (AGL-2935).\n  registerAiJobPlan()\n  // Components, layouts and templates (AGL-2908, AGL-2909).\n  registerAiComponentJob()\n  registerAiLayoutJob()\n  registerAiTemplateJob()\n  // Forms (AGL-2913).\n  registerAiExperimentJob()\n  registerAiFormJob()\n  // Pages, with the least time one pass needs (AGL-2907).\n  registerAiPageJob()\n  // Email designs and campaigns, whose drafts the email and marketing\n  // plugins write on the resource-draft seam (AGL-2912).\n  registerAiEmailJob()\n  registerAiCampaignJob()\n  // Automations drafted from a description, and explained, whose drafts the\n  // workflows plugin writes on the resource-draft seam (AGL-2919).\n  registerAiWorkflowJob()\n  // Product copy, and a store's products, categories and discounts from a\n  // brief, as proposals the commerce plugin's surfaces apply (AGL-2916).\n  registerAiProductsJob()\n  // The site scaffold, which builds a whole site through the steps above\n  // (AGL-2911).\n  registerAiSiteJob()\n  // Insights (AGL-2915): a question about a site's figures, answered from\n  // tables the figure readers return, and the weekly digest. The readers for\n  // the platform's own records — page views, forms, datasets — are this\n  // plugin's; every other plugin registers its own from its console surface.\n  registerAiFigureReaders(() => firebaseAdmin.app().firestore())\n  registerAiInsightJob()\n  // CRM by AI (AGL-2917): a record's summary and next step, an email draft\n  // and an import's column matches, read through the CRM's facts readers.\n  registerAiCrmJob()\n}\n\n/**\n * The console-side API (AGL-2939): every AI door, under the `ai` and\n * `assist` prefixes the plugin owns. The URLs the panel and the besigner\n * call are unchanged — `/api/assist/chat`, `/api/ai/assist`,\n * `/api/ai/jobs` — because the dispatcher serves them from the registry\n * exactly where the named routes used to; the two billing doors and the\n * per-member usage read (`ai/usage`) live under the plugin's own prefix.\n * The jobs beat is the one path outside them, for the reason\n * `AI_JOBS_BEAT_PATH` gives.\n */\nexport function registerAiConsoleApi(): void {\n  registerAiDeclarations()\n  registerFirstPartyProviders()\n  registerAiJobKinds()\n  // This plugin as the workspace's text generator on the core's seam\n  // (AGL-3324): another plugin drafts a paragraph through it under the\n  // generation doors' own rules, metered as a text job is.\n  registerAiTextGenerator()\n  registerPluginApiRoute('assist/chat', { web: assistChat })\n  registerPluginApiRoute('assist/feedback', { web: assistFeedback })\n  // The applied-edit record (AGL-2906): counts of a proposal the author\n  // applied in their editor, written to the site's activity log.\n  registerPluginApiRoute('assist/edit-applied', { web: assistEditApplied })\n  // A collaborator's AI toggles on one site (AGL-2927), set from the site's\n  // collaborators card through this plugin's column there.\n  registerPluginApiRoute('ai/host-permissions', { web: aiHostPermissions })\n  registerPluginApiRoute('ai/assist', aiAssistHandler)\n  registerPluginApiRoute('ai/jobs', {\n    web: (request) => (request.method === 'GET' ? listAiJobs(request) : createAiJob(request)),\n  })\n  // The agency batch (AGL-2911): one brief, one `site` job per named site,\n  // under one batch id. Before the `:jobId` routes, which it is not one of.\n  registerPluginApiRoute('ai/jobs/batch', { web: createAiSiteBatch })\n  registerPluginApiRoute('ai/jobs/:jobId/cancel', {\n    web: (request, context) =>\n      cancelAiJob(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  registerPluginApiRoute('ai/jobs/:jobId/resume', {\n    web: (request, context) =>\n      resumeAiJob(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // An insight job's answer (AGL-2915), which is kept off the job document\n  // and served only to the member who asked, or for a digest to the site's\n  // members.\n  registerPluginApiRoute('ai/insights/:jobId', {\n    web: (request, context) =>\n      aiInsightAnswer(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // A CRM job's answer (AGL-2917), which is kept off the job document and\n  // served only to a member the CRM still lets read the record.\n  registerPluginApiRoute('ai/crm/:jobId', {\n    web: (request, context) =>\n      aiCrmAnswer(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  registerPluginApiRoute('ai/jobs/:jobId/events', {\n    web: (request, context) =>\n      aiJobEvents(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // The jobs beat (AGL-3026): every step the doors leave queued, run every\n  // minute by the console's scheduler on the cron secret, on the one surface\n  // that holds the provider's key.\n  registerPluginApiRoute(AI_JOBS_BEAT_PATH, { web: runAiJobsBeat })\n  // The weekly insights (AGL-2915): Monday's digests made for the people who\n  // asked for them, and delivered once the beat has written them. Beside the\n  // beat under `/api/admin/`, where the console's scheduled sweeps live.\n  registerPluginApiRoute(AI_INSIGHTS_DIGEST_PATH, { web: runAiInsightsDigest })\n  // A site SEO audit's \"Apply all\" (AGL-2910): content fixes as new\n  // unpublished versions, listing values staged for their SEO cards.\n  registerPluginApiRoute('ai/seo/apply', { web: applyAiSeoAudit })\n  // Save the selection as a reusable component, with AI (AGL-2908): the\n  // second entry point of the component job, from the besigner's Attributes\n  // panel. It proposes, and the person's Apply writes.\n  registerPluginApiRoute('ai/generate/component', { web: aiGenerateComponent })\n  registerPluginApiRoute('ai/billing/credits', { web: billingCredits })\n  registerPluginApiRoute('ai/billing/overage', { web: billingOverage })\n  registerPluginApiRoute('ai/usage', { web: aiUsage })\n  // The allotments a manager sets, and the options the model switch lists\n  // (AGL-2942). One handler answers the allotments' GET and POST.\n  registerPluginApiRoute('ai/allotments', { web: aiAllotments })\n  registerPluginApiRoute('ai/models', { web: aiModels })\n  // The staff doors (AGL-2928, AGL-2930, AGL-2252): one org's AI in full,\n  // one account's usage across its workspaces, and the fleet's Assist\n  // signals behind the Assist signal staff page.\n  registerPluginApiRoute('ai/admin/org', { web: aiAdminOrg })\n  registerPluginApiRoute('ai/admin/orgs-spend', { web: aiAdminOrgsSpend })\n  registerPluginApiRoute('ai/admin/user', { web: aiAdminUser })\n  registerPluginApiRoute('ai/admin/signals', { web: aiAdminSignals })\n  // One workspace's overage standing and the four acts staff have over it\n  // (AGL-3011): the ceiling override, lifting a pause — the only way a\n  // dispute pause comes off — and resetting the step. Every act audited.\n  registerPluginApiRoute('ai/admin/overage', { web: aiAdminOverage })\n  // Credits given back to a workspace's band or a Free owner's allowance\n  // (AGL-3595): compensation for a fault of ours, bounded by what the month\n  // used, keyed against a double-click, and audited.\n  registerPluginApiRoute('ai/admin/credits', { web: aiAdminCredits })\n}\n\n// Type-only (AGL-3080): the plugin's entitlement keys, declared by module\n// augmentation, for every program that loads this entry point.\nexport type { aiPlanEntitlements } from './plan-entitlements'\n"],"names":["registerPluginApiRoute","registerAiDeclarations","AI_JOBS_BEAT_PATH","registerAiJobPlan","registerAiJobsPause","registerAiJobsNotify","registerAiComponentJob","registerAiCrmJob","registerAiLayoutJob","registerAiTemplateJob","registerAiExperimentJob","registerAiFormJob","registerAiPageJob","registerAiProductsJob","registerAiEmailJob","registerAiCampaignJob","registerAiSiteJob","registerAiWorkflowJob","registerAiInsightJob","registerAiFigureReaders","registerAiTextGenerator","firebaseAdmin","ensureFirstPartyAiProviders","aiAssistHandler","GET","aiCrmAnswer","POST","runAiJobsBeat","cancelAiJob","aiJobEvents","createAiSiteBatch","listAiJobs","createAiJob","resumeAiJob","aiGenerateComponent","applyAiSeoAudit","assistChat","assistEditApplied","assistFeedback","PATCH","aiHostPermissions","aiAdminOrg","aiAdminOrgsSpend","aiAdminSignals","aiAdminUser","aiAdminOverage","aiAdminCredits","aiUsage","aiAllotments","aiInsightAnswer","runAiInsightsDigest","AI_INSIGHTS_DIGEST_PATH","aiModels","billingCredits","billingOverage","registerFirstPartyProviders","registerAiJobKinds","app","firestore","registerAiConsoleApi","web","request","method","context","params","Promise","resolve","jobId","String"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { registerPluginApiRoute } from '@aglyn/aglyn/server'\nimport { registerAiDeclarations } from './declarations'\nimport { AI_JOBS_BEAT_PATH } from './jobs/ai-jobs-beat'\nimport { registerAiJobPlan } from './jobs/ai-job-plan-step'\nimport { registerAiJobsPause } from './jobs/ai-jobs-pause'\nimport { registerAiJobsNotify } from './jobs/ai-jobs-notify'\nimport { registerAiComponentJob } from './jobs/ai-job-component-step'\nimport { registerAiCrmJob } from './jobs/ai-job-crm-step'\nimport { registerAiLayoutJob } from './jobs/ai-job-layout-step'\nimport { registerAiTemplateJob } from './jobs/ai-job-template-step'\nimport { registerAiExperimentJob } from './jobs/ai-job-experiment-step'\nimport { registerAiFormJob } from './jobs/ai-job-form-step'\nimport { registerAiPageJob } from './jobs/ai-job-page-step'\nimport { registerAiProductsJob } from './jobs/ai-job-products-step'\nimport { registerAiEmailJob } from './jobs/ai-job-email-step'\nimport { registerAiCampaignJob } from './jobs/ai-job-campaign-step'\nimport { registerAiSiteJob } from './jobs/ai-job-site-step'\nimport { registerAiBuildJob } from './jobs/ai-job-build-step'\nimport { registerAiBuildCapabilities } from './jobs/ai-build-capabilities'\nimport { registerAiWorkflowJob } from './jobs/ai-job-workflow-step'\nimport { registerAiLogicJob } from './jobs/ai-job-logic-step'\nimport { registerAiInsightJob } from './jobs/ai-job-insight-step'\nimport { registerAiFigureReaders } from './insights/ai-figure-readers'\nimport { registerAiTextGenerator } from './server/plugin-text-generation'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport { ensureFirstPartyAiProviders } from './providers/registry'\nimport { aiAssistHandler } from './server/ai-assist'\nimport { GET as aiCrmAnswer } from './server/ai-crm-answer'\nimport { POST as runAiJobsBeat } from './server/ai-jobs-beat-route'\nimport { POST as cancelAiJob } from './server/ai-jobs-cancel'\nimport { GET as aiJobEvents } from './server/ai-jobs-events-route'\nimport { POST as createAiSiteBatch } from './server/ai-jobs-batch'\nimport { GET as listAiJobs, POST as createAiJob } from './server/ai-jobs-route'\nimport { POST as resumeAiJob } from './server/ai-jobs-resume'\nimport { POST as aiGenerateComponent } from './server/ai-generate-component'\nimport { POST as createAiMediaImages } from './server/ai-media-image'\nimport { POST as applyAiSeoAudit } from './server/ai-seo-apply'\nimport { POST as createAiExperimentVersions } from './server/ai-experiment-versions'\nimport { POST as assistChat } from './server/assist-chat'\nimport { POST as assistEditApplied } from './server/assist-edit-applied'\nimport { POST as assistFeedback } from './server/assist-feedback'\nimport { PATCH as aiHostPermissions } from './server/ai-host-permissions'\nimport { GET as aiAdminOrg } from './server/ai-admin-org'\nimport { GET as aiAdminOrgsSpend } from './server/ai-admin-orgs-spend'\nimport { GET as aiAdminSignals } from './server/ai-admin-signals'\nimport { GET as aiAdminUser } from './server/ai-admin-user'\nimport { POST as aiAdminOverage } from './server/ai-admin-overage'\nimport { POST as aiAdminCredits } from './server/ai-admin-credits'\nimport { GET as aiUsage } from './server/ai-usage'\nimport { GET as aiAllotments } from './server/ai-allotments'\nimport { GET as aiInsightAnswer } from './server/ai-insight-answer'\nimport { POST as runAiInsightsDigest } from './server/ai-insight-digest-route'\nimport { AI_INSIGHTS_DIGEST_PATH } from './insights/ai-insight-digest'\nimport { GET as aiModels } from './server/ai-models'\nimport { GET as billingCredits } from './server/billing-credits'\nimport { POST as billingOverage } from './server/billing-overage'\n\nexport * from './providers/contract'\nexport * from './providers/catalog'\nexport * from './providers/registry'\nexport * from './providers/routing'\nexport * from './runtime/ai-runtime'\n\n/**\n * The two first-party adapters, registered once per process. A marketplace\n * plugin registers its own against `AI_PROVIDER_CONTRACT` from its own\n * entry and never touches this.\n */\nconst registerFirstPartyProviders = ensureFirstPartyAiProviders\n\n/**\n * Every job kind this plugin runs beyond the three the machine registers\n * itself (AGL-3025). Each is a CALL, never an import made for what the\n * module does as it loads: this package declares only this file\n * effect-ful, so a bundler honoring `sideEffects` deletes an import whose\n * exports go unused — and a step registered that way ran in every spec and\n * in neither app. `registrations-survive-a-bundler.spec.ts` holds this.\n *\n * The console surface is the only caller (AGL-3026): its doors run a job's\n * first step inline, and its beat runs every step after it. The tenant app\n * loads no server surface of this plugin at all, so nothing that serves a\n * published site can reach a provider.\n */\nfunction registerAiJobKinds(): void {\n  // The workspace AI pause the machine asks before it claims any step, so a\n  // paused workspace's queued jobs spend nothing (AGL-3037).\n  registerAiJobsPause()\n  // The person who started a job is told when it needs them, finishes or\n  // stops (AGL-3593), from the write that changed it.\n  registerAiJobsNotify()\n  // The plan step every planned kind runs first (AGL-2935).\n  registerAiJobPlan()\n  // Components, layouts and templates (AGL-2908, AGL-2909).\n  registerAiComponentJob()\n  registerAiLayoutJob()\n  registerAiTemplateJob()\n  // Forms (AGL-2913).\n  registerAiExperimentJob()\n  registerAiFormJob()\n  // Pages, with the least time one pass needs (AGL-2907).\n  registerAiPageJob()\n  // Email designs and campaigns, whose drafts the email and marketing\n  // plugins write on the resource-draft seam (AGL-2912).\n  registerAiEmailJob()\n  registerAiCampaignJob()\n  // Automations drafted from a description, and explained, whose drafts the\n  // workflows plugin writes on the resource-draft seam (AGL-2919).\n  registerAiWorkflowJob()\n  // Site functions and variables proposed from a description, and functions\n  // explained, as proposals the logic editor opens unsaved (AGL-3603).\n  registerAiLogicJob()\n  // Product copy, and a store's products, categories and discounts from a\n  // brief, as proposals the commerce plugin's surfaces apply (AGL-2916).\n  registerAiProductsJob()\n  // The site scaffold, which builds a whole site through the steps above\n  // (AGL-2911).\n  registerAiSiteJob()\n  // A build from one request (AGL-3616): pages, creations and other\n  // plugins' drafts, through the steps above and the writers those plugins\n  // register, settled item by item. What this plugin lets a build make is\n  // registered on the core's capability contract like any plugin's.\n  registerAiBuildCapabilities()\n  registerAiBuildJob()\n  // Insights (AGL-2915): a question about a site's figures, answered from\n  // tables the figure readers return, and the weekly digest. The readers for\n  // the platform's own records — page views, forms, datasets — are this\n  // plugin's; every other plugin registers its own from its console surface.\n  registerAiFigureReaders(() => firebaseAdmin.app().firestore())\n  registerAiInsightJob()\n  // CRM by AI (AGL-2917): a record's summary and next step, an email draft\n  // and an import's column matches, read through the CRM's facts readers.\n  registerAiCrmJob()\n}\n\n/**\n * The console-side API (AGL-2939): every AI door, under the `ai` and\n * `assist` prefixes the plugin owns. The URLs the panel and the besigner\n * call are unchanged — `/api/assist/chat`, `/api/ai/assist`,\n * `/api/ai/jobs` — because the dispatcher serves them from the registry\n * exactly where the named routes used to; the two billing doors and the\n * per-member usage read (`ai/usage`) live under the plugin's own prefix.\n * The jobs beat is the one path outside them, for the reason\n * `AI_JOBS_BEAT_PATH` gives.\n */\nexport function registerAiConsoleApi(): void {\n  registerAiDeclarations()\n  registerFirstPartyProviders()\n  registerAiJobKinds()\n  // This plugin as the workspace's text generator on the core's seam\n  // (AGL-3324): another plugin drafts a paragraph through it under the\n  // generation doors' own rules, metered as a text job is.\n  registerAiTextGenerator()\n  registerPluginApiRoute('assist/chat', { web: assistChat })\n  registerPluginApiRoute('assist/feedback', { web: assistFeedback })\n  // The applied-edit record (AGL-2906): counts of a proposal the author\n  // applied in their editor, written to the site's activity log.\n  registerPluginApiRoute('assist/edit-applied', { web: assistEditApplied })\n  // A collaborator's AI toggles on one site (AGL-2927), set from the site's\n  // collaborators card through this plugin's column there.\n  registerPluginApiRoute('ai/host-permissions', { web: aiHostPermissions })\n  registerPluginApiRoute('ai/assist', aiAssistHandler)\n  registerPluginApiRoute('ai/jobs', {\n    web: (request) => (request.method === 'GET' ? listAiJobs(request) : createAiJob(request)),\n  })\n  // The agency batch (AGL-2911): one brief, one `site` job per named site,\n  // under one batch id. Before the `:jobId` routes, which it is not one of.\n  registerPluginApiRoute('ai/jobs/batch', { web: createAiSiteBatch })\n  registerPluginApiRoute('ai/jobs/:jobId/cancel', {\n    web: (request, context) =>\n      cancelAiJob(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  registerPluginApiRoute('ai/jobs/:jobId/resume', {\n    web: (request, context) =>\n      resumeAiJob(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // An insight job's answer (AGL-2915), which is kept off the job document\n  // and served only to the member who asked, or for a digest to the site's\n  // members.\n  registerPluginApiRoute('ai/insights/:jobId', {\n    web: (request, context) =>\n      aiInsightAnswer(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // A CRM job's answer (AGL-2917), which is kept off the job document and\n  // served only to a member the CRM still lets read the record.\n  registerPluginApiRoute('ai/crm/:jobId', {\n    web: (request, context) =>\n      aiCrmAnswer(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  registerPluginApiRoute('ai/jobs/:jobId/events', {\n    web: (request, context) =>\n      aiJobEvents(request, { params: Promise.resolve({ jobId: String(context.params['jobId']) }) }),\n  })\n  // The jobs beat (AGL-3026): every step the doors leave queued, run every\n  // minute by the console's scheduler on the cron secret, on the one surface\n  // that holds the provider's key.\n  registerPluginApiRoute(AI_JOBS_BEAT_PATH, { web: runAiJobsBeat })\n  // The weekly insights (AGL-2915): Monday's digests made for the people who\n  // asked for them, and delivered once the beat has written them. Beside the\n  // beat under `/api/admin/`, where the console's scheduled sweeps live.\n  registerPluginApiRoute(AI_INSIGHTS_DIGEST_PATH, { web: runAiInsightsDigest })\n  // A site SEO audit's \"Apply all\" (AGL-2910): content fixes as new\n  // unpublished versions, listing values staged for their SEO cards.\n  registerPluginApiRoute('ai/seo/apply', { web: applyAiSeoAudit })\n  // A page's or a section's A/B variants as draft versions (AGL-3603): the\n  // published version copied once per proposed variant, the variant's copy\n  // put in, stored unpublished for the experiment editor to pin.\n  registerPluginApiRoute('ai/experiments/versions', { web: createAiExperimentVersions })\n  // Save the selection as a reusable component, with AI (AGL-2908): the\n  // second entry point of the component job, from the besigner's Attributes\n  // panel. It proposes, and the person's Apply writes.\n  registerPluginApiRoute('ai/generate/component', { web: aiGenerateComponent })\n  // Pictures from a description, in Media (AGL-3602): photos and SVG\n  // illustrations, stored through the media upload route. POST only — the\n  // button draws from the shell's gates and asks nothing until it is used.\n  registerPluginApiRoute('ai/media/images', { web: createAiMediaImages })\n  registerPluginApiRoute('ai/billing/credits', { web: billingCredits })\n  registerPluginApiRoute('ai/billing/overage', { web: billingOverage })\n  registerPluginApiRoute('ai/usage', { web: aiUsage })\n  // The allotments a manager sets, and the options the model switch lists\n  // (AGL-2942). One handler answers the allotments' GET and POST.\n  registerPluginApiRoute('ai/allotments', { web: aiAllotments })\n  registerPluginApiRoute('ai/models', { web: aiModels })\n  // The staff doors (AGL-2928, AGL-2930, AGL-2252): one org's AI in full,\n  // one account's usage across its workspaces, and the fleet's Assist\n  // signals behind the Assist signal staff page.\n  registerPluginApiRoute('ai/admin/org', { web: aiAdminOrg })\n  registerPluginApiRoute('ai/admin/orgs-spend', { web: aiAdminOrgsSpend })\n  registerPluginApiRoute('ai/admin/user', { web: aiAdminUser })\n  registerPluginApiRoute('ai/admin/signals', { web: aiAdminSignals })\n  // One workspace's overage standing and the four acts staff have over it\n  // (AGL-3011): the ceiling override, lifting a pause — the only way a\n  // dispute pause comes off — and resetting the step. Every act audited.\n  registerPluginApiRoute('ai/admin/overage', { web: aiAdminOverage })\n  // Credits given back to a workspace's band or a Free owner's allowance\n  // (AGL-3595): compensation for a fault of ours, bounded by what the month\n  // used, keyed against a double-click, and audited.\n  registerPluginApiRoute('ai/admin/credits', { web: aiAdminCredits })\n}\n\n// Type-only (AGL-3080): the plugin's entitlement keys, declared by module\n// augmentation, for every program that loads this entry point.\nexport type { aiPlanEntitlements } from './plan-entitlements'\n"],"names":["registerPluginApiRoute","registerAiDeclarations","AI_JOBS_BEAT_PATH","registerAiJobPlan","registerAiJobsPause","registerAiJobsNotify","registerAiComponentJob","registerAiCrmJob","registerAiLayoutJob","registerAiTemplateJob","registerAiExperimentJob","registerAiFormJob","registerAiPageJob","registerAiProductsJob","registerAiEmailJob","registerAiCampaignJob","registerAiSiteJob","registerAiBuildJob","registerAiBuildCapabilities","registerAiWorkflowJob","registerAiLogicJob","registerAiInsightJob","registerAiFigureReaders","registerAiTextGenerator","firebaseAdmin","ensureFirstPartyAiProviders","aiAssistHandler","GET","aiCrmAnswer","POST","runAiJobsBeat","cancelAiJob","aiJobEvents","createAiSiteBatch","listAiJobs","createAiJob","resumeAiJob","aiGenerateComponent","createAiMediaImages","applyAiSeoAudit","createAiExperimentVersions","assistChat","assistEditApplied","assistFeedback","PATCH","aiHostPermissions","aiAdminOrg","aiAdminOrgsSpend","aiAdminSignals","aiAdminUser","aiAdminOverage","aiAdminCredits","aiUsage","aiAllotments","aiInsightAnswer","runAiInsightsDigest","AI_INSIGHTS_DIGEST_PATH","aiModels","billingCredits","billingOverage","registerFirstPartyProviders","registerAiJobKinds","app","firestore","registerAiConsoleApi","web","request","method","context","params","Promise","resolve","jobId","String"],"mappings":"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"}

package/src/lib/tools/ai-logic-tool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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 { AiTool } from '../providers/contract';
+/**
+ * The strict tools a `logic` job answers through (AGL-3603). Each carries the
+ * shape the logic editor stores and nothing else: no id, no flag that saves
+ * or publishes. `checkAiLogicFunction` and `checkAiLogicVariable` decide what
+ * is kept — the grammar, the names and a first run — never this schema.
+ */
+export declare const AI_LOGIC_FUNCTION_TOOL_NAME = "submit_function";
+export declare const AI_LOGIC_VARIABLE_TOOL_NAME = "submit_variable";
+export declare function aiLogicFunctionTool(): AiTool;
+export declare function aiLogicVariableTool(): AiTool;

package/src/lib/tools/ai-logic-tool.js

@@ -0,0 +1,207 @@
+/**
+ * @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 { AI_LOGIC_COMPARATORS, AI_LOGIC_EXPRESSION_MAX_CHARS, AI_LOGIC_MAX_LOCALS, AI_LOGIC_MAX_OPERATIONS, AI_LOGIC_MAX_PARAMETERS, AI_LOGIC_MAX_SETS, AI_LOGIC_VALUE_TYPES, AI_LOGIC_VARIABLE_TYPES } from "../model/ai-logic-job.js";
+/**
+ * The strict tools a `logic` job answers through (AGL-3603). Each carries the
+ * shape the logic editor stores and nothing else: no id, no flag that saves
+ * or publishes. `checkAiLogicFunction` and `checkAiLogicVariable` decide what
+ * is kept — the grammar, the names and a first run — never this schema.
+ */ export const AI_LOGIC_FUNCTION_TOOL_NAME = 'submit_function';
+export const AI_LOGIC_VARIABLE_TOOL_NAME = 'submit_variable';
+const assignments = {
+    type: 'array',
+    description: `At most ${AI_LOGIC_MAX_SETS}; empty when nothing changes on that branch.`,
+    items: {
+        type: 'object',
+        additionalProperties: false,
+        required: [
+            'set',
+            'expression'
+        ],
+        properties: {
+            set: {
+                type: 'string',
+                description: 'The parameter or local this assigns.'
+            },
+            expression: {
+                type: 'string',
+                description: `The value, as an expression; at most ${AI_LOGIC_EXPRESSION_MAX_CHARS} characters.`
+            }
+        }
+    }
+};
+export function aiLogicFunctionTool() {
+    return {
+        name: AI_LOGIC_FUNCTION_TOOL_NAME,
+        description: 'Submit the function, as the Functions editor stores it. Every field is required.',
+        strict: true,
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'name',
+                'parameters',
+                'locals',
+                'operations',
+                'returnValue'
+            ],
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'The function’s name: a letter or _, then letters, digits or _.'
+                },
+                parameters: {
+                    type: 'array',
+                    description: `What the function is given; at most ${AI_LOGIC_MAX_PARAMETERS}.`,
+                    items: {
+                        type: 'object',
+                        additionalProperties: false,
+                        required: [
+                            'name',
+                            'type',
+                            'required',
+                            'label',
+                            'defaultValue'
+                        ],
+                        properties: {
+                            name: {
+                                type: 'string'
+                            },
+                            type: {
+                                type: 'string',
+                                enum: [
+                                    ...AI_LOGIC_VALUE_TYPES
+                                ]
+                            },
+                            required: {
+                                type: 'boolean'
+                            },
+                            label: {
+                                type: 'string',
+                                description: 'What a visitor reads above the input; empty for none.'
+                            },
+                            defaultValue: {
+                                type: 'string',
+                                description: 'What the input starts with; empty for none.'
+                            }
+                        }
+                    }
+                },
+                locals: {
+                    type: 'array',
+                    description: `Working values the operations set; at most ${AI_LOGIC_MAX_LOCALS}.`,
+                    items: {
+                        type: 'object',
+                        additionalProperties: false,
+                        required: [
+                            'name',
+                            'type'
+                        ],
+                        properties: {
+                            name: {
+                                type: 'string'
+                            },
+                            type: {
+                                type: 'string',
+                                enum: [
+                                    ...AI_LOGIC_VALUE_TYPES
+                                ]
+                            }
+                        }
+                    }
+                },
+                operations: {
+                    type: 'array',
+                    description: `Run in order; at most ${AI_LOGIC_MAX_OPERATIONS}. Each is if (left comparator right) then … otherwise ….`,
+                    items: {
+                        type: 'object',
+                        additionalProperties: false,
+                        required: [
+                            'if',
+                            'then',
+                            'otherwise'
+                        ],
+                        properties: {
+                            if: {
+                                type: 'object',
+                                additionalProperties: false,
+                                required: [
+                                    'left',
+                                    'comparator',
+                                    'right'
+                                ],
+                                properties: {
+                                    left: {
+                                        type: 'string'
+                                    },
+                                    comparator: {
+                                        type: 'string',
+                                        enum: [
+                                            ...AI_LOGIC_COMPARATORS
+                                        ]
+                                    },
+                                    right: {
+                                        type: 'string'
+                                    }
+                                }
+                            },
+                            then: assignments,
+                            otherwise: assignments
+                        }
+                    }
+                },
+                returnValue: {
+                    type: 'string',
+                    description: 'The parameter or local whose final value the function returns.'
+                }
+            }
+        }
+    };
+}
+export function aiLogicVariableTool() {
+    return {
+        name: AI_LOGIC_VARIABLE_TOOL_NAME,
+        description: 'Submit the variable, as the Variables editor stores it. Every field is required.',
+        strict: true,
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'name',
+                'type',
+                'value'
+            ],
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'A letter or _, then letters, digits or _.'
+                },
+                type: {
+                    type: 'string',
+                    enum: [
+                        ...AI_LOGIC_VARIABLE_TYPES
+                    ]
+                },
+                value: {
+                    type: 'string',
+                    description: 'The value as stored: a number as digits; true or false; a date as YYYY-MM-DD; a time as HH:MM; a dictionary as a JSON object; a collection as a JSON list.'
+                }
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=ai-logic-tool.js.map

package/src/lib/tools/ai-logic-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-logic-tool.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AI_LOGIC_COMPARATORS,\n  AI_LOGIC_EXPRESSION_MAX_CHARS,\n  AI_LOGIC_MAX_LOCALS,\n  AI_LOGIC_MAX_OPERATIONS,\n  AI_LOGIC_MAX_PARAMETERS,\n  AI_LOGIC_MAX_SETS,\n  AI_LOGIC_VALUE_TYPES,\n  AI_LOGIC_VARIABLE_TYPES,\n} from '../model/ai-logic-job'\nimport type { AiTool } from '../providers/contract'\n\n/**\n * The strict tools a `logic` job answers through (AGL-3603). Each carries the\n * shape the logic editor stores and nothing else: no id, no flag that saves\n * or publishes. `checkAiLogicFunction` and `checkAiLogicVariable` decide what\n * is kept — the grammar, the names and a first run — never this schema.\n */\n\nexport const AI_LOGIC_FUNCTION_TOOL_NAME = 'submit_function'\nexport const AI_LOGIC_VARIABLE_TOOL_NAME = 'submit_variable'\n\nconst assignments = {\n  type: 'array',\n  description: `At most ${AI_LOGIC_MAX_SETS}; empty when nothing changes on that branch.`,\n  items: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['set', 'expression'],\n    properties: {\n      set: { type: 'string', description: 'The parameter or local this assigns.' },\n      expression: {\n        type: 'string',\n        description: `The value, as an expression; at most ${AI_LOGIC_EXPRESSION_MAX_CHARS} characters.`,\n      },\n    },\n  },\n}\n\nexport function aiLogicFunctionTool(): AiTool {\n  return {\n    name: AI_LOGIC_FUNCTION_TOOL_NAME,\n    description: 'Submit the function, as the Functions editor stores it. Every field is required.',\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['name', 'parameters', 'locals', 'operations', 'returnValue'],\n      properties: {\n        name: { type: 'string', description: 'The function’s name: a letter or _, then letters, digits or _.' },\n        parameters: {\n          type: 'array',\n          description: `What the function is given; at most ${AI_LOGIC_MAX_PARAMETERS}.`,\n          items: {\n            type: 'object',\n            additionalProperties: false,\n            required: ['name', 'type', 'required', 'label', 'defaultValue'],\n            properties: {\n              name: { type: 'string' },\n              type: { type: 'string', enum: [...AI_LOGIC_VALUE_TYPES] },\n              required: { type: 'boolean' },\n              label: { type: 'string', description: 'What a visitor reads above the input; empty for none.' },\n              defaultValue: { type: 'string', description: 'What the input starts with; empty for none.' },\n            },\n          },\n        },\n        locals: {\n          type: 'array',\n          description: `Working values the operations set; at most ${AI_LOGIC_MAX_LOCALS}.`,\n          items: {\n            type: 'object',\n            additionalProperties: false,\n            required: ['name', 'type'],\n            properties: {\n              name: { type: 'string' },\n              type: { type: 'string', enum: [...AI_LOGIC_VALUE_TYPES] },\n            },\n          },\n        },\n        operations: {\n          type: 'array',\n          description: `Run in order; at most ${AI_LOGIC_MAX_OPERATIONS}. Each is if (left comparator right) then … otherwise ….`,\n          items: {\n            type: 'object',\n            additionalProperties: false,\n            required: ['if', 'then', 'otherwise'],\n            properties: {\n              if: {\n                type: 'object',\n                additionalProperties: false,\n                required: ['left', 'comparator', 'right'],\n                properties: {\n                  left: { type: 'string' },\n                  comparator: { type: 'string', enum: [...AI_LOGIC_COMPARATORS] },\n                  right: { type: 'string' },\n                },\n              },\n              then: assignments,\n              otherwise: assignments,\n            },\n          },\n        },\n        returnValue: { type: 'string', description: 'The parameter or local whose final value the function returns.' },\n      },\n    },\n  }\n}\n\nexport function aiLogicVariableTool(): AiTool {\n  return {\n    name: AI_LOGIC_VARIABLE_TOOL_NAME,\n    description: 'Submit the variable, as the Variables editor stores it. Every field is required.',\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      additionalProperties: false,\n      required: ['name', 'type', 'value'],\n      properties: {\n        name: { type: 'string', description: 'A letter or _, then letters, digits or _.' },\n        type: { type: 'string', enum: [...AI_LOGIC_VARIABLE_TYPES] },\n        value: {\n          type: 'string',\n          description:\n            'The value as stored: a number as digits; true or false; a date as YYYY-MM-DD; a time as HH:MM; a dictionary as a JSON object; a collection as a JSON list.',\n        },\n      },\n    },\n  }\n}\n"],"names":["AI_LOGIC_COMPARATORS","AI_LOGIC_EXPRESSION_MAX_CHARS","AI_LOGIC_MAX_LOCALS","AI_LOGIC_MAX_OPERATIONS","AI_LOGIC_MAX_PARAMETERS","AI_LOGIC_MAX_SETS","AI_LOGIC_VALUE_TYPES","AI_LOGIC_VARIABLE_TYPES","AI_LOGIC_FUNCTION_TOOL_NAME","AI_LOGIC_VARIABLE_TOOL_NAME","assignments","type","description","items","additionalProperties","required","properties","set","expression","aiLogicFunctionTool","name","strict","inputSchema","parameters","enum","label","defaultValue","locals","operations","if","left","comparator","right","then","otherwise","returnValue","aiLogicVariableTool","value"],"mappings":"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"}

package/src/lib/tools/ai-overlay-tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 AiOverlayCopyAnswer, type AiOverlayCopyField, type AiOverlayKind, type AiOverlayTrigger } from '../model/ai-overlay-copy';
+import type { AiTool } from '../providers/contract';
+/**
+ * The strict tool overlay copy is answered through (AGL-3603).
+ *
+ * It carries copy and, for a popup, WHEN it opens — one of the triggers the
+ * request lists, or `none`. It has no field for a link, a schedule, the
+ * pages it shows on or whether it is switched on: those are a person's
+ * decisions in the overlay editor, and a model that could name them could put
+ * an overlay in front of visitors nobody chose.
+ */
+export declare const AI_OVERLAY_TOOL_NAME = "write_overlay_copy";
+export declare function aiOverlayTool(kind: AiOverlayKind, limits: Readonly<Record<AiOverlayCopyField, number>>, triggers: readonly AiOverlayTrigger[]): AiTool;
+/**
+ * A `write_overlay_copy` call as the check reads it, or `null` when it is not
+ * one. Values keep the lengths the model wrote: the check decides what is too
+ * long.
+ */
+export declare function parseAiOverlayCopy(input: unknown): AiOverlayCopyAnswer | null;

package/src/lib/tools/ai-overlay-tool.js

@@ -0,0 +1,107 @@
+/**
+ * @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 { AI_OVERLAY_TRIGGERS } from "../model/ai-overlay-copy.js";
+/**
+ * The strict tool overlay copy is answered through (AGL-3603).
+ *
+ * It carries copy and, for a popup, WHEN it opens — one of the triggers the
+ * request lists, or `none`. It has no field for a link, a schedule, the
+ * pages it shows on or whether it is switched on: those are a person's
+ * decisions in the overlay editor, and a model that could name them could put
+ * an overlay in front of visitors nobody chose.
+ */ export const AI_OVERLAY_TOOL_NAME = 'write_overlay_copy';
+export function aiOverlayTool(kind, limits, triggers) {
+    const properties = {
+        name: {
+            type: 'string',
+            description: `A short internal name for the ${kind === 'bar' ? 'bar' : 'popup'}, for the site owner's list; at most ${limits.name} characters.`
+        }
+    };
+    const required = [
+        'name'
+    ];
+    if (kind === 'bar') {
+        properties['text'] = {
+            type: 'string',
+            description: `The bar's one line of copy; at most ${limits.text} characters.`
+        };
+        required.push('text');
+    } else {
+        properties['headline'] = {
+            type: 'string',
+            description: `The popup's headline; at most ${limits.headline} characters.`
+        };
+        properties['body'] = {
+            type: 'string',
+            description: `The popup's supporting copy, one or two short paragraphs; at most ${limits.body} characters.`
+        };
+        properties['ctaLabel'] = {
+            type: 'string',
+            description: `The button's label, a few words that start with a verb; at most ${limits.ctaLabel} characters. Empty string for no button.`
+        };
+        properties['trigger'] = {
+            type: 'string',
+            enum: [
+                ...triggers.filter((trigger)=>AI_OVERLAY_TRIGGERS.includes(trigger)),
+                'none'
+            ],
+            description: 'When the popup opens, from the triggers the request lists; `none` to leave it as it is.'
+        };
+        properties['triggerValue'] = {
+            type: 'number',
+            description: 'Seconds after the page loads for `delay`, the percent of the page scrolled for `scroll`, inside the range the request gives; 0 for `exit` or `none`.'
+        };
+        required.push('headline', 'body', 'ctaLabel', 'trigger', 'triggerValue');
+    }
+    properties['rationale'] = {
+        type: 'string',
+        description: 'One sentence on what the copy leans on; at most 200 characters.'
+    };
+    required.push('rationale');
+    return {
+        name: AI_OVERLAY_TOOL_NAME,
+        description: `Write the copy for one ${kind === 'bar' ? 'announcement bar' : 'popup'}. Every field is required.`,
+        strict: true,
+        inputSchema: {
+            type: 'object',
+            properties,
+            required,
+            additionalProperties: false
+        }
+    };
+}
+const isRecord = (value)=>typeof value === 'object' && value !== null && !Array.isArray(value);
+const str = (value)=>typeof value === 'string' ? value : '';
+/**
+ * A `write_overlay_copy` call as the check reads it, or `null` when it is not
+ * one. Values keep the lengths the model wrote: the check decides what is too
+ * long.
+ */ export function parseAiOverlayCopy(input) {
+    if (!isRecord(input)) return null;
+    const value = input['triggerValue'];
+    return {
+        name: str(input['name']),
+        text: str(input['text']),
+        headline: str(input['headline']),
+        body: str(input['body']),
+        ctaLabel: str(input['ctaLabel']),
+        trigger: str(input['trigger']),
+        triggerValue: typeof value === 'number' && Number.isFinite(value) ? value : null,
+        rationale: str(input['rationale'])
+    };
+}
+
+//# sourceMappingURL=ai-overlay-tool.js.map

package/src/lib/tools/ai-overlay-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/tools/ai-overlay-tool.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  AI_OVERLAY_TRIGGERS,\n  type AiOverlayCopyAnswer,\n  type AiOverlayCopyField,\n  type AiOverlayKind,\n  type AiOverlayTrigger,\n} from '../model/ai-overlay-copy'\nimport type { AiTool } from '../providers/contract'\n\n/**\n * The strict tool overlay copy is answered through (AGL-3603).\n *\n * It carries copy and, for a popup, WHEN it opens — one of the triggers the\n * request lists, or `none`. It has no field for a link, a schedule, the\n * pages it shows on or whether it is switched on: those are a person's\n * decisions in the overlay editor, and a model that could name them could put\n * an overlay in front of visitors nobody chose.\n */\n\nexport const AI_OVERLAY_TOOL_NAME = 'write_overlay_copy'\n\nexport function aiOverlayTool(\n  kind: AiOverlayKind,\n  limits: Readonly<Record<AiOverlayCopyField, number>>,\n  triggers: readonly AiOverlayTrigger[],\n): AiTool {\n  const properties: Record<string, unknown> = {\n    name: {\n      type: 'string',\n      description: `A short internal name for the ${kind === 'bar' ? 'bar' : 'popup'}, for the site owner's list; at most ${limits.name} characters.`,\n    },\n  }\n  const required = ['name']\n  if (kind === 'bar') {\n    properties['text'] = {\n      type: 'string',\n      description: `The bar's one line of copy; at most ${limits.text} characters.`,\n    }\n    required.push('text')\n  } else {\n    properties['headline'] = {\n      type: 'string',\n      description: `The popup's headline; at most ${limits.headline} characters.`,\n    }\n    properties['body'] = {\n      type: 'string',\n      description: `The popup's supporting copy, one or two short paragraphs; at most ${limits.body} characters.`,\n    }\n    properties['ctaLabel'] = {\n      type: 'string',\n      description: `The button's label, a few words that start with a verb; at most ${limits.ctaLabel} characters. Empty string for no button.`,\n    }\n    properties['trigger'] = {\n      type: 'string',\n      enum: [...triggers.filter((trigger) => (AI_OVERLAY_TRIGGERS as readonly string[]).includes(trigger)), 'none'],\n      description: 'When the popup opens, from the triggers the request lists; `none` to leave it as it is.',\n    }\n    properties['triggerValue'] = {\n      type: 'number',\n      description:\n        'Seconds after the page loads for `delay`, the percent of the page scrolled for `scroll`, inside the range the request gives; 0 for `exit` or `none`.',\n    }\n    required.push('headline', 'body', 'ctaLabel', 'trigger', 'triggerValue')\n  }\n  properties['rationale'] = {\n    type: 'string',\n    description: 'One sentence on what the copy leans on; at most 200 characters.',\n  }\n  required.push('rationale')\n  return {\n    name: AI_OVERLAY_TOOL_NAME,\n    description: `Write the copy for one ${kind === 'bar' ? 'announcement bar' : 'popup'}. Every field is required.`,\n    strict: true,\n    inputSchema: {\n      type: 'object',\n      properties,\n      required,\n      additionalProperties: false,\n    },\n  }\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value : '')\n\n/**\n * A `write_overlay_copy` call as the check reads it, or `null` when it is not\n * one. Values keep the lengths the model wrote: the check decides what is too\n * long.\n */\nexport function parseAiOverlayCopy(input: unknown): AiOverlayCopyAnswer | null {\n  if (!isRecord(input)) return null\n  const value = input['triggerValue']\n  return {\n    name: str(input['name']),\n    text: str(input['text']),\n    headline: str(input['headline']),\n    body: str(input['body']),\n    ctaLabel: str(input['ctaLabel']),\n    trigger: str(input['trigger']),\n    triggerValue: typeof value === 'number' && Number.isFinite(value) ? value : null,\n    rationale: str(input['rationale']),\n  }\n}\n"],"names":["AI_OVERLAY_TRIGGERS","AI_OVERLAY_TOOL_NAME","aiOverlayTool","kind","limits","triggers","properties","name","type","description","required","text","push","headline","body","ctaLabel","enum","filter","trigger","includes","strict","inputSchema","additionalProperties","isRecord","value","Array","isArray","str","parseAiOverlayCopy","input","triggerValue","Number","isFinite","rationale"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,mBAAmB,QAKd,8BAA0B;AAGjC;;;;;;;;CAQC,GAED,OAAO,MAAMC,uBAAuB,qBAAoB;AAExD,OAAO,SAASC,cACdC,IAAmB,EACnBC,MAAoD,EACpDC,QAAqC;IAErC,MAAMC,aAAsC;QAC1CC,MAAM;YACJC,MAAM;YACNC,aAAa,CAAC,8BAA8B,EAAEN,SAAS,QAAQ,QAAQ,QAAQ,qCAAqC,EAAEC,OAAOG,IAAI,CAAC,YAAY,CAAC;QACjJ;IACF;IACA,MAAMG,WAAW;QAAC;KAAO;IACzB,IAAIP,SAAS,OAAO;QAClBG,UAAU,CAAC,OAAO,GAAG;YACnBE,MAAM;YACNC,aAAa,CAAC,oCAAoC,EAAEL,OAAOO,IAAI,CAAC,YAAY,CAAC;QAC/E;QACAD,SAASE,IAAI,CAAC;IAChB,OAAO;QACLN,UAAU,CAAC,WAAW,GAAG;YACvBE,MAAM;YACNC,aAAa,CAAC,8BAA8B,EAAEL,OAAOS,QAAQ,CAAC,YAAY,CAAC;QAC7E;QACAP,UAAU,CAAC,OAAO,GAAG;YACnBE,MAAM;YACNC,aAAa,CAAC,kEAAkE,EAAEL,OAAOU,IAAI,CAAC,YAAY,CAAC;QAC7G;QACAR,UAAU,CAAC,WAAW,GAAG;YACvBE,MAAM;YACNC,aAAa,CAAC,gEAAgE,EAAEL,OAAOW,QAAQ,CAAC,wCAAwC,CAAC;QAC3I;QACAT,UAAU,CAAC,UAAU,GAAG;YACtBE,MAAM;YACNQ,MAAM;mBAAIX,SAASY,MAAM,CAAC,CAACC,UAAY,AAAClB,oBAA0CmB,QAAQ,CAACD;gBAAW;aAAO;YAC7GT,aAAa;QACf;QACAH,UAAU,CAAC,eAAe,GAAG;YAC3BE,MAAM;YACNC,aACE;QACJ;QACAC,SAASE,IAAI,CAAC,YAAY,QAAQ,YAAY,WAAW;IAC3D;IACAN,UAAU,CAAC,YAAY,GAAG;QACxBE,MAAM;QACNC,aAAa;IACf;IACAC,SAASE,IAAI,CAAC;IACd,OAAO;QACLL,MAAMN;QACNQ,aAAa,CAAC,uBAAuB,EAAEN,SAAS,QAAQ,qBAAqB,QAAQ,0BAA0B,CAAC;QAChHiB,QAAQ;QACRC,aAAa;YACXb,MAAM;YACNF;YACAI;YACAY,sBAAsB;QACxB;IACF;AACF;AAEA,MAAMC,WAAW,CAACC,QAChB,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,OAAO,CAACF;AAEhE,MAAMG,MAAM,CAACH,QAA4B,OAAOA,UAAU,WAAWA,QAAQ;AAE7E;;;;CAIC,GACD,OAAO,SAASI,mBAAmBC,KAAc;IAC/C,IAAI,CAACN,SAASM,QAAQ,OAAO;IAC7B,MAAML,QAAQK,KAAK,CAAC,eAAe;IACnC,OAAO;QACLtB,MAAMoB,IAAIE,KAAK,CAAC,OAAO;QACvBlB,MAAMgB,IAAIE,KAAK,CAAC,OAAO;QACvBhB,UAAUc,IAAIE,KAAK,CAAC,WAAW;QAC/Bf,MAAMa,IAAIE,KAAK,CAAC,OAAO;QACvBd,UAAUY,IAAIE,KAAK,CAAC,WAAW;QAC/BX,SAASS,IAAIE,KAAK,CAAC,UAAU;QAC7BC,cAAc,OAAON,UAAU,YAAYO,OAAOC,QAAQ,CAACR,SAASA,QAAQ;QAC5ES,WAAWN,IAAIE,KAAK,CAAC,YAAY;IACnC;AACF"}

package/src/lib/tools/ai-workflow-tool.d.ts

@@ -162,6 +162,17 @@ export declare function lifecycleStageOf(value: string): ContactLifecycleStage |
  * beside rule 13. `value` is the automation when nothing is refused.
  */
 export declare function readAiAutomationAnswer(answer: Record<string, unknown>, capabilities: AiAutomationCapabilities): AiGenerationCheckResult<AiAutomationAnswer>;
+/**
+ * An answer already read, held as well to an org automation's narrower
+ * vocabulary (AGL-3603): its trigger one the vocabulary names, and every step
+ * a type it names. A refusal names what the vocabulary holds, so the re-ask
+ * can pick from it. An answer that says the automation cannot be built is
+ * left as it is.
+ */
+export declare function holdAiAutomationAnswerToVocabulary(result: AiGenerationCheckResult<AiAutomationAnswer>, vocabulary: {
+    triggers: readonly HostEventType[];
+    steps: readonly AiAutomationStepType[];
+}): AiGenerationCheckResult<AiAutomationAnswer>;
 export interface AiWorkflowExplanation {
     summary: string;
     points: string[];