@aglyn/plugins-ai 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-theme-proposal-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 { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport type { HostThemeSource } from '@aglyn/aglyn/app-utils/marketplace-theme'\nimport type { ConsoleHostThemeZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins'\nimport type { HostThemeScheme } from '@aglyn/shared-data-types'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport { themeEditorControl } from '@aglyn/shared-ui-theme/util/theme-editor-fields'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  Box,\n  Button,\n  Chip,\n  CircularProgress,\n  Grid,\n  Stack,\n  Tab,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Tabs,\n  TextField,\n  ToggleButton,\n  ToggleButtonGroup,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  AI_JOB_TERMINAL_STATUSES,\n  type AiJobSummary,\n} from '../model/ai-jobs.types'\nimport {\n  aiThemeColorToken,\n  aiThemeProposalAfter,\n  aiThemeStaleChanges,\n  readAiThemeProposal,\n  type AiThemeControlChange,\n  type AiThemeCorrection,\n  type AiThemeProposal,\n  type AiThemeProposalMode,\n} from '../model/ai-theme-proposal'\nimport { readEventFrames } from './assist-jobs-drawer.component'\n\n/**\n * The theme assistant (AGL-2938), on the site's Theme section through the\n * `hostTheme` zone: a brief in, a theme proposal out, previewed before and\n * after with the editor's own preview, and put in the editor below as\n * unsaved changes when the person chooses. It never writes the theme — the\n * editor's Save does, through the same guarded path every edit takes.\n *\n * It renders nothing until the jobs route has answered for this workspace.\n * The shell has already decided the plan and the member's permission before\n * mounting it, but a released-off feature does not exist, and the release\n * flag is the route's to decide: a 404 there is this card staying absent.\n * The same read lists the site's recent proposals, so one made while the\n * person was elsewhere is still here to preview.\n */\n\n/** How many recent jobs the card reads to find this site's proposals. */\nconst RECENT_JOBS_READ = 20\n\n/** How many of this site's proposals the card offers again. */\nconst RECENT_PROPOSALS_SHOWN = 3\n\nconst BRIEF_MAX_CHARS = 4_000\n\nconst SOURCE_COPY: Record<HostThemeSource, string> = {\n  installed:\n    'Saved as your changes on top of the installed theme. The publisher’s version stays as it is and can still take an update.',\n  custom: 'Changes this site’s own theme.',\n  default:\n    'Only these values are stored. Everything else keeps following the default theme.',\n}\n\ntype Verdict = 'checking' | 'ready' | 'hidden'\n\nconst isTerminal = (job: AiJobSummary) => AI_JOB_TERMINAL_STATUSES.includes(job.status)\n\n/** The proposal a theme job produced, when it produced one. */\nfunction proposalOf(job: AiJobSummary | null): AiThemeProposal | null {\n  const output = job?.outputs.find((entry) => entry.resource === 'theme')\n  return output ? readAiThemeProposal(output.proposal) : null\n}\n\n/** A control's label, with its scheme when it has one. */\nfunction changeLabel(change: Pick<AiThemeControlChange, 'control' | 'scheme'>): string {\n  return themeEditorControl(change.control).label\n}\n\nfunction Swatch({ value }: { value: string | number | null }) {\n  if (value === null) {\n    return (\n      <Typography variant=\"caption\" color=\"text.secondary\">\n        {'Default'}\n      </Typography>\n    )\n  }\n  const text = String(value)\n  const color = typeof value === 'string' && /^#[0-9a-f]{6}$/i.test(value)\n  return (\n    <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n      {color ? (\n        <Box\n          aria-hidden\n          sx={{\n            width: 14,\n            height: 14,\n            borderRadius: 0.5,\n            border: 1,\n            borderColor: 'divider',\n            backgroundColor: text,\n            flexShrink: 0,\n          }}\n        />\n      ) : null}\n      <Typography variant=\"body2\" sx={{ fontFamily: 'monospace', wordBreak: 'break-all' }}>\n        {text}\n      </Typography>\n    </Stack>\n  )\n}\n\nfunction correctionText(correction: AiThemeCorrection): string {\n  const label = `${changeLabel(correction)} (${correction.scheme})`\n  if (correction.reason === 'dark-value') {\n    return `${label} set to ${correction.to} so the color keeps reading on the dark background.`\n  }\n  return (\n    `${label} moved to ${correction.to} to reach ${correction.required}:1` +\n    (correction.against?.length ? ` against ${correction.against.join(' and ')}` : '') +\n    (correction.ratio ? ` (it was ${correction.ratio}:1).` : '.')\n  )\n}\n\nexport function AiThemeProposalCard(props: ConsoleHostThemeZoneProps) {\n  const { hostId, orgId, theme, themeSource, ThemePreview, proposeDraft } = props\n  const { data: user } = useUser()\n  // Held in a ref so the reads below key on WHO is signed in, never on the\n  // identity of the object that says so.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid ?? null\n\n  const [verdict, setVerdict] = useState<Verdict>('checking')\n  const [notice, setNotice] = useState<string | null>(null)\n  const [recent, setRecent] = useState<AiJobSummary[]>([])\n  const [brief, setBrief] = useState('')\n  const [mode, setMode] = useState<AiThemeProposalMode>('modify')\n  const [busy, setBusy] = useState(false)\n  const [job, setJob] = useState<AiJobSummary | null>(null)\n  const [scheme, setScheme] = useState<HostThemeScheme>('light')\n  const [applied, setApplied] = useState<string | null>(null)\n  const watchRef = useRef<AbortController | null>(null)\n\n  useEffect(() => () => watchRef.current?.abort(), [])\n\n  useEffect(() => {\n    if (!orgId || !hostId || !uid) return\n    let active = true\n    setVerdict('checking')\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs?orgId=${encodeURIComponent(orgId)}&limit=${RECENT_JOBS_READ}`,\n        )\n        if (!active) return\n        // The flag off (404) and the plan without generation (403): the\n        // feature is not this workspace's, so the card is not here at all.\n        if (response.status === 404 || response.status === 403) {\n          setVerdict('hidden')\n          return\n        }\n        const payload = await response.json().catch(() => null)\n        if (!active) return\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(\n            locked\n              ? lockdownRefusalText(locked)\n              : String(payload?.error ?? 'Recent theme proposals could not be loaded.'),\n          )\n        } else {\n          const jobs = (payload?.jobs ?? []) as AiJobSummary[]\n          setRecent(\n            jobs\n              .filter((entry) => entry.kind === 'theme' && entry.hostId === hostId)\n              .filter((entry) => proposalOf(entry) !== null)\n              .slice(0, RECENT_PROPOSALS_SHOWN),\n          )\n        }\n        setVerdict('ready')\n      } catch {\n        if (!active) return\n        setNotice('Recent theme proposals could not be loaded.')\n        setVerdict('ready')\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, hostId, uid])\n\n  /** Follows a job through the events route until it settles. */\n  const watch = useCallback(async (jobId: string, org: string) => {\n    watchRef.current?.abort()\n    const controller = new AbortController()\n    watchRef.current = controller\n    let again = true\n    while (again && !controller.signal.aborted) {\n      again = false\n      try {\n        const response = await authorizedFetch(\n          userRef.current,\n          `/api/ai/jobs/${encodeURIComponent(jobId)}/events?orgId=${encodeURIComponent(org)}`,\n          { signal: controller.signal },\n        )\n        if (!response.ok || !response.body) return\n        await readEventFrames(response.body, (event) => {\n          if (event['type'] === 'state') setJob(event['job'] as AiJobSummary)\n          else if (event['type'] === 'reconnect') again = true\n        })\n      } catch {\n        return\n      }\n    }\n  }, [])\n\n  const propose = useCallback(async () => {\n    if (!orgId || !brief.trim()) return\n    setBusy(true)\n    setNotice(null)\n    setApplied(null)\n    try {\n      const response = await authorizedFetch(userRef.current, '/api/ai/jobs', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          orgId,\n          hostId,\n          kind: 'theme',\n          brief: brief.trim(),\n          inputs: { mode },\n        }),\n      })\n      const payload = await response.json().catch(() => null)\n      if (!response.ok) {\n        const locked = parseLockdownRefusal(response.status, payload)\n        setNotice(\n          locked\n            ? lockdownRefusalText(locked)\n            : String(payload?.error ?? 'The theme proposal could not be started — try again.'),\n        )\n        return\n      }\n      const next = payload?.job as AiJobSummary | undefined\n      if (!next) return\n      setJob(next)\n      if (!isTerminal(next)) await watch(next.id, orgId)\n    } catch {\n      setNotice('The theme proposal could not be started — try again.')\n    } finally {\n      setBusy(false)\n    }\n  }, [orgId, hostId, brief, mode, watch])\n\n  const proposal = useMemo(() => proposalOf(job), [job])\n  const after = useMemo(\n    () => (proposal ? aiThemeProposalAfter(theme, proposal) : null),\n    [theme, proposal],\n  )\n  const stale = useMemo(\n    () => (proposal ? aiThemeStaleChanges(theme, proposal).length > 0 : false),\n    [theme, proposal],\n  )\n\n  const apply = useCallback(() => {\n    if (!job || !after) return\n    proposeDraft(after.theme, job.id)\n    setApplied(job.id)\n  }, [job, after, proposeDraft])\n\n  if (verdict !== 'ready') return null\n\n  const running = Boolean(job && !isTerminal(job))\n\n  return (\n      <CardDisplay\n        contentGutterX\n        contentGutterY\n        header=\"Theme assistant\"\n        help={pluginDocsHelp('aiThemes', {\n          excerpt:\n            'Describe the change and get a proposal for every control the editor has, previewed before and after. Nothing is saved until you save it in the editor.',\n        })}\n      >\n        <Stack spacing={2}>\n          <ToggleButtonGroup\n            exclusive\n            size=\"small\"\n            value={mode}\n            onChange={(_, value: AiThemeProposalMode | null) => value && setMode(value)}\n            aria-label=\"What to propose\"\n          >\n            <ToggleButton value=\"modify\">{'Change what I describe'}</ToggleButton>\n            <ToggleButton value=\"create\">{'Design a new theme'}</ToggleButton>\n          </ToggleButtonGroup>\n          <TextField\n            multiline\n            minRows={2}\n            fullWidth\n            label=\"Describe the change\"\n            placeholder=\"Warmer, with a deep green primary and bigger headings on mobile\"\n            helperText=\"A hex color in your description is used exactly. Paste a link to borrow a page’s colors.\"\n            value={brief}\n            onChange={(event) => setBrief(event.target.value.slice(0, BRIEF_MAX_CHARS))}\n            disabled={busy}\n          />\n          <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n            <Button variant=\"contained\" disabled={busy || !brief.trim()} onClick={() => void propose()}>\n              {'Propose changes'}\n            </Button>\n            {running ? <CircularProgress size={18} aria-label=\"Working on a proposal\" /> : null}\n          </Stack>\n          {notice ? <Alert severity=\"warning\">{notice}</Alert> : null}\n\n          {job && job.error && !proposal ? (\n            <Alert severity={job.status === 'failed' ? 'error' : 'warning'}>{job.error}</Alert>\n          ) : null}\n\n          {!job && recent.length ? (\n            <Stack spacing={1}>\n              <Typography variant=\"subtitle2\">{'Recent proposals for this site'}</Typography>\n              {recent.map((entry) => (\n                <Stack key={entry.id} direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n                  <Typography variant=\"body2\" sx={{ flexGrow: 1, minWidth: 0 }} noWrap>\n                    {entry.brief}\n                  </Typography>\n                  <Button size=\"small\" onClick={() => setJob(entry)}>\n                    {'Show'}\n                  </Button>\n                </Stack>\n              ))}\n            </Stack>\n          ) : null}\n\n          {proposal && after ? (\n            <Stack spacing={2} aria-label=\"Theme proposal\">\n              {proposal.summary ? <Typography variant=\"body1\">{proposal.summary}</Typography> : null}\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {SOURCE_COPY[proposal.source]}\n              </Typography>\n              {stale ? (\n                <Alert severity=\"info\">\n                  {'The theme has changed since this proposal was made. The preview and the editor apply it to the theme as it is now.'}\n                </Alert>\n              ) : null}\n\n              {proposal.changes.length || proposal.components.length || proposal.resetComponents ? (\n                <Box>\n                  <ScrollTable size=\"small\" aria-label=\"Proposed changes\">\n                    <TableHead>\n                      <TableRow>\n                        <TableCell>{'Control'}</TableCell>\n                        <TableCell>{'Now'}</TableCell>\n                        <TableCell>{'Proposed'}</TableCell>\n                      </TableRow>\n                    </TableHead>\n                    <TableBody>\n                      {proposal.changes.map((change) => (\n                        <TableRow key={`${change.control}:${change.scheme ?? ''}`}>\n                          <TableCell>\n                            <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n                              <Typography variant=\"body2\">{changeLabel(change)}</Typography>\n                              {aiThemeColorToken(change.control) && change.scheme ? (\n                                <Chip size=\"small\" variant=\"outlined\" label={change.scheme} />\n                              ) : null}\n                            </Stack>\n                          </TableCell>\n                          <TableCell>\n                            <Swatch value={change.before} />\n                          </TableCell>\n                          <TableCell>\n                            <Swatch value={change.value} />\n                          </TableCell>\n                        </TableRow>\n                      ))}\n                      {proposal.resetComponents ? (\n                        <TableRow>\n                          <TableCell>{themeEditorControl('components').label}</TableCell>\n                          <TableCell>{'This site’s overrides'}</TableCell>\n                          <TableCell>{'Theme defaults'}</TableCell>\n                        </TableRow>\n                      ) : null}\n                      {proposal.components.map((leaf) => (\n                        <TableRow key={`${leaf.component}:${leaf.target}:${leaf.slot}:${leaf.media}:${leaf.property}`}>\n                          <TableCell>\n                            <Typography variant=\"body2\">\n                              {[\n                                leaf.component,\n                                leaf.target === 'defaultProps' ? 'default' : leaf.slot,\n                                leaf.property,\n                              ].join(' · ')}\n                            </Typography>\n                            {leaf.media ? <Chip size=\"small\" variant=\"outlined\" label={leaf.media} /> : null}\n                          </TableCell>\n                          <TableCell>{'—'}</TableCell>\n                          <TableCell>\n                            <Swatch value={typeof leaf.value === 'boolean' ? String(leaf.value) : leaf.value} />\n                          </TableCell>\n                        </TableRow>\n                      ))}\n                    </TableBody>\n                  </ScrollTable>\n                </Box>\n              ) : (\n                <Typography variant=\"body2\">{'No changes proposed.'}</Typography>\n              )}\n\n              {[...proposal.corrections, ...after.corrections].length ? (\n                <Stack spacing={0.5}>\n                  <Typography variant=\"subtitle2\">{'Adjusted for readability'}</Typography>\n                  {[...proposal.corrections, ...after.corrections].map((correction) => (\n                    <Typography\n                      key={`${correction.control}:${correction.scheme}:${correction.to}`}\n                      variant=\"body2\"\n                    >\n                      {correctionText(correction)}\n                    </Typography>\n                  ))}\n                </Stack>\n              ) : null}\n\n              {[...proposal.notes, ...after.notes, ...proposal.dropped].length ? (\n                <Stack spacing={0.5}>\n                  <Typography variant=\"subtitle2\">{'Worth knowing'}</Typography>\n                  {[...proposal.notes, ...after.notes].map((line) => (\n                    <Typography key={`note:${line}`} variant=\"body2\" color=\"text.secondary\">\n                      {line}\n                    </Typography>\n                  ))}\n                  {proposal.dropped.map((line) => (\n                    <Typography key={`dropped:${line}`} variant=\"body2\" color=\"text.secondary\">\n                      {`Left out — ${line}`}\n                    </Typography>\n                  ))}\n                </Stack>\n              ) : null}\n\n              <Tabs\n                value={scheme}\n                onChange={(_, value: HostThemeScheme) => setScheme(value)}\n                aria-label=\"Preview scheme\"\n              >\n                <Tab label=\"Light\" value=\"light\" />\n                <Tab label=\"Dark\" value=\"dark\" />\n              </Tabs>\n              <Grid container spacing={2}>\n                <Grid size={{ xs: 12, md: 6 }}>\n                  <Typography variant=\"subtitle2\" gutterBottom>\n                    {'Before'}\n                  </Typography>\n                  <Box data-preview=\"before\">\n                    <ThemePreview theme={theme ?? {}} scheme={scheme} />\n                  </Box>\n                </Grid>\n                <Grid size={{ xs: 12, md: 6 }}>\n                  <Typography variant=\"subtitle2\" gutterBottom>\n                    {'After'}\n                  </Typography>\n                  <Box data-preview=\"after\">\n                    <ThemePreview theme={after.theme} scheme={scheme} />\n                  </Box>\n                </Grid>\n              </Grid>\n\n              {applied === job?.id ? (\n                <Alert severity=\"success\">\n                  {'In the editor below as unsaved changes. Review them there, then Save — or Discard changes to go back.'}\n                </Alert>\n              ) : null}\n              <Stack direction=\"row\" spacing={1}>\n                <Button variant=\"contained\" onClick={apply} disabled={applied === job?.id}>\n                  {'Put in the editor'}\n                </Button>\n                <Button\n                  onClick={() => {\n                    setJob(null)\n                    setApplied(null)\n                  }}\n                >\n                  {'Dismiss'}\n                </Button>\n              </Stack>\n            </Stack>\n          ) : null}\n        </Stack>\n      </CardDisplay>\n  )\n}\nAiThemeProposalCard.displayName = 'AiThemeProposalCard'\n\nexport default AiThemeProposalCard\n"],"names":["lockdownRefusalText","parseLockdownRefusal","pluginDocsHelp","CardDisplay","ScrollTable","themeEditorControl","authorizedFetch","useUser","Alert","Box","Button","Chip","CircularProgress","Grid","Stack","Tab","TableBody","TableCell","TableHead","TableRow","Tabs","TextField","ToggleButton","ToggleButtonGroup","Typography","useCallback","useEffect","useMemo","useRef","useState","AI_JOB_TERMINAL_STATUSES","aiThemeColorToken","aiThemeProposalAfter","aiThemeStaleChanges","readAiThemeProposal","readEventFrames","RECENT_JOBS_READ","RECENT_PROPOSALS_SHOWN","BRIEF_MAX_CHARS","SOURCE_COPY","installed","custom","default","isTerminal","job","includes","status","proposalOf","output","outputs","find","entry","resource","proposal","changeLabel","change","control","label","Swatch","value","variant","color","text","String","test","direction","spacing","sx","alignItems","aria-hidden","width","height","borderRadius","border","borderColor","backgroundColor","flexShrink","fontFamily","wordBreak","correctionText","correction","scheme","reason","to","required","against","length","join","ratio","AiThemeProposalCard","props","hostId","orgId","theme","themeSource","ThemePreview","proposeDraft","data","user","userRef","current","uid","verdict","setVerdict","notice","setNotice","recent","setRecent","brief","setBrief","mode","setMode","busy","setBusy","setJob","setScheme","applied","setApplied","watchRef","abort","active","response","encodeURIComponent","payload","json","catch","ok","locked","error","jobs","filter","kind","slice","watch","jobId","org","controller","AbortController","again","signal","aborted","body","event","propose","trim","method","headers","JSON","stringify","inputs","next","id","after","stale","apply","running","Boolean","contentGutterX","contentGutterY","header","help","excerpt","exclusive","size","onChange","_","aria-label","multiline","minRows","fullWidth","placeholder","helperText","target","disabled","onClick","severity","map","flexGrow","minWidth","noWrap","summary","source","changes","components","resetComponents","before","leaf","component","slot","property","media","corrections","notes","dropped","line","container","xs","md","gutterBottom","data-preview","displayName"],"mappings":"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"}

package/src/lib/components/ai-usage-strip.component.d.ts

@@ -0,0 +1,27 @@
+import type { AiUsageMeterWire } from '../usage/ai-usage-wire';
+export interface AiUsageStripProps {
+    /** The workspace the strip speaks for; nothing renders without one. */
+    orgId?: string | null;
+    /** For the link to who can raise an allotment; the link is omitted without it. */
+    orgSlug?: string | null;
+}
+/** The line about the reader's own month, in the words the strip uses. */
+export declare function aiUsageStripMineLabel(meter: AiUsageMeterWire): string;
+/** The line about the workspace's pool. */
+export declare function aiUsageStripPoolLabel(meter: AiUsageMeterWire): string;
+/**
+ * THE USAGE STRIP (AGL-2942): the reader's AI credits while they use AI —
+ * in the assistant panel and every generation dialog, with no dashboard to
+ * visit and no read of its own.
+ *
+ * It shows the reader's month against the allotment that binds them (or
+ * their month alone and the workspace's pool when none does), the pool, what
+ * the last request cost, and the model that answered. From 80% it warns; at
+ * a hard allotment it says who can raise it. It renders nothing until a door
+ * has answered this reader in this workspace — see `use-ai-usage-meter.ts`.
+ */
+export declare function AiUsageStrip({ orgId, orgSlug }: AiUsageStripProps): import("react").JSX.Element;
+export declare namespace AiUsageStrip {
+    var displayName: string;
+}
+export default AiUsageStrip;

package/src/lib/components/ai-usage-strip.component.js

@@ -0,0 +1,145 @@
+/**
+ * @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, Fragment as _Fragment } from "react/jsx-runtime";
+import { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import { Box, LinearProgress, Stack, Typography } from "@mui/material";
+import { useAiUsageMeter } from "./use-ai-usage-meter.js";
+const credits = (value)=>value.toLocaleString();
+/** The line about the reader's own month, in the words the strip uses. */ export function aiUsageStripMineLabel(meter) {
+    const { mine } = meter;
+    if (mine.limit === null) return `You: ${credits(mine.used)} credits this month`;
+    const who = mine.scope === 'host' ? 'This site' : mine.scope === 'collab' ? 'You, on this site' : 'You';
+    return `${who}: ${credits(mine.used)} of ${credits(mine.limit)} credits this month`;
+}
+/** The line about the workspace's pool. */ export function aiUsageStripPoolLabel(meter) {
+    const { pool } = meter;
+    return pool.limit === null ? `Workspace: ${credits(pool.used)} credits` : `Workspace: ${credits(pool.used)} of ${credits(pool.limit)} credits`;
+}
+/**
+ * THE USAGE STRIP (AGL-2942): the reader's AI credits while they use AI —
+ * in the assistant panel and every generation dialog, with no dashboard to
+ * visit and no read of its own.
+ *
+ * It shows the reader's month against the allotment that binds them (or
+ * their month alone and the workspace's pool when none does), the pool, what
+ * the last request cost, and the model that answered. From 80% it warns; at
+ * a hard allotment it says who can raise it. It renders nothing until a door
+ * has answered this reader in this workspace — see `use-ai-usage-meter.ts`.
+ */ export function AiUsageStrip({ orgId, orgSlug }) {
+    const meter = useAiUsageMeter(orgId);
+    if (!meter) return null;
+    const { mine, pool } = meter;
+    const bound = mine.limit !== null;
+    const used = bound ? mine.used : pool.used;
+    const limit = bound ? mine.limit : pool.limit;
+    const pct = limit ? Math.min(100, Math.round(used / limit * 100)) : null;
+    const tone = meter.state === 'capped' ? 'error' : meter.state === 'warn' ? 'warning' : 'primary';
+    const allotmentReached = bound && mine.mode === 'hard' && mine.limit !== null && mine.used >= mine.limit;
+    const raiseHref = orgSlug && mine.scope !== 'collab' ? `${buildRoute(Route.MANAGE_BILLING_USAGE, {
+        orgSlug
+    })}#ai-allotments` : null;
+    const whose = !bound ? 'the workspace’s credits' : mine.scope === 'host' ? 'this site’s AI allotment' : 'your AI allotment';
+    return /*#__PURE__*/ _jsxs(Box, {
+        role: "status",
+        "aria-live": "polite",
+        "data-testid": "ai-usage-strip",
+        sx: {
+            px: 1,
+            py: 0.75,
+            borderRadius: 1,
+            bgcolor: 'action.hover'
+        },
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                sx: {
+                    alignItems: 'baseline',
+                    flexWrap: 'wrap'
+                },
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        sx: {
+                            flexGrow: 1
+                        },
+                        children: aiUsageStripMineLabel(meter)
+                    }),
+                    meter.last !== null ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: `Last request: ${credits(meter.last)} credits`
+                    }) : null
+                ]
+            }),
+            pct !== null ? /*#__PURE__*/ _jsx(LinearProgress, {
+                variant: "determinate",
+                value: pct,
+                color: tone,
+                "aria-label": `${pct}% of ${whose} used`,
+                sx: {
+                    my: 0.5,
+                    height: 4,
+                    borderRadius: 2
+                }
+            }) : null,
+            /*#__PURE__*/ _jsxs(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                component: "div",
+                children: [
+                    aiUsageStripPoolLabel(meter),
+                    bound ? '' : ' this month',
+                    meter.model ? ` · ${meter.model.label}${meter.model.auto ? ' (Auto)' : ''}` : ''
+                ]
+            }),
+            meter.state === 'warn' ? /*#__PURE__*/ _jsxs(Typography, {
+                variant: "caption",
+                color: "warning.main",
+                component: "div",
+                children: [
+                    `Past 80% of ${whose}.`,
+                    bound && mine.mode === 'soft' ? ' It is soft, so requests keep working.' : ''
+                ]
+            }) : null,
+            meter.state === 'capped' ? /*#__PURE__*/ _jsxs(Typography, {
+                variant: "caption",
+                color: "error",
+                component: "div",
+                children: [
+                    allotmentReached ? mine.scope === 'collab' ? 'Your AI allotment on this site is used for the month. The site’s admin, or an organization admin, can raise it.' : mine.scope === 'host' ? 'This site’s AI allotment is used for the month. An organization admin can raise it' : 'Your AI allotment is used for the month. An organization admin can raise it' : 'That request was stopped by a limit on this workspace.',
+                    allotmentReached && raiseHref ? /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            ' under ',
+                            /*#__PURE__*/ _jsx(AppLink, {
+                                componentVariant: "naked",
+                                href: raiseHref,
+                                children: 'Billing → Usage'
+                            }),
+                            '.'
+                        ]
+                    }) : allotmentReached && mine.scope !== 'collab' ? '.' : null
+                ]
+            }) : null
+        ]
+    });
+}
+AiUsageStrip.displayName = 'AiUsageStrip';
+export default AiUsageStrip;
+
+//# sourceMappingURL=ai-usage-strip.component.js.map

package/src/lib/components/ai-usage-strip.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/ai-usage-strip.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 { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport { AppLink } from '@aglyn/shared-ui-jsx'\nimport { Box, LinearProgress, Stack, Typography } from '@mui/material'\nimport type { AiUsageMeterWire } from '../usage/ai-usage-wire'\nimport { useAiUsageMeter } from './use-ai-usage-meter'\n\nexport interface AiUsageStripProps {\n  /** The workspace the strip speaks for; nothing renders without one. */\n  orgId?: string | null\n  /** For the link to who can raise an allotment; the link is omitted without it. */\n  orgSlug?: string | null\n}\n\nconst credits = (value: number): string => value.toLocaleString()\n\n/** The line about the reader's own month, in the words the strip uses. */\nexport function aiUsageStripMineLabel(meter: AiUsageMeterWire): string {\n  const { mine } = meter\n  if (mine.limit === null) return `You: ${credits(mine.used)} credits this month`\n  const who = mine.scope === 'host' ? 'This site' : mine.scope === 'collab' ? 'You, on this site' : 'You'\n  return `${who}: ${credits(mine.used)} of ${credits(mine.limit)} credits this month`\n}\n\n/** The line about the workspace's pool. */\nexport function aiUsageStripPoolLabel(meter: AiUsageMeterWire): string {\n  const { pool } = meter\n  return pool.limit === null\n    ? `Workspace: ${credits(pool.used)} credits`\n    : `Workspace: ${credits(pool.used)} of ${credits(pool.limit)} credits`\n}\n\n/**\n * THE USAGE STRIP (AGL-2942): the reader's AI credits while they use AI —\n * in the assistant panel and every generation dialog, with no dashboard to\n * visit and no read of its own.\n *\n * It shows the reader's month against the allotment that binds them (or\n * their month alone and the workspace's pool when none does), the pool, what\n * the last request cost, and the model that answered. From 80% it warns; at\n * a hard allotment it says who can raise it. It renders nothing until a door\n * has answered this reader in this workspace — see `use-ai-usage-meter.ts`.\n */\nexport function AiUsageStrip({ orgId, orgSlug }: AiUsageStripProps) {\n  const meter = useAiUsageMeter(orgId)\n  if (!meter) return null\n  const { mine, pool } = meter\n  const bound = mine.limit !== null\n  const used = bound ? mine.used : pool.used\n  const limit = bound ? mine.limit : pool.limit\n  const pct = limit ? Math.min(100, Math.round((used / limit) * 100)) : null\n  const tone = meter.state === 'capped' ? 'error' : meter.state === 'warn' ? 'warning' : 'primary'\n  const allotmentReached = bound && mine.mode === 'hard' && mine.limit !== null && mine.used >= mine.limit\n  const raiseHref =\n    orgSlug && mine.scope !== 'collab'\n      ? `${buildRoute(Route.MANAGE_BILLING_USAGE, { orgSlug })}#ai-allotments`\n      : null\n  const whose = !bound\n    ? 'the workspace’s credits'\n    : mine.scope === 'host'\n      ? 'this site’s AI allotment'\n      : 'your AI allotment'\n\n  return (\n    <Box\n      role=\"status\"\n      aria-live=\"polite\"\n      data-testid=\"ai-usage-strip\"\n      sx={{ px: 1, py: 0.75, borderRadius: 1, bgcolor: 'action.hover' }}\n    >\n      <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'baseline', flexWrap: 'wrap' }}>\n        <Typography variant=\"caption\" sx={{ flexGrow: 1 }}>\n          {aiUsageStripMineLabel(meter)}\n        </Typography>\n        {meter.last !== null ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {`Last request: ${credits(meter.last)} credits`}\n          </Typography>\n        ) : null}\n      </Stack>\n      {pct !== null ? (\n        <LinearProgress\n          variant=\"determinate\"\n          value={pct}\n          color={tone}\n          aria-label={`${pct}% of ${whose} used`}\n          sx={{ my: 0.5, height: 4, borderRadius: 2 }}\n        />\n      ) : null}\n      <Typography variant=\"caption\" color=\"text.secondary\" component=\"div\">\n        {aiUsageStripPoolLabel(meter)}\n        {bound ? '' : ' this month'}\n        {meter.model ? ` · ${meter.model.label}${meter.model.auto ? ' (Auto)' : ''}` : ''}\n      </Typography>\n      {meter.state === 'warn' ? (\n        <Typography variant=\"caption\" color=\"warning.main\" component=\"div\">\n          {`Past 80% of ${whose}.`}\n          {bound && mine.mode === 'soft' ? ' It is soft, so requests keep working.' : ''}\n        </Typography>\n      ) : null}\n      {meter.state === 'capped' ? (\n        <Typography variant=\"caption\" color=\"error\" component=\"div\">\n          {allotmentReached\n            ? mine.scope === 'collab'\n              ? 'Your AI allotment on this site is used for the month. The site’s admin, or an organization admin, can raise it.'\n              : mine.scope === 'host'\n                ? 'This site’s AI allotment is used for the month. An organization admin can raise it'\n                : 'Your AI allotment is used for the month. An organization admin can raise it'\n            : 'That request was stopped by a limit on this workspace.'}\n          {allotmentReached && raiseHref ? (\n            <>\n              {' under '}\n              <AppLink componentVariant=\"naked\" href={raiseHref}>\n                {'Billing → Usage'}\n              </AppLink>\n              {'.'}\n            </>\n          ) : allotmentReached && mine.scope !== 'collab' ? (\n            '.'\n          ) : null}\n        </Typography>\n      ) : null}\n    </Box>\n  )\n}\nAiUsageStrip.displayName = 'AiUsageStrip'\n\nexport default AiUsageStrip\n"],"names":["buildRoute","Route","AppLink","Box","LinearProgress","Stack","Typography","useAiUsageMeter","credits","value","toLocaleString","aiUsageStripMineLabel","meter","mine","limit","used","who","scope","aiUsageStripPoolLabel","pool","AiUsageStrip","orgId","orgSlug","bound","pct","Math","min","round","tone","state","allotmentReached","mode","raiseHref","MANAGE_BILLING_USAGE","whose","role","aria-live","data-testid","sx","px","py","borderRadius","bgcolor","direction","spacing","alignItems","flexWrap","variant","flexGrow","last","color","aria-label","my","height","component","model","label","auto","componentVariant","href","displayName"],"mappings":"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"}

package/src/lib/components/assist-edit-canvas.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ReusableComponentProp } from '@aglyn/aglyn/foundation/definitions/platform.types';
+import { type EditorSession } from '@aglyn/aglyn/plugin-manager/editor-sessions';
+import { type AssistEditCanvasContext, type AssistEditProposal } from '../model/assist-edit';
+/**
+ * The edit rung's client half (AGL-2906): what the panel tells the server
+ * about the open canvas, and how a confirmed proposal lands on it.
+ *
+ * Applying goes through the canvas's own guarded mutators — the same ones
+ * the besigner's panels and the marketing appliers use — inside ONE
+ * `batch`, so the whole proposal is one undo step and a guard that refuses
+ * part-way leaves nothing behind. Every change is an unsaved edit on the
+ * version the editor has open; saving it stays the author's act, with the
+ * editor's own control. A version the live site serves is never edited:
+ * the check refuses it, and the card offers the editor's own new-version
+ * flow instead.
+ */
+/** A node as the canvas holds it — the fields this module reads. */
+export interface AssistEditCanvasNodeLike {
+    $id?: string;
+    componentId?: string;
+    parentId?: string | null;
+    nodes?: string[];
+    name?: string;
+    props?: unknown;
+    sx?: unknown;
+}
+/**
+ * The slice of the besigner canvas the edit rung reads and drives. Every
+ * member is one `CanvasManager` already has, so the panel hands over the
+ * canvas itself and a spec hands over a real one.
+ */
+export interface AssistEditCanvas {
+    getNode(id: string): AssistEditCanvasNodeLike | undefined;
+    batch<T>(mutate: () => T): T;
+    updateNodeProps(node: any, props: any): void;
+    updateNodeFields(node: any, patch: any): void;
+    reparentNode(node: any, parent: any, index?: number): unknown;
+    deleteNode(node: any): unknown;
+    addNodeFromNested(nested: any, parent: any, index?: number): unknown;
+    nodeAcceptsChildren(node: any): boolean;
+    /** The whole document, which a component save reads its definition out of. */
+    toJSON(): {
+        nodes: Record<string, unknown>;
+    };
+    /** The document after a save: the promoted subtree swapped for an instance. */
+    applyNodes(nodes: any): unknown;
+}
+/**
+ * The canvas outline a question carries on the edit rung, in two tiers, until
+ * the cap.
+ *
+ * Described in full, settings and all: the document root, the selection's
+ * ancestors and the selection, the document's top-level sections, everything
+ * inside the selection — what an edit to it changes — and its siblings.
+ *
+ * Described briefly, by place alone (`brief`): what surrounds that, so the
+ * model knows it exists and asks for it rather than calling it missing —
+ *
+ * 1. what the selection's siblings hold, level by level (the icons beside a
+ *    selected link, in the card they share);
+ * 2. the siblings of each ancestor below the top-level section, nearest
+ *    first (the other cards of the row, then what sits beside the row).
+ *
+ * An element built the same way as the selection, or as the ancestor it sits
+ * beside, is marked `like` it and its contents are left out: one card
+ * described, and every other card of the row says it holds the same.
+ *
+ * With nothing selected, it is the root, the top-level sections and one level
+ * inside each: enough for a change to the page as a whole, and the prompt asks
+ * for a selection before anything more specific.
+ *
+ * An element is only ever described after its parent, so every ancestor chain
+ * the server checks is whole. `total` counts the document, and each element's
+ * `childCount` stays its real one, so the server can tell the model what the
+ * outline leaves out. The server holds this to its own limits before it quotes
+ * a byte of it; null when the canvas has no document root loaded.
+ */
+export declare function describeAssistEditCanvas(canvas: Pick<AssistEditCanvas, 'getNode'>, selectedId: string | null): AssistEditCanvasContext | null;
+/** Why a proposal cannot land on the open editor as it stands. */
+export type AssistEditRefusal = 
+/** No editor is open. */
+'no-editor'
+/** The editor open is not the document the proposal was made for. */
+ | 'other-document'
+/** The open version is the one the live site serves. */
+ | 'live-version'
+/** An element the proposal names has gone or changed since. */
+ | 'stale'
+/** The canvas's own guards refused part of the change. */
+ | 'refused';
+export type AssistEditCheck = {
+    ok: true;
+} | {
+    ok: false;
+    reason: AssistEditRefusal;
+    message: string;
+};
+export type AssistEditApplyResult = {
+    ok: true;
+    /** Applied ops, counted by kind for the activity row. */
+    opCounts: Record<string, number>;
+    /** Editor fields staged, as the editor keys them. */
+    staged: string[];
+} | {
+    ok: false;
+    reason: AssistEditRefusal;
+    message: string;
+};
+/**
+ * Whether the proposal can land on the open editor as it stands — checked in
+ * full before anything is touched, so a refusal never leaves half an edit.
+ */
+export declare function checkAssistEdit(canvas: Pick<AssistEditCanvas, 'getNode' | 'nodeAcceptsChildren'>, proposal: AssistEditProposal, session: EditorSession | undefined): AssistEditCheck;
+/** What the apply needs from the console to create the component. */
+export interface AssistEditComponentWriter {
+    /**
+     * Creates the component through `POST /api/hosts/resources`, where the
+     * plan's entitlement and the route's field allow-list are enforced, and
+     * answers its id. The plugin never writes Firestore from the browser.
+     */
+    createComponent(input: {
+        name: string;
+        rootId: string;
+        nodes: Record<string, unknown>;
+        props: ReusableComponentProp[];
+    }): Promise<string>;
+}
+/**
+ * Lands a confirmed proposal on the open editor: the canvas ops as ONE batch
+ * — one undo step, all or nothing — then any search fields staged into the
+ * editor's own form. Nothing is saved.
+ */
+export declare function applyAssistEdit(canvas: AssistEditCanvas, proposal: AssistEditProposal, session: EditorSession | undefined): AssistEditApplyResult;
+/**
+ * Lands a proposal that saves the selection as a reusable component
+ * (AGL-2908) — AGL-2866's recipe, in place, with no clipboard.
+ *
+ * The order is the manual action's order, and it matters:
+ *
+ * 1. the definition is read off the live subtree, each bound field replaced
+ *    by its token and its current value kept as that property's default;
+ * 2. the component is created through the host resources route, where the
+ *    server enforces the plan's entitlement and its own allow-list — so a
+ *    refusal happens before the open document is touched at all;
+ * 3. the subtree is swapped for an instance of what was just created, inside
+ *    ONE `batch` with the rest of the proposal's canvas ops: one undo step.
+ *
+ * The only document created is the component, exactly as Save as reusable
+ * component creates one. The page change is an unsaved edit on the version
+ * the editor has open, which the check has already refused to be a live one.
+ * Nothing is published and nothing is saved.
+ */
+export declare function applyAssistEditSavingComponent(canvas: AssistEditCanvas, proposal: AssistEditProposal, session: EditorSession | undefined, writer: AssistEditComponentWriter): Promise<AssistEditApplyResult>;