@burdenoff/fe-libs 2026.1027.13 → 2026.1028.1

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

@@ -133,6 +133,7 @@ export * from './ui/AssistantMarkdownRenderer';
 export * from './ui/AssistantMessageAttachments';
 export * from './ui/AssistantPendingWriteCard';
 export * from './ui/AssistantWriteProposalCard';
+export * from './ui/AssistantAiDisclaimer';
 export * from './ui/AssistantWriteConfirmDialog';
 export * from './ui/useWriteProposalConfirm';
 export * from './ui/writeProposalPresentation';
@@ -301,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/assistant/ui/AssistantAiDisclaimer.d.ts

@@ -0,0 +1,26 @@
+import { FC } from 'react';
+export interface AssistantAiDisclaimerProps {
+    /** Extra layout classes from the mount point (spacing, borders). */
+    className?: string;
+    /** Distinguishes the mounts in tests and in Playwright checks. */
+    testId?: string;
+    /** Centred under a composer; start-aligned inside a card. */
+    align?: 'center' | 'start';
+}
+/**
+ * The standing "AI can make mistakes" line (BOFF-3720, AI_READINESS 5.3).
+ *
+ * ★★ Standing and non-dismissable by design: there is no close control, no
+ * prop that hides it and no stored "seen" flag. It sits under the composer of
+ * every assistant panel and on every write-proposal card, so it is on screen
+ * whenever an answer is read or a change is approved.
+ *
+ * ★ A platform shell label, not a product-prefixed assistant key. The
+ * `workspaces` dictionary is layered under every product's, so one seed of
+ * `assistantChrome.aiDisclaimer` translates it for every product. Until that
+ * seed lands, and in any locale it lacks, the English renders: the line is
+ * never missing, only untranslated.
+ *
+ * Semantic tokens only (`text-text-muted`).
+ */
+export declare const AssistantAiDisclaimer: FC<AssistantAiDisclaimerProps>;

package/dist/shared/assistant/ui/AssistantAiDisclaimer.js

@@ -0,0 +1,13 @@
+import { useAssistantDisclaimerLabel as e } from "../../providers/shell/useAssistantShellLabels.js";
+import { jsx as t } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/AssistantAiDisclaimer.tsx
+var n = ({ className: n, testId: r = "assistant-ai-disclaimer", align: i = "center" }) => {
+	let a = e();
+	return /* @__PURE__ */ t("p", {
+		className: `${i === "center" ? "text-center" : "text-start"} text-[11px] leading-snug text-text-muted${n ? ` ${n}` : ""}`,
+		"data-testid": r,
+		children: a
+	});
+};
+//#endregion
+export { n as AssistantAiDisclaimer };