@aglyn/plugins-ai 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/usage/assist-spend-guards.js

@@ -0,0 +1,182 @@
+/**
+ * @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 AI PLUGIN'S SPEND GUARDS: the staff review threshold on one
+ * workspace's monthly provider spend, the hard ceiling past which its
+ * reservations refuse, and the dedupe arithmetic the usage-alerts sweep's
+ * contributor announces both with. Pure over configured values and the
+ * sweep's guard map, so the meter that refuses and the alert that announces
+ * the refusal read one variable and agree on what it means.
+ */ /**
+ * The MARGIN GUARD.
+ *
+ * A customer's usage budget (`usage-budget.ts`) protects the customer. This
+ * protects the platform, from the one meter whose unit cost is real money
+ * paid to a third party and whose ceiling is a message count rather than a
+ * dollar figure: `assistEntitledMonthlyLimit` caps an entitled org at 1,000
+ * MESSAGES a month, and a thousand long, cache-cold Opus-class exchanges is
+ * a three-figure bill against a subscription that did not move.
+ *
+ * So one org's Assist COGS crossing this threshold notifies STAFF, not the
+ * customer — the customer is not being charged and has done nothing wrong.
+ * Returns the threshold crossed, or 0.
+ *
+ * `ASSIST_ORG_MONTHLY_COGS_ALERT_USD` overrides the default and FAILS TO THE
+ * DEFAULT: a blank or malformed value that disabled the guard would be
+ * another alert that cannot fire.
+ */ export const ASSIST_ORG_MONTHLY_COGS_ALERT_USD_DEFAULT = 25;
+export function assistCogsAlertThresholdUsd(configured) {
+    const parsed = Number(String(configured != null ? configured : '').trim());
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return ASSIST_ORG_MONTHLY_COGS_ALERT_USD_DEFAULT;
+    }
+    return parsed;
+}
+/**
+ * The repo default spend ceiling: **$40 per org per month** (AGL-2264).
+ *
+ * The number is arithmetic rather than pricing. After AGL-2441 the
+ * 1,000-message entitled guard bounds roughly $28/org/month of worst-case
+ * spend at Sonnet, and the staff margin alert already fires at $25. $40
+ * therefore sits ABOVE anything the message cap can produce at the current
+ * model, so it changes no charged amount and no plan's behaviour — it is a
+ * ceiling on OUR cost, not a customer price, which is why it is outside the
+ * Sept-1 pricing lock. It binds only when an assumption behind that
+ * arithmetic has moved: an `ASSIST_MODEL` swap to an Opus-class tier, a
+ * longer prompt, or a caller finding another way to inflate input. That is
+ * the failure it exists for.
+ *
+ * It ships as a DEFAULT rather than as an environment variable someone must
+ * remember, because an unset ceiling is the fail-open this issue was opened
+ * about: a fresh deployment and a self-hoster both inherit a sane bound
+ * without knowing the variable exists.
+ *
+ * The free tier gets no separate figure and needs none — its 10 messages a
+ * UTC day bound it at roughly $0.28/day, so this is a backstop it cannot
+ * reach rather than a cap it runs into.
+ *
+ * ⚠️ It applies only to an org whose plan sells NO assist band. Agency and
+ * Enterprise include more assist than $40 of spend, so the meter's
+ * `assistMonthlyCeilingUsd` keeps this default off every plan that sells a
+ * band — see there for which figure binds when.
+ */ export const ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD = 40;
+/**
+ * The per-org monthly PROVIDER-SPEND ceiling in USD — the dollar half of
+ * the cap (AGL-2264), from `ASSIST_ORG_MONTHLY_COGS_LIMIT_USD` as the caller
+ * read it. Defaults to {@link ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD};
+ * `off` removes it.
+ *
+ * Pure over the configured value, like {@link assistCogsAlertThresholdUsd}:
+ * the meter that refuses at the ceiling and the cron that announces the
+ * refusal read the one variable and must agree on what it means.
+ *
+ * The meter's message caps bound spend only through an assumed cost per
+ * message, and that assumption is exactly what drifts: `ASSIST_MODEL` is an
+ * env override, prompts grow, and a client controls how much history it
+ * posts. The ceiling is measured against the real figure instead: the
+ * running `estCostUsd` on the month's assist usage document, which the meter
+ * increments at the SERVING model's rates. So it bounds the actual bill
+ * rather than a forecast of it.
+ *
+ * The refusal is deliberately the same shape as the message refusal (a
+ * reservation that did not move the counter), so an org at the ceiling
+ * spends nothing at all rather than spending less. It refuses — it does
+ * NOT quietly swap to a cheaper model. A silent quality drop is worse than
+ * an honest stop, because nobody can tell it happened.
+ *
+ * ⚠️ **Fails to the DEFAULT, never to “no ceiling”.** An empty, negative or
+ * unparseable value reads as unconfigured and takes the repo default, so a
+ * typo cannot reopen the fail-open this exists to close. It cannot become a
+ * ceiling of `$0` either — a value of zero is not “refuse everyone”, it is
+ * “not a number I will honour” — because an outage across every workspace
+ * would be worse than the overspend being guarded.
+ *
+ * Removing the ceiling therefore takes a WORD rather than a number:
+ * `ASSIST_ORG_MONTHLY_COGS_LIMIT_USD=off`. A deployment paying its own
+ * provider bill may genuinely want none, and that is a decision someone
+ * should have to write down rather than reach by mistyping a digit.
+ */ export function assistOrgMonthlyCostLimitUsd(configured) {
+    const operator = assistOperatorCeilingUsd(configured);
+    return operator === undefined ? ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD : operator;
+}
+/**
+ * The operator's ceiling exactly as CONFIGURED — three states, not two:
+ * a number, `null` for the word `off`, and `undefined` for unset or
+ * unparseable.
+ *
+ * `assistOrgMonthlyCostLimitUsd` collapses `undefined` onto the repo default
+ * and is the reading every existing caller wants. The composition with a
+ * plan's own band needs the third state, because "the operator wrote a
+ * number" and "nobody configured anything" have to bind differently against a
+ * band that was sold: an operator's figure is a decision, and the repo
+ * default is a backstop for orgs that have no band of their own.
+ */ export function assistOperatorCeilingUsd(configured) {
+    const raw = String(configured != null ? configured : '').trim();
+    if (raw === '') return undefined;
+    if (raw.toLowerCase() === 'off') return null;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+/**
+ * Whether this org's Assist spend has newly crossed the margin threshold.
+ *
+ * Dedupes through the same guard shape and the same month semantics as the
+ * customer budget, under its own key, so a staff alert and a customer alert
+ * can never suppress one another.
+ */ export function assistMarginBreach(input) {
+    var _ref;
+    const { assistUsd, thresholdUsd, guard, month } = input;
+    if (!Number.isFinite(assistUsd) || !Number.isFinite(thresholdUsd)) return false;
+    if (thresholdUsd <= 0 || assistUsd < thresholdUsd) return false;
+    // The guard records how many WHOLE multiples of the threshold have been
+    // announced, so an org at 1x is announced once and an org that climbs to 2x
+    // is announced again — an escalating cost must not go quiet because it
+    // already spoke.
+    const multiple = Math.floor(assistUsd / thresholdUsd);
+    if ((guard == null ? void 0 : guard.month) === month && Number((_ref = guard == null ? void 0 : guard.threshold) != null ? _ref : 0) >= multiple) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Whether this org has newly crossed the HARD spend ceiling — the one that
+ * refuses (AGL-2264), as distinct from {@link assistMarginBreach}'s review
+ * threshold, which only warns.
+ *
+ * It needs its own guard and its own announcement because the margin alert
+ * cannot carry this news. That alert speaks in WHOLE MULTIPLES of its $25
+ * threshold, so an org that climbs from $25 to the $40 ceiling is still at
+ * 1x and stays silent — staff would learn that the assistant had stopped
+ * answering for a customer only when someone complained. A ceiling that
+ * refuses quietly is the same defect as a ceiling that does not refuse.
+ *
+ * Once per org per month: crossing is a state, not an escalating figure, and
+ * the org is refused from here to the month boundary regardless of how far
+ * past it the recorded spend sits.
+ */ export function assistCeilingBreach(input) {
+    const { assistUsd, ceilingUsd, guard, month } = input;
+    if (ceilingUsd === null) return false;
+    if (!Number.isFinite(assistUsd) || !Number.isFinite(ceilingUsd)) return false;
+    if (ceilingUsd <= 0 || assistUsd < ceilingUsd) return false;
+    return (guard == null ? void 0 : guard.month) !== month;
+}
+/** The multiple {@link assistMarginBreach} would record. */ export function assistMarginMultiple(assistUsd, thresholdUsd) {
+    if (!Number.isFinite(assistUsd) || !Number.isFinite(thresholdUsd)) return 0;
+    if (thresholdUsd <= 0) return 0;
+    return Math.max(0, Math.floor(assistUsd / thresholdUsd));
+}
+
+//# sourceMappingURL=assist-spend-guards.js.map

package/src/lib/usage/assist-spend-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/usage/assist-spend-guards.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 { UsageAlertGuard } from '@aglyn/aglyn/app-utils/usage-budget'\n\n/*\n * THE AI PLUGIN'S SPEND GUARDS: the staff review threshold on one\n * workspace's monthly provider spend, the hard ceiling past which its\n * reservations refuse, and the dedupe arithmetic the usage-alerts sweep's\n * contributor announces both with. Pure over configured values and the\n * sweep's guard map, so the meter that refuses and the alert that announces\n * the refusal read one variable and agree on what it means.\n */\n\n/**\n * The MARGIN GUARD.\n *\n * A customer's usage budget (`usage-budget.ts`) protects the customer. This\n * protects the platform, from the one meter whose unit cost is real money\n * paid to a third party and whose ceiling is a message count rather than a\n * dollar figure: `assistEntitledMonthlyLimit` caps an entitled org at 1,000\n * MESSAGES a month, and a thousand long, cache-cold Opus-class exchanges is\n * a three-figure bill against a subscription that did not move.\n *\n * So one org's Assist COGS crossing this threshold notifies STAFF, not the\n * customer — the customer is not being charged and has done nothing wrong.\n * Returns the threshold crossed, or 0.\n *\n * `ASSIST_ORG_MONTHLY_COGS_ALERT_USD` overrides the default and FAILS TO THE\n * DEFAULT: a blank or malformed value that disabled the guard would be\n * another alert that cannot fire.\n */\nexport const ASSIST_ORG_MONTHLY_COGS_ALERT_USD_DEFAULT = 25\n\nexport function assistCogsAlertThresholdUsd(\n  configured?: string | null,\n): number {\n  const parsed = Number(String(configured ?? '').trim())\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    return ASSIST_ORG_MONTHLY_COGS_ALERT_USD_DEFAULT\n  }\n  return parsed\n}\n\n/**\n * The repo default spend ceiling: **$40 per org per month** (AGL-2264).\n *\n * The number is arithmetic rather than pricing. After AGL-2441 the\n * 1,000-message entitled guard bounds roughly $28/org/month of worst-case\n * spend at Sonnet, and the staff margin alert already fires at $25. $40\n * therefore sits ABOVE anything the message cap can produce at the current\n * model, so it changes no charged amount and no plan's behaviour — it is a\n * ceiling on OUR cost, not a customer price, which is why it is outside the\n * Sept-1 pricing lock. It binds only when an assumption behind that\n * arithmetic has moved: an `ASSIST_MODEL` swap to an Opus-class tier, a\n * longer prompt, or a caller finding another way to inflate input. That is\n * the failure it exists for.\n *\n * It ships as a DEFAULT rather than as an environment variable someone must\n * remember, because an unset ceiling is the fail-open this issue was opened\n * about: a fresh deployment and a self-hoster both inherit a sane bound\n * without knowing the variable exists.\n *\n * The free tier gets no separate figure and needs none — its 10 messages a\n * UTC day bound it at roughly $0.28/day, so this is a backstop it cannot\n * reach rather than a cap it runs into.\n *\n * ⚠️ It applies only to an org whose plan sells NO assist band. Agency and\n * Enterprise include more assist than $40 of spend, so the meter's\n * `assistMonthlyCeilingUsd` keeps this default off every plan that sells a\n * band — see there for which figure binds when.\n */\nexport const ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD = 40\n\n/**\n * The per-org monthly PROVIDER-SPEND ceiling in USD — the dollar half of\n * the cap (AGL-2264), from `ASSIST_ORG_MONTHLY_COGS_LIMIT_USD` as the caller\n * read it. Defaults to {@link ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD};\n * `off` removes it.\n *\n * Pure over the configured value, like {@link assistCogsAlertThresholdUsd}:\n * the meter that refuses at the ceiling and the cron that announces the\n * refusal read the one variable and must agree on what it means.\n *\n * The meter's message caps bound spend only through an assumed cost per\n * message, and that assumption is exactly what drifts: `ASSIST_MODEL` is an\n * env override, prompts grow, and a client controls how much history it\n * posts. The ceiling is measured against the real figure instead: the\n * running `estCostUsd` on the month's assist usage document, which the meter\n * increments at the SERVING model's rates. So it bounds the actual bill\n * rather than a forecast of it.\n *\n * The refusal is deliberately the same shape as the message refusal (a\n * reservation that did not move the counter), so an org at the ceiling\n * spends nothing at all rather than spending less. It refuses — it does\n * NOT quietly swap to a cheaper model. A silent quality drop is worse than\n * an honest stop, because nobody can tell it happened.\n *\n * ⚠️ **Fails to the DEFAULT, never to “no ceiling”.** An empty, negative or\n * unparseable value reads as unconfigured and takes the repo default, so a\n * typo cannot reopen the fail-open this exists to close. It cannot become a\n * ceiling of `$0` either — a value of zero is not “refuse everyone”, it is\n * “not a number I will honour” — because an outage across every workspace\n * would be worse than the overspend being guarded.\n *\n * Removing the ceiling therefore takes a WORD rather than a number:\n * `ASSIST_ORG_MONTHLY_COGS_LIMIT_USD=off`. A deployment paying its own\n * provider bill may genuinely want none, and that is a decision someone\n * should have to write down rather than reach by mistyping a digit.\n */\nexport function assistOrgMonthlyCostLimitUsd(\n  configured?: string | null,\n): number | null {\n  const operator = assistOperatorCeilingUsd(configured)\n  return operator === undefined\n    ? ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD\n    : operator\n}\n\n/**\n * The operator's ceiling exactly as CONFIGURED — three states, not two:\n * a number, `null` for the word `off`, and `undefined` for unset or\n * unparseable.\n *\n * `assistOrgMonthlyCostLimitUsd` collapses `undefined` onto the repo default\n * and is the reading every existing caller wants. The composition with a\n * plan's own band needs the third state, because \"the operator wrote a\n * number\" and \"nobody configured anything\" have to bind differently against a\n * band that was sold: an operator's figure is a decision, and the repo\n * default is a backstop for orgs that have no band of their own.\n */\nexport function assistOperatorCeilingUsd(\n  configured?: string | null,\n): number | null | undefined {\n  const raw = String(configured ?? '').trim()\n  if (raw === '') return undefined\n  if (raw.toLowerCase() === 'off') return null\n  const parsed = Number(raw)\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined\n}\n\n/**\n * Whether this org's Assist spend has newly crossed the margin threshold.\n *\n * Dedupes through the same guard shape and the same month semantics as the\n * customer budget, under its own key, so a staff alert and a customer alert\n * can never suppress one another.\n */\nexport function assistMarginBreach(input: {\n  assistUsd: number\n  thresholdUsd: number\n  guard: UsageAlertGuard | null | undefined\n  month: string\n}): boolean {\n  const { assistUsd, thresholdUsd, guard, month } = input\n  if (!Number.isFinite(assistUsd) || !Number.isFinite(thresholdUsd)) return false\n  if (thresholdUsd <= 0 || assistUsd < thresholdUsd) return false\n  // The guard records how many WHOLE multiples of the threshold have been\n  // announced, so an org at 1x is announced once and an org that climbs to 2x\n  // is announced again — an escalating cost must not go quiet because it\n  // already spoke.\n  const multiple = Math.floor(assistUsd / thresholdUsd)\n  if (guard?.month === month && Number(guard?.threshold ?? 0) >= multiple) {\n    return false\n  }\n  return true\n}\n\n/**\n * Whether this org has newly crossed the HARD spend ceiling — the one that\n * refuses (AGL-2264), as distinct from {@link assistMarginBreach}'s review\n * threshold, which only warns.\n *\n * It needs its own guard and its own announcement because the margin alert\n * cannot carry this news. That alert speaks in WHOLE MULTIPLES of its $25\n * threshold, so an org that climbs from $25 to the $40 ceiling is still at\n * 1x and stays silent — staff would learn that the assistant had stopped\n * answering for a customer only when someone complained. A ceiling that\n * refuses quietly is the same defect as a ceiling that does not refuse.\n *\n * Once per org per month: crossing is a state, not an escalating figure, and\n * the org is refused from here to the month boundary regardless of how far\n * past it the recorded spend sits.\n */\nexport function assistCeilingBreach(input: {\n  assistUsd: number\n  ceilingUsd: number | null\n  guard: UsageAlertGuard | null | undefined\n  month: string\n}): boolean {\n  const { assistUsd, ceilingUsd, guard, month } = input\n  if (ceilingUsd === null) return false\n  if (!Number.isFinite(assistUsd) || !Number.isFinite(ceilingUsd)) return false\n  if (ceilingUsd <= 0 || assistUsd < ceilingUsd) return false\n  return guard?.month !== month\n}\n\n/** The multiple {@link assistMarginBreach} would record. */\nexport function assistMarginMultiple(\n  assistUsd: number,\n  thresholdUsd: number,\n): number {\n  if (!Number.isFinite(assistUsd) || !Number.isFinite(thresholdUsd)) return 0\n  if (thresholdUsd <= 0) return 0\n  return Math.max(0, Math.floor(assistUsd / thresholdUsd))\n}\n"],"names":["ASSIST_ORG_MONTHLY_COGS_ALERT_USD_DEFAULT","assistCogsAlertThresholdUsd","configured","parsed","Number","String","trim","isFinite","ASSIST_ORG_MONTHLY_COGS_LIMIT_DEFAULT_USD","assistOrgMonthlyCostLimitUsd","operator","assistOperatorCeilingUsd","undefined","raw","toLowerCase","assistMarginBreach","input","assistUsd","thresholdUsd","guard","month","multiple","Math","floor","threshold","assistCeilingBreach","ceilingUsd","assistMarginMultiple","max"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID;;;;;;;CAOC,GAED;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,MAAMA,4CAA4C,GAAE;AAE3D,OAAO,SAASC,4BACdC,UAA0B;IAE1B,MAAMC,SAASC,OAAOC,OAAOH,qBAAAA,aAAc,IAAII,IAAI;IACnD,IAAI,CAACF,OAAOG,QAAQ,CAACJ,WAAWA,UAAU,GAAG;QAC3C,OAAOH;IACT;IACA,OAAOG;AACT;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GACD,OAAO,MAAMK,4CAA4C,GAAE;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCC,GACD,OAAO,SAASC,6BACdP,UAA0B;IAE1B,MAAMQ,WAAWC,yBAAyBT;IAC1C,OAAOQ,aAAaE,YAChBJ,4CACAE;AACN;AAEA;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,yBACdT,UAA0B;IAE1B,MAAMW,MAAMR,OAAOH,qBAAAA,aAAc,IAAII,IAAI;IACzC,IAAIO,QAAQ,IAAI,OAAOD;IACvB,IAAIC,IAAIC,WAAW,OAAO,OAAO,OAAO;IACxC,MAAMX,SAASC,OAAOS;IACtB,OAAOT,OAAOG,QAAQ,CAACJ,WAAWA,SAAS,IAAIA,SAASS;AAC1D;AAEA;;;;;;CAMC,GACD,OAAO,SAASG,mBAAmBC,KAKlC;;IACC,MAAM,EAAEC,SAAS,EAAEC,YAAY,EAAEC,KAAK,EAAEC,KAAK,EAAE,GAAGJ;IAClD,IAAI,CAACZ,OAAOG,QAAQ,CAACU,cAAc,CAACb,OAAOG,QAAQ,CAACW,eAAe,OAAO;IAC1E,IAAIA,gBAAgB,KAAKD,YAAYC,cAAc,OAAO;IAC1D,wEAAwE;IACxE,4EAA4E;IAC5E,uEAAuE;IACvE,iBAAiB;IACjB,MAAMG,WAAWC,KAAKC,KAAK,CAACN,YAAYC;IACxC,IAAIC,CAAAA,yBAAAA,MAAOC,KAAK,MAAKA,SAAShB,eAAOe,yBAAAA,MAAOK,SAAS,mBAAI,MAAMH,UAAU;QACvE,OAAO;IACT;IACA,OAAO;AACT;AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASI,oBAAoBT,KAKnC;IACC,MAAM,EAAEC,SAAS,EAAES,UAAU,EAAEP,KAAK,EAAEC,KAAK,EAAE,GAAGJ;IAChD,IAAIU,eAAe,MAAM,OAAO;IAChC,IAAI,CAACtB,OAAOG,QAAQ,CAACU,cAAc,CAACb,OAAOG,QAAQ,CAACmB,aAAa,OAAO;IACxE,IAAIA,cAAc,KAAKT,YAAYS,YAAY,OAAO;IACtD,OAAOP,CAAAA,yBAAAA,MAAOC,KAAK,MAAKA;AAC1B;AAEA,0DAA0D,GAC1D,OAAO,SAASO,qBACdV,SAAiB,EACjBC,YAAoB;IAEpB,IAAI,CAACd,OAAOG,QAAQ,CAACU,cAAc,CAACb,OAAOG,QAAQ,CAACW,eAAe,OAAO;IAC1E,IAAIA,gBAAgB,GAAG,OAAO;IAC9B,OAAOI,KAAKM,GAAG,CAAC,GAAGN,KAAKC,KAAK,CAACN,YAAYC;AAC5C"}

package/src/lib/usage/assist-usage.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type PublicAssistCredits } from '@aglyn/aglyn/app-utils/assist-credits';
+import { type PublicAssistCredits } from './assist-credits';
 import { type AiOverageCapReason } from '../billing/ai-overage-gate';
 import type { AiRefusedBy } from '../model/ai-allotments';
 import { type AiAllotmentGate, type AiAllotmentRequestSubject } from './ai-allotments';

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

@@ -22,7 +22,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * initialization (cert credential, RTDB, AppCheck) into every unit test that
  * touches a counter; `FieldValue`'s statics need no app at all.
  */ import { FieldValue } from "firebase-admin/firestore";
-import { ASSIST_PROVIDER_COST_FIELD, assistBandRefuses, assistCreditsFromUsd, assistMonthOverage, assistOverageCapReached, publicAssistCredits, resolveAssistBudgetUsd, resolveAssistOverageCapUsd, resolveAssistOverageRateUsdPer1k } from "@aglyn/aglyn/app-utils/assist-credits";
+import { ASSIST_PROVIDER_COST_FIELD, assistBandRefuses, assistCreditsFromUsd, assistMonthOverage, assistOverageCapReached, publicAssistCredits, resolveAssistBudgetUsd, resolveAssistOverageCapUsd, resolveAssistOverageRateUsdPer1k } from "./assist-credits.js";
 import { aiOverageRefusal } from "../billing/ai-overage-gate.js";
 import { aiOverageBillsByInvoice, aiOverageGuardsApply } from "../billing/ai-overage-cutover.js";
 import { AI_BILLING_STANDING_DOC, AI_BILLING_SUBCOLLECTION, readAiOverageMonthLedger } from "../billing/ai-overage-ledger.js";