@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/use-ai-products-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-products-jobs.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { lockdownRefusalText, parseLockdownRefusal } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useHostOrgId, useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport { AI_JOB_TERMINAL_STATUSES, type AiJobSummary } from '../model/ai-jobs.types'\nimport { readEventFrames } from './assist-jobs-drawer.component'\n\n/**\n * The jobs route, as a commerce card asks it (AGL-2916): whether the feature\n * is this workspace's at all, the site's recent `products` jobs, starting one,\n * and following each until it settles.\n *\n * The shell has already decided the plan and the member's permission before a\n * card mounts; the release flag is the route's, so a 404 or 403 from the list\n * is the card staying absent. A card follows more than one job at a time — a\n * bulk copy job and a catalog, say — so each job has its own watch: every job\n * it starts, and of the jobs it finds already moving, the ones `follows`\n * names as its own.\n */\n\n/** How many recent jobs a card reads to find this site's products jobs. */\nexport const AI_PRODUCTS_RECENT_JOBS_READ = 20\n\nexport type AiProductsJobsVerdict = 'checking' | 'ready' | 'hidden'\n\nexport interface AiProductsJobs {\n  /** The org the jobs are metered against: the zone's, or the site's. */\n  orgId: string | undefined\n  verdict: AiProductsJobsVerdict\n  /** The site's recent `products` jobs, newest first, kept current while followed. */\n  jobs: AiJobSummary[]\n  notice: string | null\n  setNotice: (notice: string | null) => void\n  /** Starts a job and follows it; resolves with the job as created, or `null` with a notice. */\n  start: (brief: string, inputs: Record<string, string>) => Promise<AiJobSummary | null>\n}\n\nexport const isAiJobSettled = (job: AiJobSummary | null | undefined): boolean =>\n  Boolean(job && AI_JOB_TERMINAL_STATUSES.includes(job.status))\n\n/** Whether a job is moving now: queued or running, rather than settled or waiting for a person. */\nexport const isAiJobMoving = (job: AiJobSummary | null | undefined): boolean =>\n  job?.status === 'queued' || job?.status === 'running'\n\nconst START_FAILED_COPY = 'The AI job could not be started. Try again.'\nconst LIST_FAILED_COPY = 'Recent AI proposals could not be loaded.'\n\nexport function useAiProductsJobs(input: {\n  hostId: string\n  orgId: string | undefined\n  /** Which of the site's moving jobs this card shows, and so follows; none when absent. */\n  follows?: (job: AiJobSummary) => boolean\n}): AiProductsJobs {\n  const { hostId } = input\n  // Read through a ref: a card passes a fresh function each render, and the\n  // list is read once for who is signed in, not once for each.\n  const followsRef = useRef(input.follows)\n  followsRef.current = input.follows\n  // A plugin-hosted zone may not know the org; the site does.\n  const hostOrgId = useHostOrgId(input.orgId ? undefined : hostId)\n  const orgId = input.orgId ?? hostOrgId ?? undefined\n  const { data: user } = useUser()\n  // Held in a ref so the reads key on WHO is signed in, never on the identity\n  // 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<AiProductsJobsVerdict>('checking')\n  const [jobs, setJobs] = useState<AiJobSummary[]>([])\n  const [notice, setNotice] = useState<string | null>(null)\n  const watches = useRef(new Map<string, AbortController>())\n\n  useEffect(() => {\n    const open = watches.current\n    return () => {\n      for (const controller of open.values()) controller.abort()\n      open.clear()\n    }\n  }, [])\n\n  const put = useCallback((job: AiJobSummary) => {\n    setJobs((current) => [job, ...current.filter((entry) => entry.id !== job.id)].sort((a, b) =>\n      b.createdAt.localeCompare(a.createdAt),\n    ))\n  }, [])\n\n  /** Follows one job through the events route until it settles. */\n  const follow = useCallback(\n    async (job: AiJobSummary, org: string) => {\n      if (!isAiJobMoving(job) || watches.current.has(job.id)) return\n      const controller = new AbortController()\n      watches.current.set(job.id, controller)\n      try {\n        let again = true\n        while (again && !controller.signal.aborted) {\n          again = false\n          const response = await authorizedFetch(\n            userRef.current,\n            `/api/ai/jobs/${encodeURIComponent(job.id)}/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') put(event['job'] as AiJobSummary)\n            else if (event['type'] === 'reconnect') again = true\n          })\n        }\n      } catch {\n        // An aborted or dropped watch leaves the last state shown.\n      } finally {\n        watches.current.delete(job.id)\n      }\n    },\n    [put],\n  )\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=${AI_PRODUCTS_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(locked ? lockdownRefusalText(locked) : String(payload?.error ?? LIST_FAILED_COPY))\n        } else {\n          const recent = ((payload?.jobs ?? []) as AiJobSummary[]).filter(\n            (entry) => entry.kind === 'products' && entry.hostId === hostId,\n          )\n          setJobs(recent)\n          for (const job of recent) {\n            if (followsRef.current?.(job)) void follow(job, orgId)\n          }\n        }\n        setVerdict('ready')\n      } catch {\n        if (!active) return\n        setNotice(LIST_FAILED_COPY)\n        setVerdict('ready')\n      }\n    })()\n    return () => {\n      active = false\n    }\n  }, [orgId, hostId, uid, follow])\n\n  const start = useCallback(\n    async (brief: string, inputs: Record<string, string>) => {\n      if (!orgId) return null\n      setNotice(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({ orgId, hostId, kind: 'products', brief, inputs }),\n        })\n        const payload = await response.json().catch(() => null)\n        if (!response.ok) {\n          const locked = parseLockdownRefusal(response.status, payload)\n          setNotice(locked ? lockdownRefusalText(locked) : String(payload?.error ?? START_FAILED_COPY))\n          return null\n        }\n        const job = payload?.job as AiJobSummary | undefined\n        if (!job) return null\n        put(job)\n        void follow(job, orgId)\n        return job\n      } catch {\n        setNotice(START_FAILED_COPY)\n        return null\n      }\n    },\n    [orgId, hostId, put, follow],\n  )\n\n  return { orgId, verdict, jobs, notice, setNotice, start }\n}\n"],"names":["lockdownRefusalText","parseLockdownRefusal","authorizedFetch","useHostOrgId","useUser","useCallback","useEffect","useRef","useState","AI_JOB_TERMINAL_STATUSES","readEventFrames","AI_PRODUCTS_RECENT_JOBS_READ","isAiJobSettled","job","Boolean","includes","status","isAiJobMoving","START_FAILED_COPY","LIST_FAILED_COPY","useAiProductsJobs","input","hostId","followsRef","follows","current","hostOrgId","orgId","undefined","data","user","userRef","uid","verdict","setVerdict","jobs","setJobs","notice","setNotice","watches","Map","open","controller","values","abort","clear","put","filter","entry","id","sort","a","b","createdAt","localeCompare","follow","org","has","AbortController","set","again","signal","aborted","response","encodeURIComponent","ok","body","event","delete","active","payload","json","catch","locked","String","error","recent","kind","start","brief","inputs","method","headers","JSON","stringify"],"mappings":"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"}

package/src/lib/components/use-ai-usage-meter.d.ts

@@ -0,0 +1,11 @@
+import type { AiUsageMeterWire } from '../usage/ai-usage-wire';
+/** Whether a value is an envelope a strip can render. */
+export declare function isAiUsageMeterWire(value: unknown): value is AiUsageMeterWire;
+/** Hand a door's envelope to every strip for this reader and workspace. */
+export declare function publishAiUsageMeter(uid: string | null | undefined, orgId: string | null | undefined, meter: unknown): void;
+/** Forget every envelope; specs start each case from nothing. */
+export declare function resetAiUsageMetersForTests(): void;
+/** The latest envelope for the signed-in reader in one workspace. */
+export declare function useAiUsageMeter(orgId: string | null | undefined): AiUsageMeterWire | null;
+/** A stable publisher bound to the signed-in reader and one workspace. */
+export declare function usePublishAiUsageMeter(orgId: string | null | undefined): (meter: unknown) => void;

package/src/lib/components/use-ai-usage-meter.js

@@ -0,0 +1,96 @@
+/**
+ * @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 { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useState } from "react";
+const meters = new Map();
+const listeners = new Map();
+const keyOf = (uid, orgId)=>`${uid}\x00${orgId}`;
+const storageKey = (uid, orgId)=>`aglyn-ai-meter:${uid}:${orgId}`;
+const monthNow = ()=>new Date().toISOString().slice(0, 7);
+/** Whether a value is an envelope a strip can render. */ export function isAiUsageMeterWire(value) {
+    var _meter_pool, _meter_mine;
+    const meter = value;
+    return Boolean(meter && typeof meter === 'object' && typeof meter.month === 'string' && typeof ((_meter_pool = meter.pool) == null ? void 0 : _meter_pool.used) === 'number' && typeof ((_meter_mine = meter.mine) == null ? void 0 : _meter_mine.used) === 'number' && typeof meter.state === 'string');
+}
+function hydrate(uid, orgId) {
+    try {
+        var _globalThis_localStorage;
+        const raw = (_globalThis_localStorage = globalThis.localStorage) == null ? void 0 : _globalThis_localStorage.getItem(storageKey(uid, orgId));
+        const parsed = raw ? JSON.parse(raw) : null;
+        return isAiUsageMeterWire(parsed) && parsed.month === monthNow() ? parsed : null;
+    } catch (unused) {
+        return null;
+    }
+}
+/** Hand a door's envelope to every strip for this reader and workspace. */ export function publishAiUsageMeter(uid, orgId, meter) {
+    var _listeners_get;
+    if (!uid || !orgId || !isAiUsageMeterWire(meter)) return;
+    const key = keyOf(uid, orgId);
+    meters.set(key, meter);
+    try {
+        var _globalThis_localStorage;
+        (_globalThis_localStorage = globalThis.localStorage) == null ? void 0 : _globalThis_localStorage.setItem(storageKey(uid, orgId), JSON.stringify(meter));
+    } catch (unused) {
+    // Full or blocked storage keeps the strip for this page only.
+    }
+    for (const listener of (_listeners_get = listeners.get(key)) != null ? _listeners_get : [])listener(meter);
+}
+/** Forget every envelope; specs start each case from nothing. */ export function resetAiUsageMetersForTests() {
+    meters.clear();
+    listeners.clear();
+}
+/** The latest envelope for the signed-in reader in one workspace. */ export function useAiUsageMeter(orgId) {
+    var _ref;
+    const { data: user } = useUser();
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const key = uid && orgId ? keyOf(uid, orgId) : null;
+    const [meter, setMeter] = useState(()=>{
+        var _meters_get;
+        return key ? (_meters_get = meters.get(key)) != null ? _meters_get : null : null;
+    });
+    useEffect(()=>{
+        var _meters_get, _listeners_get;
+        if (!key || !uid || !orgId) {
+            setMeter(null);
+            return undefined;
+        }
+        if (!meters.has(key)) meters.set(key, hydrate(uid, orgId));
+        setMeter((_meters_get = meters.get(key)) != null ? _meters_get : null);
+        const subscribed = (_listeners_get = listeners.get(key)) != null ? _listeners_get : new Set();
+        listeners.set(key, subscribed);
+        subscribed.add(setMeter);
+        return ()=>{
+            subscribed.delete(setMeter);
+        };
+    }, [
+        key,
+        uid,
+        orgId
+    ]);
+    return meter;
+}
+/** A stable publisher bound to the signed-in reader and one workspace. */ export function usePublishAiUsageMeter(orgId) {
+    var _ref;
+    const { data: user } = useUser();
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    return useCallback((meter)=>publishAiUsageMeter(uid, orgId, meter), [
+        uid,
+        orgId
+    ]);
+}
+
+//# sourceMappingURL=use-ai-usage-meter.js.map

package/src/lib/components/use-ai-usage-meter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-ai-usage-meter.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useState } from 'react'\nimport type { AiUsageMeterWire } from '../usage/ai-usage-wire'\n\n/**\n * THE USAGE STRIP'S STORE (AGL-2942).\n *\n * Every AI door answers with a `meter` envelope — the chat door's `done`\n * event, the copy assistant's JSON, each refusal — and the surface that sent\n * the request hands it here. Every strip mounted for the same person and the\n * same workspace — the panel's, a dialog's — reads the latest one, so a\n * rewrite in the besigner moves the panel's strip too, and no strip ever\n * reads anything itself.\n *\n * The last envelope is kept in the browser for the rest of its month, so a\n * reload shows where the reader stood at their last request rather than an\n * empty strip until the next one. It is labeled as of that request by\n * construction: nothing refreshes it but a door's answer.\n *\n * Keyed on WHO is signed in, never on the user object, whose identity a\n * provider may hand back fresh on every render.\n */\n\ntype Listener = (meter: AiUsageMeterWire | null) => void\n\nconst meters = new Map<string, AiUsageMeterWire | null>()\nconst listeners = new Map<string, Set<Listener>>()\n\nconst keyOf = (uid: string, orgId: string): string => `${uid}\\x00${orgId}`\nconst storageKey = (uid: string, orgId: string): string => `aglyn-ai-meter:${uid}:${orgId}`\nconst monthNow = (): string => new Date().toISOString().slice(0, 7)\n\n/** Whether a value is an envelope a strip can render. */\nexport function isAiUsageMeterWire(value: unknown): value is AiUsageMeterWire {\n  const meter = value as Partial<AiUsageMeterWire> | null\n  return Boolean(\n    meter &&\n      typeof meter === 'object' &&\n      typeof meter.month === 'string' &&\n      typeof meter.pool?.used === 'number' &&\n      typeof meter.mine?.used === 'number' &&\n      typeof meter.state === 'string',\n  )\n}\n\nfunction hydrate(uid: string, orgId: string): AiUsageMeterWire | null {\n  try {\n    const raw = globalThis.localStorage?.getItem(storageKey(uid, orgId))\n    const parsed: unknown = raw ? JSON.parse(raw) : null\n    return isAiUsageMeterWire(parsed) && parsed.month === monthNow() ? parsed : null\n  } catch {\n    return null\n  }\n}\n\n/** Hand a door's envelope to every strip for this reader and workspace. */\nexport function publishAiUsageMeter(\n  uid: string | null | undefined,\n  orgId: string | null | undefined,\n  meter: unknown,\n): void {\n  if (!uid || !orgId || !isAiUsageMeterWire(meter)) return\n  const key = keyOf(uid, orgId)\n  meters.set(key, meter)\n  try {\n    globalThis.localStorage?.setItem(storageKey(uid, orgId), JSON.stringify(meter))\n  } catch {\n    // Full or blocked storage keeps the strip for this page only.\n  }\n  for (const listener of listeners.get(key) ?? []) listener(meter)\n}\n\n/** Forget every envelope; specs start each case from nothing. */\nexport function resetAiUsageMetersForTests(): void {\n  meters.clear()\n  listeners.clear()\n}\n\n/** The latest envelope for the signed-in reader in one workspace. */\nexport function useAiUsageMeter(orgId: string | null | undefined): AiUsageMeterWire | null {\n  const { data: user } = useUser()\n  const uid = user?.uid ?? null\n  const key = uid && orgId ? keyOf(uid, orgId) : null\n  const [meter, setMeter] = useState<AiUsageMeterWire | null>(() =>\n    key ? (meters.get(key) ?? null) : null,\n  )\n  useEffect(() => {\n    if (!key || !uid || !orgId) {\n      setMeter(null)\n      return undefined\n    }\n    if (!meters.has(key)) meters.set(key, hydrate(uid, orgId))\n    setMeter(meters.get(key) ?? null)\n    const subscribed = listeners.get(key) ?? new Set<Listener>()\n    listeners.set(key, subscribed)\n    subscribed.add(setMeter)\n    return () => {\n      subscribed.delete(setMeter)\n    }\n  }, [key, uid, orgId])\n  return meter\n}\n\n/** A stable publisher bound to the signed-in reader and one workspace. */\nexport function usePublishAiUsageMeter(\n  orgId: string | null | undefined,\n): (meter: unknown) => void {\n  const { data: user } = useUser()\n  const uid = user?.uid ?? null\n  return useCallback((meter: unknown) => publishAiUsageMeter(uid, orgId, meter), [uid, orgId])\n}\n"],"names":["useUser","useCallback","useEffect","useState","meters","Map","listeners","keyOf","uid","orgId","storageKey","monthNow","Date","toISOString","slice","isAiUsageMeterWire","value","meter","Boolean","month","pool","used","mine","state","hydrate","globalThis","raw","localStorage","getItem","parsed","JSON","parse","publishAiUsageMeter","key","set","setItem","stringify","listener","get","resetAiUsageMetersForTests","clear","useAiUsageMeter","data","user","setMeter","undefined","has","subscribed","Set","add","delete","usePublishAiUsageMeter"],"mappings":"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"}

package/src/lib/components/use-org-ai-usage.d.ts

@@ -0,0 +1,42 @@
+import type { OrgAiUsageTableWire } from '../usage/ai-usage-wire';
+/**
+ * Loading, answered, refused, or failed — four states, never three
+ * (AGL-2928).
+ *
+ * `refused` is its own state because three surfaces read this and only one
+ * of them is gated on the permission the route checks: the roster and the
+ * site collaborators card are open to a member who manages people and may
+ * not see billing, and for them a 403 is the ordinary answer — the column
+ * renders a dash, not an error. Folding it into `error` would paint a
+ * warning on every team page whose admin lacks `billing.view`.
+ */
+export type OrgAiUsageStatus = 'loading' | 'ready' | 'refused' | 'error';
+export interface OrgAiUsageState {
+    status: OrgAiUsageStatus;
+    data: OrgAiUsageTableWire | null;
+    /** The month the table describes, whether or not it has answered yet. */
+    month: string;
+    /** The months a reader may pick, newest first. */
+    months: string[];
+    /** Credits by uid for the month — the roster column's join. */
+    creditsByUid: Map<string, number>;
+    /** Credits on the named site by uid, when a site was named. */
+    hostCreditsByUid: Map<string, number>;
+    /** Reads the month again, for every mount sharing it. */
+    reload: () => void;
+}
+/** Forget every shared read; specs start each case from nothing. */
+export declare function resetOrgAiUsageReadsForTests(): void;
+/**
+ * One month of the per-user rollup for one org, through `/api/ai/usage`.
+ *
+ * Pass `hostId` to have each row carry its credits on that site. Pass
+ * `enabled: false` to hold the read — a card that is not yet sure of its
+ * org id, or a viewer the gate has already refused.
+ */
+export declare function useOrgAiUsage(orgId: string | null | undefined, options?: {
+    month?: string;
+    hostId?: string;
+    enabled?: boolean;
+}): OrgAiUsageState;
+export default useOrgAiUsage;

package/src/lib/components/use-org-ai-usage.js

@@ -0,0 +1,181 @@
+/**
+ * @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 { aiUsageMonthKeys } from "../model/ai-usage-by-user.js";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+const LOADING = {
+    status: 'loading',
+    data: null
+};
+const sharedReads = new Map();
+/** Forget every shared read; specs start each case from nothing. */ export function resetOrgAiUsageReadsForTests() {
+    sharedReads.clear();
+}
+function publish(entry, read) {
+    entry.read = read;
+    for (const listener of entry.listeners)listener(read);
+}
+async function readInto(entry, user, query) {
+    entry.generation += 1;
+    const generation = entry.generation;
+    publish(entry, {
+        status: 'loading',
+        data: entry.read.data
+    });
+    try {
+        const response = await authorizedFetch(user, `/api/ai/usage?${query}`);
+        if (generation !== entry.generation) return;
+        if (response.status === 403) {
+            publish(entry, {
+                status: 'refused',
+                data: null
+            });
+            return;
+        }
+        const payload = await response.json().catch(()=>null);
+        if (generation !== entry.generation) return;
+        if (!response.ok || !payload) {
+            publish(entry, {
+                status: 'error',
+                data: null
+            });
+            return;
+        }
+        publish(entry, {
+            status: 'ready',
+            data: payload
+        });
+    } catch (unused) {
+        if (generation === entry.generation) publish(entry, {
+            status: 'error',
+            data: null
+        });
+    }
+}
+/**
+ * One month of the per-user rollup for one org, through `/api/ai/usage`.
+ *
+ * Pass `hostId` to have each row carry its credits on that site. Pass
+ * `enabled: false` to hold the read — a card that is not yet sure of its
+ * org id, or a viewer the gate has already refused.
+ */ export function useOrgAiUsage(orgId, options = {}) {
+    var _ref, _options_month, _options_hostId, _ref1;
+    var _read_data;
+    const { data: user } = useUser();
+    // The read is keyed on WHO is signed in, not on the user object's identity:
+    // a provider (or a test double) that hands back a fresh object per render
+    // would otherwise re-run the effect on every paint and never settle.
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const userRef = useRef(user);
+    userRef.current = user;
+    const fallbackMonths = useMemo(()=>aiUsageMonthKeys(), []);
+    const month = (_options_month = options.month) != null ? _options_month : fallbackMonths[0];
+    const hostId = (_options_hostId = options.hostId) != null ? _options_hostId : '';
+    const enabled = options.enabled !== false;
+    const key = orgId && uid && enabled ? [
+        uid,
+        orgId,
+        month,
+        hostId
+    ].join('\x00') : null;
+    const query = useMemo(()=>{
+        if (!orgId) return '';
+        const params = new URLSearchParams({
+            orgId,
+            month
+        });
+        if (hostId) params.set('hostId', hostId);
+        return params.toString();
+    }, [
+        orgId,
+        month,
+        hostId
+    ]);
+    const [read, setRead] = useState(()=>{
+        var _ref;
+        var _sharedReads_get;
+        return (_ref = key ? (_sharedReads_get = sharedReads.get(key)) == null ? void 0 : _sharedReads_get.read : undefined) != null ? _ref : LOADING;
+    });
+    useEffect(()=>{
+        const signedIn = userRef.current;
+        if (!key || !signedIn) return undefined;
+        let entry = sharedReads.get(key);
+        if (!entry) {
+            entry = {
+                read: LOADING,
+                listeners: new Set(),
+                generation: 0
+            };
+            sharedReads.set(key, entry);
+        }
+        const shared = entry;
+        const first = shared.listeners.size === 0;
+        shared.listeners.add(setRead);
+        setRead(shared.read);
+        if (first) void readInto(shared, signedIn, query);
+        return ()=>{
+            shared.listeners.delete(setRead);
+        };
+    }, [
+        key,
+        query
+    ]);
+    const reload = useCallback(()=>{
+        const signedIn = userRef.current;
+        const entry = key ? sharedReads.get(key) : undefined;
+        if (entry && signedIn) void readInto(entry, signedIn, query);
+    }, [
+        key,
+        query
+    ]);
+    const creditsByUid = useMemo(()=>{
+        var _ref;
+        var _read_data;
+        return new Map(((_ref = (_read_data = read.data) == null ? void 0 : _read_data.rows) != null ? _ref : []).map((row)=>[
+                row.uid,
+                row.credits
+            ]));
+    }, [
+        read.data
+    ]);
+    const hostCreditsByUid = useMemo(()=>{
+        var _ref;
+        var _read_data;
+        return new Map(((_ref = (_read_data = read.data) == null ? void 0 : _read_data.rows) != null ? _ref : []).map((row)=>{
+            var _row_hostCredits;
+            return [
+                row.uid,
+                (_row_hostCredits = row.hostCredits) != null ? _row_hostCredits : 0
+            ];
+        }));
+    }, [
+        read.data
+    ]);
+    return {
+        status: key ? read.status : 'loading',
+        data: key ? read.data : null,
+        month,
+        months: (_ref1 = (_read_data = read.data) == null ? void 0 : _read_data.months) != null ? _ref1 : fallbackMonths,
+        creditsByUid,
+        hostCreditsByUid,
+        reload
+    };
+}
+export default useOrgAiUsage;
+
+//# sourceMappingURL=use-org-ai-usage.js.map

package/src/lib/components/use-org-ai-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-org-ai-usage.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { aiUsageMonthKeys } from '../model/ai-usage-by-user'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport type { OrgAiUsageTableWire } from '../usage/ai-usage-wire'\n\n/**\n * Loading, answered, refused, or failed — four states, never three\n * (AGL-2928).\n *\n * `refused` is its own state because three surfaces read this and only one\n * of them is gated on the permission the route checks: the roster and the\n * site collaborators card are open to a member who manages people and may\n * not see billing, and for them a 403 is the ordinary answer — the column\n * renders a dash, not an error. Folding it into `error` would paint a\n * warning on every team page whose admin lacks `billing.view`.\n */\nexport type OrgAiUsageStatus = 'loading' | 'ready' | 'refused' | 'error'\n\nexport interface OrgAiUsageState {\n  status: OrgAiUsageStatus\n  data: OrgAiUsageTableWire | null\n  /** The month the table describes, whether or not it has answered yet. */\n  month: string\n  /** The months a reader may pick, newest first. */\n  months: string[]\n  /** Credits by uid for the month — the roster column's join. */\n  creditsByUid: Map<string, number>\n  /** Credits on the named site by uid, when a site was named. */\n  hostCreditsByUid: Map<string, number>\n  /** Reads the month again, for every mount sharing it. */\n  reload: () => void\n}\n\ninterface OrgAiUsageRead {\n  status: OrgAiUsageStatus\n  data: OrgAiUsageTableWire | null\n}\n\n/**\n * One read of one month, shared by every mount that asks for it.\n *\n * A roster column is mounted once per ROW, so a read per mount would send\n * one request per member for the same table. Mounts of the same reader, org,\n * month and site subscribe to one entry instead: the first subscriber reads,\n * the rest take its answer, and `reload` reads again for all of them. An\n * answer that arrives after a newer read has started is dropped.\n */\ninterface SharedRead {\n  read: OrgAiUsageRead\n  listeners: Set<(read: OrgAiUsageRead) => void>\n  generation: number\n}\n\nconst LOADING: OrgAiUsageRead = { status: 'loading', data: null }\n\nconst sharedReads = new Map<string, SharedRead>()\n\n/** Forget every shared read; specs start each case from nothing. */\nexport function resetOrgAiUsageReadsForTests(): void {\n  sharedReads.clear()\n}\n\nfunction publish(entry: SharedRead, read: OrgAiUsageRead): void {\n  entry.read = read\n  for (const listener of entry.listeners) listener(read)\n}\n\nasync function readInto(\n  entry: SharedRead,\n  user: Parameters<typeof authorizedFetch>[0],\n  query: string,\n): Promise<void> {\n  entry.generation += 1\n  const generation = entry.generation\n  publish(entry, { status: 'loading', data: entry.read.data })\n  try {\n    const response = await authorizedFetch(user, `/api/ai/usage?${query}`)\n    if (generation !== entry.generation) return\n    if (response.status === 403) {\n      publish(entry, { status: 'refused', data: null })\n      return\n    }\n    const payload = await response.json().catch(() => null)\n    if (generation !== entry.generation) return\n    if (!response.ok || !payload) {\n      publish(entry, { status: 'error', data: null })\n      return\n    }\n    publish(entry, { status: 'ready', data: payload as OrgAiUsageTableWire })\n  } catch {\n    if (generation === entry.generation) publish(entry, { status: 'error', data: null })\n  }\n}\n\n/**\n * One month of the per-user rollup for one org, through `/api/ai/usage`.\n *\n * Pass `hostId` to have each row carry its credits on that site. Pass\n * `enabled: false` to hold the read — a card that is not yet sure of its\n * org id, or a viewer the gate has already refused.\n */\nexport function useOrgAiUsage(\n  orgId: string | null | undefined,\n  options: { month?: string; hostId?: string; enabled?: boolean } = {},\n): OrgAiUsageState {\n  const { data: user } = useUser()\n  // The read is keyed on WHO is signed in, not on the user object's identity:\n  // a provider (or a test double) that hands back a fresh object per render\n  // would otherwise re-run the effect on every paint and never settle.\n  const uid = user?.uid ?? null\n  const userRef = useRef(user)\n  userRef.current = user\n  const fallbackMonths = useMemo(() => aiUsageMonthKeys(), [])\n  const month = options.month ?? fallbackMonths[0]\n  const hostId = options.hostId ?? ''\n  const enabled = options.enabled !== false\n  const key = orgId && uid && enabled ? [uid, orgId, month, hostId].join('\\x00') : null\n  const query = useMemo(() => {\n    if (!orgId) return ''\n    const params = new URLSearchParams({ orgId, month })\n    if (hostId) params.set('hostId', hostId)\n    return params.toString()\n  }, [orgId, month, hostId])\n  const [read, setRead] = useState<OrgAiUsageRead>(\n    () => (key ? sharedReads.get(key)?.read : undefined) ?? LOADING,\n  )\n\n  useEffect(() => {\n    const signedIn = userRef.current\n    if (!key || !signedIn) return undefined\n    let entry = sharedReads.get(key)\n    if (!entry) {\n      entry = { read: LOADING, listeners: new Set(), generation: 0 }\n      sharedReads.set(key, entry)\n    }\n    const shared = entry\n    const first = shared.listeners.size === 0\n    shared.listeners.add(setRead)\n    setRead(shared.read)\n    if (first) void readInto(shared, signedIn, query)\n    return () => {\n      shared.listeners.delete(setRead)\n    }\n  }, [key, query])\n\n  const reload = useCallback(() => {\n    const signedIn = userRef.current\n    const entry = key ? sharedReads.get(key) : undefined\n    if (entry && signedIn) void readInto(entry, signedIn, query)\n  }, [key, query])\n\n  const creditsByUid = useMemo(\n    () => new Map((read.data?.rows ?? []).map((row) => [row.uid, row.credits])),\n    [read.data],\n  )\n  const hostCreditsByUid = useMemo(\n    () =>\n      new Map(\n        (read.data?.rows ?? []).map((row) => [row.uid, row.hostCredits ?? 0]),\n      ),\n    [read.data],\n  )\n\n  return {\n    status: key ? read.status : 'loading',\n    data: key ? read.data : null,\n    month,\n    months: read.data?.months ?? fallbackMonths,\n    creditsByUid,\n    hostCreditsByUid,\n    reload,\n  }\n}\n\nexport default useOrgAiUsage\n"],"names":["aiUsageMonthKeys","authorizedFetch","useUser","useCallback","useEffect","useMemo","useRef","useState","LOADING","status","data","sharedReads","Map","resetOrgAiUsageReadsForTests","clear","publish","entry","read","listener","listeners","readInto","user","query","generation","response","payload","json","catch","ok","useOrgAiUsage","orgId","options","uid","userRef","current","fallbackMonths","month","hostId","enabled","key","join","params","URLSearchParams","set","toString","setRead","get","undefined","signedIn","Set","shared","first","size","add","delete","reload","creditsByUid","rows","map","row","credits","hostCreditsByUid","hostCredits","months"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAEA,SAASA,gBAAgB,QAAQ,+BAA2B;AAC5D,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,QAAO;AAmDzE,MAAMC,UAA0B;IAAEC,QAAQ;IAAWC,MAAM;AAAK;AAEhE,MAAMC,cAAc,IAAIC;AAExB,kEAAkE,GAClE,OAAO,SAASC;IACdF,YAAYG,KAAK;AACnB;AAEA,SAASC,QAAQC,KAAiB,EAAEC,IAAoB;IACtDD,MAAMC,IAAI,GAAGA;IACb,KAAK,MAAMC,YAAYF,MAAMG,SAAS,CAAED,SAASD;AACnD;AAEA,eAAeG,SACbJ,KAAiB,EACjBK,IAA2C,EAC3CC,KAAa;IAEbN,MAAMO,UAAU,IAAI;IACpB,MAAMA,aAAaP,MAAMO,UAAU;IACnCR,QAAQC,OAAO;QAAEP,QAAQ;QAAWC,MAAMM,MAAMC,IAAI,CAACP,IAAI;IAAC;IAC1D,IAAI;QACF,MAAMc,WAAW,MAAMvB,gBAAgBoB,MAAM,CAAC,cAAc,EAAEC,OAAO;QACrE,IAAIC,eAAeP,MAAMO,UAAU,EAAE;QACrC,IAAIC,SAASf,MAAM,KAAK,KAAK;YAC3BM,QAAQC,OAAO;gBAAEP,QAAQ;gBAAWC,MAAM;YAAK;YAC/C;QACF;QACA,MAAMe,UAAU,MAAMD,SAASE,IAAI,GAAGC,KAAK,CAAC,IAAM;QAClD,IAAIJ,eAAeP,MAAMO,UAAU,EAAE;QACrC,IAAI,CAACC,SAASI,EAAE,IAAI,CAACH,SAAS;YAC5BV,QAAQC,OAAO;gBAAEP,QAAQ;gBAASC,MAAM;YAAK;YAC7C;QACF;QACAK,QAAQC,OAAO;YAAEP,QAAQ;YAASC,MAAMe;QAA+B;IACzE,EAAE,eAAM;QACN,IAAIF,eAAeP,MAAMO,UAAU,EAAER,QAAQC,OAAO;YAAEP,QAAQ;YAASC,MAAM;QAAK;IACpF;AACF;AAEA;;;;;;CAMC,GACD,OAAO,SAASmB,cACdC,KAAgC,EAChCC,UAAkE,CAAC,CAAC;cAUtDA,gBACCA;QAqDLd;IA9DV,MAAM,EAAEP,MAAMW,IAAI,EAAE,GAAGnB;IACvB,4EAA4E;IAC5E,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM8B,cAAMX,wBAAAA,KAAMW,GAAG,mBAAI;IACzB,MAAMC,UAAU3B,OAAOe;IACvBY,QAAQC,OAAO,GAAGb;IAClB,MAAMc,iBAAiB9B,QAAQ,IAAML,oBAAoB,EAAE;IAC3D,MAAMoC,SAAQL,iBAAAA,QAAQK,KAAK,YAAbL,iBAAiBI,cAAc,CAAC,EAAE;IAChD,MAAME,UAASN,kBAAAA,QAAQM,MAAM,YAAdN,kBAAkB;IACjC,MAAMO,UAAUP,QAAQO,OAAO,KAAK;IACpC,MAAMC,MAAMT,SAASE,OAAOM,UAAU;QAACN;QAAKF;QAAOM;QAAOC;KAAO,CAACG,IAAI,CAAC,UAAU;IACjF,MAAMlB,QAAQjB,QAAQ;QACpB,IAAI,CAACyB,OAAO,OAAO;QACnB,MAAMW,SAAS,IAAIC,gBAAgB;YAAEZ;YAAOM;QAAM;QAClD,IAAIC,QAAQI,OAAOE,GAAG,CAAC,UAAUN;QACjC,OAAOI,OAAOG,QAAQ;IACxB,GAAG;QAACd;QAAOM;QAAOC;KAAO;IACzB,MAAM,CAACpB,MAAM4B,QAAQ,GAAGtC,SACtB;YAAOgC;YAAM5B;gBAAN4B,OAAAA,OAAM5B,mBAAAA,YAAYmC,GAAG,CAACP,yBAAhB5B,iBAAsBM,IAAI,GAAG8B,qBAAnCR,OAAiD/B;;IAG1DJ,UAAU;QACR,MAAM4C,WAAWf,QAAQC,OAAO;QAChC,IAAI,CAACK,OAAO,CAACS,UAAU,OAAOD;QAC9B,IAAI/B,QAAQL,YAAYmC,GAAG,CAACP;QAC5B,IAAI,CAACvB,OAAO;YACVA,QAAQ;gBAAEC,MAAMT;gBAASW,WAAW,IAAI8B;gBAAO1B,YAAY;YAAE;YAC7DZ,YAAYgC,GAAG,CAACJ,KAAKvB;QACvB;QACA,MAAMkC,SAASlC;QACf,MAAMmC,QAAQD,OAAO/B,SAAS,CAACiC,IAAI,KAAK;QACxCF,OAAO/B,SAAS,CAACkC,GAAG,CAACR;QACrBA,QAAQK,OAAOjC,IAAI;QACnB,IAAIkC,OAAO,KAAK/B,SAAS8B,QAAQF,UAAU1B;QAC3C,OAAO;YACL4B,OAAO/B,SAAS,CAACmC,MAAM,CAACT;QAC1B;IACF,GAAG;QAACN;QAAKjB;KAAM;IAEf,MAAMiC,SAASpD,YAAY;QACzB,MAAM6C,WAAWf,QAAQC,OAAO;QAChC,MAAMlB,QAAQuB,MAAM5B,YAAYmC,GAAG,CAACP,OAAOQ;QAC3C,IAAI/B,SAASgC,UAAU,KAAK5B,SAASJ,OAAOgC,UAAU1B;IACxD,GAAG;QAACiB;QAAKjB;KAAM;IAEf,MAAMkC,eAAenD,QACnB;;YAAeY;eAAT,IAAIL,IAAI,UAACK,aAAAA,KAAKP,IAAI,qBAATO,WAAWwC,IAAI,mBAAI,EAAE,EAAEC,GAAG,CAAC,CAACC,MAAQ;gBAACA,IAAI3B,GAAG;gBAAE2B,IAAIC,OAAO;aAAC;OACzE;QAAC3C,KAAKP,IAAI;KAAC;IAEb,MAAMmD,mBAAmBxD,QACvB;;YAEKY;eADH,IAAIL,IACF,UAACK,aAAAA,KAAKP,IAAI,qBAATO,WAAWwC,IAAI,mBAAI,EAAE,EAAEC,GAAG,CAAC,CAACC;gBAAkBA;mBAAV;gBAACA,IAAI3B,GAAG;iBAAE2B,mBAAAA,IAAIG,WAAW,YAAfH,mBAAmB;aAAE;;OAExE;QAAC1C,KAAKP,IAAI;KAAC;IAGb,OAAO;QACLD,QAAQ8B,MAAMtB,KAAKR,MAAM,GAAG;QAC5BC,MAAM6B,MAAMtB,KAAKP,IAAI,GAAG;QACxB0B;QACA2B,MAAM,YAAE9C,aAAAA,KAAKP,IAAI,qBAATO,WAAW8C,MAAM,oBAAI5B;QAC7BqB;QACAK;QACAN;IACF;AACF;AAEA,eAAe1B,cAAa"}

package/src/lib/components/use-staff-orgs-ai-spend.d.ts

@@ -0,0 +1,18 @@
+/** Loading, answered, or failed. A failure reads as a dash in every cell. */
+export type StaffOrgsAiSpendStatus = 'loading' | 'ready' | 'error';
+export interface StaffOrgsAiSpendState {
+    status: StaffOrgsAiSpendStatus;
+    /** The month the figures describe, once the route has answered. */
+    month: string | null;
+    /** Spend by org id as the route answered it; empty until it has. */
+    spendUsd: Readonly<Record<string, number | null>>;
+}
+/** Forget every shared read; specs start each case from nothing. */
+export declare function resetStaffOrgsAiSpendReadsForTests(): void;
+/**
+ * This month's AI spend for a page of orgs, through
+ * `/api/ai/admin/orgs-spend` — one request per reader and set of orgs,
+ * however many cells and headers ask.
+ */
+export declare function useStaffOrgsAiSpend(orgIds: readonly string[] | null | undefined): StaffOrgsAiSpendState;
+export default useStaffOrgsAiSpend;

package/src/lib/components/use-staff-orgs-ai-spend.js

@@ -0,0 +1,127 @@
+/**
+ * @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 { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useEffect, useRef, useState } from "react";
+import { staffOrgsAiSpendQuery } from "../usage/staff-orgs-ai-spend.js";
+const LOADING = {
+    status: 'loading',
+    data: null
+};
+const NO_SPEND = Object.freeze({});
+const sharedReads = new Map();
+/** Forget every shared read; specs start each case from nothing. */ export function resetStaffOrgsAiSpendReadsForTests() {
+    sharedReads.clear();
+}
+function publish(entry, read) {
+    entry.read = read;
+    for (const listener of entry.listeners)listener(read);
+}
+async function readInto(entry, user, orgIds) {
+    entry.generation += 1;
+    const generation = entry.generation;
+    publish(entry, LOADING);
+    try {
+        const response = await authorizedFetch(user, `/api/ai/admin/orgs-spend?${staffOrgsAiSpendQuery(orgIds)}`);
+        const payload = response.ok ? await response.json().catch(()=>null) : null;
+        if (generation !== entry.generation) return;
+        const answered = payload !== null && typeof payload === 'object' && typeof payload.spendUsd === 'object' && payload.spendUsd !== null;
+        publish(entry, answered ? {
+            status: 'ready',
+            data: payload
+        } : {
+            status: 'error',
+            data: null
+        });
+    } catch (unused) {
+        if (generation === entry.generation) {
+            publish(entry, {
+                status: 'error',
+                data: null
+            });
+        }
+    }
+}
+/** The ids as one key: distinct and sorted, so the rows' order is not in it. */ function idsKeyOf(orgIds) {
+    const distinct = [
+        ...new Set((orgIds != null ? orgIds : []).filter((orgId)=>typeof orgId === 'string' && orgId.length > 0))
+    ].sort();
+    return distinct.length ? JSON.stringify(distinct) : '';
+}
+/**
+ * This month's AI spend for a page of orgs, through
+ * `/api/ai/admin/orgs-spend` — one request per reader and set of orgs,
+ * however many cells and headers ask.
+ */ export function useStaffOrgsAiSpend(orgIds) {
+    var _ref, _ref1, _ref2;
+    var _read_data, _read_data1;
+    const { data: user } = useUser();
+    // The read is keyed on WHO is signed in and WHICH orgs, never on an
+    // object's identity: a provider or a table that hands back a fresh object
+    // per render would otherwise re-run the effect on every paint.
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const userRef = useRef(user);
+    userRef.current = user;
+    const idsKey = idsKeyOf(orgIds);
+    const key = uid && idsKey ? `${uid}\x00${idsKey}` : null;
+    const [held, setHeld] = useState(()=>{
+        var _ref;
+        var _sharedReads_get;
+        return {
+            key,
+            read: (_ref = key ? (_sharedReads_get = sharedReads.get(key)) == null ? void 0 : _sharedReads_get.read : undefined) != null ? _ref : LOADING
+        };
+    });
+    useEffect(()=>{
+        const signedIn = userRef.current;
+        if (!key || !signedIn) return undefined;
+        let entry = sharedReads.get(key);
+        if (!entry) {
+            entry = {
+                read: LOADING,
+                listeners: new Set(),
+                generation: 0
+            };
+            sharedReads.set(key, entry);
+        }
+        const shared = entry;
+        const listener = (read)=>setHeld({
+                key,
+                read
+            });
+        const first = shared.listeners.size === 0;
+        shared.listeners.add(listener);
+        listener(shared.read);
+        if (first) void readInto(shared, signedIn, JSON.parse(idsKey));
+        return ()=>{
+            shared.listeners.delete(listener);
+        };
+    }, [
+        key,
+        idsKey
+    ]);
+    // A read held for another set of orgs says nothing about this one.
+    const read = held.key === key ? held.read : LOADING;
+    return {
+        status: key ? read.status : 'loading',
+        month: (_ref1 = (_read_data = read.data) == null ? void 0 : _read_data.month) != null ? _ref1 : null,
+        spendUsd: (_ref2 = (_read_data1 = read.data) == null ? void 0 : _read_data1.spendUsd) != null ? _ref2 : NO_SPEND
+    };
+}
+export default useStaffOrgsAiSpend;
+
+//# sourceMappingURL=use-staff-orgs-ai-spend.js.map

package/src/lib/components/use-staff-orgs-ai-spend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/use-staff-orgs-ai-spend.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useEffect, useRef, useState } from 'react'\nimport {\n  staffOrgsAiSpendQuery,\n  type StaffOrgsAiSpendWire,\n} from '../usage/staff-orgs-ai-spend'\n\n/** Loading, answered, or failed. A failure reads as a dash in every cell. */\nexport type StaffOrgsAiSpendStatus = 'loading' | 'ready' | 'error'\n\nexport interface StaffOrgsAiSpendState {\n  status: StaffOrgsAiSpendStatus\n  /** The month the figures describe, once the route has answered. */\n  month: string | null\n  /** Spend by org id as the route answered it; empty until it has. */\n  spendUsd: Readonly<Record<string, number | null>>\n}\n\ninterface SpendRead {\n  status: StaffOrgsAiSpendStatus\n  data: StaffOrgsAiSpendWire | null\n}\n\n/**\n * One read of one page of orgs, shared by every mount that asks for it.\n *\n * The column is mounted once per ROW and once more for its header, so a read\n * per mount would send a request per org for the same page. Mounts for the\n * same reader and the same set of orgs subscribe to one entry instead: the\n * first subscriber reads, the rest take its answer. An answer that arrives\n * after a newer read of the same entry has started is dropped.\n */\ninterface SharedRead {\n  read: SpendRead\n  listeners: Set<(read: SpendRead) => void>\n  generation: number\n}\n\nconst LOADING: SpendRead = { status: 'loading', data: null }\n\nconst NO_SPEND: Readonly<Record<string, number | null>> = Object.freeze({})\n\nconst sharedReads = new Map<string, SharedRead>()\n\n/** Forget every shared read; specs start each case from nothing. */\nexport function resetStaffOrgsAiSpendReadsForTests(): void {\n  sharedReads.clear()\n}\n\nfunction publish(entry: SharedRead, read: SpendRead): void {\n  entry.read = read\n  for (const listener of entry.listeners) listener(read)\n}\n\nasync function readInto(\n  entry: SharedRead,\n  user: Parameters<typeof authorizedFetch>[0],\n  orgIds: readonly string[],\n): Promise<void> {\n  entry.generation += 1\n  const generation = entry.generation\n  publish(entry, LOADING)\n  try {\n    const response = await authorizedFetch(\n      user,\n      `/api/ai/admin/orgs-spend?${staffOrgsAiSpendQuery(orgIds)}`,\n    )\n    const payload = response.ok\n      ? await response.json().catch(() => null)\n      : null\n    if (generation !== entry.generation) return\n    const answered =\n      payload !== null &&\n      typeof payload === 'object' &&\n      typeof payload.spendUsd === 'object' &&\n      payload.spendUsd !== null\n    publish(\n      entry,\n      answered\n        ? { status: 'ready', data: payload as StaffOrgsAiSpendWire }\n        : { status: 'error', data: null },\n    )\n  } catch {\n    if (generation === entry.generation) {\n      publish(entry, { status: 'error', data: null })\n    }\n  }\n}\n\n/** The ids as one key: distinct and sorted, so the rows' order is not in it. */\nfunction idsKeyOf(orgIds: readonly string[] | null | undefined): string {\n  const distinct = [\n    ...new Set(\n      (orgIds ?? []).filter(\n        (orgId) => typeof orgId === 'string' && orgId.length > 0,\n      ),\n    ),\n  ].sort()\n  return distinct.length ? JSON.stringify(distinct) : ''\n}\n\n/**\n * This month's AI spend for a page of orgs, through\n * `/api/ai/admin/orgs-spend` — one request per reader and set of orgs,\n * however many cells and headers ask.\n */\nexport function useStaffOrgsAiSpend(\n  orgIds: readonly string[] | null | undefined,\n): StaffOrgsAiSpendState {\n  const { data: user } = useUser()\n  // The read is keyed on WHO is signed in and WHICH orgs, never on an\n  // object's identity: a provider or a table that hands back a fresh object\n  // per render would otherwise re-run the effect on every paint.\n  const uid = user?.uid ?? null\n  const userRef = useRef(user)\n  userRef.current = user\n  const idsKey = idsKeyOf(orgIds)\n  const key = uid && idsKey ? `${uid}\\x00${idsKey}` : null\n  const [held, setHeld] = useState<{ key: string | null; read: SpendRead }>(\n    () => ({\n      key,\n      read: (key ? sharedReads.get(key)?.read : undefined) ?? LOADING,\n    }),\n  )\n\n  useEffect(() => {\n    const signedIn = userRef.current\n    if (!key || !signedIn) return undefined\n    let entry = sharedReads.get(key)\n    if (!entry) {\n      entry = { read: LOADING, listeners: new Set(), generation: 0 }\n      sharedReads.set(key, entry)\n    }\n    const shared = entry\n    const listener = (read: SpendRead) => setHeld({ key, read })\n    const first = shared.listeners.size === 0\n    shared.listeners.add(listener)\n    listener(shared.read)\n    if (first) void readInto(shared, signedIn, JSON.parse(idsKey) as string[])\n    return () => {\n      shared.listeners.delete(listener)\n    }\n  }, [key, idsKey])\n\n  // A read held for another set of orgs says nothing about this one.\n  const read = held.key === key ? held.read : LOADING\n  return {\n    status: key ? read.status : 'loading',\n    month: read.data?.month ?? null,\n    spendUsd: read.data?.spendUsd ?? NO_SPEND,\n  }\n}\n\nexport default useStaffOrgsAiSpend\n"],"names":["authorizedFetch","useUser","useEffect","useRef","useState","staffOrgsAiSpendQuery","LOADING","status","data","NO_SPEND","Object","freeze","sharedReads","Map","resetStaffOrgsAiSpendReadsForTests","clear","publish","entry","read","listener","listeners","readInto","user","orgIds","generation","response","payload","ok","json","catch","answered","spendUsd","idsKeyOf","distinct","Set","filter","orgId","length","sort","JSON","stringify","useStaffOrgsAiSpend","uid","userRef","current","idsKey","key","held","setHeld","get","undefined","signedIn","set","shared","first","size","add","parse","delete","month"],"mappings":"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"}

package/src/lib/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The plugin's stable id — persisted in `org.enabledPlugins`, the document
+ * id under `pluginSettings`, and the owner every registry records. Matches
+ * `plugins.config.json` and `FIRST_PARTY_PLUGINS`.
+ */
+export declare const AI_PLUGIN_ID = "ai";
+/** The `pluginSettings/ai` document's schema id — the same string. */
+export declare const AI_PLUGIN_SETTINGS_ID = "ai";

package/src/lib/constants.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The plugin's stable id — persisted in `org.enabledPlugins`, the document
+ * id under `pluginSettings`, and the owner every registry records. Matches
+ * `plugins.config.json` and `FIRST_PARTY_PLUGINS`.
+ */ export const AI_PLUGIN_ID = 'ai';
+/** The `pluginSettings/ai` document's schema id — the same string. */ export const AI_PLUGIN_SETTINGS_ID = AI_PLUGIN_ID;
+
+//# sourceMappingURL=constants.js.map

package/src/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/ai/src/lib/constants.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The plugin's stable id — persisted in `org.enabledPlugins`, the document\n * id under `pluginSettings`, and the owner every registry records. Matches\n * `plugins.config.json` and `FIRST_PARTY_PLUGINS`.\n */\nexport const AI_PLUGIN_ID = 'ai'\n\n/** The `pluginSettings/ai` document's schema id — the same string. */\nexport const AI_PLUGIN_SETTINGS_ID = AI_PLUGIN_ID\n"],"names":["AI_PLUGIN_ID","AI_PLUGIN_SETTINGS_ID"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GACD,OAAO,MAAMA,eAAe,KAAI;AAEhC,oEAAoE,GACpE,OAAO,MAAMC,wBAAwBD,aAAY"}