@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/assist-signals-page.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/assist-signals-page.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 { aiAddonName, type ConsoleStaffPageProps } from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport {\n  Accordion,\n  AccordionDetails,\n  AccordionSummary,\n  Alert,\n  Box,\n  Chip,\n  LinearProgress,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { useEffect, useRef, useState } from 'react'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport type {\n  AssistMiningReport,\n  AssistSpendRow,\n} from '../usage/assist-signal-mining'\nimport {\n  costSplitRows,\n  freeTasteRefusals,\n  kindTokenRows,\n} from '../usage/assist-signal-mining'\n\n/** The month leaderboard as the route serves it beside the report. */\ninterface AssistSpendLeaderboard {\n  month: string\n  rows: AssistSpendRow[]\n  ranked: number\n  truncated: boolean\n  failed: boolean\n}\n\n/**\n * The Assist docs-gap and cost board (AGL-1860, AGL-2252) — the read side of\n * the data loop, and until now the half that did not exist.\n *\n * AGL-1972 split every assist turn into prose that expires and a signal that\n * does not, on the reasoning that \"the corpus the loop needs outlives the\n * words that produced it\". That is only true once something reads the corpus.\n * This is that something.\n *\n * Four panels, in the order the questions actually get asked:\n *\n *  1. **Docs gaps** — cited pages ranked by thumbs-down, then volume. A page\n *     high on this list is being found and is not answering, which is a docs\n *     issue with its evidence attached. The `orgs` column is the sanity\n *     check: a gap one workspace has is a workspace, not a gap.\n *  2. **Ungrounded questions** — turns where retrieval matched nothing at\n *     all, grouped by the screen the person was on. These cite no page, so\n *     they can never appear in the ranking above; a missing page is invisible\n *     to anything keyed on paths, and this panel is the only place it shows.\n *  3. **Cost** — per org, dearest first, plus the fleet totals and the\n *     cache-read rate. The rate is not decoration: the cached system prefix\n *     measures 1,030–1,190 tokens against Sonnet 5's 1,024-token minimum, so\n *     whether it caches is an empirical question the chat route could only\n *     pose, and this is the evidence.\n *  4. **Tokens by kind** — what each kind of model request costs per\n *     request, what it sends and generates, how much of its prompt the cache\n *     served, and the p95 output its `max_tokens` is sized against\n *     (AGL-2937).\n *\n * Read through `/api/ai/admin/signals` rather than Firestore directly.\n * `assistSignals` is absent from the rules file on purpose — default-deny for\n * every client — which is exactly what lets it hold cross-tenant analytics.\n *\n * The AI plugin's staff page (AGL-2939): the console's generic staff route\n * draws the header, the breadcrumbs and the staff gate around this body, and\n * gives it the tab it had.\n */\n\nconst money = (value: number) =>\n  `$${(Number(value) || 0).toFixed(Math.abs(Number(value) || 0) < 1 ? 4 : 2)}`\n\nconst percent = (value: number | null) =>\n  value == null ? '—' : `${Math.round(value * 100)}%`\n\n/**\n * One cost breakdown — tier or model, dearest first (AGL-2340).\n *\n * The `share` column is why this is a table rather than a row of chips. The\n * decision it feeds is always comparative — \"is free eating the margin\" is a\n * question about proportion, not about a dollar figure — and a reader asked\n * to divide two numbers in their head does not do it.\n *\n * `turns` is kept beside the money on purpose: a tier that is a third of the\n * traffic and two thirds of the bill is the finding, and neither column says\n * that alone.\n *\n * ## Full width, and stacked rather than side by side\n *\n * Both breakdowns split the SAME total, so the reader's act is scanning one\n * against the other: does the tier carrying the turns also carry the money,\n * and would a cheaper model on the common path move it. Two tables squeezed\n * into thirds of a row put each Cost column at a different horizontal\n * position, so that comparison becomes two separate readings held in the\n * head. Stacked full-width, the Cost and Share columns of both land on the\n * same axis and the comparison is a glance down the page.\n *\n * ## Why the caption is not a row of the table\n *\n * It used to be a `colSpan={4}` cell in `TableHead`, which gave it header\n * styling and made the header two rows deep — so this table's head sat at a\n * different weight and height from the four sibling tables on the same page,\n * which is most of what made the card read as a foreign fragment.\n *\n * ## No footer, and why\n *\n * A breakdown has one row per tier and one per model — single digits, and\n * bounded by the vocabulary rather than by a collection that grows. There is\n * no page two to go to, and a pager over four rows is furniture that teaches\n * a reader to look for pages that never exist.\n */\nfunction CostSplitTable({\n  caption,\n  label,\n  rows,\n  totalUsd,\n}: {\n  caption: string\n  label: string\n  rows: { key: string; messages: number; providerCostUsd: number }[]\n  totalUsd: number\n}) {\n  return (\n    <Stack spacing={1} sx={{ width: '100%' }}>\n      <Typography variant=\"subtitle2\">{caption}</Typography>\n      <ScrollTable size=\"small\">\n        <TableHead>\n          <TableRow>\n            <TableCell>{label}</TableCell>\n            <TableCell align=\"right\">Turns</TableCell>\n            <TableCell align=\"right\">Cost</TableCell>\n            <TableCell align=\"right\">Share</TableCell>\n          </TableRow>\n        </TableHead>\n        <TableBody>\n          {!rows.length ? (\n            <TableRow>\n              <TableCell colSpan={4}>\n                <Typography variant=\"body2\" color=\"text.secondary\">\n                  No turns in this sample.\n                </Typography>\n              </TableCell>\n            </TableRow>\n          ) : (\n            rows.map((row) => (\n              <TableRow key={row.key}>\n                <TableCell>{row.key}</TableCell>\n                <TableCell align=\"right\">\n                  {row.messages.toLocaleString()}\n                </TableCell>\n                <TableCell align=\"right\">{money(row.providerCostUsd)}</TableCell>\n                <TableCell align=\"right\">\n                  {percent(totalUsd > 0 ? row.providerCostUsd / totalUsd : null)}\n                </TableCell>\n              </TableRow>\n            ))\n          )}\n        </TableBody>\n      </ScrollTable>\n    </Stack>\n  )\n}\n\n/**\n * The count line under a RANKED table — how much of the ranking is on screen.\n *\n * These three tables are not paged, and the reason is the same for all of\n * them: each is a ranking whose value is its top. Page two of \"where are the\n * docs thin\" is, by construction, the pages least worth rewriting, and a\n * pager over a ranking invites a reader to walk it as if position carried no\n * meaning. What a pager WOULD have given honestly is the count — how much of\n * this am I looking at, and is there more — so that is what this says, and it\n * says it whether or not the ranking was cut.\n *\n * Rendered even when nothing was cut. A disclosure that appears only on\n * truncation is one a reader has never seen before the day it matters, and\n * cannot tell from a card that simply has no footer.\n */\nfunction RankingFootnote({\n  shown,\n  total,\n  noun,\n}: {\n  shown: number\n  total: number\n  /** Both forms: a fleet of one is the common case on a young install. */\n  noun: { one: string; many: string }\n}) {\n  if (!total) return null\n  const counted = `${total.toLocaleString()} ${total === 1 ? noun.one : noun.many}`\n  return (\n    <Typography variant=\"caption\" color=\"text.secondary\">\n      {shown >= total\n        ? `Showing all ${counted}.`\n        : `Showing the top ${shown.toLocaleString()} of ${counted}. This is a ranking, not a page — what is past the cut is what it ranked lowest.`}\n    </Typography>\n  )\n}\n\nexport function AssistSignalsPage(_props: ConsoleStaffPageProps) {\n  const { data: user } = useUser()\n  // Keyed on who is signed in, not on the user object's identity.\n  const signedInUid = user?.uid ?? null\n  const userRef = useRef(user)\n  userRef.current = user\n  const [report, setReport] = useState<AssistMiningReport | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [loading, setLoading] = useState(false)\n\n  useEffect(() => {\n    // Mounted only for a confirmed staff reader: the generic staff route\n    // renders this inside `StaffOnly`, which draws nothing while the claim\n    // loads, so no request is fired from the loading default.\n    const user = userRef.current\n    if (!signedInUid || !user) return undefined\n    let active = true\n    void (async () => {\n      setLoading(true)\n      setError(null)\n      try {\n        const response = await authorizedFetch(user, '/api/ai/admin/signals')\n        const body = await response.json().catch(() => null)\n        if (!active) return\n        if (!response.ok) {\n          setError(body?.error ?? 'Assist signal lookup failed')\n        } else {\n          setReport(body as AssistMiningReport)\n        }\n      } catch {\n        if (active) setError('Assist signal lookup failed')\n      } finally {\n        if (active) setLoading(false)\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [signedInUid])\n\n  const totals = report?.totals\n  // The route serves the prose beside the report (AGL-2314) — it is not part\n  // of the pure miner's output, because the miner never touches Firestore.\n  const prose = ((report as any)?.prose ?? []) as Array<Record<string, unknown>>\n  // The month's spend leaderboard (AGL-2930), likewise served beside the\n  // report: it reads the month documents, which the miner never sees.\n  const spend = ((report as any)?.spend ?? null) as AssistSpendLeaderboard | null\n  // Absent from a route older than the page, which reads as no kinds.\n  const kindRows = totals?.byKind ? kindTokenRows(totals.byKind) : []\n\n  return (\n    <Stack spacing={3}>\n      {loading && <LinearProgress />}\n      {error && <Alert severity=\"error\">{error}</Alert>}\n      {report?.truncated && (\n        // Never a silent partial. A ranking cut short looks exactly\n        // like a complete one, and this one decides where docs effort\n        // goes.\n        <Alert severity=\"warning\">\n          {`Ranked the first ${report.scanned.toLocaleString()} signals only — there are more. Every number below describes that sample, not the fleet.`}\n        </Alert>\n      )}\n\n      <CardDisplay\n        header={'Fleet'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#fleet' })}\n        contentGutterX\n        contentGutterY\n      >\n        {!totals ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {loading ? 'Reading signals…' : 'No assist turns recorded yet.'}\n          </Typography>\n        ) : (\n          // Neither `gap` nor `flexWrap` is a Stack prop under MUI 9\n          // — both go through `sx` or it is a typecheck error.\n          // AGL-1891 is the same drift, in the Assist panel itself.\n          <Stack direction=\"row\" sx={{ flexWrap: 'wrap', gap: 1 }}>\n            <Chip label={`${totals.messages.toLocaleString()} turns`} />\n            <Chip label={`${money(totals.providerCostUsd)} estimated`} />\n            {/*\n             * The headline number for whether Assist is affordable to\n             * leave on (AGL-2486): the share of turns answered from the\n             * docs index or the answer cache, with no model call and no\n             * provider spend. Placed beside the money rather than with\n             * the token chips because it is the thing that MOVES the\n             * money — every point of it is a turn that cost nothing.\n             *\n             * Success above half, because that is the point at which\n             * the cheap path is carrying the feature rather than\n             * trimming it.\n             */}\n            <Chip\n              // `?? 0` on the count, and it is not defensive noise: this\n              // whole object is JSON off `/api/ai/admin/signals`,\n              // and a chip that throws on a missing number takes the\n              // ENTIRE staff page down with it rather than rendering a\n              // dash. The rate beside it is legitimately nullable —\n              // `percent` renders that — so the two are handled\n              // differently on purpose.\n              label={`answered free ${percent(totals.deflectionRate)} (${(\n                totals.deflected ?? 0\n              ).toLocaleString()})`}\n              color={\n                totals.deflectionRate != null && totals.deflectionRate > 0.5\n                  ? 'success'\n                  : 'default'\n              }\n            />\n            <Chip\n              label={`${totals.inputTokens.toLocaleString()} in / ${totals.outputTokens.toLocaleString()} out`}\n            />\n            <Chip\n              label={`cache reads ${percent(totals.cacheReadRate)}`}\n              color={\n                totals.cacheReadRate != null && totals.cacheReadRate > 0.5\n                  ? 'success'\n                  : 'default'\n              }\n            />\n            {/*\n             * Cache WRITES, beside the reads (AGL-2340). The pair only\n             * means anything together: a write is billed at a premium\n             * over a fresh input token and pays for itself only if\n             * enough reads follow it. A board that showed the cheap\n             * half alone made a prefix that is re-written every turn —\n             * the expensive failure mode — look like a caching win.\n             */}\n            <Chip\n              label={`cache writes ${totals.cacheWriteTokens.toLocaleString()}`}\n            />\n            <Chip\n              label={`👍 ${totals.feedback.up} · 👎 ${totals.feedback.down} · unrated ${totals.feedback.none}`}\n            />\n            {Object.entries(totals.stopReasons).map(([reason, count]) => (\n              <Chip\n                key={reason}\n                size=\"small\"\n                // A refusal and a truncation both read as a short\n                // answer in the data and need opposite fixes: a rising\n                // refusal rate is a prompt problem, a rising max_tokens\n                // rate is a ceiling problem.\n                color={\n                  reason === 'refusal' || reason === 'max_tokens'\n                    ? 'warning'\n                    : 'default'\n                }\n                label={`${reason}: ${count}`}\n              />\n            ))}\n            {/*\n             * Today's FREE-TIER spend against the platform ceiling\n             * (AGL-2925). The one AI band with no invoice behind it,\n             * and the one figure that can switch every Free\n             * workspace's generation off at once — so it sits with\n             * the fleet money rather than on a page of its own. Red\n             * once paused, amber once staff were mailed at 80%.\n             */}\n            {report.freeSpend ? (\n              <Chip\n                color={\n                  report.freeSpend.paused\n                    ? 'error'\n                    : report.freeSpend.alerted\n                      ? 'warning'\n                      : 'default'\n                }\n                label={\n                  `free tier today ${money(report.freeSpend.estCostUsd)} of ` +\n                  `${money(report.freeSpend.ceilingUsd)} ceiling · ` +\n                  `${report.freeSpend.requests.toLocaleString()} requests` +\n                  (report.freeSpend.paused ? ' · PAUSED until tomorrow' : '')\n                }\n              />\n            ) : null}\n          </Stack>\n        )}\n      </CardDisplay>\n\n      {/* The month's spend, per workspace (AGL-2930) — ABOVE the\n          tier and model splits, because \"which org\" is the question\n          staff open this board with, and the two tables below split\n          one fleet total that this ranking names the parts of. */}\n      <CardDisplay\n        header={`AI spend this month, by workspace${spend ? ` · ${spend.month}` : ''}`}\n        help={pluginDocsHelp('aiMonitoring', { anchor: '#the-spend-leaderboard' })}\n        contentGutterX\n        contentGutterY\n      >\n        {spend?.failed ? (\n          <Alert severity=\"warning\" sx={{ mb: 1 }}>\n            {'Could not read this month’s spend documents — a failed read, not a month in which nobody spent.'}\n          </Alert>\n        ) : spend?.truncated ? (\n          <Alert severity=\"warning\" sx={{ mb: 1 }}>\n            {'Ranked over a sample of the month documents — there are more. This is not the whole fleet.'}\n          </Alert>\n        ) : null}\n        <ScrollTable size=\"small\">\n          <TableHead>\n            <TableRow>\n              <TableCell>Workspace</TableCell>\n              <TableCell>Plan</TableCell>\n              <TableCell>{aiAddonName()}</TableCell>\n              <TableCell align=\"right\">Credits</TableCell>\n              <TableCell align=\"right\">Cost</TableCell>\n              <TableCell align=\"right\">Refusals</TableCell>\n            </TableRow>\n          </TableHead>\n          <TableBody>\n            {!spend?.rows?.length ? (\n              <TableRow>\n                <TableCell colSpan={6}>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    No workspace has spent AI credits this month.\n                  </Typography>\n                </TableCell>\n              </TableRow>\n            ) : (\n              spend.rows.map((row) => (\n                <TableRow key={row.orgId}>\n                  <TableCell>{row.orgLabel ?? row.orgId}</TableCell>\n                  <TableCell>{row.plan}</TableCell>\n                  <TableCell>\n                    <Chip\n                      size=\"small\"\n                      variant={row.aiAddon ? 'filled' : 'outlined'}\n                      color={row.aiAddon ? 'primary' : 'default'}\n                      label={row.aiAddon ? 'on' : 'off'}\n                    />\n                  </TableCell>\n                  <TableCell align=\"right\">\n                    {row.credits.toLocaleString()}\n                  </TableCell>\n                  <TableCell align=\"right\" sx={{ fontFamily: 'monospace' }}>\n                    {money(row.providerCostUsd)}\n                  </TableCell>\n                  {/* The total, with the reasons on hover-free display:\n                      a reader comparing spend to refusals needs both\n                      on one row, and the reasons are what turn a count\n                      into a diagnosis. */}\n                  <TableCell align=\"right\">\n                    {row.refusals.total.toLocaleString()}\n                    {row.refusals.total > 0 ? (\n                      <Typography\n                        variant=\"caption\"\n                        color=\"text.secondary\"\n                        sx={{ display: 'block' }}\n                      >\n                        {`band ${row.refusals.band} · ceiling ${row.refusals.cap} · messages ${row.refusals.messages} · backstop ${row.refusals.budget}${row.refusals.allotment > 0 ? ` · allotments ${row.refusals.allotment}` : ''}${freeTasteRefusals(row.refusals) > 0 ? ` · free taste ${freeTasteRefusals(row.refusals)}` : ''}`}\n                      </Typography>\n                    ) : null}\n                  </TableCell>\n                </TableRow>\n              ))\n            )}\n          </TableBody>\n        </ScrollTable>\n        <RankingFootnote\n          shown={spend?.rows?.length ?? 0}\n          total={spend?.ranked ?? 0}\n          noun={{ one: 'workspace', many: 'workspaces' }}\n        />\n      </CardDisplay>\n\n      <CardDisplay\n        header={'Where the money goes'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#where-the-money-goes' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          The same spend split two ways. By tier answers whether the free\n          cap or the paid price is the lever; by model answers whether a\n          cheaper model on the common path would do — the one lever that\n          never reaches the customer.\n        </Typography>\n        {!totals ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {loading ? 'Reading signals…' : 'No assist turns recorded yet.'}\n          </Typography>\n        ) : totals.providerCostUsd === 0 ? (\n          /*\n           * ZERO SPEND IS A FINDING, NOT AN EMPTY TABLE.\n           *\n           * Rendered as a sentence rather than two grids of `$0.0000`\n           * and em dashes. A share column is a proportion of the total,\n           * and there is no proportion of nothing — so the grid could\n           * only ever print a dash in every cell, which reads as a card\n           * that failed rather than as a bill that is genuinely zero.\n           *\n           * The two zeros mean OPPOSITE things and are separated here.\n           * Every turn deflected is the deflection path working: those\n           * turns were answered from the docs index or the answer cache\n           * with no provider call, so nothing was spent because nothing\n           * was bought. A turn that reached a model and still priced at\n           * zero is the other case — the model is missing from the\n           * model catalog's rates and its spend is landing nowhere,\n           * which is a hole in the meter and must not be reported as\n           * thrift.\n           */\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {totals.deflected >= totals.messages\n              ? `Nothing spent on these ${totals.messages.toLocaleString()} turns — every one was answered from the docs index or the answer cache, with no model call. There is no split to show until a turn reaches a provider.`\n              : `${(totals.messages - totals.deflected).toLocaleString()} of ${totals.messages.toLocaleString()} turns reached a model and every one priced at $0. That is a gap in the rate table, not a saving — the serving model has no entry in the cost model, so its spend is landing nowhere.`}\n          </Typography>\n        ) : (\n          <Stack spacing={3}>\n            <CostSplitTable\n              caption=\"By tier\"\n              label=\"Tier\"\n              rows={costSplitRows(totals.byTier)}\n              totalUsd={totals.providerCostUsd}\n            />\n            <CostSplitTable\n              caption=\"By model\"\n              label=\"Model\"\n              rows={costSplitRows(totals.byModel)}\n              totalUsd={totals.providerCostUsd}\n            />\n          </Stack>\n        )}\n      </CardDisplay>\n\n      {/*\n        * TOKENS BY KIND (AGL-2937): what a kind of request costs and weighs,\n        * and the p95 output its `max_tokens` is sized against. Model turns\n        * only — a docs answer has no tokens to split.\n        */}\n      <CardDisplay\n        header={'Tokens by kind'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#tokens-by-kind' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          What each kind of model request costs per request, what its prompts\n          and answers weigh, how much of its prompt the cache served, and the\n          answer size 95 of every 100 requests stayed within — the figure its\n          output ceiling is sized against.\n        </Typography>\n        <ScrollTable size=\"small\">\n          <TableHead>\n            <TableRow>\n              <TableCell>Kind</TableCell>\n              <TableCell align=\"right\">Requests</TableCell>\n              <TableCell align=\"right\">Per request</TableCell>\n              <TableCell align=\"right\">In</TableCell>\n              <TableCell align=\"right\">Cache reads</TableCell>\n              <TableCell align=\"right\">Cache writes</TableCell>\n              <TableCell align=\"right\">Out</TableCell>\n              <TableCell align=\"right\">p95 out</TableCell>\n              <TableCell align=\"right\">Cache hit</TableCell>\n            </TableRow>\n          </TableHead>\n          <TableBody>\n            {!kindRows.length ? (\n              <TableRow>\n                <TableCell colSpan={9}>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    No model turns in this sample.\n                  </Typography>\n                </TableCell>\n              </TableRow>\n            ) : (\n              kindRows.map((row) => (\n                <TableRow key={row.kind}>\n                  <TableCell>{row.kind}</TableCell>\n                  <TableCell align=\"right\">{row.messages.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\" sx={{ fontFamily: 'monospace' }}>\n                    {money(row.messages ? row.providerCostUsd / row.messages : 0)}\n                  </TableCell>\n                  <TableCell align=\"right\">{row.inputTokens.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\">{row.cacheReadTokens.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\">{row.cacheWriteTokens.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\">{row.outputTokens.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\">{row.outputP95.toLocaleString()}</TableCell>\n                  <TableCell align=\"right\">{percent(row.cacheHitRate)}</TableCell>\n                </TableRow>\n              ))\n            )}\n          </TableBody>\n        </ScrollTable>\n      </CardDisplay>\n\n      <CardDisplay\n        header={'Docs gaps'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#docs-gaps' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          Cited pages ranked by thumbs-down, then by how often a question\n          landed there. A page near the top is being found and is not\n          answering — that is a docs issue with its evidence attached.\n        </Typography>\n        <ScrollTable size=\"small\">\n          <TableHead>\n            <TableRow>\n              <TableCell>Docs page</TableCell>\n              <TableCell align=\"right\">Questions</TableCell>\n              <TableCell align=\"right\">👍</TableCell>\n              <TableCell align=\"right\">👎</TableCell>\n              <TableCell align=\"right\">Down rate</TableCell>\n              <TableCell align=\"right\">Orgs</TableCell>\n              <TableCell align=\"right\">Cost</TableCell>\n            </TableRow>\n          </TableHead>\n          <TableBody>\n            {!report?.docsGaps?.length ? (\n              <TableRow>\n                <TableCell colSpan={7}>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    Nothing cited yet.\n                  </Typography>\n                </TableCell>\n              </TableRow>\n            ) : (\n              report.docsGaps.map((row) => (\n                <TableRow key={row.path}>\n                  <TableCell sx={{ fontFamily: 'monospace' }}>\n                    {row.path}\n                  </TableCell>\n                  <TableCell align=\"right\">{row.questions}</TableCell>\n                  <TableCell align=\"right\">{row.up}</TableCell>\n                  <TableCell align=\"right\">{row.down}</TableCell>\n                  <TableCell align=\"right\">\n                    {percent(row.downRate)}\n                  </TableCell>\n                  <TableCell align=\"right\">{row.orgs}</TableCell>\n                  <TableCell align=\"right\" sx={{ fontFamily: 'monospace' }}>\n                    {money(row.providerCostUsd)}\n                  </TableCell>\n                </TableRow>\n              ))\n            )}\n          </TableBody>\n        </ScrollTable>\n        <RankingFootnote\n          shown={report?.docsGaps?.length ?? 0}\n          total={report?.ranked?.docsGaps ?? 0}\n          noun={{ one: 'cited page', many: 'cited pages' }}\n        />\n      </CardDisplay>\n\n      <CardDisplay\n        header={'Questions the docs could not answer'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#questions-the-docs-could-not-answer' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          {report\n            ? `${report.ungrounded.questions.toLocaleString()} turns matched no documentation at all, ${report.ungrounded.down} of them rated down. These cite no page, so they cannot appear in the ranking above — a missing page is invisible to anything keyed on paths.`\n            : 'Turns where retrieval matched no documentation at all.'}\n        </Typography>\n        <ScrollTable size=\"small\">\n          <TableHead>\n            <TableRow>\n              <TableCell>Asked from</TableCell>\n              <TableCell align=\"right\">Questions</TableCell>\n              <TableCell align=\"right\">👎</TableCell>\n            </TableRow>\n          </TableHead>\n          <TableBody>\n            {!report?.ungrounded?.routes?.length ? (\n              <TableRow>\n                <TableCell colSpan={3}>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    Every question so far matched something.\n                  </Typography>\n                </TableCell>\n              </TableRow>\n            ) : (\n              report.ungrounded.routes.map((row) => (\n                <TableRow key={row.route}>\n                  <TableCell sx={{ fontFamily: 'monospace' }}>\n                    {row.route}\n                  </TableCell>\n                  <TableCell align=\"right\">{row.questions}</TableCell>\n                  <TableCell align=\"right\">{row.down}</TableCell>\n                </TableRow>\n              ))\n            )}\n          </TableBody>\n        </ScrollTable>\n        <RankingFootnote\n          shown={report?.ungrounded?.routes?.length ?? 0}\n          total={report?.ranked?.ungroundedRoutes ?? 0}\n          noun={{ one: 'screen', many: 'screens' }}\n        />\n      </CardDisplay>\n\n      {/*\n        * THE WORDS THEMSELVES (AGL-2314).\n        *\n        * `assistExchanges` held the question a customer typed and the\n        * answer we gave, for 180 days, and `assist-usage.ts` called it\n        * \"the data loop's corpus\". Nothing read it — so we retained\n        * customers' words, and committed publicly in the privacy policy\n        * to retaining them, for zero product value. The two panels above\n        * can say a page fails and cannot say what people were trying to\n        * do; only this can.\n        *\n        * Behind a disclosure, and only for turns that FAILED — the shape\n        * AGL-2294 used for churn free text. The route fetches nothing\n        * else, so the panel being closed is not the privacy control; the\n        * shortlist is.\n        */}\n      <CardDisplay\n        header={'What people actually asked'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#what-people-actually-asked' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          {'The verbatim question behind each failing turn — rated down, ' +\n            'or grounded in nothing. Kept for 180 days and then deleted, ' +\n            'so an older failure shows its counts with the words gone. ' +\n            'Who asked is deliberately not shown: the question is what ' +\n            'this is for.'}\n        </Typography>\n        {!prose.length ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {loading\n              ? 'Reading exchanges…'\n              : 'No failing turns in this sample — nothing to read.'}\n          </Typography>\n        ) : (\n          <Accordion>\n            <AccordionSummary expandIcon={<span aria-hidden>{'▾'}</span>}>\n              <Typography variant=\"body2\">\n                {`Show ${prose.length} question${prose.length === 1 ? '' : 's'}`}\n              </Typography>\n            </AccordionSummary>\n            <AccordionDetails>\n              <Stack spacing={2}>\n                {prose.map((row: any) => (\n                  <Stack key={`${row.orgId}:${row.exchangeId}`} spacing={0.5}>\n                    <Stack\n                      direction=\"row\"\n                      sx={{ flexWrap: 'wrap', gap: 1, alignItems: 'center' }}\n                    >\n                      <Chip\n                        size=\"small\"\n                        color={row.feedback === 'down' ? 'error' : 'default'}\n                        label={\n                          row.feedback === 'down'\n                            ? 'rated down'\n                            : 'no documentation matched'\n                        }\n                      />\n                      <Typography variant=\"caption\" color=\"text.secondary\">\n                        <Box\n                          component=\"span\"\n                          sx={{ fontFamily: 'monospace' }}\n                        >\n                          {row.route}\n                        </Box>\n                        {` · ${row.orgLabel ?? row.orgId}`}\n                      </Typography>\n                    </Stack>\n                    {row.expired ? (\n                      // Said out loud. A shortlist quietly shorter than\n                      // the failure count it came from would read as\n                      // \"these are all the failures\".\n                      <Typography variant=\"body2\" color=\"text.secondary\">\n                        {'The words are past their 180-day retention and ' +\n                          'have been deleted. The counts above still ' +\n                          'include this turn.'}\n                      </Typography>\n                    ) : (\n                      <>\n                        <Typography variant=\"body2\">\n                          {row.question || '(no question recorded)'}\n                        </Typography>\n                        {row.answer ? (\n                          <Typography\n                            variant=\"caption\"\n                            color=\"text.secondary\"\n                          >\n                            {`We said: ${row.answer}${row.answerTruncated ? '…' : ''}`}\n                          </Typography>\n                        ) : null}\n                      </>\n                    )}\n                  </Stack>\n                ))}\n              </Stack>\n            </AccordionDetails>\n          </Accordion>\n        )}\n      </CardDisplay>\n\n      <CardDisplay\n        header={'What Assist costs, by workspace'}\n        help={pluginDocsHelp('assistSignals', { anchor: '#what-assist-costs-by-workspace' })}\n        contentGutterX\n        contentGutterY\n      >\n        <Typography variant=\"body2\" color=\"text.secondary\" gutterBottom>\n          Our estimated cost at the serving model&apos;s list rates —\n          telemetry for tuning price against margin, not a bill.\n        </Typography>\n        <ScrollTable size=\"small\">\n          <TableHead>\n            <TableRow>\n              <TableCell>Workspace</TableCell>\n              <TableCell align=\"right\">Turns</TableCell>\n              <TableCell align=\"right\">In</TableCell>\n              <TableCell align=\"right\">Out</TableCell>\n              <TableCell align=\"right\">Cache reads</TableCell>\n              <TableCell align=\"right\">👎</TableCell>\n              <TableCell align=\"right\">Cost</TableCell>\n            </TableRow>\n          </TableHead>\n          <TableBody>\n            {!report?.orgs?.length ? (\n              <TableRow>\n                <TableCell colSpan={7}>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    No workspace has used Assist yet.\n                  </Typography>\n                </TableCell>\n              </TableRow>\n            ) : (\n              report.orgs.map((row) => (\n                <TableRow key={row.orgId}>\n                  {/*\n                    The workspace's NAME. The route resolves it and\n                    falls back to the id, so a deleted workspace still\n                    renders a lead a staff member can search for rather\n                    than an empty cell. Not monospaced: monospace is how\n                    this page marks a value you copy, and a customer's\n                    name is one you read.\n                  */}\n                  <TableCell>{row.orgLabel ?? row.orgId}</TableCell>\n                  <TableCell align=\"right\">{row.messages}</TableCell>\n                  <TableCell align=\"right\">\n                    {row.inputTokens.toLocaleString()}\n                  </TableCell>\n                  <TableCell align=\"right\">\n                    {row.outputTokens.toLocaleString()}\n                  </TableCell>\n                  <TableCell align=\"right\">\n                    {row.cacheReadTokens.toLocaleString()}\n                  </TableCell>\n                  <TableCell align=\"right\">{row.down}</TableCell>\n                  <TableCell align=\"right\" sx={{ fontFamily: 'monospace' }}>\n                    {money(row.providerCostUsd)}\n                  </TableCell>\n                </TableRow>\n              ))\n            )}\n          </TableBody>\n        </ScrollTable>\n        <RankingFootnote\n          shown={report?.orgs?.length ?? 0}\n          total={report?.ranked?.orgs ?? 0}\n          noun={{ one: 'workspace', many: 'workspaces' }}\n        />\n      </CardDisplay>\n    </Stack>\n  )\n}\n\nexport default AssistSignalsPage\n"],"names":["aiAddonName","pluginDocsHelp","CardDisplay","ScrollTable","Accordion","AccordionDetails","AccordionSummary","Alert","Box","Chip","LinearProgress","Stack","TableBody","TableCell","TableHead","TableRow","Typography","useEffect","useRef","useState","useUser","authorizedFetch","costSplitRows","freeTasteRefusals","kindTokenRows","money","value","Number","toFixed","Math","abs","percent","round","CostSplitTable","caption","label","rows","totalUsd","spacing","sx","width","variant","size","align","length","colSpan","color","map","row","key","messages","toLocaleString","providerCostUsd","RankingFootnote","shown","total","noun","counted","one","many","AssistSignalsPage","_props","totals","spend","report","data","user","signedInUid","uid","userRef","current","setReport","error","setError","loading","setLoading","undefined","active","response","body","json","catch","ok","prose","kindRows","byKind","severity","truncated","scanned","header","help","anchor","contentGutterX","contentGutterY","direction","flexWrap","gap","deflectionRate","deflected","inputTokens","outputTokens","cacheReadRate","cacheWriteTokens","feedback","up","down","none","Object","entries","stopReasons","reason","count","freeSpend","paused","alerted","estCostUsd","ceilingUsd","requests","month","failed","mb","orgLabel","orgId","plan","aiAddon","credits","fontFamily","refusals","display","band","cap","budget","allotment","ranked","gutterBottom","byTier","byModel","kind","cacheReadTokens","outputP95","cacheHitRate","docsGaps","path","questions","downRate","orgs","ungrounded","routes","route","ungroundedRoutes","expandIcon","span","aria-hidden","alignItems","component","expired","question","answer","answerTruncated","exchangeId"],"mappings":"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"}

package/src/lib/components/besigner-ai-controls.component.d.ts

@@ -0,0 +1,29 @@
+import { type NodeSchema } from '@aglyn/aglyn';
+/**
+ * Whether the copy assistant can rewrite an element (AGL-89, AGL-130): a
+ * text-editable element, or one declaring a text attribute — alt text, a
+ * label — the rewrite dialog lets the reader pick.
+ */
+export declare function nodeTakesCopyRewrite(node: NodeSchema<any> | null | undefined): boolean;
+/**
+ * Generate a section (AGL-169), on the besigner toolbar through the
+ * `besignerToolbar` zone: opens the provider's prompt dialog, and the
+ * proposed subtree lands at the end of the canvas root. Not drawn while the
+ * reader's permission refuses the door.
+ */
+export declare function AiGenerateSectionControl(): import("react").JSX.Element;
+export declare namespace AiGenerateSectionControl {
+    var displayName: string;
+}
+/**
+ * Rewrite with AI (AGL-89), under the selected element's fields through the
+ * `besignerInspector` zone: opens the provider's instruction dialog for the
+ * element. Drawn for an element the rewrite applies to, while the reader's
+ * permission admits the door.
+ */
+export declare function AiRewriteControl(props: {
+    node?: NodeSchema<any> | null;
+}): import("react").JSX.Element;
+export declare namespace AiRewriteControl {
+    var displayName: string;
+}

package/src/lib/components/besigner-ai-controls.component.js

@@ -0,0 +1,81 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import { FEATURE_FLAG, FieldComponentType } from "@aglyn/aglyn";
+import { mdiAutoFix } from "@aglyn/shared-data-mdi";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import { Button, FormControl, IconButton, Tooltip } from "@mui/material";
+import { useContext } from "react";
+import { AiAssistActionsContext } from "./ai-assist-actions-context.js";
+/**
+ * Whether the copy assistant can rewrite an element (AGL-89, AGL-130): a
+ * text-editable element, or one declaring a text attribute — alt text, a
+ * label — the rewrite dialog lets the reader pick.
+ */ export function nodeTakesCopyRewrite(node) {
+    var _ref, _ref1;
+    var _schema_flags;
+    const schema = node == null ? void 0 : node.componentSchema;
+    const textEditable = (((_ref = schema == null ? void 0 : (_schema_flags = schema.flags) == null ? void 0 : _schema_flags.textEditable) != null ? _ref : FEATURE_FLAG.DISABLED) & FEATURE_FLAG.ENABLED) !== 0;
+    const hasTextAttributes = ((_ref1 = schema == null ? void 0 : schema.attributes) != null ? _ref1 : []).some((field)=>field.component === FieldComponentType.TEXT_FIELD || field.component === FieldComponentType.TEXTAREA);
+    return textEditable || hasTextAttributes;
+}
+/**
+ * Generate a section (AGL-169), on the besigner toolbar through the
+ * `besignerToolbar` zone: opens the provider's prompt dialog, and the
+ * proposed subtree lands at the end of the canvas root. Not drawn while the
+ * reader's permission refuses the door.
+ */ export function AiGenerateSectionControl() {
+    const { onGenerateSection } = useContext(AiAssistActionsContext);
+    if (!onGenerateSection) return null;
+    return /*#__PURE__*/ _jsx(Tooltip, {
+        title: "Generate a section with AI",
+        children: /*#__PURE__*/ _jsx(IconButton, {
+            "aria-label": "generate section with ai",
+            size: "small",
+            color: "inherit",
+            onClick: ()=>onGenerateSection(),
+            children: /*#__PURE__*/ _jsx(MdiIcon, {
+                fontSize: "inherit",
+                path: mdiAutoFix.path
+            })
+        })
+    });
+}
+AiGenerateSectionControl.displayName = 'AiGenerateSectionControl';
+/**
+ * Rewrite with AI (AGL-89), under the selected element's fields through the
+ * `besignerInspector` zone: opens the provider's instruction dialog for the
+ * element. Drawn for an element the rewrite applies to, while the reader's
+ * permission admits the door.
+ */ export function AiRewriteControl(props) {
+    const { onRewrite } = useContext(AiAssistActionsContext);
+    const node = props.node;
+    if (!onRewrite || !node || !nodeTakesCopyRewrite(node)) return null;
+    return /*#__PURE__*/ _jsx(FormControl, {
+        margin: "none",
+        fullWidth: true,
+        children: /*#__PURE__*/ _jsx(Button, {
+            color: "primary",
+            onClick: ()=>onRewrite(node),
+            fullWidth: true,
+            children: 'Rewrite with AI'
+        })
+    });
+}
+AiRewriteControl.displayName = 'AiRewriteControl';
+
+//# sourceMappingURL=besigner-ai-controls.component.js.map

package/src/lib/components/besigner-ai-controls.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/besigner-ai-controls.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 { FEATURE_FLAG, FieldComponentType, type NodeSchema } from '@aglyn/aglyn'\nimport { mdiAutoFix } from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport { Button, FormControl, IconButton, Tooltip } from '@mui/material'\nimport { useContext } from 'react'\nimport { AiAssistActionsContext } from './ai-assist-actions-context'\n\n/**\n * Whether the copy assistant can rewrite an element (AGL-89, AGL-130): a\n * text-editable element, or one declaring a text attribute — alt text, a\n * label — the rewrite dialog lets the reader pick.\n */\nexport function nodeTakesCopyRewrite(node: NodeSchema<any> | null | undefined): boolean {\n  const schema = node?.componentSchema\n  const textEditable =\n    ((schema?.flags?.textEditable ?? FEATURE_FLAG.DISABLED) & FEATURE_FLAG.ENABLED) !== 0\n  const hasTextAttributes = (schema?.attributes ?? []).some(\n    (field: { component?: unknown }) =>\n      field.component === FieldComponentType.TEXT_FIELD ||\n      field.component === FieldComponentType.TEXTAREA,\n  )\n  return textEditable || hasTextAttributes\n}\n\n/**\n * Generate a section (AGL-169), on the besigner toolbar through the\n * `besignerToolbar` zone: opens the provider's prompt dialog, and the\n * proposed subtree lands at the end of the canvas root. Not drawn while the\n * reader's permission refuses the door.\n */\nexport function AiGenerateSectionControl() {\n  const { onGenerateSection } = useContext(AiAssistActionsContext)\n  if (!onGenerateSection) return null\n  return (\n    <Tooltip title=\"Generate a section with AI\">\n      <IconButton\n        aria-label=\"generate section with ai\"\n        size=\"small\"\n        color=\"inherit\"\n        onClick={() => onGenerateSection()}\n      >\n        <MdiIcon fontSize=\"inherit\" path={mdiAutoFix.path} />\n      </IconButton>\n    </Tooltip>\n  )\n}\nAiGenerateSectionControl.displayName = 'AiGenerateSectionControl'\n\n/**\n * Rewrite with AI (AGL-89), under the selected element's fields through the\n * `besignerInspector` zone: opens the provider's instruction dialog for the\n * element. Drawn for an element the rewrite applies to, while the reader's\n * permission admits the door.\n */\nexport function AiRewriteControl(props: { node?: NodeSchema<any> | null }) {\n  const { onRewrite } = useContext(AiAssistActionsContext)\n  const node = props.node\n  if (!onRewrite || !node || !nodeTakesCopyRewrite(node)) return null\n  return (\n    <FormControl margin=\"none\" fullWidth>\n      <Button color=\"primary\" onClick={() => onRewrite(node)} fullWidth>\n        {'Rewrite with AI'}\n      </Button>\n    </FormControl>\n  )\n}\nAiRewriteControl.displayName = 'AiRewriteControl'\n"],"names":["FEATURE_FLAG","FieldComponentType","mdiAutoFix","MdiIcon","Button","FormControl","IconButton","Tooltip","useContext","AiAssistActionsContext","nodeTakesCopyRewrite","node","schema","componentSchema","textEditable","flags","DISABLED","ENABLED","hasTextAttributes","attributes","some","field","component","TEXT_FIELD","TEXTAREA","AiGenerateSectionControl","onGenerateSection","title","aria-label","size","color","onClick","fontSize","path","displayName","AiRewriteControl","props","onRewrite","margin","fullWidth"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,YAAY,EAAEC,kBAAkB,QAAyB,eAAc;AAChF,SAASC,UAAU,QAAQ,yBAAwB;AACnD,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,SAASC,MAAM,EAAEC,WAAW,EAAEC,UAAU,EAAEC,OAAO,QAAQ,gBAAe;AACxE,SAASC,UAAU,QAAQ,QAAO;AAClC,SAASC,sBAAsB,QAAQ,iCAA6B;AAEpE;;;;CAIC,GACD,OAAO,SAASC,qBAAqBC,IAAwC;;QAGvEC;IAFJ,MAAMA,SAASD,wBAAAA,KAAME,eAAe;IACpC,MAAMC,eACJ,AAAC,CAAA,SAACF,2BAAAA,gBAAAA,OAAQG,KAAK,qBAAbH,cAAeE,YAAY,mBAAId,aAAagB,QAAQ,IAAIhB,aAAaiB,OAAO,AAAD,MAAO;IACtF,MAAMC,oBAAoB,UAACN,0BAAAA,OAAQO,UAAU,oBAAI,EAAE,EAAEC,IAAI,CACvD,CAACC,QACCA,MAAMC,SAAS,KAAKrB,mBAAmBsB,UAAU,IACjDF,MAAMC,SAAS,KAAKrB,mBAAmBuB,QAAQ;IAEnD,OAAOV,gBAAgBI;AACzB;AAEA;;;;;CAKC,GACD,OAAO,SAASO;IACd,MAAM,EAAEC,iBAAiB,EAAE,GAAGlB,WAAWC;IACzC,IAAI,CAACiB,mBAAmB,OAAO;IAC/B,qBACE,KAACnB;QAAQoB,OAAM;kBACb,cAAA,KAACrB;YACCsB,cAAW;YACXC,MAAK;YACLC,OAAM;YACNC,SAAS,IAAML;sBAEf,cAAA,KAACvB;gBAAQ6B,UAAS;gBAAUC,MAAM/B,WAAW+B,IAAI;;;;AAIzD;AACAR,yBAAyBS,WAAW,GAAG;AAEvC;;;;;CAKC,GACD,OAAO,SAASC,iBAAiBC,KAAwC;IACvE,MAAM,EAAEC,SAAS,EAAE,GAAG7B,WAAWC;IACjC,MAAME,OAAOyB,MAAMzB,IAAI;IACvB,IAAI,CAAC0B,aAAa,CAAC1B,QAAQ,CAACD,qBAAqBC,OAAO,OAAO;IAC/D,qBACE,KAACN;QAAYiC,QAAO;QAAOC,SAAS;kBAClC,cAAA,KAACnC;YAAO0B,OAAM;YAAUC,SAAS,IAAMM,UAAU1B;YAAO4B,SAAS;sBAC9D;;;AAIT;AACAJ,iBAAiBD,WAAW,GAAG"}

package/src/lib/components/billing-ai-allotments.component.d.ts

@@ -0,0 +1,36 @@
+import type { AiAllotmentRowWire } from '../usage/ai-usage-wire';
+/** An allotment as a table cell reads it: used of credits, mode, models. */
+export declare function aiAllotmentSummary(row: Pick<AiAllotmentRowWire, 'credits' | 'mode' | 'models' | 'used'> | null | undefined): string;
+/** The color an allotment's figure reads in: warning from 80%, error at it. */
+export declare function aiAllotmentTone(row: Pick<AiAllotmentRowWire, 'credits' | 'used'> | null | undefined): 'text.primary' | 'warning.main' | 'error.main';
+/**
+ * AI ALLOTMENTS ON BILLING → USAGE (AGL-2942): who may draw how much of the
+ * workspace's AI pool.
+ *
+ * Team members and sites, each with this month's credits and its allotment;
+ * select several and set one allotment for all of them, or set the same
+ * allotment on every site at once — the agency's "same for every client
+ * site". Collaborators' allotments, which their sites' Users cards set, are
+ * listed below. On a plan that offers it, the organization's model
+ * restriction sits at the end.
+ *
+ * Read with `billing.view`; the controls appear with `billing.manage`, and
+ * the route refuses a write without it whatever this card draws.
+ */
+export declare function BillingAiAllotments({ orgId }: {
+    orgId?: string;
+}): import("react").JSX.Element;
+export declare namespace BillingAiAllotments {
+    var displayName: string;
+}
+/**
+ * The card on Billing → Usage, through the `orgBillingUsage` zone, beneath
+ * the table of who drew the credits. Registered with `billing.view`.
+ */
+export declare function AiAllotmentsCard(props: {
+    orgId?: string;
+}): import("react").JSX.Element;
+export declare namespace AiAllotmentsCard {
+    var displayName: string;
+}
+export default AiAllotmentsCard;