@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/server.js

@@ -0,0 +1,265 @@
+/**
+ * @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 { registerPluginApiRoute } from "@aglyn/aglyn/server";
+import { registerAiDeclarations } from "./declarations.js";
+import { AI_JOBS_BEAT_PATH } from "./jobs/ai-jobs-beat.js";
+import { registerAiJobPlan } from "./jobs/ai-job-plan-step.js";
+import { registerAiJobsPause } from "./jobs/ai-jobs-pause.js";
+import { registerAiComponentJob } from "./jobs/ai-job-component-step.js";
+import { registerAiCrmJob } from "./jobs/ai-job-crm-step.js";
+import { registerAiLayoutJob } from "./jobs/ai-job-layout-step.js";
+import { registerAiTemplateJob } from "./jobs/ai-job-template-step.js";
+import { registerAiExperimentJob } from "./jobs/ai-job-experiment-step.js";
+import { registerAiFormJob } from "./jobs/ai-job-form-step.js";
+import { registerAiPageJob } from "./jobs/ai-job-page-step.js";
+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 { registerAiWorkflowJob } from "./jobs/ai-job-workflow-step.js";
+import { registerAiInsightJob } from "./jobs/ai-job-insight-step.js";
+import { registerAiFigureReaders } from "./insights/ai-figure-readers.js";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { ensureFirstPartyAiProviders } from "./providers/registry.js";
+import { aiAssistHandler } from "./server/ai-assist.js";
+import { GET as aiCrmAnswer } from "./server/ai-crm-answer.js";
+import { POST as runAiJobsBeat } from "./server/ai-jobs-beat-route.js";
+import { POST as cancelAiJob } from "./server/ai-jobs-cancel.js";
+import { GET as aiJobEvents } from "./server/ai-jobs-events-route.js";
+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 applyAiSeoAudit } from "./server/ai-seo-apply.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";
+import { PATCH as aiHostPermissions } from "./server/ai-host-permissions.js";
+import { GET as aiAdminOrg } from "./server/ai-admin-org.js";
+import { GET as aiAdminOrgsSpend } from "./server/ai-admin-orgs-spend.js";
+import { GET as aiAdminSignals } from "./server/ai-admin-signals.js";
+import { GET as aiAdminUser } from "./server/ai-admin-user.js";
+import { POST as aiAdminOverage } from "./server/ai-admin-overage.js";
+import { GET as aiUsage } from "./server/ai-usage.js";
+import { GET as aiAllotments } from "./server/ai-allotments.js";
+import { GET as aiInsightAnswer } from "./server/ai-insight-answer.js";
+import { POST as runAiInsightsDigest } from "./server/ai-insight-digest-route.js";
+import { AI_INSIGHTS_DIGEST_PATH } from "./insights/ai-insight-digest.js";
+import { GET as aiModels } from "./server/ai-models.js";
+import { GET as billingCredits } from "./server/billing-credits.js";
+import { POST as billingOverage } from "./server/billing-overage.js";
+export * from "./providers/contract.js";
+export * from "./providers/catalog.js";
+export * from "./providers/registry.js";
+export * from "./providers/routing.js";
+export * from "./runtime/ai-runtime.js";
+/**
+ * The two first-party adapters, registered once per process. A marketplace
+ * plugin registers its own against `AI_PROVIDER_CONTRACT` from its own
+ * entry and never touches this.
+ */ const registerFirstPartyProviders = ensureFirstPartyAiProviders;
+/**
+ * Every job kind this plugin runs beyond the three the machine registers
+ * itself (AGL-3025). Each is a CALL, never an import made for what the
+ * module does as it loads: this package declares only this file
+ * effect-ful, so a bundler honoring `sideEffects` deletes an import whose
+ * exports go unused — and a step registered that way ran in every spec and
+ * in neither app. `registrations-survive-a-bundler.spec.ts` holds this.
+ *
+ * The console surface is the only caller (AGL-3026): its doors run a job's
+ * first step inline, and its beat runs every step after it. The tenant app
+ * loads no server surface of this plugin at all, so nothing that serves a
+ * published site can reach a provider.
+ */ function registerAiJobKinds() {
+    // The workspace AI pause the machine asks before it claims any step, so a
+    // paused workspace's queued jobs spend nothing (AGL-3037).
+    registerAiJobsPause();
+    // The plan step every planned kind runs first (AGL-2935).
+    registerAiJobPlan();
+    // Components, layouts and templates (AGL-2908, AGL-2909).
+    registerAiComponentJob();
+    registerAiLayoutJob();
+    registerAiTemplateJob();
+    // Forms (AGL-2913).
+    registerAiExperimentJob();
+    registerAiFormJob();
+    // Pages, with the least time one pass needs (AGL-2907).
+    registerAiPageJob();
+    // Email designs and campaigns, whose drafts the email and marketing
+    // plugins write on the resource-draft seam (AGL-2912).
+    registerAiEmailJob();
+    registerAiCampaignJob();
+    // Automations drafted from a description, and explained, whose drafts the
+    // workflows plugin writes on the resource-draft seam (AGL-2919).
+    registerAiWorkflowJob();
+    // 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();
+    // 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
+    // plugin's; every other plugin registers its own from its console surface.
+    registerAiFigureReaders(()=>firebaseAdmin.app().firestore());
+    registerAiInsightJob();
+    // CRM by AI (AGL-2917): a record's summary and next step, an email draft
+    // and an import's column matches, read through the CRM's facts readers.
+    registerAiCrmJob();
+}
+/**
+ * The console-side API (AGL-2939): every AI door, under the `ai` and
+ * `assist` prefixes the plugin owns. The URLs the panel and the besigner
+ * call are unchanged — `/api/assist/chat`, `/api/ai/assist`,
+ * `/api/ai/jobs` — because the dispatcher serves them from the registry
+ * exactly where the named routes used to; the two billing doors and the
+ * per-member usage read (`ai/usage`) live under the plugin's own prefix.
+ * The jobs beat is the one path outside them, for the reason
+ * `AI_JOBS_BEAT_PATH` gives.
+ */ export function registerAiConsoleApi() {
+    registerAiDeclarations();
+    registerFirstPartyProviders();
+    registerAiJobKinds();
+    registerPluginApiRoute('assist/chat', {
+        web: assistChat
+    });
+    registerPluginApiRoute('assist/feedback', {
+        web: assistFeedback
+    });
+    // The applied-edit record (AGL-2906): counts of a proposal the author
+    // applied in their editor, written to the site's activity log.
+    registerPluginApiRoute('assist/edit-applied', {
+        web: assistEditApplied
+    });
+    // A collaborator's AI toggles on one site (AGL-2927), set from the site's
+    // collaborators card through this plugin's column there.
+    registerPluginApiRoute('ai/host-permissions', {
+        web: aiHostPermissions
+    });
+    registerPluginApiRoute('ai/assist', aiAssistHandler);
+    registerPluginApiRoute('ai/jobs', {
+        web: (request)=>request.method === 'GET' ? listAiJobs(request) : createAiJob(request)
+    });
+    // The agency batch (AGL-2911): one brief, one `site` job per named site,
+    // under one batch id. Before the `:jobId` routes, which it is not one of.
+    registerPluginApiRoute('ai/jobs/batch', {
+        web: createAiSiteBatch
+    });
+    registerPluginApiRoute('ai/jobs/:jobId/cancel', {
+        web: (request, context)=>cancelAiJob(request, {
+                params: Promise.resolve({
+                    jobId: String(context.params['jobId'])
+                })
+            })
+    });
+    registerPluginApiRoute('ai/jobs/:jobId/resume', {
+        web: (request, context)=>resumeAiJob(request, {
+                params: Promise.resolve({
+                    jobId: String(context.params['jobId'])
+                })
+            })
+    });
+    // An insight job's answer (AGL-2915), which is kept off the job document
+    // and served only to the member who asked, or for a digest to the site's
+    // members.
+    registerPluginApiRoute('ai/insights/:jobId', {
+        web: (request, context)=>aiInsightAnswer(request, {
+                params: Promise.resolve({
+                    jobId: String(context.params['jobId'])
+                })
+            })
+    });
+    // A CRM job's answer (AGL-2917), which is kept off the job document and
+    // served only to a member the CRM still lets read the record.
+    registerPluginApiRoute('ai/crm/:jobId', {
+        web: (request, context)=>aiCrmAnswer(request, {
+                params: Promise.resolve({
+                    jobId: String(context.params['jobId'])
+                })
+            })
+    });
+    registerPluginApiRoute('ai/jobs/:jobId/events', {
+        web: (request, context)=>aiJobEvents(request, {
+                params: Promise.resolve({
+                    jobId: String(context.params['jobId'])
+                })
+            })
+    });
+    // The jobs beat (AGL-3026): every step the doors leave queued, run every
+    // minute by the console's scheduler on the cron secret, on the one surface
+    // that holds the provider's key.
+    registerPluginApiRoute(AI_JOBS_BEAT_PATH, {
+        web: runAiJobsBeat
+    });
+    // The weekly insights (AGL-2915): Monday's digests made for the people who
+    // asked for them, and delivered once the beat has written them. Beside the
+    // beat under `/api/admin/`, where the console's scheduled sweeps live.
+    registerPluginApiRoute(AI_INSIGHTS_DIGEST_PATH, {
+        web: runAiInsightsDigest
+    });
+    // A site SEO audit's "Apply all" (AGL-2910): content fixes as new
+    // unpublished versions, listing values staged for their SEO cards.
+    registerPluginApiRoute('ai/seo/apply', {
+        web: applyAiSeoAudit
+    });
+    // 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
+    });
+    registerPluginApiRoute('ai/billing/credits', {
+        web: billingCredits
+    });
+    registerPluginApiRoute('ai/billing/overage', {
+        web: billingOverage
+    });
+    registerPluginApiRoute('ai/usage', {
+        web: aiUsage
+    });
+    // The allotments a manager sets, and the options the model switch lists
+    // (AGL-2942). One handler answers the allotments' GET and POST.
+    registerPluginApiRoute('ai/allotments', {
+        web: aiAllotments
+    });
+    registerPluginApiRoute('ai/models', {
+        web: aiModels
+    });
+    // The staff doors (AGL-2928, AGL-2930, AGL-2252): one org's AI in full,
+    // one account's usage across its workspaces, and the fleet's Assist
+    // signals behind the Assist signal staff page.
+    registerPluginApiRoute('ai/admin/org', {
+        web: aiAdminOrg
+    });
+    registerPluginApiRoute('ai/admin/orgs-spend', {
+        web: aiAdminOrgsSpend
+    });
+    registerPluginApiRoute('ai/admin/user', {
+        web: aiAdminUser
+    });
+    registerPluginApiRoute('ai/admin/signals', {
+        web: aiAdminSignals
+    });
+    // One workspace's overage standing and the four acts staff have over it
+    // (AGL-3011): the ceiling override, lifting a pause — the only way a
+    // dispute pause comes off — and resetting the step. Every act audited.
+    registerPluginApiRoute('ai/admin/overage', {
+        web: aiAdminOverage
+    });
+}
+
+//# sourceMappingURL=server.js.map

package/src/lib/server.js.map

@@ -0,0 +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 { 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 { 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 { 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 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  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}\n"],"names":["registerPluginApiRoute","registerAiDeclarations","AI_JOBS_BEAT_PATH","registerAiJobPlan","registerAiJobsPause","registerAiComponentJob","registerAiCrmJob","registerAiLayoutJob","registerAiTemplateJob","registerAiExperimentJob","registerAiFormJob","registerAiPageJob","registerAiProductsJob","registerAiEmailJob","registerAiCampaignJob","registerAiSiteJob","registerAiWorkflowJob","registerAiInsightJob","registerAiFigureReaders","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","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/subprocessors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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 { PluginSubprocessorDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-subprocessors';
+export declare function aiSubprocessors(): PluginSubprocessorDeclaration[];

package/src/lib/subprocessors.js

@@ -0,0 +1,52 @@
+/**
+ * @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_CATALOG_PROVIDERS } from "./providers/catalog.js";
+import { listAiProviders } from "./providers/registry.js";
+/**
+ * The plugin's SUBPROCESSORS (AGL-2984): one declaration for every
+ * registered provider whose catalog entry carries a subprocessor row, at
+ * the host that provider reports. Named under `subprocessors` in
+ * `plugins.config.json`: the manifest generator calls it and writes the
+ * result into the console's subprocessors manifest as data, and the
+ * subprocessor inventory folds that in through core's
+ * `foldPluginSubprocessors`.
+ *
+ * Provider-generic by construction. The wording is the catalog's; the host
+ * and the credential's name are the adapter's; this module names no
+ * vendor. A provider whose endpoint an operator names carries no row in the
+ * catalog, so it contributes nothing here.
+ */ /** Stands for the provider's `apiKeyEnv` in the catalog wording. */ const API_KEY_ENV_PLACEHOLDER = '{apiKeyEnv}';
+export function aiSubprocessors() {
+    const declarations = [];
+    for (const provider of listAiProviders()){
+        var _AI_CATALOG_PROVIDERS_find;
+        const wording = (_AI_CATALOG_PROVIDERS_find = AI_CATALOG_PROVIDERS.find((entry)=>entry.id === provider.id)) == null ? void 0 : _AI_CATALOG_PROVIDERS_find.subprocessor;
+        if (!wording) continue;
+        const fill = (text)=>text.replaceAll(API_KEY_ENV_PLACEHOLDER, provider.apiKeyEnv);
+        declarations.push({
+            host: provider.endpointHost,
+            entity: fill(wording.entity),
+            region: fill(wording.region),
+            purpose: fill(wording.purpose),
+            publishedOn: fill(wording.publishedOn),
+            reason: fill(wording.reason),
+            dataReceived: fill(wording.dataReceived)
+        });
+    }
+    return declarations;
+}
+
+//# sourceMappingURL=subprocessors.js.map

package/src/lib/subprocessors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/subprocessors.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginSubprocessorDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-subprocessors'\nimport { AI_CATALOG_PROVIDERS } from './providers/catalog'\nimport { listAiProviders } from './providers/registry'\n\n/**\n * The plugin's SUBPROCESSORS (AGL-2984): one declaration for every\n * registered provider whose catalog entry carries a subprocessor row, at\n * the host that provider reports. Named under `subprocessors` in\n * `plugins.config.json`: the manifest generator calls it and writes the\n * result into the console's subprocessors manifest as data, and the\n * subprocessor inventory folds that in through core's\n * `foldPluginSubprocessors`.\n *\n * Provider-generic by construction. The wording is the catalog's; the host\n * and the credential's name are the adapter's; this module names no\n * vendor. A provider whose endpoint an operator names carries no row in the\n * catalog, so it contributes nothing here.\n */\n\n/** Stands for the provider's `apiKeyEnv` in the catalog wording. */\nconst API_KEY_ENV_PLACEHOLDER = '{apiKeyEnv}'\n\nexport function aiSubprocessors(): PluginSubprocessorDeclaration[] {\n  const declarations: PluginSubprocessorDeclaration[] = []\n  for (const provider of listAiProviders()) {\n    const wording = AI_CATALOG_PROVIDERS.find((entry) => entry.id === provider.id)?.subprocessor\n    if (!wording) continue\n    const fill = (text: string) => text.replaceAll(API_KEY_ENV_PLACEHOLDER, provider.apiKeyEnv)\n    declarations.push({\n      host: provider.endpointHost,\n      entity: fill(wording.entity),\n      region: fill(wording.region),\n      purpose: fill(wording.purpose),\n      publishedOn: fill(wording.publishedOn),\n      reason: fill(wording.reason),\n      dataReceived: fill(wording.dataReceived),\n    })\n  }\n  return declarations\n}\n"],"names":["AI_CATALOG_PROVIDERS","listAiProviders","API_KEY_ENV_PLACEHOLDER","aiSubprocessors","declarations","provider","wording","find","entry","id","subprocessor","fill","text","replaceAll","apiKeyEnv","push","host","endpointHost","entity","region","purpose","publishedOn","reason","dataReceived"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,SAASA,oBAAoB,QAAQ,yBAAqB;AAC1D,SAASC,eAAe,QAAQ,0BAAsB;AAEtD;;;;;;;;;;;;;CAaC,GAED,kEAAkE,GAClE,MAAMC,0BAA0B;AAEhC,OAAO,SAASC;IACd,MAAMC,eAAgD,EAAE;IACxD,KAAK,MAAMC,YAAYJ,kBAAmB;YACxBD;QAAhB,MAAMM,WAAUN,6BAAAA,qBAAqBO,IAAI,CAAC,CAACC,QAAUA,MAAMC,EAAE,KAAKJ,SAASI,EAAE,sBAA7DT,2BAAgEU,YAAY;QAC5F,IAAI,CAACJ,SAAS;QACd,MAAMK,OAAO,CAACC,OAAiBA,KAAKC,UAAU,CAACX,yBAAyBG,SAASS,SAAS;QAC1FV,aAAaW,IAAI,CAAC;YAChBC,MAAMX,SAASY,YAAY;YAC3BC,QAAQP,KAAKL,QAAQY,MAAM;YAC3BC,QAAQR,KAAKL,QAAQa,MAAM;YAC3BC,SAAST,KAAKL,QAAQc,OAAO;YAC7BC,aAAaV,KAAKL,QAAQe,WAAW;YACrCC,QAAQX,KAAKL,QAAQgB,MAAM;YAC3BC,cAAcZ,KAAKL,QAAQiB,YAAY;QACzC;IACF;IACA,OAAOnB;AACT"}

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

@@ -0,0 +1,99 @@
+/**
+ * @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 { ReusableComponentProp, ReusableComponentPropType } from '@aglyn/aglyn/foundation/definitions/platform.types';
+import type { AiTool } from '../providers/contract';
+import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * The tool a generated reusable component arrives through (AGL-2908), and
+ * the reading of the properties it declares.
+ *
+ * ── The kinds are the Properties dialog's ────────────────────────────────
+ *
+ * FILE ▸ Properties… declares a property as one of `REUSABLE_PROP_KINDS`,
+ * and so does this tool: the kinds it offers are that table less the ones
+ * `AI_COMPONENT_PROP_KINDS_NOT_OFFERED` names, each with the reason it is
+ * left out, and a spec holds the two in both directions. A kind added to the
+ * dialog does not compile here until it is offered or given a reason.
+ *
+ * What is offered is what a generated element can carry and a brief can
+ * fill: copy (Text, Long text), a picture (Image), a link (Link), an icon
+ * the site owner picks (Icon), a number (Number), a switch or a part's
+ * visibility (Yes / no), and a setting with fixed answers (Choice).
+ *
+ * ── A declaration as the dialog saves one ────────────────────────────────
+ *
+ * `readAiComponentProps` returns each property in the shape the dialog's
+ * cleaner stores: trimmed, with only the fields its kind uses, and a default
+ * in the kind's own type — a Yes / no a real `true` or `false`, a Number a
+ * number. Every refusal is a building-rule finding the doctrine's re-ask
+ * quotes by its path.
+ */
+type OfferedKind = 'text' | 'richText' | 'image' | 'href' | 'icon' | 'number' | 'boolean' | 'choice';
+/**
+ * Why each property kind the dialog declares is not offered to a model.
+ * Keyed by every kind outside the offered ones, so the table is complete by
+ * type.
+ */
+export declare const AI_COMPONENT_PROP_KINDS_NOT_OFFERED: Readonly<Record<Exclude<ReusableComponentPropType, OfferedKind>, string>>;
+/**
+ * The kinds a generated component may declare: the dialog's table less the
+ * kinds above, in the dialog's own order.
+ */
+export declare const AI_COMPONENT_PROP_KINDS: readonly OfferedKind[];
+export type AiComponentPropKind = OfferedKind;
+/**
+ * The kinds a property proposed for a section already on a page may take
+ * (AGL-3054): every offered kind but an Icon. That door reads each default off
+ * the live field it binds, and an icon's default is drawn from a path the
+ * picker stores beside its id, which the field it reads does not carry.
+ */
+export declare const AI_COMPONENT_SELECTION_PROP_KINDS: readonly AiComponentPropKind[];
+/** The kinds as a model reads them: the stored type and the name a page reads. */
+export declare function aiComponentPropKindWords(kinds?: readonly AiComponentPropKind[]): string;
+export declare const AI_COMPONENT_TOOL_NAME = "submit_component";
+/** The most properties one generated component declares. */
+export declare const AI_COMPONENT_MAX_PROPS = 20;
+/**
+ * The strict tool a component arrives through: the doctrine's tree, as the
+ * doctrine's own component tool carries it, and the properties beside it.
+ * Every field of a property is required and flat, because optional
+ * properties are not portable across strict tool implementations; a kind
+ * that has no answers sends `[]`.
+ */
+export declare function aiComponentTool(): AiTool;
+export interface AiComponentPropsScope {
+    /** The screens a Link default may name: the site inventory's. */
+    screenIds: ReadonlySet<string>;
+}
+export interface AiComponentPropsReading {
+    /** Every property that could be read, as the Properties dialog stores one. */
+    props: ReusableComponentProp[];
+    /**
+     * The names of properties that were declared under a usable name and
+     * refused for something else — their kind, answers, default or label — so
+     * a check of the tree does not report their tokens a second time.
+     */
+    refused: string[];
+    violations: AiDoctrineViolation[];
+}
+/**
+ * The properties a component answer declares, read into the shape the
+ * Properties dialog stores, with a finding for everything that would not
+ * save there or would not read as the brief's own copy.
+ */
+export declare function readAiComponentProps(answer: Record<string, unknown>, scope: AiComponentPropsScope): AiComponentPropsReading;
+export {};