@burdenoff/fe-libs 2026.1027.14 → 2026.1028.2

package/dist/shared/assistant/createSandboxAssistantTransport.js

@@ -28,7 +28,7 @@ function D(e, t) {
 }
 function O(O, k) {
 	let A = O.mode ?? "assistant", j = O.streamBudgetMs ?? S, M = { accumulateNarration: O.accumulateNarration === !0 }, N = O.ttlSeconds ?? 3600, P = O.isProdRuntime ?? (() => !1), F = O.enableCredits ?? !1, I = _("transport", O.product), L = (e) => async (t) => {
-		t.messageId && await f(t.workspaceId, t.sessionId, t.messageId, t.model, t.tokens, e);
+		t.messageId && await f(t.workspaceId, t.sessionId, t.messageId, t.model, t.tokens, e, O.product, O.aiCreditLedger);
 	}, R = new h({
 		product: O.product,
 		mode: A,
@@ -141,7 +141,7 @@ function O(O, k) {
 				let e = await b(I, n, L(r));
 				if (!e.ok) throw x(e.kind);
 			}
-			return F && l(n, r).catch((e) => {
+			return F && l(n, r, O.product, O.aiCreditLedger).catch((e) => {
 				t(e) && O.onQuotaExhausted?.(e);
 			}), B(e, n, r, 1);
 		},

package/dist/shared/assistant/index.d.ts

@@ -302,6 +302,7 @@ export * from './appControls/languageReply';
 export * from './appControls/text';
 export * from './turnOutcomeCopy';
 export * from './aiCredits';
+export * from './productAiCredits';
 export * from './usageReporting';
 export * from './writeProposals';
 export * from './writeReplyBinder';

package/dist/shared/assistant/operations.d.ts

@@ -40,6 +40,14 @@ export declare const STOP_MY_ASSISTANT_SANDBOX = "\n  mutation StopMyAssistantSa
 export declare const EXTEND_MY_ASSISTANT_SANDBOX_TTL = "\n  mutation ExtendMyAssistantSandboxTtl(\n    $id: ID!\n    $additionalSeconds: Int!\n    $context: ContextInput!\n  ) {\n    extendMyAssistantSandboxTTL(id: $id, additionalSeconds: $additionalSeconds, context: $context) {\n      id\n      expiresAt\n    }\n  }\n";
 export declare const CHECK_AI_CREDITS = "\n  mutation CheckAiCredits {\n    checkAiCredits\n  }\n";
 export declare const REPORT_AI_TOKEN_USAGE = "\n  mutation ReportAiTokenUsage($input: ReportAiTokenUsageInput!) {\n    reportAiTokenUsage(input: $input)\n  }\n";
+/**
+ * BOFF-3732: the shared, product-keyed AI-credit gate and charge in
+ * wspace-prompts-svc. Each works on `<productKey>.ai.credits`, so a product's
+ * assistant turns are billed to its own quota, never VibeControls'.
+ */
+export declare const CHECK_AI_CREDITS_FOR = "\n  mutation CheckAiCreditsFor($productKey: String!) {\n    checkAiCreditsFor(productKey: $productKey) {\n      provisioned\n      exhausted\n      remaining\n    }\n  }\n";
+export declare const CHARGE_AI_INVOCATION = "\n  mutation ChargeAiInvocation($input: PromptChargeAiInvocationInput!) {\n    chargeAiInvocation(input: $input) {\n      status\n      reason\n      credits\n    }\n  }\n";
+export declare const AI_CREDIT_STATUS = "\n  query AiCreditStatus($productKey: String!) {\n    aiCreditStatus(productKey: $productKey) {\n      productKey\n      quotaName\n      provisioned\n      noLimit\n      used\n      limit\n      remaining\n      exhausted\n    }\n  }\n";
 /**
  * BOFF-7801: finished turns' timings for the production latency histograms
  * (wspace-sandbox-svc). Self-scoped — the actor comes from the gateway, and

package/dist/shared/assistant/operations.js

@@ -1,4 +1,4 @@
 //#region src/shared/assistant/operations.ts
-var e = "\n  mutation CreateSandbox($input: CreateSandboxInput!) {\n    createSandbox(input: $input) {\n      id\n      name\n      status\n      network {\n        internalUrl\n      }\n    }\n  }\n", t = "\n  query GetSandbox($id: ID!, $context: ContextInput!) {\n    getSandbox(id: $id, context: $context) {\n      id\n      status\n      errorMessage\n      network {\n        internalUrl\n      }\n    }\n  }\n", n = "\n  query WaitForSandboxRunning($id: ID!, $timeoutSeconds: Int, $context: ContextInput!) {\n    waitForSandboxRunning(id: $id, timeoutSeconds: $timeoutSeconds, context: $context) {\n      id\n      status\n      errorMessage\n    }\n  }\n", r = "\n  query WaitForAssistantReady($id: ID!, $timeoutSeconds: Int, $context: ContextInput!) {\n    waitForAssistantReady(id: $id, timeoutSeconds: $timeoutSeconds, context: $context) {\n      ready\n      health\n      waited\n    }\n  }\n", i = "\n  query GetActiveSandboxes($context: ContextInput!) {\n    getActiveSandboxes(context: $context) {\n      id\n      name\n      status\n      metadata\n      template\n      createdBy\n    }\n  }\n", a = "\n  mutation ProxySandboxRequest($input: ProxySandboxRequestInput!) {\n    proxySandboxRequest(input: $input) {\n      status\n      body\n    }\n  }\n", o = "\n  mutation StopAssistantSandbox($id: ID!, $context: ContextInput!) {\n    stopSandbox(id: $id, context: $context) {\n      id\n      status\n    }\n  }\n", s = "\n  mutation ExtendSandboxTtl($id: ID!, $additionalSeconds: Int!, $context: ContextInput!) {\n    extendSandboxTTL(id: $id, additionalSeconds: $additionalSeconds, context: $context) {\n      id\n      expiresAt\n    }\n  }\n", c = "\n  mutation ProvisionAssistantSandbox($input: ProvisionAssistantSandboxInput!) {\n    provisionAssistantSandbox(input: $input) {\n      id\n      name\n      status\n    }\n  }\n", l = "\n  mutation StopMyAssistantSandbox($id: ID!, $context: ContextInput!) {\n    stopMyAssistantSandbox(id: $id, context: $context) {\n      id\n      status\n    }\n  }\n", u = "\n  mutation ExtendMyAssistantSandboxTtl(\n    $id: ID!\n    $additionalSeconds: Int!\n    $context: ContextInput!\n  ) {\n    extendMyAssistantSandboxTTL(id: $id, additionalSeconds: $additionalSeconds, context: $context) {\n      id\n      expiresAt\n    }\n  }\n", d = "\n  mutation CheckAiCredits {\n    checkAiCredits\n  }\n", f = "\n  mutation ReportAiTokenUsage($input: ReportAiTokenUsageInput!) {\n    reportAiTokenUsage(input: $input)\n  }\n", p = "\n  mutation ReportMyAssistantTurnTimings($input: ReportAssistantTurnTimingsInput!) {\n    reportMyAssistantTurnTimings(input: $input) {\n      enabled\n      accepted\n      rejected\n      duplicate\n      rateLimited\n    }\n  }\n";
+var e = "\n  mutation CreateSandbox($input: CreateSandboxInput!) {\n    createSandbox(input: $input) {\n      id\n      name\n      status\n      network {\n        internalUrl\n      }\n    }\n  }\n", t = "\n  query GetSandbox($id: ID!, $context: ContextInput!) {\n    getSandbox(id: $id, context: $context) {\n      id\n      status\n      errorMessage\n      network {\n        internalUrl\n      }\n    }\n  }\n", n = "\n  query WaitForSandboxRunning($id: ID!, $timeoutSeconds: Int, $context: ContextInput!) {\n    waitForSandboxRunning(id: $id, timeoutSeconds: $timeoutSeconds, context: $context) {\n      id\n      status\n      errorMessage\n    }\n  }\n", r = "\n  query WaitForAssistantReady($id: ID!, $timeoutSeconds: Int, $context: ContextInput!) {\n    waitForAssistantReady(id: $id, timeoutSeconds: $timeoutSeconds, context: $context) {\n      ready\n      health\n      waited\n    }\n  }\n", i = "\n  query GetActiveSandboxes($context: ContextInput!) {\n    getActiveSandboxes(context: $context) {\n      id\n      name\n      status\n      metadata\n      template\n      createdBy\n    }\n  }\n", a = "\n  mutation ProxySandboxRequest($input: ProxySandboxRequestInput!) {\n    proxySandboxRequest(input: $input) {\n      status\n      body\n    }\n  }\n", o = "\n  mutation StopAssistantSandbox($id: ID!, $context: ContextInput!) {\n    stopSandbox(id: $id, context: $context) {\n      id\n      status\n    }\n  }\n", s = "\n  mutation ExtendSandboxTtl($id: ID!, $additionalSeconds: Int!, $context: ContextInput!) {\n    extendSandboxTTL(id: $id, additionalSeconds: $additionalSeconds, context: $context) {\n      id\n      expiresAt\n    }\n  }\n", c = "\n  mutation ProvisionAssistantSandbox($input: ProvisionAssistantSandboxInput!) {\n    provisionAssistantSandbox(input: $input) {\n      id\n      name\n      status\n    }\n  }\n", l = "\n  mutation StopMyAssistantSandbox($id: ID!, $context: ContextInput!) {\n    stopMyAssistantSandbox(id: $id, context: $context) {\n      id\n      status\n    }\n  }\n", u = "\n  mutation ExtendMyAssistantSandboxTtl(\n    $id: ID!\n    $additionalSeconds: Int!\n    $context: ContextInput!\n  ) {\n    extendMyAssistantSandboxTTL(id: $id, additionalSeconds: $additionalSeconds, context: $context) {\n      id\n      expiresAt\n    }\n  }\n", d = "\n  mutation CheckAiCredits {\n    checkAiCredits\n  }\n", f = "\n  mutation ReportAiTokenUsage($input: ReportAiTokenUsageInput!) {\n    reportAiTokenUsage(input: $input)\n  }\n", p = "\n  mutation CheckAiCreditsFor($productKey: String!) {\n    checkAiCreditsFor(productKey: $productKey) {\n      provisioned\n      exhausted\n      remaining\n    }\n  }\n", m = "\n  mutation ChargeAiInvocation($input: PromptChargeAiInvocationInput!) {\n    chargeAiInvocation(input: $input) {\n      status\n      reason\n      credits\n    }\n  }\n", h = "\n  query AiCreditStatus($productKey: String!) {\n    aiCreditStatus(productKey: $productKey) {\n      productKey\n      quotaName\n      provisioned\n      noLimit\n      used\n      limit\n      remaining\n      exhausted\n    }\n  }\n", g = "\n  mutation ReportMyAssistantTurnTimings($input: ReportAssistantTurnTimingsInput!) {\n    reportMyAssistantTurnTimings(input: $input) {\n      enabled\n      accepted\n      rejected\n      duplicate\n      rateLimited\n    }\n  }\n";
 //#endregion
-export { d as CHECK_AI_CREDITS, e as CREATE_SANDBOX, u as EXTEND_MY_ASSISTANT_SANDBOX_TTL, s as EXTEND_SANDBOX_TTL, i as GET_ACTIVE_SANDBOXES, t as GET_SANDBOX, c as PROVISION_ASSISTANT_SANDBOX, a as PROXY_SANDBOX_REQUEST, f as REPORT_AI_TOKEN_USAGE, p as REPORT_MY_ASSISTANT_TURN_TIMINGS, o as STOP_ASSISTANT_SANDBOX, l as STOP_MY_ASSISTANT_SANDBOX, r as WAIT_FOR_ASSISTANT_READY, n as WAIT_FOR_SANDBOX_RUNNING };
+export { h as AI_CREDIT_STATUS, m as CHARGE_AI_INVOCATION, d as CHECK_AI_CREDITS, p as CHECK_AI_CREDITS_FOR, e as CREATE_SANDBOX, u as EXTEND_MY_ASSISTANT_SANDBOX_TTL, s as EXTEND_SANDBOX_TTL, i as GET_ACTIVE_SANDBOXES, t as GET_SANDBOX, c as PROVISION_ASSISTANT_SANDBOX, a as PROXY_SANDBOX_REQUEST, f as REPORT_AI_TOKEN_USAGE, g as REPORT_MY_ASSISTANT_TURN_TIMINGS, o as STOP_ASSISTANT_SANDBOX, l as STOP_MY_ASSISTANT_SANDBOX, r as WAIT_FOR_ASSISTANT_READY, n as WAIT_FOR_SANDBOX_RUNNING };

package/dist/shared/assistant/productAiCredits.d.ts

@@ -0,0 +1,28 @@
+import { UsageReport } from './usageReporting';
+/** How a workspace stands against `<productKey>.ai.credits`. */
+export interface AiCreditStatus {
+    productKey: string;
+    quotaName: string;
+    /** False when the workspace has no assignment for the quota: AI is not metered there. */
+    provisioned: boolean;
+    noLimit: boolean;
+    used: number | null;
+    limit: number | null;
+    remaining: number | null;
+    exhausted: boolean;
+}
+/** The operation key the shared ledger stores for an assistant turn. */
+export declare const ASSISTANT_TURN_OPERATION = "assistant.turn";
+/**
+ * A `reportTokenUsage` for `AssistantProductProvider` that charges the
+ * product's own AI credits. A turn without a message id or model is skipped:
+ * the server needs the first for idempotency and the second for the price.
+ */
+export declare function createAiCreditReporter(productKey: string): (report: UsageReport) => Promise<void>;
+/** Parse an `aiCreditStatus` payload; anything malformed reads as null. */
+export declare function parseAiCreditStatus(value: unknown): AiCreditStatus | null;
+/**
+ * The workspace's remaining AI credits for a product, for showing the balance
+ * before an AI action. Resolves null when it cannot be read; never throws.
+ */
+export declare function fetchAiCreditStatus(productKey: string, workspaceId?: string): Promise<AiCreditStatus | null>;

package/dist/shared/assistant/productAiCredits.js

@@ -0,0 +1,64 @@
+import { graphqlFetch as e } from "../graphql/fetch.js";
+import { AI_CREDIT_STATUS as t, CHARGE_AI_INVOCATION as n } from "./operations.js";
+//#region src/shared/assistant/productAiCredits.ts
+var r = "assistant.turn";
+function i(t) {
+	return async (i) => {
+		let { workspaceId: a, sessionId: o, messageId: s, model: c, tokens: l } = i;
+		if (!s || !c) return;
+		let u = Math.max(0, Math.round(l.input ?? 0)), d = Math.max(0, Math.round(l.output ?? 0)), f = Math.max(0, Math.round(l.cache?.read ?? 0)), p = Math.max(0, Math.round(l.cache?.write ?? 0));
+		u + d + f + p !== 0 && await e({
+			gateway: "workspace",
+			query: n,
+			operationName: "ChargeAiInvocation",
+			variables: { input: {
+				productKey: t,
+				sessionId: o,
+				messageId: s,
+				model: c,
+				inputTokens: u,
+				outputTokens: d,
+				cacheReadTokens: f,
+				cacheWriteTokens: p,
+				operationKey: r
+			} },
+			workspaceId: a,
+			suppressGlobalErrorEvent: !0
+		});
+	};
+}
+function a(e) {
+	return typeof e == "number" && Number.isFinite(e) ? e : null;
+}
+function o(e) {
+	if (!e || typeof e != "object") return null;
+	let t = e.aiCreditStatus;
+	if (!t || typeof t != "object") return null;
+	let n = t;
+	return typeof n.productKey != "string" || typeof n.quotaName != "string" || typeof n.provisioned != "boolean" || typeof n.noLimit != "boolean" || typeof n.exhausted != "boolean" ? null : {
+		productKey: n.productKey,
+		quotaName: n.quotaName,
+		provisioned: n.provisioned,
+		noLimit: n.noLimit,
+		used: a(n.used),
+		limit: a(n.limit),
+		remaining: a(n.remaining),
+		exhausted: n.exhausted
+	};
+}
+async function s(n, r) {
+	try {
+		return o(await e({
+			gateway: "workspace",
+			query: t,
+			operationName: "AiCreditStatus",
+			variables: { productKey: n },
+			workspaceId: r ?? !0,
+			suppressGlobalErrorEvent: !0
+		}));
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { r as ASSISTANT_TURN_OPERATION, i as createAiCreditReporter, s as fetchAiCreditStatus, o as parseAiCreditStatus };

package/dist/shared/assistant/types.d.ts

@@ -30,6 +30,8 @@ export type ProductAssistantMode = string & {
 };
 export type AssistantMode = BuiltInAssistantMode | ProductAssistantMode;
 /** Local mirror of a product's PageContext; the transport forwards a subset. */
+/** Where a product's assistant AI credits are gated and charged (see `aiCreditLedger`). */
+export type AiCreditLedger = 'shared' | 'product-service';
 export interface PageContext {
     currentUrl?: string;
     currentPage?: string;
@@ -164,6 +166,19 @@ export interface SandboxAssistantConfig {
      * pauses the next send until it is (`usageReporting.ts`).
      */
     enableCredits?: boolean;
+    /**
+     * Which service gates and charges this product's AI credits (BOFF-3732).
+     *
+     * - `'shared'` (default): wspace-prompts-svc's product-keyed
+     *   `checkAiCreditsFor` / `chargeAiInvocation`, against
+     *   `<product>.ai.credits`.
+     * - `'product-service'`: the product's own service declares
+     *   `checkAiCredits` / `reportAiTokenUsage` and charges its own quota. Only a
+     *   product whose service really owns those mutations may set it: they are
+     *   declared once in the supergraph, so any other product setting it bills
+     *   that service's quota, not its own.
+     */
+    aiCreditLedger?: AiCreditLedger;
     /** Overall per-turn deadline. Default 420_000ms. */
     streamBudgetMs?: number;
     /**

package/dist/shared/pages/AiPage.js

@@ -4,47 +4,49 @@ import { useAuth as n } from "../providers/shell/AuthProvider.js";
 import { useActiveContext as r } from "../providers/shell/ActiveContextProvider.js";
 import { MainLandmark as i } from "../components/SkipToContent.js";
 import { PermissionProvider as a, usePermissions as o, useSafePermissions as s } from "../providers/shell/PermissionProvider.js";
-import { MODELS as c, PROVIDERS as l, SUMMARY as u, catalog as d, sevenDays as f, summary as p } from "./ai/contracts.js";
-import { useAiTr as m } from "./ai/i18n.js";
-import { CatalogPanel as h } from "./ai/CatalogPanel.js";
-import { SummaryPanel as g } from "./ai/SummaryPanel.js";
-import { useAiRead as _ } from "./ai/useAiRead.js";
-import { useCallback as v, useMemo as y, useState as b } from "react";
-import { Fragment as x, jsx as S, jsxs as C } from "react/jsx-runtime";
+import { BREAKDOWN as c, CREDITS as l, MODELS as u, PROVIDERS as d, SUMMARY as f, breakdown as p, catalog as m, credits as h, sevenDays as g, summary as _ } from "./ai/contracts.js";
+import { useAiTr as v } from "./ai/i18n.js";
+import { CatalogPanel as y } from "./ai/CatalogPanel.js";
+import { SummaryPanel as b } from "./ai/SummaryPanel.js";
+import { BreakdownPanel as x } from "./ai/BreakdownPanel.js";
+import { CreditsPanel as S } from "./ai/CreditsPanel.js";
+import { useAiRead as C } from "./ai/useAiRead.js";
+import { useCallback as w, useMemo as T, useState as E } from "react";
+import { Fragment as D, jsx as O, jsxs as k } from "react/jsx-runtime";
 //#region src/shared/pages/AiPage.tsx
-function w({ productName: t, productId: n }) {
-	let r = m(), a = e("workspace");
-	return /* @__PURE__ */ C(i, {
+function A({ productName: t, productId: n }) {
+	let r = v(), a = e("workspace");
+	return /* @__PURE__ */ k(i, {
 		className: "mx-auto w-full max-w-6xl space-y-6 px-4 py-6 sm:px-6",
 		"data-product-id": n,
-		children: [/* @__PURE__ */ C("header", {
+		children: [/* @__PURE__ */ k("header", {
 			className: "space-y-2",
-			children: [/* @__PURE__ */ S("h1", {
+			children: [/* @__PURE__ */ O("h1", {
 				className: "text-2xl font-semibold text-foreground",
 				children: r("title", "{product} AI operations", { product: t })
-			}), /* @__PURE__ */ S("p", {
+			}), /* @__PURE__ */ O("p", {
 				className: "max-w-3xl text-sm text-muted-foreground",
 				children: r("intro", "Review the workspace model catalog and recorded AI usage.")
 			})]
-		}), a ? /* @__PURE__ */ S(T, { children: /* @__PURE__ */ S(E, {
+		}), a ? /* @__PURE__ */ O(j, { children: /* @__PURE__ */ O(M, {
 			productId: n,
 			client: a
-		}) }) : /* @__PURE__ */ S("p", {
+		}) }) : /* @__PURE__ */ O("p", {
 			role: "status",
 			children: r("unavailable", "AI operations are unavailable in this context.")
 		})]
 	});
 }
-function T({ children: e }) {
+function j({ children: e }) {
 	let t = s(), { workspaceId: n } = r();
-	return t ? e : /* @__PURE__ */ S(a, {
+	return t ? e : /* @__PURE__ */ O(a, {
 		scopeId: n ?? null,
 		gateway: "workspace",
 		children: e
 	});
 }
-function E({ productId: e, client: i }) {
-	let a = n(), { workspaceId: s } = r(), w = o(), { locale: T } = t(), E = m(), D = y(() => ({
+function M({ productId: e, client: i }) {
+	let a = n(), { workspaceId: s } = r(), A = o(), { locale: j } = t(), M = v(), N = T(() => ({
 		workspaceId: s ?? "",
 		actorId: a.user?.id ?? "",
 		profileId: a.activeProfileId,
@@ -56,78 +58,102 @@ function E({ productId: e, client: i }) {
 		a.activeProfileId,
 		a.tokens?.accessToken,
 		a.workspaceToken
-	]), [O, k] = b(f), [A, j] = b({
-		scope: D,
+	]), [P, F] = E(g), [I, L] = E({
+		scope: N,
 		models: 0,
 		providers: 0,
 		revision: 0
-	}), M = A.scope === D ? A.models : 0, N = A.scope === D ? A.providers : 0, P = A.scope === D ? A.revision : 0, F = (e) => a.isLoading ? "loading" : !a.isAuthenticated || !D.workspaceId || !D.actorId || !D.accessToken ? "unavailable" : w.isLoading || w.scopeId !== D.workspaceId ? "loading" : w.error ? "unavailable" : !w.isSuperAdmin && w.permissions?.actorId !== D.actorId ? "loading" : w.hasPermission(e) ? "ready" : "denied", I = y(() => ({ pagination: {
+	}), R = I.scope === N ? I.models : 0, z = I.scope === N ? I.providers : 0, B = I.scope === N ? I.revision : 0, V = (e) => a.isLoading ? "loading" : !a.isAuthenticated || !N.workspaceId || !N.actorId || !N.accessToken ? "unavailable" : A.isLoading || A.scopeId !== N.workspaceId ? "loading" : A.error ? "unavailable" : !A.isSuperAdmin && A.permissions?.actorId !== N.actorId ? "loading" : A.hasPermission(e) ? "ready" : "denied", H = T(() => ({ pagination: {
 		limit: 20,
-		offset: M
-	} }), [M]), L = y(() => ({ pagination: {
+		offset: R
+	} }), [R]), U = T(() => ({ pagination: {
 		limit: 20,
-		offset: N
-	} }), [N]), R = y(() => ({
-		...O,
+		offset: z
+	} }), [z]), W = T(() => ({
+		...P,
 		productKey: e
-	}), [O, e]), z = v((e) => d(e, "models"), []), B = v((e) => d(e, "providers"), []), V = v((t) => p(t, D.workspaceId, e, O), [
-		D.workspaceId,
+	}), [P, e]), G = w((e) => m(e, "models"), []), K = w((e) => m(e, "providers"), []), ee = w((t) => _(t, N.workspaceId, e, P), [
+		N.workspaceId,
 		e,
-		O
-	]), H = _(i, D, F("prompt-model:read"), c, I, z, P), U = _(i, D, F("prompt-provider:read"), l, L, B, P), W = _(i, D, F("prompt-invocation:read"), u, R, V, P);
-	function G() {
-		k(f()), j({
-			scope: D,
-			models: M,
-			providers: N,
-			revision: P + 1
+		P
+	]), q = C(i, N, V("prompt-model:read"), u, H, G, B), J = C(i, N, V("prompt-provider:read"), d, U, K, B), Y = C(i, N, V("prompt-invocation:read"), f, W, ee, B), X = T(() => ({
+		...P,
+		productKey: e,
+		groupBy: ["MODEL"]
+	}), [P, e]), Z = T(() => ({
+		...P,
+		productKey: e,
+		groupBy: ["OPERATION"]
+	}), [P, e]), Q = T(() => ({
+		...P,
+		productKey: e,
+		groupBy: ["TRIGGER"]
+	}), [P, e]), $ = w((t) => p(t, N.workspaceId, e, "MODEL"), [N.workspaceId, e]), te = w((t) => p(t, N.workspaceId, e, "OPERATION"), [N.workspaceId, e]), ne = w((t) => p(t, N.workspaceId, e, "TRIGGER"), [N.workspaceId, e]), re = T(() => ({ productKey: e }), [e]), ie = w((t) => h(t, e), [e]), ae = C(i, N, V("prompt-invocation:read"), c, X, $, B), oe = C(i, N, V("prompt-invocation:read"), c, Z, te, B), se = C(i, N, V("prompt-invocation:read"), c, Q, ne, B), ce = C(i, N, V("assistant:use"), l, re, ie, B);
+	function le() {
+		F(g()), L({
+			scope: N,
+			models: R,
+			providers: z,
+			revision: B + 1
 		});
 	}
-	return /* @__PURE__ */ C(x, { children: [
-		/* @__PURE__ */ C("div", {
+	return /* @__PURE__ */ k(D, { children: [
+		/* @__PURE__ */ k("div", {
 			className: "flex flex-wrap items-center justify-between gap-3",
-			children: [/* @__PURE__ */ S("p", {
+			children: [/* @__PURE__ */ O("p", {
 				className: "text-sm text-muted-foreground",
-				children: E("readonly", "Read-only workspace view")
-			}), /* @__PURE__ */ S("button", {
+				children: M("readonly", "Read-only workspace view")
+			}), /* @__PURE__ */ O("button", {
 				type: "button",
-				onClick: G,
+				onClick: le,
 				className: "rounded-md border border-border px-3 py-2 text-sm font-medium focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring",
-				children: E("refresh", "Refresh")
+				children: M("refresh", "Refresh")
 			})]
 		}),
-		/* @__PURE__ */ S(g, {
-			state: W,
-			window: O,
-			locale: T
+		/* @__PURE__ */ O(S, {
+			state: ce,
+			locale: j
 		}),
-		/* @__PURE__ */ C("div", {
+		/* @__PURE__ */ O(b, {
+			state: Y,
+			window: P,
+			locale: j
+		}),
+		/* @__PURE__ */ O(x, {
+			states: {
+				MODEL: ae,
+				OPERATION: oe,
+				TRIGGER: se
+			},
+			locale: j
+		}),
+		/* @__PURE__ */ k("div", {
 			className: "grid gap-6 lg:grid-cols-2",
-			children: [/* @__PURE__ */ S(h, {
+			children: [/* @__PURE__ */ O(y, {
 				kind: "models",
-				state: H,
-				offset: M,
-				locale: T,
-				onPage: (e) => j({
-					scope: D,
+				state: q,
+				offset: R,
+				locale: j,
+				onPage: (e) => L({
+					scope: N,
 					models: e,
-					providers: N,
-					revision: P
+					providers: z,
+					revision: B
 				})
-			}), /* @__PURE__ */ S(h, {
+			}), /* @__PURE__ */ O(y, {
 				kind: "providers",
-				state: U,
-				offset: N,
-				locale: T,
-				onPage: (e) => j({
-					scope: D,
-					models: M,
+				state: J,
+				offset: z,
+				locale: j,
+				onPage: (e) => L({
+					scope: N,
+					models: R,
 					providers: e,
-					revision: P
+					revision: B
 				})
 			})]
 		})
 	] });
 }
 //#endregion
-export { w as AiPage };
+export { A as AiPage };

package/dist/shared/pages/ai/BreakdownPanel.d.ts

@@ -0,0 +1,6 @@
+import { Breakdown, BreakdownDimension } from './contracts';
+import { ReadState } from './useAiRead';
+export declare function BreakdownPanel({ states, locale, }: {
+    states: Record<BreakdownDimension, ReadState<Breakdown>>;
+    locale: string;
+}): import('react/jsx-runtime').JSX.Element;

package/dist/shared/pages/ai/BreakdownPanel.js

@@ -0,0 +1,117 @@
+import { exactInteger as e, exactUsd as t } from "./contracts.js";
+import { useAiTr as n } from "./i18n.js";
+import { ReadNotice as r } from "./ReadNotice.js";
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+//#region src/shared/pages/ai/BreakdownPanel.tsx
+function o({ title: o, state: s, locale: c }) {
+	let l = n();
+	return /* @__PURE__ */ a("div", {
+		className: "min-w-0",
+		children: [/* @__PURE__ */ i("h3", {
+			className: "text-sm font-semibold",
+			children: o
+		}), /* @__PURE__ */ i("div", {
+			className: "mt-2",
+			"aria-live": "polite",
+			children: s.status === "ready" ? s.data.rows.length === 0 ? /* @__PURE__ */ i("p", {
+				className: "text-sm text-muted-foreground",
+				children: l("breakdownEmpty", "No recorded attempts in this window.")
+			}) : /* @__PURE__ */ a("div", {
+				className: "overflow-x-auto",
+				children: [/* @__PURE__ */ a("table", {
+					className: "w-full min-w-0 text-left text-sm",
+					children: [/* @__PURE__ */ i("thead", {
+						className: "text-xs text-muted-foreground",
+						children: /* @__PURE__ */ a("tr", { children: [
+							/* @__PURE__ */ i("th", {
+								scope: "col",
+								className: "py-1 pr-3 font-medium",
+								children: o
+							}),
+							/* @__PURE__ */ i("th", {
+								scope: "col",
+								className: "py-1 pr-3 text-right font-medium",
+								children: l("breakdownAttempts", "Attempts")
+							}),
+							/* @__PURE__ */ i("th", {
+								scope: "col",
+								className: "py-1 pr-3 text-right font-medium",
+								children: l("breakdownTokens", "Tokens")
+							}),
+							/* @__PURE__ */ i("th", {
+								scope: "col",
+								className: "py-1 text-right font-medium",
+								children: l("breakdownCost", "Est. cost")
+							})
+						] })
+					}), /* @__PURE__ */ i("tbody", { children: s.data.rows.map((n, r) => /* @__PURE__ */ a("tr", {
+						className: "border-t border-border",
+						children: [
+							/* @__PURE__ */ i("td", {
+								className: "max-w-[16rem] break-all py-1 pr-3",
+								children: n.key ?? /* @__PURE__ */ i("span", {
+									className: "text-muted-foreground",
+									children: l("breakdownUnrecorded", "Not recorded")
+								})
+							}),
+							/* @__PURE__ */ i("td", {
+								className: "py-1 pr-3 text-right tabular-nums",
+								children: e(n.attempts, c)
+							}),
+							/* @__PURE__ */ i("td", {
+								className: "py-1 pr-3 text-right tabular-nums",
+								children: n.totalTokens === null ? l("unknown", "Unknown") : e(n.totalTokens, c)
+							}),
+							/* @__PURE__ */ i("td", {
+								className: "py-1 text-right tabular-nums",
+								children: n.costMicroUsd === null ? l("unknown", "Unknown") : t(n.costMicroUsd, c)
+							})
+						]
+					}, `${n.key ?? ""}-${r}`)) })]
+				}), s.data.more && /* @__PURE__ */ i("p", {
+					className: "mt-1 text-xs text-muted-foreground",
+					children: l("breakdownMore", "Showing the highest-cost groups only.")
+				})]
+			}) : /* @__PURE__ */ i(r, { status: s.status })
+		})]
+	});
+}
+function s({ states: e, locale: t }) {
+	let r = n(), s = r("breakdown", "Where the spend went");
+	return /* @__PURE__ */ a("section", {
+		"aria-label": s,
+		className: "min-w-0 rounded-xl border border-border bg-card p-4 sm:p-5",
+		children: [
+			/* @__PURE__ */ i("h2", {
+				className: "text-lg font-semibold",
+				children: s
+			}),
+			/* @__PURE__ */ i("p", {
+				className: "mt-2 text-sm text-muted-foreground",
+				children: r("breakdownNotice", "Recorded attempts in the same window, grouped by model, AI surface and what started them. Costs are estimates.")
+			}),
+			/* @__PURE__ */ a("div", {
+				className: "mt-4 grid gap-6 xl:grid-cols-3",
+				children: [
+					/* @__PURE__ */ i(o, {
+						title: r("byModel", "Model"),
+						state: e.MODEL,
+						locale: t
+					}),
+					/* @__PURE__ */ i(o, {
+						title: r("bySurface", "AI surface"),
+						state: e.OPERATION,
+						locale: t
+					}),
+					/* @__PURE__ */ i(o, {
+						title: r("byTrigger", "Trigger"),
+						state: e.TRIGGER,
+						locale: t
+					})
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { s as BreakdownPanel };

package/dist/shared/pages/ai/CreditsPanel.d.ts

@@ -0,0 +1,10 @@
+import { CreditStatus } from './contracts';
+import { ReadState } from './useAiRead';
+/**
+ * The workspace's remaining AI credits for this product (BOFF-3732), so the
+ * balance is visible before an AI action rather than after a refusal.
+ */
+export declare function CreditsPanel({ state, locale, }: {
+    state: ReadState<CreditStatus>;
+    locale: string;
+}): import('react/jsx-runtime').JSX.Element;

package/dist/shared/pages/ai/CreditsPanel.js

@@ -0,0 +1,64 @@
+import { useAiTr as e } from "./i18n.js";
+import { ReadNotice as t } from "./ReadNotice.js";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+//#region src/shared/pages/ai/CreditsPanel.tsx
+function i({ state: i, locale: a }) {
+	let o = e(), s = o("credits", "AI credits this cycle"), c = new Intl.NumberFormat(a, { maximumFractionDigits: 0 });
+	return /* @__PURE__ */ r("section", {
+		"aria-label": s,
+		className: "min-w-0 rounded-xl border border-border bg-card p-4 sm:p-5",
+		children: [/* @__PURE__ */ n("h2", {
+			className: "text-lg font-semibold",
+			children: s
+		}), /* @__PURE__ */ r("div", {
+			className: "mt-3",
+			"aria-live": "polite",
+			children: [i.status === "ready" ? i.data.provisioned ? i.data.noLimit ? /* @__PURE__ */ n("p", {
+				className: "text-sm",
+				children: o("creditsUnlimited", "This plan has no AI credit limit.")
+			}) : /* @__PURE__ */ r("dl", {
+				className: "grid grid-cols-3 gap-3",
+				children: [
+					/* @__PURE__ */ r("div", {
+						className: "min-w-0",
+						children: [/* @__PURE__ */ n("dt", {
+							className: "text-xs text-muted-foreground",
+							children: o("creditsRemaining", "Remaining")
+						}), /* @__PURE__ */ n("dd", {
+							className: `break-all text-xl font-semibold tabular-nums ${i.data.exhausted ? "text-destructive" : ""}`,
+							children: c.format(i.data.remaining ?? 0)
+						})]
+					}),
+					/* @__PURE__ */ r("div", {
+						className: "min-w-0",
+						children: [/* @__PURE__ */ n("dt", {
+							className: "text-xs text-muted-foreground",
+							children: o("creditsUsed", "Used")
+						}), /* @__PURE__ */ n("dd", {
+							className: "break-all text-xl font-semibold tabular-nums",
+							children: c.format(i.data.used ?? 0)
+						})]
+					}),
+					/* @__PURE__ */ r("div", {
+						className: "min-w-0",
+						children: [/* @__PURE__ */ n("dt", {
+							className: "text-xs text-muted-foreground",
+							children: o("creditsLimit", "Limit")
+						}), /* @__PURE__ */ n("dd", {
+							className: "break-all text-xl font-semibold tabular-nums",
+							children: c.format(i.data.limit ?? 0)
+						})]
+					})
+				]
+			}) : /* @__PURE__ */ n("p", {
+				className: "text-sm text-muted-foreground",
+				children: o("creditsNotMetered", "AI use is not metered against a credit budget in this workspace.")
+			}) : /* @__PURE__ */ n(t, { status: i.status }), i.status === "ready" && i.data.exhausted && /* @__PURE__ */ n("p", {
+				className: "mt-3 text-sm text-destructive",
+				children: o("creditsExhausted", "AI credits are used up. AI actions resume next cycle or after an upgrade.")
+			})]
+		})]
+	});
+}
+//#endregion
+export { i as CreditsPanel };

package/dist/shared/pages/ai/contracts.d.ts

@@ -43,3 +43,38 @@ export declare function summary(value: unknown, workspaceId: string, productKey:
 export declare function exactInteger(value: string, locale: string): string;
 export declare function exactUsd(value: string, locale: string): string;
 export declare function sevenDays(now?: Date): UsageWindow;
+/**
+ * BOFF-3732: spend grouped by one dimension (BOFF-9935's promptUsageBreakdownV2),
+ * so an admin can tell a runaway workflow from the team asking the assistant.
+ */
+export declare const BREAKDOWN: import('graphql').DocumentNode;
+/** BOFF-3732: the workspace's remaining `<productKey>.ai.credits`. */
+export declare const CREDITS: import('graphql').DocumentNode;
+export type BreakdownDimension = 'MODEL' | 'OPERATION' | 'TRIGGER';
+export declare const BREAKDOWN_DIMENSIONS: readonly BreakdownDimension[];
+/** Rows shown per breakdown; the service orders by known cost, highest first. */
+export declare const BREAKDOWN_ROWS = 10;
+export interface BreakdownRow {
+    /** The group's value; null when the ledger rows did not record it (older rows have no trigger). */
+    key: string | null;
+    attempts: string;
+    totalTokens: string | null;
+    costMicroUsd: string | null;
+    costKnownAttempts: string;
+}
+export interface Breakdown {
+    dimension: BreakdownDimension;
+    rows: BreakdownRow[];
+    /** More groups exist than are shown. */
+    more: boolean;
+}
+export declare function breakdown(value: unknown, workspaceId: string, productKey: string, dimension: BreakdownDimension): Breakdown;
+export interface CreditStatus {
+    provisioned: boolean;
+    noLimit: boolean;
+    exhausted: boolean;
+    used: number | null;
+    limit: number | null;
+    remaining: number | null;
+}
+export declare function credits(value: unknown, productKey: string): CreditStatus;