@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/server/ai-admin-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/ai-admin-signals.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  ORG_BILLING_DOC_ID,\n  ORG_BILLING_SUBCOLLECTION,\n  pluginRequestFromWeb,\n} from '@aglyn/aglyn/server'\nimport {\n  emailUnverifiedResponse,\n  firebaseAdmin,\n  isImpersonationSession,\n} from '@aglyn/tenant-data-admin'\nimport {\n  ASSIST_PROVIDER_COST_FIELD,\n  assistCreditsFromUsd,\n  assistProviderCostUsd,\n} from '@aglyn/aglyn/app-utils/assist-credits'\nimport {\n  hasAiAddon,\n  resolveEffectivePlan,\n} from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { readPlatformFreeSpend } from '../usage/assist-free-taste'\nimport { assistRefusalCounts } from '../usage/assist-refusals'\nimport { assistUsageDay, assistUsageMonth } from '../usage/assist-usage'\nimport { invalidIdTokenResponse } from '@aglyn/tenant-data-admin/server/id-token-refusal'\nimport {\n  assistSignalRow,\n  mineAssistSignals,\n  rankAssistSpend,\n  type AssistSpendRow,\n} from '../usage/assist-signal-mining'\n\n/**\n * The Assist docs-gap and cost mining view (AGL-1860, AGL-2252), served at\n * `/api/ai/admin/signals` for the plugin's Assist signal staff page.\n * Staff-gated, read-only, and the only reader `assistSignals` has.\n *\n * ## Why a route and not a client query\n *\n * `assistSignals` is absent from `firebase-firestore.rules` deliberately: the\n * org block matches its subcollections BY NAME and carries no wildcard, so an\n * unlisted name is default-deny for every client. That is the property that\n * lets the collection hold cross-tenant analytics at all. Reading it therefore\n * goes through the Admin SDK behind the staff claim, exactly as every staff\n * route does.\n *\n * ## The collection group, and the index it does not need\n *\n * One `collectionGroup('assistSignals')` read gathers every org's signals in a\n * single query; the owning org is `ref.parent.parent.id`, since the document\n * carries no `orgId` field (it carries no identifiers at all — see AGL-1972).\n * The query has no `where` and no `orderBy`, so it needs no composite index,\n * and adding one later would mean declaring a `COLLECTION_GROUP`-scoped\n * override and deploying it by hand. `/api/admin/overview` reads org billing\n * the same way and for the same reason.\n *\n * ## Truncation is reported, never hidden\n *\n * The read is bounded — an unbounded fleet-wide get is how a staff page\n * becomes an outage — but a ranking cut short looks exactly like a complete\n * one, so the ceiling is fetched PLUS ONE and the extra row sets `truncated`.\n * AGL-2220 is the standing example of the alternative: a sweep that stopped at\n * 500 orgs and reported nothing about the rest, for as long as nobody counted.\n */\n\n/**\n * Rows read in one pass. Each signal is a handful of scalars, so this is a\n * few megabytes at the ceiling — large enough to be worth ranking, small\n * enough that the honest answer to \"is it all of them\" is usually yes.\n */\nconst SCAN_CEILING = 20000\n\n/**\n * How much of an answer the prose panel shows.\n *\n * Enough to judge whether the answer was wrong, short enough that twenty-five\n * of them are still a page somebody reads.\n */\nconst ANSWER_PREVIEW_CHARS = 600\n\n/**\n * Month documents read in one pass for the spend leaderboard (AGL-2930).\n *\n * `assistUsage` holds one document per org per month, so this is orgs times\n * months — a fraction of the signal count, and the same PLUS-ONE truncation\n * probe the signals read uses. Read as a collection group with NO `where`\n * and NO `orderBy`, for the reason the module note gives: a filter on\n * `month` would need a COLLECTION_GROUP-scoped index deployed by hand, and\n * filtering the month in memory costs nothing at this size.\n */\nconst SPEND_SCAN_CEILING = 20000\n\nexport interface AssistSpendLeaderboard {\n  month: string\n  rows: AssistSpendRow[]\n  /** How many workspaces had a document for the month — the ranked count. */\n  ranked: number\n  /** True when the scan hit its ceiling, so the ranking is over a sample. */\n  truncated: boolean\n  /**\n   * True when the month documents could not be read at all. Reported rather\n   * than rendered as an empty table: \"no workspace spent anything\" and \"the\n   * read failed\" are opposite findings, and the rest of the board — read\n   * from a different collection — is still good.\n   */\n  failed: boolean\n}\n\n/**\n * The month's per-org spend, refusals and plan, dearest first.\n *\n * Plan and add-on come from the org and billing documents of the ranked\n * rows only — bounded by `limit`, never by the fleet — merged org-doc-first\n * exactly as every other staff reader merges them.\n */\nasync function readAssistSpendLeaderboard(\n  firestore: FirebaseFirestore.Firestore,\n  limit: number,\n  month: string,\n): Promise<AssistSpendLeaderboard> {\n  try {\n    return await rankAssistSpendForMonth(firestore, limit, month)\n  } catch (error) {\n    console.error('[ai/admin/signals] spend leaderboard read failed', error)\n    return { month, rows: [], ranked: 0, truncated: false, failed: true }\n  }\n}\n\nasync function rankAssistSpendForMonth(\n  firestore: FirebaseFirestore.Firestore,\n  limit: number,\n  month: string,\n): Promise<AssistSpendLeaderboard> {\n  const snapshot = await firestore\n    .collectionGroup('assistUsage')\n    .limit(SPEND_SCAN_CEILING + 1)\n    .get()\n  const truncated = snapshot.size > SPEND_SCAN_CEILING\n  const docs = truncated ? snapshot.docs.slice(0, SPEND_SCAN_CEILING) : snapshot.docs\n  const unranked: AssistSpendRow[] = []\n  for (const doc of docs) {\n    // The id IS the month; the field is the same value and is what an\n    // older document may lack.\n    if (doc.id !== month && doc.get('month') !== month) continue\n    const orgId = doc.ref.parent.parent?.id\n    if (!orgId) continue\n    // Two figures off one document (AGL-3015): the credits a workspace drew\n    // come from what it was BILLED, and the dollars staff rank workspaces by\n    // come from what it COST US. Ranking on the billed figure would sort the\n    // fleet by our own markup wherever workspaces differ in model mix.\n    const billed = Number(doc.get('estCostUsd') ?? 0)\n    const billedUsd = Number.isFinite(billed) && billed > 0 ? billed : 0\n    unranked.push({\n      orgId,\n      plan: 'free',\n      aiAddon: false,\n      credits: assistCreditsFromUsd(billedUsd),\n      providerCostUsd: assistProviderCostUsd(\n        billedUsd,\n        doc.get(ASSIST_PROVIDER_COST_FIELD),\n      ),\n      refusals: assistRefusalCounts(doc.get('refusals')),\n    })\n  }\n  const { rows, ranked } = rankAssistSpend(unranked, limit)\n  if (rows.length) {\n    const orgRefs = rows.map((row) => firestore.collection('orgs').doc(row.orgId))\n    const [orgSnaps, billingSnaps] = await Promise.all([\n      firestore.getAll(...orgRefs),\n      firestore.getAll(\n        ...orgRefs.map((ref) =>\n          ref.collection(ORG_BILLING_SUBCOLLECTION).doc(ORG_BILLING_DOC_ID),\n        ),\n      ),\n    ])\n    rows.forEach((row, index) => {\n      const orgData = orgSnaps[index]?.exists ? (orgSnaps[index].data() ?? {}) : {}\n      const org = {\n        ...orgData,\n        ...(billingSnaps[index]?.exists ? billingSnaps[index].data() : {}),\n      }\n      row.plan = resolveEffectivePlan(org as never)\n      row.aiAddon = hasAiAddon(org as never)\n      const label = (orgData['name'] ?? orgData['slug'] ?? '') as string\n      row.orgLabel = label || null\n    })\n  }\n  return { month, rows, ranked, truncated, failed: false }\n}\n\nasync function handler(request: Request): Promise<Response> {\n  const { method, query, headers: rawHeaders } = await pluginRequestFromWeb(request)\n  const headers = rawHeaders as Partial<Record<string, string>>\n  if (method !== 'GET') {\n    return Response.json({ error: 'Method not allowed' }, { status: 405 })\n  }\n  const authorization = headers.authorization ?? ''\n  const idToken = authorization.startsWith('Bearer ')\n    ? authorization.slice('Bearer '.length)\n    : undefined\n  if (!idToken) return Response.json({ error: 'Unauthenticated' }, { status: 401 })\n\n  try {\n    const decoded = await firebaseAdmin.app().auth().verifyIdToken(idToken)\n    if (!decoded.email_verified && !isImpersonationSession(decoded)) {\n      return emailUnverifiedResponse()\n    }\n    if (!decoded['staff']) {\n      return Response.json({ error: 'Staff only' }, { status: 403 })\n    }\n\n    const requested = Number(query.limit ?? 25)\n    const limit =\n      Number.isFinite(requested) && requested > 0\n        ? Math.min(Math.floor(requested), 100)\n        : 25\n\n    const snapshot = await firebaseAdmin\n      .app()\n      .firestore()\n      .collectionGroup('assistSignals')\n      // Ceiling PLUS ONE: the extra document is what makes truncation\n      // detectable rather than assumed.\n      .limit(SCAN_CEILING + 1)\n      .get()\n\n    const truncated = snapshot.size > SCAN_CEILING\n    const docs = truncated ? snapshot.docs.slice(0, SCAN_CEILING) : snapshot.docs\n    const rows = docs.map((doc) =>\n      assistSignalRow(\n        doc.ref.parent.parent?.id ?? '(unknown)',\n        // The signal id IS the exchange id (AGL-2314) — one id, two halves,\n        // minted together by `recordAssistExchange` precisely so the join is\n        // possible. Until now nothing carried it this far.\n        doc.id,\n        doc.data(),\n      ),\n    )\n\n    const report = mineAssistSignals(rows, { truncated, limit })\n\n    // This month's spend, per workspace (AGL-2930) — the board's only\n    // month-scoped panel, read off the month documents rather than mined\n    // from the all-time signals above.\n    const spend = await readAssistSpendLeaderboard(\n      firebaseAdmin.app().firestore(),\n      limit,\n      assistUsageMonth(),\n    )\n\n    /*==========================================\n     * THE VERBATIM HALF (AGL-2314).\n     *\n     * `assistExchanges` stores the question a customer typed and the answer\n     * we gave, for 180 days, and `assist-usage.ts` calls it \"the data loop's\n     * corpus\". NOTHING read it — one write, no reader, no collection group.\n     * So we retained customers' words, and committed publicly in the privacy\n     * policy to retaining them, for zero product value.\n     *\n     * Read here rather than in the miner because the miner is pure: it does\n     * the arithmetic, the route does the reading.\n     *\n     * ## Only the turns that FAILED\n     *\n     * The shortlist is thumbs-down and ungrounded turns only, capped by the\n     * same `limit` as every other panel. That is a privacy decision as much\n     * as a cost one: the counts already answer \"how often\", and the words are\n     * fetched only where the counts CANNOT say what went wrong. Pulling every\n     * exchange would be surveillance with a dashboard on it.\n     *\n     * `uid` is deliberately not projected. The corpus question is what people\n     * asked, never who asked it — and the exchange is the only document that\n     * still carries an identifier at all.\n     *\n     * ## An expired exchange is an ANSWER\n     *\n     * The 180-day TTL means a signal can outlive its prose, and it is meant\n     * to. A missing document therefore reports `expired: true` rather than\n     * being dropped: a shortlist silently shorter than the failure count it\n     * came from would read as \"these are all the failures\", which is the\n     * AGL-2220 shape.\n     *=========================================*/\n    const firestore = firebaseAdmin.app().firestore()\n    const exchanges = report.proseCandidates.length\n      ? await firestore.getAll(\n          ...report.proseCandidates.map((candidate) =>\n            firestore\n              .collection('orgs')\n              .doc(candidate.orgId)\n              .collection('assistExchanges')\n              .doc(candidate.exchangeId),\n          ),\n        )\n      : []\n    const prose = report.proseCandidates.map((candidate, index) => {\n      const snapshot = exchanges[index]\n      const data = (snapshot?.exists ? snapshot.data() : null) ?? {}\n      return {\n        ...candidate,\n        expired: !snapshot?.exists,\n        question: typeof data['question'] === 'string' ? data['question'] : null,\n        // Trimmed, not omitted: judging whether an answer was wrong needs to\n        // see it, and a whole answer per row would make the panel unreadable.\n        answer:\n          typeof data['answer'] === 'string'\n            ? data['answer'].slice(0, ANSWER_PREVIEW_CHARS)\n            : null,\n        answerTruncated:\n          typeof data['answer'] === 'string' &&\n          data['answer'].length > ANSWER_PREVIEW_CHARS,\n      }\n    })\n\n    /*==========================================\n     * THE WORKSPACE, BY NAME.\n     *\n     * A staff reader recognizes a customer by name, never by document id,\n     * and the cost board's own column header says \"Workspace\" over a column\n     * of generated ids. `/api/admin/overview` fixed the same shape by\n     * building a label map from a snapshot it already held; there is no such\n     * snapshot here — this route reads `assistSignals` and nothing else — so\n     * the labels are fetched, with the same `name` → `slug` → id precedence\n     * so one workspace cannot appear under two different labels on two\n     * screens.\n     *\n     * Bounded by what is actually RENDERED, not by the fleet. Both lists the\n     * ids come from are already sliced to `limit` (25 by default, 100 at the\n     * ceiling), so this is one `getAll` over at most a couple of hundred\n     * documents — and it reads the orgs the reader can see rather than\n     * scanning a collection to name a handful of rows.\n     *\n     * An org that has been deleted keeps its id rather than going blank: an\n     * unfamiliar id is still a lead a staff member can paste into the org\n     * search, and an empty cell is not.\n     *=========================================*/\n    const orgIds = [\n      ...new Set(\n        [\n          ...report.orgs.map((row) => row.orgId),\n          ...report.proseCandidates.map((row) => row.orgId),\n        ].filter((orgId) => orgId && orgId !== '(unknown)'),\n      ),\n    ]\n    const orgLabelById = new Map<string, string>()\n    if (orgIds.length) {\n      const orgDocs = await firestore.getAll(\n        ...orgIds.map((orgId) => firestore.collection('orgs').doc(orgId)),\n      )\n      for (const doc of orgDocs) {\n        if (!doc.exists) continue\n        const data = doc.data() ?? {}\n        const label = (data['name'] ?? data['slug'] ?? '') as string\n        if (label) orgLabelById.set(doc.id, label)\n      }\n    }\n    const orgLabel = (orgId: string): string =>\n      orgLabelById.get(orgId) ?? orgId\n\n    // Today's free-tier spend against the platform ceiling (AGL-2925): one\n    // document read, and the only place staff can see the taste switching\n    // itself off before the email arrives. Best-effort — a readout that\n    // cannot be read must not take the rest of the board down with it.\n    const freeSpend = await readPlatformFreeSpend(\n      firestore,\n      assistUsageDay(),\n    ).catch((error) => {\n      console.error('[ai/admin/signals] free spend readout failed', error)\n      return undefined\n    })\n\n    return Response.json(\n      {\n        ...report,\n        freeSpend,\n        orgs: report.orgs.map((row) => ({\n          ...row,\n          orgLabel: orgLabel(row.orgId),\n        })),\n        prose: prose.map((row) => ({ ...row, orgLabel: orgLabel(row.orgId) })),\n        spend,\n        ceiling: SCAN_CEILING,\n      },\n      { status: 200 },\n    )\n  } catch (error) {\n    // An unverifiable credential is a 401, not a fault of ours\n    // (AGL-1993). Null for anything else, so a real failure keeps its 500.\n    const unauthenticated = invalidIdTokenResponse(error)\n    if (unauthenticated) return unauthenticated\n    console.error('[ai/admin/signals]', error)\n    return Response.json({ error: 'Assist signal lookup failed' }, { status: 500 })\n  }\n}\n\nexport { handler as GET }\n"],"names":["ORG_BILLING_DOC_ID","ORG_BILLING_SUBCOLLECTION","pluginRequestFromWeb","emailUnverifiedResponse","firebaseAdmin","isImpersonationSession","ASSIST_PROVIDER_COST_FIELD","assistCreditsFromUsd","assistProviderCostUsd","hasAiAddon","resolveEffectivePlan","readPlatformFreeSpend","assistRefusalCounts","assistUsageDay","assistUsageMonth","invalidIdTokenResponse","assistSignalRow","mineAssistSignals","rankAssistSpend","SCAN_CEILING","ANSWER_PREVIEW_CHARS","SPEND_SCAN_CEILING","readAssistSpendLeaderboard","firestore","limit","month","rankAssistSpendForMonth","error","console","rows","ranked","truncated","failed","snapshot","collectionGroup","get","size","docs","slice","unranked","doc","id","orgId","ref","parent","billed","Number","billedUsd","isFinite","push","plan","aiAddon","credits","providerCostUsd","refusals","length","orgRefs","map","row","collection","orgSnaps","billingSnaps","Promise","all","getAll","forEach","index","orgData","exists","data","org","label","orgLabel","handler","request","headers","method","query","rawHeaders","Response","json","status","authorization","idToken","startsWith","undefined","decoded","app","auth","verifyIdToken","email_verified","requested","Math","min","floor","report","spend","exchanges","proseCandidates","candidate","exchangeId","prose","expired","question","answer","answerTruncated","orgIds","Set","orgs","filter","orgLabelById","Map","orgDocs","set","freeSpend","catch","ceiling","unauthenticated","GET"],"mappings":"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"}

package/src/lib/server/ai-admin-user.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+export interface StaffUserAiUsageRow {
+    orgId: string;
+    orgName: string | null;
+    slug: string | null;
+    month: string;
+    credits: number;
+    requests: number;
+    refusals: number;
+}
+declare function handler(request: Request): Promise<Response>;
+export { handler as GET };

package/src/lib/server/ai-admin-user.js

@@ -0,0 +1,128 @@
+/**
+ * @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 { pluginRequestFromWeb } from "@aglyn/aglyn/server";
+import { emailUnverifiedResponse, firebaseAdmin, isImpersonationSession } from "@aglyn/tenant-data-admin";
+import { readUserAiUsageMonths } from "../usage/ai-usage-by-user.js";
+import { recordAdminAudit } from "@aglyn/tenant-data-admin/server/admin-audit";
+import { invalidIdTokenResponse } from "@aglyn/tenant-data-admin/server/id-token-refusal";
+/**
+ * ONE ACCOUNT'S AI USAGE ACROSS ORGANIZATIONS (AGL-2928) — the staff user
+ * page's card, beside `admin/users/detail`.
+ *
+ * Walks the account's reverse index of memberships, the same read the detail
+ * route makes, and lists each workspace's months for this uid newest first.
+ * A membership walk rather than a collection-group query, so the card works
+ * the moment it ships and needs no index deployed first; a workspace the
+ * person has left is not listed, and its months expire on the retention
+ * window.
+ *
+ * Opening it is recorded as an ACCESS about THIS person — `subjectUid` set,
+ * unlike the org card's row — because the whole response is about one
+ * account, and that is exactly the row their page exists to show.
+ */ /** The most workspaces one account is walked across. */ const MAX_ORGS = 50;
+async function handler(request) {
+    var _headers_authorization, _query_uid;
+    const { method, query, headers: rawHeaders } = await pluginRequestFromWeb(request);
+    const headers = rawHeaders;
+    if (method !== 'GET') {
+        return Response.json({
+            error: 'Method not allowed'
+        }, {
+            status: 405
+        });
+    }
+    const authorization = (_headers_authorization = headers.authorization) != null ? _headers_authorization : '';
+    const idToken = authorization.startsWith('Bearer ') ? authorization.slice('Bearer '.length) : undefined;
+    if (!idToken) return Response.json({
+        error: 'Unauthenticated'
+    }, {
+        status: 401
+    });
+    const uid = String((_query_uid = query.uid) != null ? _query_uid : '').trim();
+    if (!uid) return Response.json({
+        error: 'Missing uid'
+    }, {
+        status: 400
+    });
+    try {
+        const decoded = await firebaseAdmin.app().auth().verifyIdToken(idToken);
+        if (!decoded.email_verified && !isImpersonationSession(decoded)) {
+            return emailUnverifiedResponse();
+        }
+        if (!decoded['staff']) {
+            return Response.json({
+                error: 'Staff only'
+            }, {
+                status: 403
+            });
+        }
+        const firestore = firebaseAdmin.app().firestore();
+        const reverse = await firestore.collection('users').doc(uid).collection('orgs').limit(MAX_ORGS).get();
+        // Recorded BEFORE the person-shaped read is served, and awaited, for
+        // the reason the org card gives: a card that rendered and then failed
+        // to record the look would be the access this collection exists to
+        // never lose.
+        try {
+            await recordAdminAudit({
+                actorUid: decoded.uid,
+                action: 'user.ai-usage-viewed',
+                target: `users/${uid}`,
+                subjectUid: uid,
+                note: `AI usage opened across ${reverse.size} workspace(s)`
+            });
+        } catch (error) {
+            console.error('[ai/admin/user] audit write failed', error);
+        }
+        const rows = [];
+        for (const entry of reverse.docs){
+            const months = await readUserAiUsageMonths(firestore, entry.id, uid);
+            for (const month of months){
+                rows.push({
+                    orgId: entry.id,
+                    orgName: typeof entry.get('orgName') === 'string' ? String(entry.get('orgName')) : null,
+                    slug: typeof entry.get('slug') === 'string' ? String(entry.get('slug')) : null,
+                    month: month.month,
+                    credits: month.credits,
+                    requests: month.requests,
+                    refusals: month.refusals
+                });
+            }
+        }
+        // Newest month first, dearest workspace first within it.
+        rows.sort((a, b)=>b.month.localeCompare(a.month) || b.credits - a.credits);
+        return Response.json({
+            uid,
+            rows,
+            truncated: reverse.size >= MAX_ORGS
+        }, {
+            status: 200
+        });
+    } catch (error) {
+        // An unverifiable credential is a 401, not a fault of ours
+        // (AGL-1993). Null for anything else, so a real failure keeps its 500.
+        const unauthenticated = invalidIdTokenResponse(error);
+        if (unauthenticated) return unauthenticated;
+        console.error('[ai/admin/user]', error);
+        return Response.json({
+            error: 'AI usage lookup failed'
+        }, {
+            status: 500
+        });
+    }
+}
+export { handler as GET };
+
+//# sourceMappingURL=ai-admin-user.js.map

package/src/lib/server/ai-admin-user.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/server/ai-admin-user.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { pluginRequestFromWeb } from '@aglyn/aglyn/server'\nimport {\n  emailUnverifiedResponse,\n  firebaseAdmin,\n  isImpersonationSession,\n} from '@aglyn/tenant-data-admin'\nimport { readUserAiUsageMonths } from '../usage/ai-usage-by-user'\nimport { recordAdminAudit } from '@aglyn/tenant-data-admin/server/admin-audit'\nimport { invalidIdTokenResponse } from '@aglyn/tenant-data-admin/server/id-token-refusal'\n\n/**\n * ONE ACCOUNT'S AI USAGE ACROSS ORGANIZATIONS (AGL-2928) — the staff user\n * page's card, beside `admin/users/detail`.\n *\n * Walks the account's reverse index of memberships, the same read the detail\n * route makes, and lists each workspace's months for this uid newest first.\n * A membership walk rather than a collection-group query, so the card works\n * the moment it ships and needs no index deployed first; a workspace the\n * person has left is not listed, and its months expire on the retention\n * window.\n *\n * Opening it is recorded as an ACCESS about THIS person — `subjectUid` set,\n * unlike the org card's row — because the whole response is about one\n * account, and that is exactly the row their page exists to show.\n */\n\n/** The most workspaces one account is walked across. */\nconst MAX_ORGS = 50\n\nexport interface StaffUserAiUsageRow {\n  orgId: string\n  orgName: string | null\n  slug: string | null\n  month: string\n  credits: number\n  requests: number\n  refusals: number\n}\n\nasync function handler(request: Request): Promise<Response> {\n  const { method, query, headers: rawHeaders } = await pluginRequestFromWeb(request)\n  const headers = rawHeaders as Partial<Record<string, string>>\n  if (method !== 'GET') {\n    return Response.json({ error: 'Method not allowed' }, { status: 405 })\n  }\n  const authorization = headers.authorization ?? ''\n  const idToken = authorization.startsWith('Bearer ')\n    ? authorization.slice('Bearer '.length)\n    : undefined\n  if (!idToken) return Response.json({ error: 'Unauthenticated' }, { status: 401 })\n  const uid = String(query.uid ?? '').trim()\n  if (!uid) return Response.json({ error: 'Missing uid' }, { status: 400 })\n\n  try {\n    const decoded = await firebaseAdmin.app().auth().verifyIdToken(idToken)\n    if (!decoded.email_verified && !isImpersonationSession(decoded)) {\n      return emailUnverifiedResponse()\n    }\n    if (!decoded['staff']) {\n      return Response.json({ error: 'Staff only' }, { status: 403 })\n    }\n    const firestore = firebaseAdmin.app().firestore()\n    const reverse = await firestore\n      .collection('users')\n      .doc(uid)\n      .collection('orgs')\n      .limit(MAX_ORGS)\n      .get()\n\n    // Recorded BEFORE the person-shaped read is served, and awaited, for\n    // the reason the org card gives: a card that rendered and then failed\n    // to record the look would be the access this collection exists to\n    // never lose.\n    try {\n      await recordAdminAudit({\n        actorUid: decoded.uid,\n        action: 'user.ai-usage-viewed',\n        target: `users/${uid}`,\n        subjectUid: uid,\n        note: `AI usage opened across ${reverse.size} workspace(s)`,\n      })\n    } catch (error) {\n      console.error('[ai/admin/user] audit write failed', error)\n    }\n\n    const rows: StaffUserAiUsageRow[] = []\n    for (const entry of reverse.docs) {\n      const months = await readUserAiUsageMonths(firestore, entry.id, uid)\n      for (const month of months) {\n        rows.push({\n          orgId: entry.id,\n          orgName: typeof entry.get('orgName') === 'string' ? String(entry.get('orgName')) : null,\n          slug: typeof entry.get('slug') === 'string' ? String(entry.get('slug')) : null,\n          month: month.month,\n          credits: month.credits,\n          requests: month.requests,\n          refusals: month.refusals,\n        })\n      }\n    }\n    // Newest month first, dearest workspace first within it.\n    rows.sort(\n      (a, b) => b.month.localeCompare(a.month) || b.credits - a.credits,\n    )\n    return Response.json(\n      { uid, rows, truncated: reverse.size >= MAX_ORGS },\n      { status: 200 },\n    )\n  } catch (error) {\n    // An unverifiable credential is a 401, not a fault of ours\n    // (AGL-1993). Null for anything else, so a real failure keeps its 500.\n    const unauthenticated = invalidIdTokenResponse(error)\n    if (unauthenticated) return unauthenticated\n    console.error('[ai/admin/user]', error)\n    return Response.json({ error: 'AI usage lookup failed' }, { status: 500 })\n  }\n}\n\nexport { handler as GET }\n"],"names":["pluginRequestFromWeb","emailUnverifiedResponse","firebaseAdmin","isImpersonationSession","readUserAiUsageMonths","recordAdminAudit","invalidIdTokenResponse","MAX_ORGS","handler","request","headers","query","method","rawHeaders","Response","json","error","status","authorization","idToken","startsWith","slice","length","undefined","uid","String","trim","decoded","app","auth","verifyIdToken","email_verified","firestore","reverse","collection","doc","limit","get","actorUid","action","target","subjectUid","note","size","console","rows","entry","docs","months","id","month","push","orgId","orgName","slug","credits","requests","refusals","sort","a","b","localeCompare","truncated","unauthenticated","GET"],"mappings":"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"}

package/src/lib/server/ai-allotments.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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 AiAllotmentMode, type AiAllotmentSubject } from '../model/ai-allotments';
+interface ParsedWrite {
+    subject: AiAllotmentSubject;
+    credits: number | null;
+    mode: AiAllotmentMode;
+    models: string[] | null;
+}
+/** One entry of `set`, validated; a string names what is wrong. */
+export declare function parseAllotmentWrite(raw: unknown): ParsedWrite | string;
+declare function handler(request: Request): Promise<Response>;
+export { handler as GET, handler as POST };