@aglyn/plugins-ai 1.0.0-beta.254 → 1.0.0-beta.255

package/src/lib/usage/assist-signals-view.js

@@ -0,0 +1,151 @@
+/**
+ * @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 { aiAddonName } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { costSplitRows, freeTasteRefusals, kindTokenRows } from "./assist-signal-mining.js";
+/*
+ * THE ASSIST SIGNAL BOARD, AS THE STAFF PAGE PRINTS IT (AGL-3667).
+ *
+ * `/admin/assist-signals` draws the mining report in the browser: money to the
+ * cent (four places under a dollar), shares as whole percents, the cost split
+ * by tier, model and kind. The staff apps read the same report through
+ * `/api/ai/admin/signals?view=prepared`, which sends each table as the lines
+ * the page prints, so a figure or a sentence on the board is decided once.
+ */ export const money = (value)=>`$${(Number(value) || 0).toFixed(Math.abs(Number(value) || 0) < 1 ? 4 : 2)}`;
+export const percent = (value)=>value == null ? '\u2014' : `${Math.round(value * 100)}%`;
+/** The line under a ranking, which is a cut and not a page. */ export function rankingFootnote(shown, total, noun) {
+    if (!total) return '';
+    const counted = `${total.toLocaleString('en-US')} ${total === 1 ? noun.one : noun.many}`;
+    return shown >= total ? `Showing all ${counted}.` : `Showing the top ${shown.toLocaleString('en-US')} of ${counted}. This is a ranking, not a page \u2014 what is past the cut is what it ranked lowest.`;
+}
+const count = (value)=>(Number(value) || 0).toLocaleString('en-US');
+export function assistSignalsView(report) {
+    var _report_spend, _totals_deflected, _ref, _ref1, _ref2, _ref3, _ref4, _report_docsGaps, _ref5, _ref6, _ref7, _ref8, _ref9, _report_prose, _ref10, _ref11, _report_orgs;
+    var _spend_rows, _report_docsGaps1, _report_ranked, _report_ungrounded, _report_ungrounded1, _report_ungrounded_routes, _report_ungrounded2, _report_ranked1, _report_ungrounded3, _report_orgs1, _report_ranked2;
+    const totals = report.totals;
+    const spend = (_report_spend = report.spend) != null ? _report_spend : null;
+    const shareOf = (cost, total)=>percent(total > 0 ? cost / total : null);
+    const splitRows = (split)=>costSplitRows(split).map((row)=>{
+            var _ref;
+            return {
+                key: row.key,
+                detail: `${count(row.messages)} turns \u00b7 ${money(row.providerCostUsd)} \u00b7 ${shareOf(row.providerCostUsd, (_ref = totals == null ? void 0 : totals.providerCostUsd) != null ? _ref : 0)}`
+            };
+        });
+    const free = report.freeSpend;
+    const chips = totals ? [
+        `${count(totals.messages)} turns`,
+        `${money(totals.providerCostUsd)} estimated`,
+        `answered free ${percent(totals.deflectionRate)} (${count((_totals_deflected = totals.deflected) != null ? _totals_deflected : 0)})`,
+        `${count(totals.inputTokens)} in / ${count(totals.outputTokens)} out`,
+        `cache reads ${percent(totals.cacheReadRate)}`,
+        `cache writes ${count(totals.cacheWriteTokens)}`,
+        `up ${totals.feedback.up} \u00b7 down ${totals.feedback.down} \u00b7 unrated ${totals.feedback.none}`,
+        ...Object.entries(totals.stopReasons).map(([reason, total])=>`${reason}: ${total}`)
+    ] : [];
+    return {
+        truncatedNote: report.truncated ? `Ranked the first ${count(report.scanned)} signals only; there are more. Every number below describes that sample, not the fleet.` : '',
+        fleet: {
+            chips,
+            empty: totals ? '' : 'No assist turns recorded yet.'
+        },
+        freeSpend: free ? {
+            line: `free tier today ${money(free.estCostUsd)} of ${money(free.ceilingUsd)} ceiling \u00b7 ${count(free.requests)} requests` + (free.paused ? ' \u00b7 PAUSED until tomorrow' : ''),
+            tone: free.paused ? 'error' : free.alerted ? 'warning' : 'neutral'
+        } : null,
+        spend: {
+            heading: `AI spend this month, by workspace${spend ? ` \u00b7 ${spend.month}` : ''}`,
+            note: (spend == null ? void 0 : spend.failed) ? 'Could not read this month\u2019s spend documents: a failed read, not a month in which nobody spent.' : (spend == null ? void 0 : spend.truncated) ? 'Ranked over a sample of the month documents; there are more. This is not the whole fleet.' : '',
+            addonName: aiAddonName(),
+            rows: ((_ref = spend == null ? void 0 : spend.rows) != null ? _ref : []).map((row)=>{
+                var _row_orgLabel;
+                return {
+                    orgId: row.orgId,
+                    workspace: (_row_orgLabel = row.orgLabel) != null ? _row_orgLabel : row.orgId,
+                    plan: row.plan,
+                    addon: row.aiAddon ? 'on' : 'off',
+                    credits: count(row.credits),
+                    cost: money(row.providerCostUsd),
+                    refusals: count(row.refusals.total),
+                    refusalDetail: row.refusals.total > 0 ? `band ${row.refusals.band} \u00b7 ceiling ${row.refusals.cap} \u00b7 messages ${row.refusals.messages} \u00b7 backstop ${row.refusals.budget}` + (row.refusals.allotment > 0 ? ` \u00b7 allotments ${row.refusals.allotment}` : '') + (freeTasteRefusals(row.refusals) > 0 ? ` \u00b7 free taste ${freeTasteRefusals(row.refusals)}` : '') : ''
+                };
+            }),
+            footnote: rankingFootnote((_ref1 = spend == null ? void 0 : (_spend_rows = spend.rows) == null ? void 0 : _spend_rows.length) != null ? _ref1 : 0, (_ref2 = spend == null ? void 0 : spend.ranked) != null ? _ref2 : 0, {
+                one: 'workspace',
+                many: 'workspaces'
+            })
+        },
+        split: {
+            note: 'The same spend split two ways. By tier answers whether the free cap or the paid price is the lever; by model answers whether a cheaper model on the common path would do, the one lever that never reaches the customer.',
+            empty: !totals ? 'No assist turns recorded yet.' : totals.providerCostUsd === 0 ? totals.deflected >= totals.messages ? `Nothing spent on these ${count(totals.messages)} turns: every one was answered from the docs index or the answer cache, with no model call. There is no split to show until a turn reaches a provider.` : `${count(totals.messages - totals.deflected)} of ${count(totals.messages)} turns reached a model and every one priced at $0. That is a gap in the rate table, not a saving: the serving model has no entry in the cost model, so its spend is landing nowhere.` : '',
+            tier: totals && totals.providerCostUsd !== 0 ? splitRows(totals.byTier) : [],
+            model: totals && totals.providerCostUsd !== 0 ? splitRows(totals.byModel) : []
+        },
+        kinds: ((totals == null ? void 0 : totals.byKind) ? kindTokenRows(totals.byKind) : []).map((row)=>({
+                kind: row.kind,
+                headline: `${count(row.messages)} requests \u00b7 ${money(row.messages ? row.providerCostUsd / row.messages : 0)} per request \u00b7 cache hit ${percent(row.cacheHitRate)}`,
+                detail: `in ${count(row.inputTokens)} \u00b7 cache reads ${count(row.cacheReadTokens)} \u00b7 cache writes ${count(row.cacheWriteTokens)} \u00b7 out ${count(row.outputTokens)} \u00b7 p95 out ${count(row.outputP95)}`
+            })),
+        docsGaps: {
+            footnote: rankingFootnote((_ref3 = (_report_docsGaps1 = report.docsGaps) == null ? void 0 : _report_docsGaps1.length) != null ? _ref3 : 0, (_ref4 = (_report_ranked = report.ranked) == null ? void 0 : _report_ranked.docsGaps) != null ? _ref4 : 0, {
+                one: 'cited page',
+                many: 'cited pages'
+            }),
+            rows: ((_report_docsGaps = report.docsGaps) != null ? _report_docsGaps : []).map((row)=>({
+                    path: row.path,
+                    headline: `${row.questions} questions \u00b7 down rate ${percent(row.downRate)} \u00b7 ${row.orgs} workspaces`,
+                    detail: `up ${row.up} \u00b7 down ${row.down} \u00b7 cost ${money(row.providerCostUsd)}`
+                }))
+        },
+        ungrounded: {
+            note: `${count((_ref5 = (_report_ungrounded = report.ungrounded) == null ? void 0 : _report_ungrounded.questions) != null ? _ref5 : 0)} turns matched no documentation at all, ${(_ref6 = (_report_ungrounded1 = report.ungrounded) == null ? void 0 : _report_ungrounded1.down) != null ? _ref6 : 0} of them rated down. These cite no page, so they cannot appear in the ranking above: a missing page is invisible to anything keyed on paths.`,
+            footnote: rankingFootnote((_ref7 = (_report_ungrounded2 = report.ungrounded) == null ? void 0 : (_report_ungrounded_routes = _report_ungrounded2.routes) == null ? void 0 : _report_ungrounded_routes.length) != null ? _ref7 : 0, (_ref8 = (_report_ranked1 = report.ranked) == null ? void 0 : _report_ranked1.ungroundedRoutes) != null ? _ref8 : 0, {
+                one: 'console page',
+                many: 'console pages'
+            }),
+            rows: ((_ref9 = (_report_ungrounded3 = report.ungrounded) == null ? void 0 : _report_ungrounded3.routes) != null ? _ref9 : []).map((row)=>({
+                    route: row.route,
+                    detail: `${row.questions} questions \u00b7 ${row.down} rated down`
+                }))
+        },
+        prose: ((_report_prose = report.prose) != null ? _report_prose : []).map((row)=>{
+            var _row_orgLabel;
+            return {
+                flag: row.feedback === 'down' ? 'rated down' : 'no documentation matched',
+                flagTone: row.feedback === 'down' ? 'error' : 'neutral',
+                where: `${row.route} \u00b7 ${(_row_orgLabel = row.orgLabel) != null ? _row_orgLabel : row.orgId}`,
+                text: row.expired ? 'The words are past their 180-day retention and have been deleted. The counts still include this turn.' : row.question || '(no question recorded)',
+                answer: !row.expired && row.answer ? `We said: ${row.answer}${row.answerTruncated ? '\u2026' : ''}` : ''
+            };
+        }),
+        orgs: {
+            footnote: rankingFootnote((_ref10 = (_report_orgs1 = report.orgs) == null ? void 0 : _report_orgs1.length) != null ? _ref10 : 0, (_ref11 = (_report_ranked2 = report.ranked) == null ? void 0 : _report_ranked2.orgs) != null ? _ref11 : 0, {
+                one: 'workspace',
+                many: 'workspaces'
+            }),
+            rows: ((_report_orgs = report.orgs) != null ? _report_orgs : []).map((row)=>{
+                var _row_orgLabel;
+                return {
+                    orgId: row.orgId,
+                    workspace: (_row_orgLabel = row.orgLabel) != null ? _row_orgLabel : row.orgId,
+                    headline: `${count(row.messages)} turns \u00b7 cost ${money(row.providerCostUsd)} \u00b7 down ${row.down}`,
+                    detail: `in ${count(row.inputTokens)} \u00b7 out ${count(row.outputTokens)} \u00b7 cache reads ${count(row.cacheReadTokens)}`
+                };
+            })
+        }
+    };
+}
+
+//# sourceMappingURL=assist-signals-view.js.map

package/src/lib/usage/assist-signals-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/usage/assist-signals-view.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 { aiAddonName } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  costSplitRows,\n  freeTasteRefusals,\n  kindTokenRows,\n  type AssistMiningReport,\n  type AssistSpendRow,\n} from './assist-signal-mining'\n\n/*\n * THE ASSIST SIGNAL BOARD, AS THE STAFF PAGE PRINTS IT (AGL-3667).\n *\n * `/admin/assist-signals` draws the mining report in the browser: money to the\n * cent (four places under a dollar), shares as whole percents, the cost split\n * by tier, model and kind. The staff apps read the same report through\n * `/api/ai/admin/signals?view=prepared`, which sends each table as the lines\n * the page prints, so a figure or a sentence on the board is decided once.\n */\n\nexport const money = (value: number): string =>\n  `$${(Number(value) || 0).toFixed(Math.abs(Number(value) || 0) < 1 ? 4 : 2)}`\n\nexport const percent = (value: number | null): string => (value == null ? '\\u2014' : `${Math.round(value * 100)}%`)\n\n/** The line under a ranking, which is a cut and not a page. */\nexport function rankingFootnote(shown: number, total: number, noun: { one: string; many: string }): string {\n  if (!total) return ''\n  const counted = `${total.toLocaleString('en-US')} ${total === 1 ? noun.one : noun.many}`\n  return shown >= total\n    ? `Showing all ${counted}.`\n    : `Showing the top ${shown.toLocaleString('en-US')} of ${counted}. This is a ranking, not a page \\u2014 what is past the cut is what it ranked lowest.`\n}\n\ntype SpendBoard = {\n  month: string\n  rows: AssistSpendRow[]\n  ranked: number\n  truncated: boolean\n  failed: boolean\n}\n\ntype ProseRow = {\n  orgId: string\n  orgLabel?: string | null\n  exchangeId: string\n  route: string\n  feedback: 'up' | 'down' | null\n  expired?: boolean\n  question?: string | null\n  answer?: string | null\n  answerTruncated?: boolean\n}\n\nexport interface AssistSignalsView {\n  truncatedNote: string\n  fleet: { chips: string[]; empty: string }\n  freeSpend: { line: string; tone: 'error' | 'warning' | 'neutral' } | null\n  spend: {\n    heading: string\n    note: string\n    addonName: string\n    rows: Array<{ orgId: string; workspace: string; plan: string; addon: string; credits: string; cost: string; refusals: string; refusalDetail: string }>\n    footnote: string\n  }\n  split: {\n    note: string\n    empty: string\n    tier: Array<{ key: string; detail: string }>\n    model: Array<{ key: string; detail: string }>\n  }\n  kinds: Array<{ kind: string; headline: string; detail: string }>\n  docsGaps: { footnote: string; rows: Array<{ path: string; headline: string; detail: string }> }\n  ungrounded: { note: string; footnote: string; rows: Array<{ route: string; detail: string }> }\n  prose: Array<{ flag: string; flagTone: string; where: string; text: string; answer: string }>\n  orgs: { footnote: string; rows: Array<{ orgId: string; workspace: string; headline: string; detail: string }> }\n}\n\nconst count = (value: number) => (Number(value) || 0).toLocaleString('en-US')\n\nexport function assistSignalsView(report: AssistMiningReport & { spend?: SpendBoard | null; prose?: ProseRow[] }): AssistSignalsView {\n  const totals = report.totals\n  const spend = report.spend ?? null\n  const shareOf = (cost: number, total: number) => percent(total > 0 ? cost / total : null)\n  const splitRows = (split: Record<string, { messages: number; providerCostUsd: number }>) =>\n    costSplitRows(split as never).map((row) => ({\n      key: row.key,\n      detail: `${count(row.messages)} turns \\u00b7 ${money(row.providerCostUsd)} \\u00b7 ${shareOf(row.providerCostUsd, totals?.providerCostUsd ?? 0)}`,\n    }))\n  const free = report.freeSpend\n  const chips = totals\n    ? [\n        `${count(totals.messages)} turns`,\n        `${money(totals.providerCostUsd)} estimated`,\n        `answered free ${percent(totals.deflectionRate)} (${count(totals.deflected ?? 0)})`,\n        `${count(totals.inputTokens)} in / ${count(totals.outputTokens)} out`,\n        `cache reads ${percent(totals.cacheReadRate)}`,\n        `cache writes ${count(totals.cacheWriteTokens)}`,\n        `up ${totals.feedback.up} \\u00b7 down ${totals.feedback.down} \\u00b7 unrated ${totals.feedback.none}`,\n        ...Object.entries(totals.stopReasons).map(([reason, total]) => `${reason}: ${total}`),\n      ]\n    : []\n  return {\n    truncatedNote: report.truncated\n      ? `Ranked the first ${count(report.scanned)} signals only; there are more. Every number below describes that sample, not the fleet.`\n      : '',\n    fleet: { chips, empty: totals ? '' : 'No assist turns recorded yet.' },\n    freeSpend: free\n      ? {\n          line:\n            `free tier today ${money(free.estCostUsd)} of ${money(free.ceilingUsd)} ceiling \\u00b7 ${count(free.requests)} requests` +\n            (free.paused ? ' \\u00b7 PAUSED until tomorrow' : ''),\n          tone: free.paused ? 'error' : free.alerted ? 'warning' : 'neutral',\n        }\n      : null,\n    spend: {\n      heading: `AI spend this month, by workspace${spend ? ` \\u00b7 ${spend.month}` : ''}`,\n      note: spend?.failed\n        ? 'Could not read this month\\u2019s spend documents: a failed read, not a month in which nobody spent.'\n        : spend?.truncated\n          ? 'Ranked over a sample of the month documents; there are more. This is not the whole fleet.'\n          : '',\n      addonName: aiAddonName(),\n      rows: (spend?.rows ?? []).map((row) => ({\n        orgId: row.orgId,\n        workspace: row.orgLabel ?? row.orgId,\n        plan: row.plan,\n        addon: row.aiAddon ? 'on' : 'off',\n        credits: count(row.credits),\n        cost: money(row.providerCostUsd),\n        refusals: count(row.refusals.total),\n        refusalDetail:\n          row.refusals.total > 0\n            ? `band ${row.refusals.band} \\u00b7 ceiling ${row.refusals.cap} \\u00b7 messages ${row.refusals.messages} \\u00b7 backstop ${row.refusals.budget}` +\n              (row.refusals.allotment > 0 ? ` \\u00b7 allotments ${row.refusals.allotment}` : '') +\n              (freeTasteRefusals(row.refusals) > 0 ? ` \\u00b7 free taste ${freeTasteRefusals(row.refusals)}` : '')\n            : '',\n      })),\n      footnote: rankingFootnote(spend?.rows?.length ?? 0, spend?.ranked ?? 0, { one: 'workspace', many: 'workspaces' }),\n    },\n    split: {\n      note: 'The same spend split two ways. By tier answers whether the free cap or the paid price is the lever; by model answers whether a cheaper model on the common path would do, the one lever that never reaches the customer.',\n      empty: !totals\n        ? 'No assist turns recorded yet.'\n        : totals.providerCostUsd === 0\n          ? totals.deflected >= totals.messages\n            ? `Nothing spent on these ${count(totals.messages)} turns: every one was answered from the docs index or the answer cache, with no model call. There is no split to show until a turn reaches a provider.`\n            : `${count(totals.messages - totals.deflected)} of ${count(totals.messages)} turns reached a model and every one priced at $0. That is a gap in the rate table, not a saving: the serving model has no entry in the cost model, so its spend is landing nowhere.`\n          : '',\n      tier: totals && totals.providerCostUsd !== 0 ? splitRows(totals.byTier) : [],\n      model: totals && totals.providerCostUsd !== 0 ? splitRows(totals.byModel) : [],\n    },\n    kinds: (totals?.byKind ? kindTokenRows(totals.byKind) : []).map((row) => ({\n      kind: row.kind,\n      headline: `${count(row.messages)} requests \\u00b7 ${money(row.messages ? row.providerCostUsd / row.messages : 0)} per request \\u00b7 cache hit ${percent(row.cacheHitRate)}`,\n      detail: `in ${count(row.inputTokens)} \\u00b7 cache reads ${count(row.cacheReadTokens)} \\u00b7 cache writes ${count(row.cacheWriteTokens)} \\u00b7 out ${count(row.outputTokens)} \\u00b7 p95 out ${count(row.outputP95)}`,\n    })),\n    docsGaps: {\n      footnote: rankingFootnote(report.docsGaps?.length ?? 0, report.ranked?.docsGaps ?? 0, { one: 'cited page', many: 'cited pages' }),\n      rows: (report.docsGaps ?? []).map((row) => ({\n        path: row.path,\n        headline: `${row.questions} questions \\u00b7 down rate ${percent(row.downRate)} \\u00b7 ${row.orgs} workspaces`,\n        detail: `up ${row.up} \\u00b7 down ${row.down} \\u00b7 cost ${money(row.providerCostUsd)}`,\n      })),\n    },\n    ungrounded: {\n      note: `${count(report.ungrounded?.questions ?? 0)} turns matched no documentation at all, ${report.ungrounded?.down ?? 0} of them rated down. These cite no page, so they cannot appear in the ranking above: a missing page is invisible to anything keyed on paths.`,\n      footnote: rankingFootnote(report.ungrounded?.routes?.length ?? 0, report.ranked?.ungroundedRoutes ?? 0, { one: 'console page', many: 'console pages' }),\n      rows: (report.ungrounded?.routes ?? []).map((row) => ({ route: row.route, detail: `${row.questions} questions \\u00b7 ${row.down} rated down` })),\n    },\n    prose: (report.prose ?? []).map((row) => ({\n      flag: row.feedback === 'down' ? 'rated down' : 'no documentation matched',\n      flagTone: row.feedback === 'down' ? 'error' : 'neutral',\n      where: `${row.route} \\u00b7 ${row.orgLabel ?? row.orgId}`,\n      text: row.expired\n        ? 'The words are past their 180-day retention and have been deleted. The counts still include this turn.'\n        : row.question || '(no question recorded)',\n      answer: !row.expired && row.answer ? `We said: ${row.answer}${row.answerTruncated ? '\\u2026' : ''}` : '',\n    })),\n    orgs: {\n      footnote: rankingFootnote(report.orgs?.length ?? 0, report.ranked?.orgs ?? 0, { one: 'workspace', many: 'workspaces' }),\n      rows: (report.orgs ?? []).map((row) => ({\n        orgId: row.orgId,\n        workspace: row.orgLabel ?? row.orgId,\n        headline: `${count(row.messages)} turns \\u00b7 cost ${money(row.providerCostUsd)} \\u00b7 down ${row.down}`,\n        detail: `in ${count(row.inputTokens)} \\u00b7 out ${count(row.outputTokens)} \\u00b7 cache reads ${count(row.cacheReadTokens)}`,\n      })),\n    },\n  }\n}\n"],"names":["aiAddonName","costSplitRows","freeTasteRefusals","kindTokenRows","money","value","Number","toFixed","Math","abs","percent","round","rankingFootnote","shown","total","noun","counted","toLocaleString","one","many","count","assistSignalsView","report","totals","spend","shareOf","cost","splitRows","split","map","row","key","detail","messages","providerCostUsd","free","freeSpend","chips","deflectionRate","deflected","inputTokens","outputTokens","cacheReadRate","cacheWriteTokens","feedback","up","down","none","Object","entries","stopReasons","reason","truncatedNote","truncated","scanned","fleet","empty","line","estCostUsd","ceilingUsd","requests","paused","tone","alerted","heading","month","note","failed","addonName","rows","orgId","workspace","orgLabel","plan","addon","aiAddon","credits","refusals","refusalDetail","band","cap","budget","allotment","footnote","length","ranked","tier","byTier","model","byModel","kinds","byKind","kind","headline","cacheHitRate","cacheReadTokens","outputP95","docsGaps","path","questions","downRate","orgs","ungrounded","routes","ungroundedRoutes","route","prose","flag","flagTone","where","text","expired","question","answer","answerTruncated"],"mappings":"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"}

package/src/lib/usage/staff-org-ai-conversations-view.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 { StaffAiAssistRow, StaffAiConversationPerson, StaffAiJobResult, StaffAiJobRow } from './staff-org-ai-conversations';
+export declare const who: (person: StaffAiConversationPerson) => string;
+export declare const money: (value: number | null) => string | null;
+/** What a job kept beside it, as the label above it and the words under it. */
+export declare function jobResultText(result: StaffAiJobResult): {
+    label: string;
+    text: string;
+};
+/** The chips under an Assist turn: where it was asked, the model, the cost, the thumbs. */
+export declare function assistChips(row: StaffAiAssistRow): string[];
+/** The chips under a job: its kind, its status, what it spent. */
+export declare function jobChips(row: StaffAiJobRow): string[];
+/** What a job made, one line each. */
+export declare function jobMadeText(row: StaffAiJobRow): string;
+/** The fields filled in beside a brief, one line each. */
+export declare function jobFilledInText(row: StaffAiJobRow): string;
+export interface StaffAiRowView {
+    who: string;
+    /** The chips joined into the one line under a list row. */
+    meta: string;
+    chips: string[];
+    /** Empty for an Assist turn and for a job with nothing filled in. */
+    filledIn: string;
+    resultLabel: string;
+    /** Empty when the kind keeps nothing beside the job, or the result has expired. */
+    resultText: string;
+    made: string;
+}
+export declare function staffAiAssistRowView(row: StaffAiAssistRow): StaffAiRowView;
+export declare function staffAiJobRowView(row: StaffAiJobRow): StaffAiRowView;
+/** A page with each row's `view` beside it. */
+export declare function withRowViews<T extends {
+    kind: 'assist' | 'jobs';
+    rows: StaffAiAssistRow[] | StaffAiJobRow[];
+}>(page: T): T;

package/src/lib/usage/staff-org-ai-conversations-view.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.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/*
+ * THE AI REQUESTS CARD, AS IT PRINTS (AGL-3667).
+ *
+ * The staff card lists what people typed to Aglyn AI and what came back. The
+ * words themselves are the rows' own; what the card adds is who asked (an
+ * email, else a name, else the uid), the chips under each row (the route and
+ * model and cost of an Assist turn, the kind and status and credits of a job),
+ * the fields filled in beside a brief, the result a job kept, and what it made.
+ * The staff apps read the same rows through
+ * `/api/ai/admin/conversations?view=prepared`, which sends each row with that
+ * `view`, so those lines are decided once, and the card imports them too.
+ */ export const who = (person)=>{
+    var _ref, _person_email;
+    return (_ref = (_person_email = person.email) != null ? _person_email : person.name) != null ? _ref : person.uid ? `uid ${person.uid}` : 'Unknown member';
+};
+export const money = (value)=>value === null ? null : `$${value.toFixed(value < 1 ? 4 : 2)}`;
+/** What a job kept beside it, as the label above it and the words under it. */ export function jobResultText(result) {
+    switch(result.kind){
+        case 'insight':
+            return {
+                label: 'Answer',
+                text: [
+                    ...result.insights,
+                    ...result.gap ? [
+                        `Not answered: ${result.gap}`
+                    ] : []
+                ].join('\n\n')
+            };
+        case 'crm-record':
+            return {
+                label: 'Summary',
+                text: [
+                    result.summary,
+                    result.standing,
+                    result.nextStep ? `Next step: ${result.nextStep}` : null
+                ].filter(Boolean).join('\n\n')
+            };
+        case 'crm-email':
+            return {
+                label: 'Email draft',
+                text: `Subject: ${result.subject}\n\n${result.body}`
+            };
+        case 'crm-mapping':
+            return {
+                label: 'Column matches',
+                text: result.matches.join('\n')
+            };
+    }
+}
+/** The chips under an Assist turn: where it was asked, the model, the cost, the thumbs. */ export function assistChips(row) {
+    return [
+        row.route,
+        row.model,
+        money(row.estCostUsd),
+        row.feedback ? `Rated ${row.feedback}` : null
+    ].filter((chip)=>Boolean(chip));
+}
+/** The chips under a job: its kind, its status, what it spent. */ export function jobChips(row) {
+    return [
+        row.kind,
+        row.status,
+        `${row.credits.toLocaleString('en-US')} credits`
+    ];
+}
+/** What a job made, one line each. */ export function jobMadeText(row) {
+    return row.outputs.map((output)=>[
+            output.label,
+            output.note
+        ].filter(Boolean).join(' — ')).join('\n');
+}
+/** The fields filled in beside a brief, one line each. */ export function jobFilledInText(row) {
+    var _row_inputs;
+    return ((_row_inputs = row.inputs) != null ? _row_inputs : []).map((input)=>`${input.label}: ${input.value}`).join('\n');
+}
+export function staffAiAssistRowView(row) {
+    const chips = assistChips(row);
+    return {
+        who: who(row.by),
+        meta: chips.join(' · '),
+        chips,
+        filledIn: '',
+        resultLabel: '',
+        resultText: '',
+        made: ''
+    };
+}
+export function staffAiJobRowView(row) {
+    var _ref, _ref1;
+    const chips = jobChips(row);
+    const result = row.result ? jobResultText(row.result) : null;
+    return {
+        who: who(row.by),
+        meta: chips.join(' · '),
+        chips,
+        filledIn: jobFilledInText(row),
+        resultLabel: (_ref = result == null ? void 0 : result.label) != null ? _ref : '',
+        resultText: (_ref1 = result == null ? void 0 : result.text) != null ? _ref1 : '',
+        made: jobMadeText(row)
+    };
+}
+/** A page with each row's `view` beside it. */ export function withRowViews(page) {
+    return _extends({}, page, {
+        rows: page.kind === 'assist' ? page.rows.map((row)=>_extends({}, row, {
+                view: staffAiAssistRowView(row)
+            })) : page.rows.map((row)=>_extends({}, row, {
+                view: staffAiJobRowView(row)
+            }))
+    });
+}
+
+//# sourceMappingURL=staff-org-ai-conversations-view.js.map

package/src/lib/usage/staff-org-ai-conversations-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/usage/staff-org-ai-conversations-view.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 type {\n  StaffAiAssistRow,\n  StaffAiConversationPerson,\n  StaffAiJobResult,\n  StaffAiJobRow,\n} from './staff-org-ai-conversations'\n\n/*\n * THE AI REQUESTS CARD, AS IT PRINTS (AGL-3667).\n *\n * The staff card lists what people typed to Aglyn AI and what came back. The\n * words themselves are the rows' own; what the card adds is who asked (an\n * email, else a name, else the uid), the chips under each row (the route and\n * model and cost of an Assist turn, the kind and status and credits of a job),\n * the fields filled in beside a brief, the result a job kept, and what it made.\n * The staff apps read the same rows through\n * `/api/ai/admin/conversations?view=prepared`, which sends each row with that\n * `view`, so those lines are decided once, and the card imports them too.\n */\n\nexport const who = (person: StaffAiConversationPerson): string =>\n  person.email ?? person.name ?? (person.uid ? `uid ${person.uid}` : 'Unknown member')\n\nexport const money = (value: number | null): string | null =>\n  value === null ? null : `$${value.toFixed(value < 1 ? 4 : 2)}`\n\n/** What a job kept beside it, as the label above it and the words under it. */\nexport function jobResultText(result: StaffAiJobResult): { label: string; text: string } {\n  switch (result.kind) {\n    case 'insight':\n      return {\n        label: 'Answer',\n        text: [...result.insights, ...(result.gap ? [`Not answered: ${result.gap}`] : [])].join('\\n\\n'),\n      }\n    case 'crm-record':\n      return {\n        label: 'Summary',\n        text: [result.summary, result.standing, result.nextStep ? `Next step: ${result.nextStep}` : null]\n          .filter(Boolean)\n          .join('\\n\\n'),\n      }\n    case 'crm-email':\n      return { label: 'Email draft', text: `Subject: ${result.subject}\\n\\n${result.body}` }\n    case 'crm-mapping':\n      return { label: 'Column matches', text: result.matches.join('\\n') }\n  }\n}\n\n/** The chips under an Assist turn: where it was asked, the model, the cost, the thumbs. */\nexport function assistChips(row: StaffAiAssistRow): string[] {\n  return [row.route, row.model, money(row.estCostUsd), row.feedback ? `Rated ${row.feedback}` : null].filter(\n    (chip): chip is string => Boolean(chip),\n  )\n}\n\n/** The chips under a job: its kind, its status, what it spent. */\nexport function jobChips(row: StaffAiJobRow): string[] {\n  return [row.kind, row.status, `${row.credits.toLocaleString('en-US')} credits`]\n}\n\n/** What a job made, one line each. */\nexport function jobMadeText(row: StaffAiJobRow): string {\n  return row.outputs.map((output) => [output.label, output.note].filter(Boolean).join(' — ')).join('\\n')\n}\n\n/** The fields filled in beside a brief, one line each. */\nexport function jobFilledInText(row: StaffAiJobRow): string {\n  return (row.inputs ?? []).map((input) => `${input.label}: ${input.value}`).join('\\n')\n}\n\nexport interface StaffAiRowView {\n  who: string\n  /** The chips joined into the one line under a list row. */\n  meta: string\n  chips: string[]\n  /** Empty for an Assist turn and for a job with nothing filled in. */\n  filledIn: string\n  resultLabel: string\n  /** Empty when the kind keeps nothing beside the job, or the result has expired. */\n  resultText: string\n  made: string\n}\n\nexport function staffAiAssistRowView(row: StaffAiAssistRow): StaffAiRowView {\n  const chips = assistChips(row)\n  return { who: who(row.by), meta: chips.join(' · '), chips, filledIn: '', resultLabel: '', resultText: '', made: '' }\n}\n\nexport function staffAiJobRowView(row: StaffAiJobRow): StaffAiRowView {\n  const chips = jobChips(row)\n  const result = row.result ? jobResultText(row.result) : null\n  return {\n    who: who(row.by),\n    meta: chips.join(' · '),\n    chips,\n    filledIn: jobFilledInText(row),\n    resultLabel: result?.label ?? '',\n    resultText: result?.text ?? '',\n    made: jobMadeText(row),\n  }\n}\n\n/** A page with each row's `view` beside it. */\nexport function withRowViews<T extends { kind: 'assist' | 'jobs'; rows: StaffAiAssistRow[] | StaffAiJobRow[] }>(\n  page: T,\n): T {\n  return {\n    ...page,\n    rows:\n      page.kind === 'assist'\n        ? (page.rows as StaffAiAssistRow[]).map((row) => ({ ...row, view: staffAiAssistRowView(row) }))\n        : (page.rows as StaffAiJobRow[]).map((row) => ({ ...row, view: staffAiJobRowView(row) })),\n  }\n}\n"],"names":["who","person","email","name","uid","money","value","toFixed","jobResultText","result","kind","label","text","insights","gap","join","summary","standing","nextStep","filter","Boolean","subject","body","matches","assistChips","row","route","model","estCostUsd","feedback","chip","jobChips","status","credits","toLocaleString","jobMadeText","outputs","map","output","note","jobFilledInText","inputs","input","staffAiAssistRowView","chips","by","meta","filledIn","resultLabel","resultText","made","staffAiJobRowView","withRowViews","page","rows","view"],"mappings":"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"}

package/src/lib/usage/staff-org-ai-view.d.ts

@@ -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.
+ */
+import { type StaffAssistPool, type StaffOrgUsageAiMonth } from './staff-org-usage-ai';
+import type { StaffAiAccountAllowance, StaffOrgAiMargin, StaffOrgAiOverage, StaffOrgAiPool, StaffOrgAiRefusals, StaffOrgAiResponse } from './staff-org-ai';
+export declare const credits: (value: number | null | undefined) => string;
+/**
+ * Four decimals under a dollar, two above (the assist-signals page's rule):
+ * a month that really cost eight cents must not read as `$0.00`.
+ */
+export declare const usd: (value: number | null | undefined) => string;
+export declare const tokenCount: (value: number) => string;
+export declare const rate: (value: number | null) => string;
+/** The pool as one sentence naming every part that is non-zero. */
+export declare function poolPartsSentence(pool: StaffOrgAiPool, addonName: string): string;
+/**
+ * The overage's state as one line: sold, walled, or capped — or, for an
+ * uncapped staff comp (AGL-3049), nothing to sell past at all.
+ */
+export declare function overageStateSentence(overage: StaffOrgAiOverage, uncapped?: boolean): string;
+/** Whether the margin section renders red. */
+export declare function marginTone(margin: StaffOrgAiMargin): 'error' | 'warning' | 'success';
+/** The words for each reason the gate refused, in the order the card lists them. */
+export declare const REFUSAL_LABELS: Record<keyof Omit<StaffOrgAiRefusals, 'total'>, string>;
+/**
+ * Each reason as the chip the card draws: `band 3`. A reason the answering
+ * server does not yet count reads as zero.
+ */
+export declare function refusalChips(refusals: StaffOrgAiRefusals): Array<{
+    label: string;
+    count: number;
+}>;
+/** The statuses the jobs row names, and the ones that turn it amber or red. */
+export declare const JOB_CHIP_STATUSES: readonly ["queued", "running", "needs_input", "needs_review", "failed"];
+/** What the add-on row says about when it was bought. */
+export declare function addonSinceNote(addon: StaffOrgAiResponse['addon']): string;
+/** Which meters a give-back may go to, as the dialog offers them, and the one it starts on. */
+export declare function creditReturnMeters(hasWorkspace: boolean, hasAccount: boolean): Array<{
+    value: 'both' | 'workspace' | 'account';
+    label: string;
+}>;
+/** The most one give-back may return to the meter(s) chosen: the lower of the two for both. */
+export declare function creditReturnable(meter: 'both' | 'workspace' | 'account', workspaceUsed: number | null, accountUsed: number | null): number;
+/** The sentence under the give-back form: what each meter used, which is all it can return. */
+export declare function creditReturnSummary(workspaceUsed: number | null, accountUsed: number | null): string;
+/** One line of the allowance, as the org card and the user card print it. */
+export declare function allowanceSentence(account: StaffAiAccountAllowance, scope: 'org' | 'user'): string;
+export interface StaffOrgAiView {
+    month: string;
+    addon: {
+        status: string;
+        price: string;
+        since: string | null;
+        sinceNote: string;
+        on: boolean;
+    };
+    pool: {
+        band: string;
+        used: string;
+        returned: string;
+        allowance: string;
+        projected: string;
+    };
+    overage: {
+        line: string;
+        state: string;
+    };
+    refusals: {
+        heading: string;
+        chips: string[];
+    };
+    jobs: {
+        failedRead: boolean;
+        empty: boolean;
+        chips: string[];
+        floor: string;
+        recent: Array<{
+            id: string;
+            kind: string;
+            status: string;
+            credits: string;
+            startedAt: string | null;
+            startedBy: string | null;
+            giveBack: number;
+        }>;
+    };
+    tokens: {
+        totals: string;
+        cacheHit: string;
+        empty: boolean;
+        kinds: Array<{
+            kind: string;
+            headline: string;
+            detail: string;
+        }>;
+    } | null;
+    users: Array<{
+        uid: string;
+        name: string;
+        headline: string;
+        detail: string;
+    }>;
+    margin: {
+        tone: 'error' | 'warning' | 'success';
+        text: string;
+        contribution: string;
+    };
+    giveBack: {
+        meters: Array<{
+            value: string;
+            label: string;
+        }>;
+        defaultMeter: string;
+        summary: string;
+        returnable: number;
+    };
+    /**
+     * The AI columns of the org page's monthly usage table, and the pool line it draws above them
+     * (`staffOrgUsageColumn`); null where the reader did not hand the rollups over.
+     */
+    usage: {
+        pool: string;
+        months: Array<{
+            month: string;
+            headline: string;
+            detail: string;
+        }>;
+    } | null;
+}
+/** The AI fields of one monthly rollup, with the month they belong to. */
+export type StaffOrgAiUsageRollup = StaffOrgUsageAiMonth & {
+    month: string;
+};
+/** The card's figures as the sentences it prints. */
+export declare function staffOrgAiView(data: StaffOrgAiResponse, addonName: string, usage?: {
+    pool: StaffAssistPool;
+    months: readonly StaffOrgAiUsageRollup[];
+}): StaffOrgAiView;
+/** One row of `/api/ai/admin/user`: a workspace's month for the account. */
+export interface StaffUserAiRow {
+    orgId: string;
+    orgName: string | null;
+    slug: string | null;
+    month: string;
+    credits: number;
+    requests: number;
+    refusals: number;
+}
+export interface StaffUserAiView {
+    allowance: string;
+    giveBack: {
+        summary: string;
+        returnable: number;
+    };
+    empty: string;
+    rows: Array<{
+        orgId: string;
+        workspace: string;
+        month: string;
+        headline: string;
+        detail: string;
+    }>;
+}
+/** The account card as it prints: the Free allowance, and a row per workspace per month kept. */
+export declare function staffUserAiView(data: {
+    rows: StaffUserAiRow[];
+    allowance: StaffAiAccountAllowance | null;
+}): StaffUserAiView;