@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/ai-collaborator-permissions-column.component.js

@@ -0,0 +1,132 @@
+/**
+ * @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.
+ */ 'use client';
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Checkbox, FormControlLabel, Stack } from "@mui/material";
+import { useCallback, useState } from "react";
+import { AI_PERMISSION_KEYS, HOST_ROLE_AI_PERMISSIONS } from "../model/ai-permissions.js";
+/** What each toggle is called in the row. */ const TOGGLE_LABELS = {
+    'ai.use': 'Assist',
+    'ai.generate': 'Generate'
+};
+/**
+ * A collaborator's AI verdict on the site, as the row shows it: the roster
+ * copy the toggle door wrote, else the host role's default — which is what
+ * the doors resolve for a member document the toggle has never touched, so
+ * a row never shows a state the server does not hold.
+ */ export function collaboratorAiPermissions(member) {
+    var _ref, _HOST_ROLE_AI_PERMISSIONS_role, _ref1, _ref2;
+    const role = (_ref = member == null ? void 0 : member.role) != null ? _ref : 'editor';
+    const base = (_HOST_ROLE_AI_PERMISSIONS_role = HOST_ROLE_AI_PERMISSIONS[role]) != null ? _HOST_ROLE_AI_PERMISSIONS_role : HOST_ROLE_AI_PERMISSIONS.viewer;
+    const stored = member == null ? void 0 : member.aiPermissions;
+    return {
+        'ai.use': (_ref1 = stored == null ? void 0 : stored['ai.use']) != null ? _ref1 : base['ai.use'],
+        'ai.generate': (_ref2 = stored == null ? void 0 : stored['ai.generate']) != null ? _ref2 : base['ai.generate']
+    };
+}
+/**
+ * THE COLLABORATORS TABLE'S AI COLUMN (AGL-2927, AGL-2984): whether this
+ * person may open the AI doors ON THIS SITE, through the `hostMembers`
+ * zone. The host role sets the default; the boxes refine it, and the doors
+ * read the same answer, so an unticked box is a closed door rather than a
+ * hidden button. The owner is decided by the org role, and says so.
+ */ export function AiCollaboratorPermissionsCell(props) {
+    const { hostId, canManage, member } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [busy, setBusy] = useState(false);
+    const memberId = member == null ? void 0 : member.$id;
+    const handleToggle = useCallback((key)=>async (_event, checked)=>{
+            if (!memberId || !hostId) return;
+            setBusy(true);
+            try {
+                const response = await authorizedFetch(user, '/api/ai/host-permissions', {
+                    method: 'PATCH',
+                    headers: {
+                        'Content-Type': 'application/json'
+                    },
+                    body: JSON.stringify({
+                        hostId,
+                        memberId,
+                        aiPermissions: {
+                            [key]: checked
+                        }
+                    })
+                });
+                const payload = await response.json().catch(()=>({}));
+                if (!response.ok) {
+                    var _ref;
+                    enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Member operation failed', {
+                        variant: 'warning',
+                        persist: false
+                    });
+                    return;
+                }
+                enqueueSnackbar('AI access updated', {
+                    variant: 'success',
+                    persist: false
+                });
+            } catch (error) {
+                console.error(error);
+                enqueueSnackbar('Member operation failed', {
+                    variant: 'error'
+                });
+            } finally{
+                setBusy(false);
+            }
+        }, [
+        user,
+        hostId,
+        memberId,
+        enqueueSnackbar
+    ]);
+    if ((member == null ? void 0 : member.role) === 'owner') return /*#__PURE__*/ _jsx(_Fragment, {
+        children: 'By org role'
+    });
+    const verdict = collaboratorAiPermissions(member);
+    return(// An invited row has no member document to carry a toggle yet; it
+    // becomes settable once the invite is accepted, which is when the person
+    // gains the role the default derives from.
+    /*#__PURE__*/ _jsx(Stack, {
+        direction: "row",
+        spacing: 0,
+        children: AI_PERMISSION_KEYS.map((key)=>/*#__PURE__*/ _jsx(FormControlLabel, {
+                label: TOGGLE_LABELS[key],
+                slotProps: {
+                    typography: {
+                        variant: 'caption'
+                    }
+                },
+                control: /*#__PURE__*/ _jsx(Checkbox, {
+                    size: "small",
+                    checked: verdict[key],
+                    onChange: handleToggle(key),
+                    disabled: busy || !canManage || (member == null ? void 0 : member.status) === 'invited',
+                    slotProps: {
+                        input: {
+                            'aria-label': `${TOGGLE_LABELS[key]} with AI`
+                        }
+                    }
+                })
+            }, key))
+    }));
+}
+AiCollaboratorPermissionsCell.displayName = 'AiCollaboratorPermissionsCell';
+
+//# sourceMappingURL=ai-collaborator-permissions-column.component.js.map

package/src/lib/components/ai-collaborator-permissions-column.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-collaborator-permissions-column.component.tsx"],"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'use client'\n\nimport type { HostAccessRole } from '@aglyn/aglyn/foundation/definitions/organization.types'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { Checkbox, FormControlLabel, Stack } from '@mui/material'\nimport { useCallback, useState } from 'react'\nimport {\n  AI_PERMISSION_KEYS,\n  HOST_ROLE_AI_PERMISSIONS,\n  type AiPermission,\n  type AiPermissionVerdict,\n} from '../model/ai-permissions'\n\n/** A roster row as the collaborators table hands it to a column. */\ninterface CollaboratorRow {\n  $id?: string\n  uid?: string\n  role?: string\n  status?: string\n  aiPermissions?: Partial<AiPermissionVerdict>\n}\n\n/** What each toggle is called in the row. */\nconst TOGGLE_LABELS: Record<AiPermission, string> = {\n  'ai.use': 'Assist',\n  'ai.generate': 'Generate',\n}\n\n/**\n * A collaborator's AI verdict on the site, as the row shows it: the roster\n * copy the toggle door wrote, else the host role's default — which is what\n * the doors resolve for a member document the toggle has never touched, so\n * a row never shows a state the server does not hold.\n */\nexport function collaboratorAiPermissions(member: CollaboratorRow | undefined): AiPermissionVerdict {\n  const role = (member?.role ?? 'editor') as HostAccessRole\n  const base = HOST_ROLE_AI_PERMISSIONS[role] ?? HOST_ROLE_AI_PERMISSIONS.viewer\n  const stored = member?.aiPermissions\n  return {\n    'ai.use': stored?.['ai.use'] ?? base['ai.use'],\n    'ai.generate': stored?.['ai.generate'] ?? base['ai.generate'],\n  }\n}\n\n/**\n * THE COLLABORATORS TABLE'S AI COLUMN (AGL-2927, AGL-2984): whether this\n * person may open the AI doors ON THIS SITE, through the `hostMembers`\n * zone. The host role sets the default; the boxes refine it, and the doors\n * read the same answer, so an unticked box is a closed door rather than a\n * hidden button. The owner is decided by the org role, and says so.\n */\nexport function AiCollaboratorPermissionsCell(props: {\n  hostId?: string\n  canManage?: boolean\n  member?: CollaboratorRow\n}) {\n  const { hostId, canManage, member } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [busy, setBusy] = useState(false)\n  const memberId = member?.$id\n\n  const handleToggle = useCallback(\n    (key: AiPermission) => async (_event: unknown, checked: boolean) => {\n      if (!memberId || !hostId) return\n      setBusy(true)\n      try {\n        const response = await authorizedFetch(user, '/api/ai/host-permissions', {\n          method: 'PATCH',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ hostId, memberId, aiPermissions: { [key]: checked } }),\n        })\n        const payload = await response.json().catch(() => ({}))\n        if (!response.ok) {\n          enqueueSnackbar(payload?.error ?? 'Member operation failed', {\n            variant: 'warning',\n            persist: false,\n          })\n          return\n        }\n        enqueueSnackbar('AI access updated', { variant: 'success', persist: false })\n      } catch (error) {\n        console.error(error)\n        enqueueSnackbar('Member operation failed', { variant: 'error' })\n      } finally {\n        setBusy(false)\n      }\n    },\n    [user, hostId, memberId, enqueueSnackbar],\n  )\n\n  if (member?.role === 'owner') return <>{'By org role'}</>\n  const verdict = collaboratorAiPermissions(member)\n  return (\n    // An invited row has no member document to carry a toggle yet; it\n    // becomes settable once the invite is accepted, which is when the person\n    // gains the role the default derives from.\n    <Stack direction=\"row\" spacing={0}>\n      {AI_PERMISSION_KEYS.map((key) => (\n        <FormControlLabel\n          key={key}\n          label={TOGGLE_LABELS[key]}\n          slotProps={{ typography: { variant: 'caption' } }}\n          control={\n            <Checkbox\n              size=\"small\"\n              checked={verdict[key]}\n              onChange={handleToggle(key)}\n              disabled={busy || !canManage || member?.status === 'invited'}\n              slotProps={{\n                input: { 'aria-label': `${TOGGLE_LABELS[key]} with AI` },\n              }}\n            />\n          }\n        />\n      ))}\n    </Stack>\n  )\n}\nAiCollaboratorPermissionsCell.displayName = 'AiCollaboratorPermissionsCell'\n"],"names":["useSnackbar","authorizedFetch","useUser","Checkbox","FormControlLabel","Stack","useCallback","useState","AI_PERMISSION_KEYS","HOST_ROLE_AI_PERMISSIONS","TOGGLE_LABELS","collaboratorAiPermissions","member","role","base","viewer","stored","aiPermissions","AiCollaboratorPermissionsCell","props","hostId","canManage","data","user","enqueueSnackbar","busy","setBusy","memberId","$id","handleToggle","key","_event","checked","response","method","headers","body","JSON","stringify","payload","json","catch","ok","error","variant","persist","console","verdict","direction","spacing","map","label","slotProps","typography","control","size","onChange","disabled","status","input","displayName"],"mappings":"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"}

package/src/lib/components/ai-credits-card.component.d.ts

@@ -0,0 +1,34 @@
+import { type AglynOrgBilling } from '@aglyn/aglyn';
+export interface AiCreditsCardProps {
+    orgId?: string | null;
+    /** The billing-merged org doc the Usage page resolved. */
+    org?: Partial<AglynOrgBilling> | null;
+    /** The Billing overview's path, for the one caption that points at the add-ons card. */
+    billingHref?: string;
+}
+/**
+ * The AI credits meter (AGL-2899), on the Billing → Usage page's plugin
+ * band below the platform's own meters (AGL-2939).
+ *
+ * Credits, because AI actions differ in cost by up to two orders of
+ * magnitude — a question against generating a screen — and a message count
+ * would price them the same. The band is refused at the cap, so this
+ * readout is the only thing standing between a customer and learning their
+ * limit by being turned down mid-build.
+ *
+ * Rendered only where a band is sold, which since AGL-3203 is every plan
+ * row: Free carries the taste and Starter 750, so both render a meter even
+ * though neither carries `aiAssist` — the band is credits, not the guided
+ * rung. What still renders nothing is a band of ZERO, which now reaches this
+ * component only as a per-org override, and a "0 of 0" meter is not a
+ * readout of anything. ONE meter for one pool: the
+ * add-on widens `assistCreditsPerMonth` rather than opening a second band,
+ * so the limit here is already plan plus add-on and the caption under it
+ * says how much of that the add-on is.
+ *
+ * From the server, not from Firestore like the platform's meters:
+ * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser
+ * read would fail silently and leave this reading "not yet metered" forever.
+ * Credits, never dollars: the route is where the one conversion happens.
+ */
+export default function AiCreditsCard(props: AiCreditsCardProps): import("react").JSX.Element;

package/src/lib/components/ai-credits-card.component.js

@@ -0,0 +1,131 @@
+/**
+ * @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.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AI_ADDON_CREDITS_PER_MONTH, aiAddonName, hasAiAddon, isUnlimitedQuota, resolveEffectivePlan, resolveOrgEntitlements, resolvePlanPricing } from "@aglyn/aglyn";
+import { pluginDocsHelp } from "@aglyn/aglyn/app-utils/docs-help";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { UsageMeter } from "@aglyn/shared-ui-jsx/components/usage-meter.component";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { Link, Typography } from "@mui/material";
+import { useEffect, useState } from "react";
+import { useUser } from "@aglyn/tenant-feature-instance";
+/**
+ * The AI credits meter (AGL-2899), on the Billing → Usage page's plugin
+ * band below the platform's own meters (AGL-2939).
+ *
+ * Credits, because AI actions differ in cost by up to two orders of
+ * magnitude — a question against generating a screen — and a message count
+ * would price them the same. The band is refused at the cap, so this
+ * readout is the only thing standing between a customer and learning their
+ * limit by being turned down mid-build.
+ *
+ * Rendered only where a band is sold, which since AGL-3203 is every plan
+ * row: Free carries the taste and Starter 750, so both render a meter even
+ * though neither carries `aiAssist` — the band is credits, not the guided
+ * rung. What still renders nothing is a band of ZERO, which now reaches this
+ * component only as a per-org override, and a "0 of 0" meter is not a
+ * readout of anything. ONE meter for one pool: the
+ * add-on widens `assistCreditsPerMonth` rather than opening a second band,
+ * so the limit here is already plan plus add-on and the caption under it
+ * says how much of that the add-on is.
+ *
+ * From the server, not from Firestore like the platform's meters:
+ * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser
+ * read would fail silently and leave this reading "not yet metered" forever.
+ * Credits, never dollars: the route is where the one conversion happens.
+ */ export default function AiCreditsCard(props) {
+    const { orgId, org, billingHref } = props;
+    const { data: user } = useUser();
+    const [credits, setCredits] = useState(null);
+    useEffect(()=>{
+        if (!orgId || !user) return undefined;
+        let active = true;
+        void (async ()=>{
+            try {
+                const response = await authorizedFetch(user, `/api/ai/billing/credits?orgId=${encodeURIComponent(orgId)}`);
+                if (!response.ok) return;
+                const result = await response.json();
+                if (active && (result == null ? void 0 : result.credits)) setCredits(result.credits);
+            } catch (unused) {
+            // The meter keeps its "not yet metered" state on failure —
+            // deliberately not 0, which reads as "you have used none".
+            }
+        })();
+        return ()=>{
+            active = false;
+        };
+    }, [
+        orgId,
+        user
+    ]);
+    const entitlements = resolveOrgEntitlements(org);
+    if (entitlements.assistCreditsPerMonth <= 0) return null;
+    const plan = resolveEffectivePlan(org);
+    const aiAddonCredits = hasAiAddon(org) ? AI_ADDON_CREDITS_PER_MONTH[plan] : 0;
+    // Sold to THIS workspace, not merely on its plan: a staff comp has no
+    // subscription to add the item to, so its price list sells none (AGL-3034).
+    const aiAddonSold = resolvePlanPricing(org).aiAddonMonthlyUsd != null;
+    return /*#__PURE__*/ _jsxs(CardDisplay, {
+        header: 'AI credits',
+        help: pluginDocsHelp('billing', {
+            anchor: '#usage-meters',
+            excerpt: 'AI credits drawn this month against your included band, plan ' + 'plus the AI add-on where you have it.'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: [
+            /*#__PURE__*/ _jsx(UsageMeter, {
+                label: "AI credits (this month)",
+                used: credits ? credits.used : null,
+                limit: entitlements.assistCreditsPerMonth,
+                unlimited: isUnlimitedQuota(entitlements.assistCreditsPerMonth),
+                upgradeHref: billingHref ? `${billingHref}#plans` : '#plans'
+            }),
+            aiAddonCredits > 0 ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                sx: {
+                    display: 'block',
+                    mt: -1.5,
+                    mb: 2
+                },
+                children: `Includes ${aiAddonCredits.toLocaleString()} credits a month from ` + `the ${aiAddonName()} add-on.`
+            }) : null,
+            !entitlements.features.aiGenerative && aiAddonSold ? /*#__PURE__*/ _jsxs(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                sx: {
+                    display: 'block',
+                    mt: -1.5,
+                    mb: 2
+                },
+                children: [
+                    `Generate pages, emails, campaigns and more with ${aiAddonName()}, ` + `and add ${AI_ADDON_CREDITS_PER_MONTH[plan].toLocaleString()} ` + 'credits a month to this pool: ',
+                    /*#__PURE__*/ _jsx(Link, {
+                        href: `${billingHref != null ? billingHref : ''}#addons`,
+                        color: "primary",
+                        underline: "hover",
+                        children: `Add ${aiAddonName()}`
+                    }),
+                    ' in Billing → Plans.'
+                ]
+            }) : null
+        ]
+    });
+}
+
+//# sourceMappingURL=ai-credits-card.component.js.map

package/src/lib/components/ai-credits-card.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-credits-card.component.tsx"],"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'use client'\n\nimport {\n  AI_ADDON_CREDITS_PER_MONTH,\n  aiAddonName,\n  hasAiAddon,\n  isUnlimitedQuota,\n  resolveEffectivePlan,\n  resolveOrgEntitlements,\n  resolvePlanPricing,\n  type AglynOrgBilling,\n} from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { UsageMeter } from '@aglyn/shared-ui-jsx/components/usage-meter.component'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { Link, Typography } from '@mui/material'\nimport { useEffect, useState } from 'react'\nimport { useUser } from '@aglyn/tenant-feature-instance'\n\nexport interface AiCreditsCardProps {\n  orgId?: string | null\n  /** The billing-merged org doc the Usage page resolved. */\n  org?: Partial<AglynOrgBilling> | null\n  /** The Billing overview's path, for the one caption that points at the add-ons card. */\n  billingHref?: string\n}\n\n/**\n * The AI credits meter (AGL-2899), on the Billing → Usage page's plugin\n * band below the platform's own meters (AGL-2939).\n *\n * Credits, because AI actions differ in cost by up to two orders of\n * magnitude — a question against generating a screen — and a message count\n * would price them the same. The band is refused at the cap, so this\n * readout is the only thing standing between a customer and learning their\n * limit by being turned down mid-build.\n *\n * Rendered only where a band is sold, which since AGL-3203 is every plan\n * row: Free carries the taste and Starter 750, so both render a meter even\n * though neither carries `aiAssist` — the band is credits, not the guided\n * rung. What still renders nothing is a band of ZERO, which now reaches this\n * component only as a per-org override, and a \"0 of 0\" meter is not a\n * readout of anything. ONE meter for one pool: the\n * add-on widens `assistCreditsPerMonth` rather than opening a second band,\n * so the limit here is already plan plus add-on and the caption under it\n * says how much of that the add-on is.\n *\n * From the server, not from Firestore like the platform's meters:\n * `orgs/{orgId}/assistUsage` is default-deny for every client, so a browser\n * read would fail silently and leave this reading \"not yet metered\" forever.\n * Credits, never dollars: the route is where the one conversion happens.\n */\nexport default function AiCreditsCard(props: AiCreditsCardProps) {\n  const { orgId, org, billingHref } = props\n  const { data: user } = useUser()\n  const [credits, setCredits] = useState<{ used: number; limit: number | null } | null>(null)\n  useEffect(() => {\n    if (!orgId || !user) return undefined\n    let active = true\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          user,\n          `/api/ai/billing/credits?orgId=${encodeURIComponent(orgId)}`,\n        )\n        if (!response.ok) return\n        const result = await response.json()\n        if (active && result?.credits) setCredits(result.credits)\n      } catch {\n        // The meter keeps its \"not yet metered\" state on failure —\n        // deliberately not 0, which reads as \"you have used none\".\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, user])\n\n  const entitlements = resolveOrgEntitlements(org)\n  if (entitlements.assistCreditsPerMonth <= 0) return null\n  const plan = resolveEffectivePlan(org)\n  const aiAddonCredits = hasAiAddon(org) ? AI_ADDON_CREDITS_PER_MONTH[plan] : 0\n  // Sold to THIS workspace, not merely on its plan: a staff comp has no\n  // subscription to add the item to, so its price list sells none (AGL-3034).\n  const aiAddonSold = resolvePlanPricing(org).aiAddonMonthlyUsd != null\n  return (\n    <CardDisplay\n      header={'AI credits'}\n      help={pluginDocsHelp('billing', {\n        anchor: '#usage-meters',\n        excerpt:\n          'AI credits drawn this month against your included band, plan ' +\n          'plus the AI add-on where you have it.',\n      })}\n      contentGutterX\n      contentGutterY\n    >\n      {/* An uncapped staff comp (AGL-3049) resolves this band `UNLIMITED`:\n          the meter reads \"Unlimited\" and draws no bar, never \"/ Infinity\". */}\n      <UsageMeter\n        label=\"AI credits (this month)\"\n        used={credits ? credits.used : null}\n        limit={entitlements.assistCreditsPerMonth}\n        unlimited={isUnlimitedQuota(entitlements.assistCreditsPerMonth)}\n        upgradeHref={billingHref ? `${billingHref}#plans` : '#plans'}\n      />\n      {aiAddonCredits > 0 ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Includes ${aiAddonCredits.toLocaleString()} credits a month from ` +\n            `the ${aiAddonName()} add-on.`}\n        </Typography>\n      ) : null}\n      {/* A plan with a band that sells the add-on and has not bought it:\n          the one line on the meters that points at more capacity rather\n          than at an upgrade. */}\n      {!entitlements.features.aiGenerative && aiAddonSold ? (\n        <Typography\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={{ display: 'block', mt: -1.5, mb: 2 }}\n        >\n          {`Generate pages, emails, campaigns and more with ${aiAddonName()}, ` +\n            `and add ${AI_ADDON_CREDITS_PER_MONTH[plan].toLocaleString()} ` +\n            'credits a month to this pool: '}\n          <Link href={`${billingHref ?? ''}#addons`} color=\"primary\" underline=\"hover\">\n            {`Add ${aiAddonName()}`}\n          </Link>\n          {' in Billing → Plans.'}\n        </Typography>\n      ) : null}\n    </CardDisplay>\n  )\n}\n"],"names":["AI_ADDON_CREDITS_PER_MONTH","aiAddonName","hasAiAddon","isUnlimitedQuota","resolveEffectivePlan","resolveOrgEntitlements","resolvePlanPricing","pluginDocsHelp","CardDisplay","UsageMeter","authorizedFetch","Link","Typography","useEffect","useState","useUser","AiCreditsCard","props","orgId","org","billingHref","data","user","credits","setCredits","undefined","active","response","encodeURIComponent","ok","result","json","entitlements","assistCreditsPerMonth","plan","aiAddonCredits","aiAddonSold","aiAddonMonthlyUsd","header","help","anchor","excerpt","contentGutterX","contentGutterY","label","used","limit","unlimited","upgradeHref","variant","color","sx","display","mt","mb","toLocaleString","features","aiGenerative","href","underline"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SACEA,0BAA0B,EAC1BC,WAAW,EACXC,UAAU,EACVC,gBAAgB,EAChBC,oBAAoB,EACpBC,sBAAsB,EACtBC,kBAAkB,QAEb,eAAc;AACrB,SAASC,cAAc,QAAQ,mCAAkC;AACjE,SAASC,WAAW,QAAQ,uBAAsB;AAClD,SAASC,UAAU,QAAQ,wDAAuD;AAClF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,IAAI,EAAEC,UAAU,QAAQ,gBAAe;AAChD,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,OAAO,QAAQ,iCAAgC;AAUxD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,eAAe,SAASC,cAAcC,KAAyB;IAC7D,MAAM,EAAEC,KAAK,EAAEC,GAAG,EAAEC,WAAW,EAAE,GAAGH;IACpC,MAAM,EAAEI,MAAMC,IAAI,EAAE,GAAGP;IACvB,MAAM,CAACQ,SAASC,WAAW,GAAGV,SAAwD;IACtFD,UAAU;QACR,IAAI,CAACK,SAAS,CAACI,MAAM,OAAOG;QAC5B,IAAIC,SAAS;QACb,KAAK,AAAC,CAAA;YACJ,IAAI;gBACF,MAAMC,WAAW,MAAMjB,gBACrBY,MACA,CAAC,8BAA8B,EAAEM,mBAAmBV,QAAQ;gBAE9D,IAAI,CAACS,SAASE,EAAE,EAAE;gBAClB,MAAMC,SAAS,MAAMH,SAASI,IAAI;gBAClC,IAAIL,WAAUI,0BAAAA,OAAQP,OAAO,GAAEC,WAAWM,OAAOP,OAAO;YAC1D,EAAE,eAAM;YACN,2DAA2D;YAC3D,2DAA2D;YAC7D;QACF,CAAA;QACA,OAAO;YACLG,SAAS;QACX;IACF,GAAG;QAACR;QAAOI;KAAK;IAEhB,MAAMU,eAAe3B,uBAAuBc;IAC5C,IAAIa,aAAaC,qBAAqB,IAAI,GAAG,OAAO;IACpD,MAAMC,OAAO9B,qBAAqBe;IAClC,MAAMgB,iBAAiBjC,WAAWiB,OAAOnB,0BAA0B,CAACkC,KAAK,GAAG;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,MAAME,cAAc9B,mBAAmBa,KAAKkB,iBAAiB,IAAI;IACjE,qBACE,MAAC7B;QACC8B,QAAQ;QACRC,MAAMhC,eAAe,WAAW;YAC9BiC,QAAQ;YACRC,SACE,kEACA;QACJ;QACAC,cAAc;QACdC,cAAc;;0BAId,KAAClC;gBACCmC,OAAM;gBACNC,MAAMtB,UAAUA,QAAQsB,IAAI,GAAG;gBAC/BC,OAAOd,aAAaC,qBAAqB;gBACzCc,WAAW5C,iBAAiB6B,aAAaC,qBAAqB;gBAC9De,aAAa5B,cAAc,GAAGA,YAAY,MAAM,CAAC,GAAG;;YAErDe,iBAAiB,kBAChB,KAACvB;gBACCqC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;0BAEvC,CAAC,SAAS,EAAEnB,eAAeoB,cAAc,GAAG,sBAAsB,CAAC,GAClE,CAAC,IAAI,EAAEtD,cAAc,QAAQ,CAAC;iBAEhC;YAIH,CAAC+B,aAAawB,QAAQ,CAACC,YAAY,IAAIrB,4BACtC,MAACxB;gBACCqC,SAAQ;gBACRC,OAAM;gBACNC,IAAI;oBAAEC,SAAS;oBAASC,IAAI,CAAC;oBAAKC,IAAI;gBAAE;;oBAEvC,CAAC,gDAAgD,EAAErD,cAAc,EAAE,CAAC,GACnE,CAAC,QAAQ,EAAED,0BAA0B,CAACkC,KAAK,CAACqB,cAAc,GAAG,CAAC,CAAC,GAC/D;kCACF,KAAC5C;wBAAK+C,MAAM,GAAGtC,sBAAAA,cAAe,GAAG,OAAO,CAAC;wBAAE8B,OAAM;wBAAUS,WAAU;kCAClE,CAAC,IAAI,EAAE1D,eAAe;;oBAExB;;iBAED;;;AAGV"}

package/src/lib/components/ai-credits-columns.component.d.ts

@@ -0,0 +1,56 @@
+import type { ConsoleWidgetColumnHeaderProps } from '@aglyn/aglyn';
+/** A roster row as the member tables hand it to a column. */
+interface MemberRow {
+    $id?: string;
+    uid?: string;
+    status?: string;
+}
+/**
+ * THE ORG TEAM TABLE'S AI CREDITS COLUMN (AGL-2928): the credits each member
+ * drew this month across every site, through the `orgMembersListColumn`
+ * zone. Every cell and the header share one read of the month. A reader the
+ * route refuses — a manager without `billing.view` — sees a dash in every
+ * row, not a warning: the roster is theirs to manage whether or not the
+ * spend is theirs to see.
+ */
+export declare function AiMemberCreditsHeader(props: {
+    orgId?: string;
+} & Partial<ConsoleWidgetColumnHeaderProps>): import("react").JSX.Element;
+export declare namespace AiMemberCreditsHeader {
+    var displayName: string;
+}
+/** One member's credits this month, or a dash until the month is read. */
+export declare function AiMemberCreditsCell(props: {
+    orgId?: string;
+    member?: MemberRow;
+}): import("react").JSX.Element;
+export declare namespace AiMemberCreditsCell {
+    var displayName: string;
+}
+/**
+ * THE SITE COLLABORATORS TABLE'S AI CREDITS COLUMN (AGL-2928): what each
+ * collaborator drew ON THIS SITE this month, from the per-member rollup's
+ * split by host — so an agency sees which client site's people spend. Not
+ * across the workspace, which is the org Team table's column.
+ */
+export declare function AiCollaboratorCreditsHeader(props: {
+    orgId?: string;
+    hostId?: string;
+}): import("react").JSX.Element;
+export declare namespace AiCollaboratorCreditsHeader {
+    var displayName: string;
+}
+/**
+ * One collaborator's credits on this site this month. An invitation not yet
+ * accepted has drawn nothing and reads as a dash; the owner's row is a row
+ * like any other.
+ */
+export declare function AiCollaboratorCreditsCell(props: {
+    orgId?: string;
+    hostId?: string;
+    member?: MemberRow;
+}): import("react").JSX.Element;
+export declare namespace AiCollaboratorCreditsCell {
+    var displayName: string;
+}
+export {};

package/src/lib/components/ai-credits-columns.component.js

@@ -0,0 +1,118 @@
+/**
+ * @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.
+ */ 'use client';
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { TableSortLabel, Tooltip } from "@mui/material";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { aiUsageMonthLabel } from "../usage/ai-usage-wire.js";
+import { useOrgAiUsage } from "./use-org-ai-usage.js";
+/**
+ * THE ORG TEAM TABLE'S AI CREDITS COLUMN (AGL-2928): the credits each member
+ * drew this month across every site, through the `orgMembersListColumn`
+ * zone. Every cell and the header share one read of the month. A reader the
+ * route refuses — a manager without `billing.view` — sees a dash in every
+ * row, not a warning: the roster is theirs to manage whether or not the
+ * spend is theirs to see.
+ */ export function AiMemberCreditsHeader(props) {
+    const { orgId, onSort, sorted } = props;
+    const usage = useOrgAiUsage(orgId);
+    const [direction, setDirection] = useState(null);
+    const onSortRef = useRef(onSort);
+    onSortRef.current = onSort;
+    const compare = useMemo(()=>{
+        if (!direction || usage.status !== 'ready') return null;
+        const credits = (row)=>{
+            var _usage_creditsByUid_get, _ref;
+            return (_usage_creditsByUid_get = usage.creditsByUid.get(String((_ref = row == null ? void 0 : row.$id) != null ? _ref : ''))) != null ? _usage_creditsByUid_get : 0;
+        };
+        return direction === 'desc' ? (a, b)=>credits(b) - credits(a) : (a, b)=>credits(a) - credits(b);
+    }, [
+        direction,
+        usage.status,
+        usage.creditsByUid
+    ]);
+    const compareRef = useRef(compare);
+    compareRef.current = compare;
+    // Keyed on the comparator, which changes only with the direction or the
+    // month's answer, so handing it over cannot re-run on every render.
+    useEffect(()=>{
+        onSortRef.current == null ? void 0 : onSortRef.current.call(onSortRef, compare);
+    }, [
+        compare
+    ]);
+    // Another column taking the sort puts this one back to unsorted; a
+    // comparator withdrawn while the month re-reads keeps its direction.
+    useEffect(()=>{
+        if (sorted === false && compareRef.current) setDirection(null);
+    }, [
+        sorted
+    ]);
+    return /*#__PURE__*/ _jsx(Tooltip, {
+        title: `AI credits each member has drawn in ${aiUsageMonthLabel(usage.month)}, across every site. Open a member for the split by site.`,
+        children: /*#__PURE__*/ _jsx(TableSortLabel, {
+            active: direction !== null,
+            direction: direction != null ? direction : 'desc',
+            disabled: usage.status !== 'ready',
+            onClick: ()=>setDirection((current)=>current === 'desc' ? 'asc' : current === 'asc' ? null : 'desc'),
+            children: 'AI credits (month)'
+        })
+    });
+}
+AiMemberCreditsHeader.displayName = 'AiMemberCreditsHeader';
+/** One member's credits this month, or a dash until the month is read. */ export function AiMemberCreditsCell(props) {
+    var _usage_creditsByUid_get, _ref;
+    var _props_member;
+    const usage = useOrgAiUsage(props.orgId);
+    return /*#__PURE__*/ _jsx(_Fragment, {
+        children: usage.status === 'ready' ? ((_usage_creditsByUid_get = usage.creditsByUid.get(String((_ref = (_props_member = props.member) == null ? void 0 : _props_member.$id) != null ? _ref : ''))) != null ? _usage_creditsByUid_get : 0).toLocaleString() : '—'
+    });
+}
+AiMemberCreditsCell.displayName = 'AiMemberCreditsCell';
+/**
+ * THE SITE COLLABORATORS TABLE'S AI CREDITS COLUMN (AGL-2928): what each
+ * collaborator drew ON THIS SITE this month, from the per-member rollup's
+ * split by host — so an agency sees which client site's people spend. Not
+ * across the workspace, which is the org Team table's column.
+ */ export function AiCollaboratorCreditsHeader(props) {
+    const usage = useOrgAiUsage(props.orgId, {
+        hostId: props.hostId
+    });
+    return /*#__PURE__*/ _jsx(Tooltip, {
+        title: `AI credits drawn on this site in ${aiUsageMonthLabel(usage.month)}, per collaborator.`,
+        children: /*#__PURE__*/ _jsx("span", {
+            children: 'AI credits (site, month)'
+        })
+    });
+}
+AiCollaboratorCreditsHeader.displayName = 'AiCollaboratorCreditsHeader';
+/**
+ * One collaborator's credits on this site this month. An invitation not yet
+ * accepted has drawn nothing and reads as a dash; the owner's row is a row
+ * like any other.
+ */ export function AiCollaboratorCreditsCell(props) {
+    var _ref, _usage_hostCreditsByUid_get;
+    const usage = useOrgAiUsage(props.orgId, {
+        hostId: props.hostId
+    });
+    const member = props.member;
+    const uid = (_ref = member == null ? void 0 : member.uid) != null ? _ref : member == null ? void 0 : member.$id;
+    return /*#__PURE__*/ _jsx(_Fragment, {
+        children: usage.status === 'ready' && uid && (member == null ? void 0 : member.status) !== 'invited' ? ((_usage_hostCreditsByUid_get = usage.hostCreditsByUid.get(uid)) != null ? _usage_hostCreditsByUid_get : 0).toLocaleString() : '—'
+    });
+}
+AiCollaboratorCreditsCell.displayName = 'AiCollaboratorCreditsCell';
+
+//# sourceMappingURL=ai-credits-columns.component.js.map

package/src/lib/components/ai-credits-columns.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-credits-columns.component.tsx"],"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'use client'\n\nimport type { ConsoleWidgetColumnHeaderProps } from '@aglyn/aglyn'\nimport { TableSortLabel, Tooltip } from '@mui/material'\nimport { useEffect, useMemo, useRef, useState } from 'react'\nimport { aiUsageMonthLabel } from '../usage/ai-usage-wire'\nimport { useOrgAiUsage } from './use-org-ai-usage'\n\n/** A roster row as the member tables hand it to a column. */\ninterface MemberRow {\n  $id?: string\n  uid?: string\n  status?: string\n}\n\n/**\n * THE ORG TEAM TABLE'S AI CREDITS COLUMN (AGL-2928): the credits each member\n * drew this month across every site, through the `orgMembersListColumn`\n * zone. Every cell and the header share one read of the month. A reader the\n * route refuses — a manager without `billing.view` — sees a dash in every\n * row, not a warning: the roster is theirs to manage whether or not the\n * spend is theirs to see.\n */\nexport function AiMemberCreditsHeader(\n  props: { orgId?: string } & Partial<ConsoleWidgetColumnHeaderProps>,\n) {\n  const { orgId, onSort, sorted } = props\n  const usage = useOrgAiUsage(orgId)\n  const [direction, setDirection] = useState<'desc' | 'asc' | null>(null)\n  const onSortRef = useRef(onSort)\n  onSortRef.current = onSort\n  const compare = useMemo(() => {\n    if (!direction || usage.status !== 'ready') return null\n    const credits = (row: MemberRow) => usage.creditsByUid.get(String(row?.$id ?? '')) ?? 0\n    return direction === 'desc'\n      ? (a: MemberRow, b: MemberRow) => credits(b) - credits(a)\n      : (a: MemberRow, b: MemberRow) => credits(a) - credits(b)\n  }, [direction, usage.status, usage.creditsByUid])\n  const compareRef = useRef(compare)\n  compareRef.current = compare\n  // Keyed on the comparator, which changes only with the direction or the\n  // month's answer, so handing it over cannot re-run on every render.\n  useEffect(() => {\n    onSortRef.current?.(compare as never)\n  }, [compare])\n  // Another column taking the sort puts this one back to unsorted; a\n  // comparator withdrawn while the month re-reads keeps its direction.\n  useEffect(() => {\n    if (sorted === false && compareRef.current) setDirection(null)\n  }, [sorted])\n  return (\n    <Tooltip\n      title={`AI credits each member has drawn in ${aiUsageMonthLabel(usage.month)}, across every site. Open a member for the split by site.`}\n    >\n      <TableSortLabel\n        active={direction !== null}\n        direction={direction ?? 'desc'}\n        disabled={usage.status !== 'ready'}\n        onClick={() =>\n          setDirection((current) =>\n            current === 'desc' ? 'asc' : current === 'asc' ? null : 'desc',\n          )\n        }\n      >\n        {'AI credits (month)'}\n      </TableSortLabel>\n    </Tooltip>\n  )\n}\nAiMemberCreditsHeader.displayName = 'AiMemberCreditsHeader'\n\n/** One member's credits this month, or a dash until the month is read. */\nexport function AiMemberCreditsCell(props: { orgId?: string; member?: MemberRow }) {\n  const usage = useOrgAiUsage(props.orgId)\n  return (\n    <>\n      {usage.status === 'ready'\n        ? (usage.creditsByUid.get(String(props.member?.$id ?? '')) ?? 0).toLocaleString()\n        : '—'}\n    </>\n  )\n}\nAiMemberCreditsCell.displayName = 'AiMemberCreditsCell'\n\n/**\n * THE SITE COLLABORATORS TABLE'S AI CREDITS COLUMN (AGL-2928): what each\n * collaborator drew ON THIS SITE this month, from the per-member rollup's\n * split by host — so an agency sees which client site's people spend. Not\n * across the workspace, which is the org Team table's column.\n */\nexport function AiCollaboratorCreditsHeader(props: { orgId?: string; hostId?: string }) {\n  const usage = useOrgAiUsage(props.orgId, { hostId: props.hostId })\n  return (\n    <Tooltip\n      title={`AI credits drawn on this site in ${aiUsageMonthLabel(usage.month)}, per collaborator.`}\n    >\n      <span>{'AI credits (site, month)'}</span>\n    </Tooltip>\n  )\n}\nAiCollaboratorCreditsHeader.displayName = 'AiCollaboratorCreditsHeader'\n\n/**\n * One collaborator's credits on this site this month. An invitation not yet\n * accepted has drawn nothing and reads as a dash; the owner's row is a row\n * like any other.\n */\nexport function AiCollaboratorCreditsCell(props: {\n  orgId?: string\n  hostId?: string\n  member?: MemberRow\n}) {\n  const usage = useOrgAiUsage(props.orgId, { hostId: props.hostId })\n  const member = props.member\n  const uid = member?.uid ?? member?.$id\n  return (\n    <>\n      {usage.status === 'ready' && uid && member?.status !== 'invited'\n        ? (usage.hostCreditsByUid.get(uid) ?? 0).toLocaleString()\n        : '—'}\n    </>\n  )\n}\nAiCollaboratorCreditsCell.displayName = 'AiCollaboratorCreditsCell'\n"],"names":["TableSortLabel","Tooltip","useEffect","useMemo","useRef","useState","aiUsageMonthLabel","useOrgAiUsage","AiMemberCreditsHeader","props","orgId","onSort","sorted","usage","direction","setDirection","onSortRef","current","compare","status","credits","row","creditsByUid","get","String","$id","a","b","compareRef","title","month","active","disabled","onClick","displayName","AiMemberCreditsCell","member","toLocaleString","AiCollaboratorCreditsHeader","hostId","span","AiCollaboratorCreditsCell","uid","hostCreditsByUid"],"mappings":"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"}

package/src/lib/components/ai-crm-email-draft.component.d.ts

@@ -0,0 +1,17 @@
+import type { ConsoleRecordEmailZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins';
+/**
+ * "Draft the message" (AGL-2917), in the CRM's one-to-one composer through
+ * the `recordEmail` zone: the member says what the email should say, a `crm`
+ * job drafts a subject and a message from that and the record's timeline, and
+ * the draft goes into the composer through `proposeDraft`, which asks before
+ * it replaces a written message.
+ *
+ * Nothing here sends anything, and nothing can: the composer's Send is the
+ * member's. A draft is asked afresh each time, so the card recalls no earlier
+ * one, and the answer door serves a draft only to the member who asked.
+ */
+export declare function AiCrmEmailDraft(props: ConsoleRecordEmailZoneProps): import("react").JSX.Element;
+export declare namespace AiCrmEmailDraft {
+    var displayName: string;
+}
+export default AiCrmEmailDraft;