@aglyn/plugins-ai 1.0.0-beta.219 → 1.0.0-beta.221

package/src/lib/declarations.server.js

@@ -20,12 +20,11 @@
 import { listPluginEventHandlers, registerPluginEventHandler } from "@aglyn/aglyn/plugin-manager/plugin-events";
 import { listPluginUserErasers, registerPluginUserEraser } from "@aglyn/aglyn/plugin-manager/plugin-user-erasure";
 import { listUsageAlertContributors, registerUsageAlertContributor } from "@aglyn/aglyn/plugin-manager/usage-alert-contributors";
-import { pluginMeteredLineOwner } from "@aglyn/aglyn/plugin-manager/plugin-metered-lines";
+import { registerPluginUsageMeter } from "@aglyn/aglyn/plugin-manager/plugin-usage-meters";
 import { registerOperatorAlerts } from "@aglyn/aglyn/plugin-manager/operator-alerts";
-import { AI_PLUGIN_ID } from "./constants.js";
+import { AI_PLUGIN_ID, AI_USAGE_METER_ID } from "./constants.js";
 import { AI_PROVIDER_UNAVAILABLE } from "./operator-alerts.js";
 import { registerAiDeclarations } from "./declarations.js";
-import { AI_OVERAGE_METER_LINE_ID, registerAiOverageMeteredLine } from "./billing/ai-overage-cutover.js";
 /** The provider-spend staff alerts' contributor id under the plugin. */ const AI_USAGE_ALERTS_ID = 'provider-spend';
 /**
  * The plugin's SERVER declarations (AGL-2939): what the server must know
@@ -109,13 +108,24 @@ import { AI_OVERAGE_METER_LINE_ID, registerAiOverageMeteredLine } from "./billin
             pluginId: AI_PLUGIN_ID
         });
     }
-    // The meter line the plugin bills for itself from the cutover month
-    // (AGL-3011). Registered at boot because the monthly usage sweep is a core
-    // cron; the claim reads its own cutover month on every call, so it is
-    // inert until the month is configured.
-    if (pluginMeteredLineOwner(AI_OVERAGE_METER_LINE_ID) !== AI_PLUGIN_ID) {
-        registerAiOverageMeteredLine();
-    }
+    // The plugin's meter in the monthly usage sweep: the month's provider spend
+    // onto the rollup, the credits past the band onto the invoice, and — from
+    // the cutover month (AGL-3011) — the close-out of what the plugin invoices
+    // itself. Registered at boot because the sweep is a core cron, and declared
+    // in `usageAxes` so the sweep refuses to bill a month without it. The same
+    // registration again replaces itself.
+    registerPluginUsageMeter({
+        pluginId: AI_PLUGIN_ID,
+        id: AI_USAGE_METER_ID,
+        measure: async (context)=>{
+            const { measureAiMonth } = await import("./billing/ai-month-meter.js");
+            return measureAiMonth(context);
+        },
+        closeMonth: async (context)=>{
+            const { closeAiMonth } = await import("./billing/ai-month-meter.js");
+            await closeAiMonth(context);
+        }
+    });
     if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {
         registerPluginUserEraser(async (request)=>{
             const { eraseAiUsageForUser } = await import("./usage/ai-usage-eraser.js");
@@ -138,6 +148,10 @@ import { AI_OVERAGE_METER_LINE_ID, registerAiOverageMeteredLine } from "./billin
             evaluate: async (context)=>{
                 const { evaluateAiUsageAlerts } = await import("./usage/ai-usage-alerts.js");
                 await evaluateAiUsageAlerts(context);
+            },
+            quotaChecks: async (context)=>{
+                const { aiQuotaChecks } = await import("./usage/ai-quota-checks.js");
+                return aiQuotaChecks(context);
             }
         });
     }

package/src/lib/declarations.server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.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\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { pluginMeteredLineOwner } from '@aglyn/aglyn/plugin-manager/plugin-metered-lines'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { AI_PLUGIN_ID } from './constants'\nimport { AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\nimport {\n  AI_OVERAGE_METER_LINE_ID,\n  registerAiOverageMeteredLine,\n} from './billing/ai-overage-cutover'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The meter line the plugin bills for itself from the cutover month\n  // (AGL-3011). Registered at boot because the monthly usage sweep is a core\n  // cron; the claim reads its own cutover month on every call, so it is\n  // inert until the month is configured.\n  if (pluginMeteredLineOwner(AI_OVERAGE_METER_LINE_ID) !== AI_PLUGIN_ID) {\n    registerAiOverageMeteredLine()\n  }\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), listed on Staff →\n  // Operator alerts before the first one is ever raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE], { pluginId: AI_PLUGIN_ID })\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","pluginMeteredLineOwner","registerOperatorAlerts","AI_PLUGIN_ID","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_OVERAGE_METER_LINE_ID","registerAiOverageMeteredLine","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","request","eraseAiUsageForUser","some","contributor","id","evaluate","context","evaluateAiUsageAlerts"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,+BAA+B;AAC/B,SACEA,uBAAuB,EACvBC,0BAA0B,QACrB,4CAA2C;AAClD,SACEC,qBAAqB,EACrBC,wBAAwB,QACnB,kDAAiD;AACxD,SACEC,0BAA0B,EAC1BC,6BAA6B,QACxB,uDAAsD;AAC7D,SAASC,sBAAsB,QAAQ,mDAAkD;AACzF,SAASC,sBAAsB,QAAQ,8CAA6C;AACpF,SAASC,YAAY,QAAQ,iBAAa;AAC1C,SAASC,uBAAuB,QAAQ,uBAAmB;AAC3D,SAASC,sBAAsB,QAAQ,oBAAgB;AACvD,SACEC,wBAAwB,EACxBC,4BAA4B,QACvB,kCAA8B;AAErC,sEAAsE,GACtE,MAAMC,qBAAqB;AAE3B;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASC;IACdJ;IACA,mEAAmE;IACnE,uEAAuE;IACvE,IAAI,CAACV,wBAAwB,0BAA0Be,QAAQ,CAACP,eAAe;QAC7EP,2BACE,0BACA,OAAO,EAAEe,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAEC,KAAK,EAAE;YACpC,MAAM,EAAEC,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;YAC3C,MAAMA,kBAAkBJ,OAAOC,OAAO;gBAAEC;gBAAQC;YAAM;QACxD,GACA;YAAEE,UAAUb;QAAa;QAE3BP,2BACE,2BACA,OAAO,EAAEe,KAAK,EAAEC,KAAK,EAAEK,OAAO,EAAEC,UAAU,EAAEC,OAAO,EAAE;YACnD,IAAI,CAACD,WAAWE,UAAU,CAAC,QAAQ;YACnC,MAAM,EAAEC,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC;YAChD,MAAMA,uBAAuBV,OAAOC,OAAO;gBAAEK;gBAASC;gBAAYC;YAAQ;QAC5E,GACA;YAAEH,UAAUb;QAAa;IAE7B;IACA,uEAAuE;IACvE,wEAAwE;IACxE,0EAA0E;IAC1E,wEAAwE;IACxE,EAAE;IACF,sEAAsE;IACtE,kEAAkE;IAClE,IAAI,CAACR,wBAAwB,wBAAwBe,QAAQ,CAACP,eAAe;QAC3EP,2BACE,wBACA,OAAO0B;YACL,MAAM,EAAEC,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC;YAChD,MAAMA,uBAAuBD;QAC/B,GACA;YAAEN,UAAUb;QAAa;QAE3BP,2BACE,0BACA,OAAO0B;YACL,MAAM,EAAEE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC;YAClD,MAAMA,yBAAyBF;QACjC,GACA;YAAEN,UAAUb;QAAa;QAE3BP,2BACE,0BACA,OAAO0B;YACL,MAAM,EAAEG,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC;YAClD,MAAMA,yBAAyBH;QACjC,GACA;YAAEN,UAAUb;QAAa;QAE3BP,2BACE,0BACA,OAAO0B;YACL,MAAM,EAAEI,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC;YAClD,MAAMA,yBAAyBJ;QACjC,GACA;YAAEN,UAAUb;QAAa;QAE3BP,2BACE,iCACA,OAAO0B;YACL,MAAM,EAAEK,+BAA+B,EAAE,GAAG,MAAM,MAAM,CACtD;YAEF,MAAMA,gCAAgCL;QACxC,GACA;YAAEN,UAAUb;QAAa;IAE7B;IACA,oEAAoE;IACpE,2EAA2E;IAC3E,sEAAsE;IACtE,uCAAuC;IACvC,IAAIF,uBAAuBK,8BAA8BH,cAAc;QACrEI;IACF;IACA,IAAI,CAACV,wBAAwBa,QAAQ,CAACP,eAAe;QACnDL,yBACE,OAAO8B;YACL,MAAM,EAAEC,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC;YAC7C,OAAOA,oBAAoBD;QAC7B,GACA;YAAEZ,UAAUb;QAAa;IAE7B;IACA,oEAAoE;IACpE,uDAAuD;IACvDD,uBAAuB;QAACE;KAAwB,EAAE;QAAEY,UAAUb;IAAa;IAC3E,IACE,CAACJ,6BAA6B+B,IAAI,CAChC,CAACC,cACCA,YAAYf,QAAQ,KAAKb,gBACzB4B,YAAYC,EAAE,KAAKxB,qBAEvB;QACAR,8BAA8B;YAC5BgB,UAAUb;YACV6B,IAAIxB;YACJyB,UAAU,OAAOC;gBACf,MAAM,EAAEC,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC;gBAC/C,MAAMA,sBAAsBD;YAC9B;QACF;IACF;AACF;AAEAzB"}
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/declarations.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\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs three registries rather than the whole server surface, and a\n// suite that stubs that barrel wholesale still loads these declarations\n// against the real registries.\nimport {\n  listPluginEventHandlers,\n  registerPluginEventHandler,\n} from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport {\n  listUsageAlertContributors,\n  registerUsageAlertContributor,\n} from '@aglyn/aglyn/plugin-manager/usage-alert-contributors'\nimport { registerPluginUsageMeter } from '@aglyn/aglyn/plugin-manager/plugin-usage-meters'\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { AI_PLUGIN_ID, AI_USAGE_METER_ID } from './constants'\nimport { AI_PROVIDER_UNAVAILABLE } from './operator-alerts'\nimport { registerAiDeclarations } from './declarations'\n\n/** The provider-spend staff alerts' contributor id under the plugin. */\nconst AI_USAGE_ALERTS_ID = 'provider-spend'\n\n/**\n * The plugin's SERVER declarations (AGL-2939): what the server must know\n * at boot, before any door of the plugin has been called. The two platform\n * events the plugin writes activity for — the AI add-on bought or dropped,\n * an `ai.*` permission moved — are raised by core billing and membership\n * routes that never load the plugin's API surface, so the subscriptions\n * have to be in place from the first request. So does the eraser: an\n * account erasure is a core route too, and a person's AI usage months sit\n * under each org, keyed by the uid, where no core delete reaches them. So\n * does the usage alert contributor (AGL-2984): the usage-alerts sweep is a\n * core cron, and it evaluates the plugin's staff alerts on provider spend for\n * every org it reads.\n *\n * Light at boot by construction: the writers behind the handlers are\n * imported when the first event arrives, and the alert rules when the sweep\n * first evaluates an org, not when the process starts, so the boot cost is\n * the registration and nothing that touches Firestore.\n */\nexport function registerAiServerDeclarations(): void {\n  registerAiDeclarations()\n  // Idempotent against each REGISTRY rather than a module flag, so a\n  // registry reset (a spec) or a second module instance registers again.\n  if (!listPluginEventHandlers('org.seatAddons.changed').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'org.seatAddons.changed',\n      async ({ orgId, actor, before, after }) => {\n        const { logAiAddonChanged } = await import('./activity/ai-activity')\n        await logAiAddonChanged(orgId, actor, { before, after })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'org.permissions.changed',\n      async ({ orgId, actor, subject, permission, granted }) => {\n        if (!permission.startsWith('ai.')) return\n        const { logAiPermissionChanged } = await import('./activity/ai-activity')\n        await logAiPermissionChanged(orgId, actor, { subject, permission, granted })\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // THE PLATFORM'S BILLING EVENTS (AGL-3011). Subscribed at boot for the\n  // same reason as the two above: they are raised by the billing webhook,\n  // which never loads an AI door, and a workspace's overage standing moving\n  // late is a workspace charged or refused against a fact we already had.\n  //\n  // The handler modules are imported when the first event arrives, so a\n  // process that never receives one pays only for the registration.\n  if (!listPluginEventHandlers('billing.invoice.paid').includes(AI_PLUGIN_ID)) {\n    registerPluginEventHandler(\n      'billing.invoice.paid',\n      async (payload) => {\n        const { onAiBillingInvoicePaid } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoicePaid(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.failed',\n      async (payload) => {\n        const { onAiBillingInvoiceFailed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceFailed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.invoice.closed',\n      async (payload) => {\n        const { onAiBillingInvoiceClosed } = await import('./billing/ai-overage-events')\n        await onAiBillingInvoiceClosed(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.dispute.opened',\n      async (payload) => {\n        const { onAiBillingDisputeOpened } = await import('./billing/ai-overage-events')\n        await onAiBillingDisputeOpened(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n    registerPluginEventHandler(\n      'billing.paymentMethod.changed',\n      async (payload) => {\n        const { onAiBillingPaymentMethodChanged } = await import(\n          './billing/ai-overage-events'\n        )\n        await onAiBillingPaymentMethodChanged(payload)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The plugin's meter in the monthly usage sweep: the month's provider spend\n  // onto the rollup, the credits past the band onto the invoice, and — from\n  // the cutover month (AGL-3011) — the close-out of what the plugin invoices\n  // itself. Registered at boot because the sweep is a core cron, and declared\n  // in `usageAxes` so the sweep refuses to bill a month without it. The same\n  // registration again replaces itself.\n  registerPluginUsageMeter({\n    pluginId: AI_PLUGIN_ID,\n    id: AI_USAGE_METER_ID,\n    measure: async (context) => {\n      const { measureAiMonth } = await import('./billing/ai-month-meter')\n      return measureAiMonth(context)\n    },\n    closeMonth: async (context) => {\n      const { closeAiMonth } = await import('./billing/ai-month-meter')\n      await closeAiMonth(context)\n    },\n  })\n  if (!listPluginUserErasers().includes(AI_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { eraseAiUsageForUser } = await import('./usage/ai-usage-eraser')\n        return eraseAiUsageForUser(request)\n      },\n      { pluginId: AI_PLUGIN_ID },\n    )\n  }\n  // The platform provider account alert (AGL-3377), listed on Staff →\n  // Operator alerts before the first one is ever raised.\n  registerOperatorAlerts([AI_PROVIDER_UNAVAILABLE], { pluginId: AI_PLUGIN_ID })\n  if (\n    !listUsageAlertContributors().some(\n      (contributor) =>\n        contributor.pluginId === AI_PLUGIN_ID &&\n        contributor.id === AI_USAGE_ALERTS_ID,\n    )\n  ) {\n    registerUsageAlertContributor({\n      pluginId: AI_PLUGIN_ID,\n      id: AI_USAGE_ALERTS_ID,\n      evaluate: async (context) => {\n        const { evaluateAiUsageAlerts } = await import('./usage/ai-usage-alerts')\n        await evaluateAiUsageAlerts(context)\n      },\n      quotaChecks: async (context) => {\n        const { aiQuotaChecks } = await import('./usage/ai-quota-checks')\n        return aiQuotaChecks(context)\n      },\n    })\n  }\n}\n\nregisterAiServerDeclarations()\n"],"names":["listPluginEventHandlers","registerPluginEventHandler","listPluginUserErasers","registerPluginUserEraser","listUsageAlertContributors","registerUsageAlertContributor","registerPluginUsageMeter","registerOperatorAlerts","AI_PLUGIN_ID","AI_USAGE_METER_ID","AI_PROVIDER_UNAVAILABLE","registerAiDeclarations","AI_USAGE_ALERTS_ID","registerAiServerDeclarations","includes","orgId","actor","before","after","logAiAddonChanged","pluginId","subject","permission","granted","startsWith","logAiPermissionChanged","payload","onAiBillingInvoicePaid","onAiBillingInvoiceFailed","onAiBillingInvoiceClosed","onAiBillingDisputeOpened","onAiBillingPaymentMethodChanged","id","measure","context","measureAiMonth","closeMonth","closeAiMonth","request","eraseAiUsageForUser","some","contributor","evaluate","evaluateAiUsageAlerts","quotaChecks","aiQuotaChecks"],"mappings":"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"}

package/src/lib/insights/ai-dataset-catalog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @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.
+ */
+/**
+ * The datasets an insight question may name (AGL-2915), with their fields:
+ * what the model picks a dataset breakdown from.
+ *
+ * The datasets are the data plugin's, so they are listed through the
+ * `dataset` index it publishes (AGL-3080), never read from its collection:
+ * where no plugin keeps datasets, there are none to name. Narrowed to a site,
+ * the index answers only the datasets shared with it. Who may see which is the
+ * platform's own rule over the scope tokens each dataset carries
+ * (`memberCanSee`), applied for the member who asked — with no member, only
+ * datasets shared with every site. The figures themselves are read by the
+ * data plugin's own figure readers, under the same rule.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+/** Datasets a catalog lists: the dataset summary's window. */
+export declare const AI_DATASET_CATALOG_LIMIT = 50;
+/** A dataset a question may name, with its fields, as the read prompt lists it. */
+export interface AiDatasetCatalogEntry {
+    id: string;
+    name: string;
+    fields: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+}
+/** The datasets a request may read, with their fields, by name. */
+export declare function aiDatasetCatalog(firestore: Firestore, request: {
+    orgId: string;
+    hostId: string | null;
+    uid: string | null;
+}): Promise<AiDatasetCatalogEntry[]>;
+export {};

package/src/lib/insights/ai-dataset-catalog.js

@@ -0,0 +1,57 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { hostRoleFor, isOrgWideMember, memberCanSee } from "@aglyn/aglyn/app-utils/organizations";
+import { ORG_SCOPE_TOKEN } from "@aglyn/aglyn/app-utils/scope-tokens";
+import { pluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
+/** Datasets a catalog lists: the dataset summary's window. */ export const AI_DATASET_CATALOG_LIMIT = 50;
+const text = (value)=>typeof value === 'string' ? value.trim() : '';
+function fieldsOf(value) {
+    return (Array.isArray(value) ? value : []).map((field)=>({
+            id: text(field == null ? void 0 : field['id']),
+            name: text(field == null ? void 0 : field['name']),
+            type: text(field == null ? void 0 : field['type']) || 'text'
+        })).filter((field)=>field.id).map((field)=>_extends({}, field, {
+            name: field.name || field.id
+        }));
+}
+/** The datasets a request may read, with their fields, by name. */ export async function aiDatasetCatalog(firestore, request) {
+    const datasets = pluginRecordIndex('dataset');
+    if (!datasets) return [];
+    const [{ records }, memberSnapshot] = await Promise.all([
+        datasets.index.list({
+            orgId: request.orgId,
+            hostId: request.hostId,
+            limit: AI_DATASET_CATALOG_LIMIT
+        }),
+        request.uid ? firestore.collection('orgs').doc(request.orgId).collection('members').doc(request.uid).get() : Promise.resolve(null)
+    ]);
+    const member = (memberSnapshot == null ? void 0 : memberSnapshot.exists) ? memberSnapshot.data() : null;
+    if (request.uid && !member) return [];
+    if (request.hostId && member && !isOrgWideMember(member) && hostRoleFor(member, request.hostId) === null) {
+        return [];
+    }
+    return records.filter((record)=>{
+        const visibleTo = Array.isArray(record.facts['visibleTo']) ? record.facts['visibleTo'] : [];
+        return member ? memberCanSee(member, visibleTo) : visibleTo.includes(ORG_SCOPE_TOKEN);
+    }).map((record)=>({
+            id: record.id,
+            name: record.name,
+            fields: fieldsOf(record.facts['fields'])
+        })).sort((a, b)=>a.name.localeCompare(b.name));
+}
+
+//# sourceMappingURL=ai-dataset-catalog.js.map

package/src/lib/insights/ai-dataset-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/insights/ai-dataset-catalog.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 { hostRoleFor, isOrgWideMember, memberCanSee } from '@aglyn/aglyn/app-utils/organizations'\nimport { ORG_SCOPE_TOKEN } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport type { AglynOrgMember } from '@aglyn/aglyn/foundation/definitions/organization.types'\nimport { pluginRecordIndex } from '@aglyn/aglyn/plugin-manager/plugin-record-index'\n\n/**\n * The datasets an insight question may name (AGL-2915), with their fields:\n * what the model picks a dataset breakdown from.\n *\n * The datasets are the data plugin's, so they are listed through the\n * `dataset` index it publishes (AGL-3080), never read from its collection:\n * where no plugin keeps datasets, there are none to name. Narrowed to a site,\n * the index answers only the datasets shared with it. Who may see which is the\n * platform's own rule over the scope tokens each dataset carries\n * (`memberCanSee`), applied for the member who asked — with no member, only\n * datasets shared with every site. The figures themselves are read by the\n * data plugin's own figure readers, under the same rule.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** Datasets a catalog lists: the dataset summary's window. */\nexport const AI_DATASET_CATALOG_LIMIT = 50\n\n/** A dataset a question may name, with its fields, as the read prompt lists it. */\nexport interface AiDatasetCatalogEntry {\n  id: string\n  name: string\n  fields: Array<{ id: string; name: string; type: string }>\n}\n\nconst text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nfunction fieldsOf(value: unknown): AiDatasetCatalogEntry['fields'] {\n  return (Array.isArray(value) ? (value as Array<Record<string, unknown>>) : [])\n    .map((field) => ({ id: text(field?.['id']), name: text(field?.['name']), type: text(field?.['type']) || 'text' }))\n    .filter((field) => field.id)\n    .map((field) => ({ ...field, name: field.name || field.id }))\n}\n\n/** The datasets a request may read, with their fields, by name. */\nexport async function aiDatasetCatalog(\n  firestore: Firestore,\n  request: { orgId: string; hostId: string | null; uid: string | null },\n): Promise<AiDatasetCatalogEntry[]> {\n  const datasets = pluginRecordIndex('dataset')\n  if (!datasets) return []\n  const [{ records }, memberSnapshot] = await Promise.all([\n    datasets.index.list({ orgId: request.orgId, hostId: request.hostId, limit: AI_DATASET_CATALOG_LIMIT }),\n    request.uid\n      ? firestore.collection('orgs').doc(request.orgId).collection('members').doc(request.uid).get()\n      : Promise.resolve(null),\n  ])\n  const member = memberSnapshot?.exists ? (memberSnapshot.data() as Partial<AglynOrgMember>) : null\n  if (request.uid && !member) return []\n  if (request.hostId && member && !isOrgWideMember(member) && hostRoleFor(member, request.hostId) === null) {\n    return []\n  }\n  return records\n    .filter((record) => {\n      const visibleTo = Array.isArray(record.facts['visibleTo']) ? (record.facts['visibleTo'] as string[]) : []\n      return member ? memberCanSee(member, visibleTo) : visibleTo.includes(ORG_SCOPE_TOKEN)\n    })\n    .map((record) => ({ id: record.id, name: record.name, fields: fieldsOf(record.facts['fields']) }))\n    .sort((a, b) => a.name.localeCompare(b.name))\n}\n"],"names":["hostRoleFor","isOrgWideMember","memberCanSee","ORG_SCOPE_TOKEN","pluginRecordIndex","AI_DATASET_CATALOG_LIMIT","text","value","trim","fieldsOf","Array","isArray","map","field","id","name","type","filter","aiDatasetCatalog","firestore","request","datasets","records","memberSnapshot","Promise","all","index","list","orgId","hostId","limit","uid","collection","doc","get","resolve","member","exists","data","record","visibleTo","facts","includes","fields","sort","a","b","localeCompare"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,WAAW,EAAEC,eAAe,EAAEC,YAAY,QAAQ,uCAAsC;AACjG,SAASC,eAAe,QAAQ,sCAAqC;AAErE,SAASC,iBAAiB,QAAQ,kDAAiD;AAkBnF,4DAA4D,GAC5D,OAAO,MAAMC,2BAA2B,GAAE;AAS1C,MAAMC,OAAO,CAACC,QAA4B,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;AAErF,SAASC,SAASF,KAAc;IAC9B,OAAO,AAACG,CAAAA,MAAMC,OAAO,CAACJ,SAAUA,QAA2C,EAAE,AAAD,EACzEK,GAAG,CAAC,CAACC,QAAW,CAAA;YAAEC,IAAIR,KAAKO,yBAAAA,KAAO,CAAC,KAAK;YAAGE,MAAMT,KAAKO,yBAAAA,KAAO,CAAC,OAAO;YAAGG,MAAMV,KAAKO,yBAAAA,KAAO,CAAC,OAAO,KAAK;QAAO,CAAA,GAC9GI,MAAM,CAAC,CAACJ,QAAUA,MAAMC,EAAE,EAC1BF,GAAG,CAAC,CAACC,QAAW,aAAKA;YAAOE,MAAMF,MAAME,IAAI,IAAIF,MAAMC,EAAE;;AAC7D;AAEA,iEAAiE,GACjE,OAAO,eAAeI,iBACpBC,SAAoB,EACpBC,OAAqE;IAErE,MAAMC,WAAWjB,kBAAkB;IACnC,IAAI,CAACiB,UAAU,OAAO,EAAE;IACxB,MAAM,CAAC,EAAEC,OAAO,EAAE,EAAEC,eAAe,GAAG,MAAMC,QAAQC,GAAG,CAAC;QACtDJ,SAASK,KAAK,CAACC,IAAI,CAAC;YAAEC,OAAOR,QAAQQ,KAAK;YAAEC,QAAQT,QAAQS,MAAM;YAAEC,OAAOzB;QAAyB;QACpGe,QAAQW,GAAG,GACPZ,UAAUa,UAAU,CAAC,QAAQC,GAAG,CAACb,QAAQQ,KAAK,EAAEI,UAAU,CAAC,WAAWC,GAAG,CAACb,QAAQW,GAAG,EAAEG,GAAG,KAC1FV,QAAQW,OAAO,CAAC;KACrB;IACD,MAAMC,SAASb,CAAAA,kCAAAA,eAAgBc,MAAM,IAAId,eAAee,IAAI,KAAiC;IAC7F,IAAIlB,QAAQW,GAAG,IAAI,CAACK,QAAQ,OAAO,EAAE;IACrC,IAAIhB,QAAQS,MAAM,IAAIO,UAAU,CAACnC,gBAAgBmC,WAAWpC,YAAYoC,QAAQhB,QAAQS,MAAM,MAAM,MAAM;QACxG,OAAO,EAAE;IACX;IACA,OAAOP,QACJL,MAAM,CAAC,CAACsB;QACP,MAAMC,YAAY9B,MAAMC,OAAO,CAAC4B,OAAOE,KAAK,CAAC,YAAY,IAAKF,OAAOE,KAAK,CAAC,YAAY,GAAgB,EAAE;QACzG,OAAOL,SAASlC,aAAakC,QAAQI,aAAaA,UAAUE,QAAQ,CAACvC;IACvE,GACCS,GAAG,CAAC,CAAC2B,SAAY,CAAA;YAAEzB,IAAIyB,OAAOzB,EAAE;YAAEC,MAAMwB,OAAOxB,IAAI;YAAE4B,QAAQlC,SAAS8B,OAAOE,KAAK,CAAC,SAAS;QAAE,CAAA,GAC9FG,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAE9B,IAAI,CAACgC,aAAa,CAACD,EAAE/B,IAAI;AAC/C"}

package/src/lib/insights/ai-figure-readers.d.ts

@@ -14,22 +14,17 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type PluginFigureReader, type PluginFigureRequest } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import { type PluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
 /**
  * The figure readers this plugin registers for records the PLATFORM keeps
- * (AGL-2915): a site's page-view counters, its forms' counters and the
- * workspace's datasets. Every other reader an insight reads is registered by
- * the plugin that owns its records — commerce, bookings, marketing — on the
+ * (AGL-2915): a site's page-view counters and its forms' counters. Every
+ * other reader an insight reads is registered by the plugin that owns its
+ * records — commerce, bookings, marketing, the workspace's datasets — on the
  * `plugin-figures` seam, and nothing here reads their documents.
  *
  * Each reader answers with one compact table of aggregates, read-only and
- * about nobody: counts, sums and rates, labeled by a page path, a form's name,
- * a referring site or a dataset's own field — never a visitor, a submission or
- * a record. A dataset breakdown refuses a field with more than
- * `AI_DATASET_MAX_GROUP_VALUES` different values — on a dataset of any size, a
- * name, an address or an order number — and folds every group of fewer than
- * `AI_DATASET_MIN_GROUP` records into one row, so each label it shows is a
- * value at least that many records share.
+ * about nobody: counts, sums and rates, labeled by a page path, a form's name
+ * or a referring site — never a visitor or a submission.
  *
  * The readers use the arithmetic their console cards use: the Traffic card's
  * windows and change (`pluginFigureWindows`, `pluginFigureChange`, which are
@@ -50,36 +45,8 @@ export declare const AI_TRAFFIC_TOP_REFERRERS = 8;
 export declare const AI_TRAFFIC_TOP_CAMPAIGNS = 5;
 /** Forms a forms table reads. */
 export declare const AI_FORMS_READ_LIMIT = 100;
-/** Datasets a dataset summary reads. */
-export declare const AI_DATASETS_READ_LIMIT = 50;
-/** Records a dataset breakdown or field summary reads, in document order; the rest are named in a note. */
-export declare const AI_DATASET_RECORDS_READ_LIMIT = 2000;
-/** The fewest records a breakdown shows a group of by its own label. */
-export declare const AI_DATASET_MIN_GROUP = 3;
-/**
- * The most different values a breakdown groups by: every state and territory,
- * a status, a category. A field with more tells records apart rather than
- * sorting them, so it is refused.
- */
-export declare const AI_DATASET_MAX_GROUP_VALUES = 60;
-/** The aggregates a breakdown computes. */
-export declare const AI_DATASET_OPERATIONS: readonly ["count", "sum", "average", "min", "max"];
-export type AiDatasetOperation = (typeof AI_DATASET_OPERATIONS)[number];
 export declare function trafficFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[];
 export declare function formsFigureReader(firestore: AiFigureFirestore): PluginFigureReader;
-/** A dataset a question may name, with its fields, as the read prompt lists it. */
-export interface AiDatasetCatalogEntry {
-    id: string;
-    name: string;
-    fields: Array<{
-        id: string;
-        name: string;
-        type: string;
-    }>;
-}
-/** The datasets a request may read, with their fields: what the model picks a breakdown from. */
-export declare function aiDatasetCatalog(firestore: Firestore, request: Pick<PluginFigureRequest, 'orgId' | 'hostId' | 'uid'>): Promise<AiDatasetCatalogEntry[]>;
-export declare function datasetFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[];
 /** Every reader this plugin registers, for the platform's own records. */
 export declare function aiFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[];
 /**