@burdenoff/fe-libs 2026.1021.10 → 2026.1021.11

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

@@ -1,5 +1,5 @@
 import { AssistantUiCatalogue } from './uiActions/uiCatalogue';
-import { AssistantMode, AssistantPromptPart, AssistantRawMessage, AssistantSandboxAuthContext, AssistantArtifact, AssistantSessionInfo, DownloadedAssistantArtifact, StreamAccess } from './types';
+import { AssistantMode, AssistantPromptPart, AssistantRawMessage, AssistantTokenUsage, AssistantSandboxAuthContext, AssistantArtifact, AssistantSessionInfo, DownloadedAssistantArtifact, StreamAccess } from './types';
 import { SandboxWriteCapabilities, WriteApprovalMode, WriteExecutionState } from './writeProposals';
 import { WriteReplyKind, WriteReplyOrigin } from './writeReplyBinder';
 /**
@@ -568,7 +568,4 @@ export declare function downloadAssistantArtifact(sandboxId: string, workspaceId
  */
 mode: AssistantMode | undefined, authContext: AssistantSandboxAuthContext): Promise<DownloadedAssistantArtifact>;
 export declare function checkAssistantAiCredits(workspaceId: string, authContext: AssistantSandboxAuthContext): Promise<boolean>;
-export declare function reportAssistantAiTokenUsage(workspaceId: string, sessionId: string, messageId: string, model: string | undefined, tokens: {
-    input: number;
-    output: number;
-}, authContext: AssistantSandboxAuthContext): Promise<void>;
+export declare function reportAssistantAiTokenUsage(workspaceId: string, sessionId: string, messageId: string, model: string | undefined, tokens: AssistantTokenUsage, authContext: AssistantSandboxAuthContext): Promise<void>;

package/dist/shared/assistant/api.js

@@ -594,20 +594,35 @@ async function We(e, t) {
 		authContext: t
 	})).checkAiCredits;
 }
-async function Ge(e, t, n, r, i, o) {
-	let s = Math.max(0, Math.round(i.input ?? 0)), c = Math.max(0, Math.round(i.output ?? 0));
-	s + c === 0 || !r || await a({
+async function Ge(e, t, n, r, o, s) {
+	let c = Math.max(0, Math.round(o.input ?? 0)), l = Math.max(0, Math.round(o.output ?? 0)), u = Math.max(0, Math.round(o.cache?.read ?? 0)), d = Math.max(0, Math.round(o.cache?.write ?? 0));
+	if (c + l + u + d === 0 || !r) return;
+	let f = !1;
+	if (o.cache) try {
+		f = (await i({
+			query: "query AiCacheTokensSupported { aiCacheTokensSupported }",
+			operationName: "AiCacheTokensSupported",
+			variables: {},
+			workspaceId: e,
+			authContext: s
+		})).aiCacheTokensSupported === !0;
+	} catch {}
+	await a({
 		query: ee,
 		operationName: "ReportAiTokenUsage",
 		variables: { input: {
 			sessionId: t,
 			messageId: n,
 			model: r,
-			inputTokens: s,
-			outputTokens: c
+			inputTokens: c,
+			outputTokens: l,
+			...f ? {
+				cacheReadTokens: u,
+				cacheWriteTokens: d
+			} : {}
 		} },
 		workspaceId: e,
-		authContext: o
+		authContext: s
 	});
 }
 //#endregion

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

@@ -1,7 +1,7 @@
 import { PendingWrite } from './pendingWrite';
 import { WriteProposalMessageRef } from './writeProposalDiscovery';
 import { AssistantMessageAttachment } from './attachments';
-import { AssistantMode } from './types';
+import { AssistantMode, AssistantTokenUsage } from './types';
 export type AssistantSandboxStatus = "none" | "provisioning" | "running" | "stopping" | "error";
 export type AssistantConversationStatus = "idle" | "provisioning" | "connecting" | "streaming" | "complete" | "error";
 /**
@@ -259,10 +259,7 @@ export interface Message {
     role: "user" | "assistant" | "system";
     content: string;
     timestamp: string;
-    tokens?: {
-        input: number;
-        output: number;
-    };
+    tokens?: AssistantTokenUsage;
     metadata?: AssistantMessageMetadata;
     /**
      * ★ BOFF-7335: where this message stands with server history — `pending`

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

@@ -1,7 +1,7 @@
 import { LocalUiCommandOptions } from './localUiCommands';
 import { ReactNode } from 'react';
 import { AssistantModeConfig } from './conversation';
-import { AssistantMode, PageContext } from './types';
+import { AssistantMode, AssistantTokenUsage, PageContext } from './types';
 import { WriteApprovalMode, WriteProposalView } from './writeProposals';
 /**
  * The sixth argument of `buildPrompt` (BOFF-7803 5a, design §3.5): which write
@@ -100,10 +100,7 @@ export interface AssistantProductCapabilities {
         sessionId: string;
         messageId?: string;
         model?: string;
-        tokens: {
-            input: number;
-            output: number;
-        };
+        tokens: AssistantTokenUsage;
     }) => Promise<void>;
     /**
      * Where the assistant's files land in the workspace file library.

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

@@ -1,6 +1,6 @@
 import { PendingWrite } from './pendingWrite';
 import { AssistantProgressOptions } from './progress';
-import { AssistantRawMessage } from './types';
+import { AssistantRawMessage, AssistantTokenUsage } from './types';
 /** What one poll of the sandbox says this turn has produced so far. */
 export interface AssistantTurnProgress {
     /**
@@ -35,10 +35,7 @@ export interface AssistantTurnProgress {
      */
     usedTools?: boolean;
     done: boolean;
-    tokens?: {
-        input: number;
-        output: number;
-    };
+    tokens?: AssistantTokenUsage;
     /**
      * Identity + model of the message these tokens came from, needed to charge the
      * turn: `messageId` is half the server's idempotency hash and `model` selects the

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

@@ -104,6 +104,15 @@ export type AssistantPromptPart = {
     data?: string;
     name?: string;
 };
+/** Runtime input excludes the separately reported provider cache counts. */
+export interface AssistantTokenUsage {
+    input: number;
+    output: number;
+    cache?: {
+        read?: number;
+        write?: number;
+    };
+}
 export interface AssistantRawMessage {
     info?: {
         id?: string;
@@ -115,10 +124,7 @@ export interface AssistantRawMessage {
         parentID?: string;
         providerID?: string;
         modelID?: string;
-        tokens?: {
-            input: number;
-            output: number;
-        };
+        tokens?: AssistantTokenUsage;
         time?: {
             created?: number;
             completed?: number;

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

@@ -1,14 +1,12 @@
 import { AssistantSendRefusal } from './turnOutcome';
+import { AssistantTokenUsage } from './types';
 /** One finished turn's charge, as a product's `reportTokenUsage` receives it. */
 export interface UsageReport {
     workspaceId: string;
     sessionId: string;
     messageId?: string;
     model?: string;
-    tokens: {
-        input: number;
-        output: number;
-    };
+    tokens: AssistantTokenUsage;
 }
 /** Sends one report to its ledger. Rejects when the ledger did not record it. */
 export type UsageReporter = (report: UsageReport) => Promise<void>;

package/dist/shared/assistant/usageReporting.js

@@ -48,14 +48,26 @@ var v = (e) => typeof e == "number" && Number.isFinite(e) && e >= 0, y = (e) =>
 function b(e, t) {
 	if (!e || typeof e != "object") return null;
 	let n = e, r = n.tokens;
-	return n.workspaceId !== t || typeof n.sessionId != "string" || n.sessionId.length === 0 || !y(n.messageId) || !y(n.model) || !r || typeof r != "object" || !v(r.input) || !v(r.output) ? null : {
+	if (n.workspaceId !== t || typeof n.sessionId != "string" || n.sessionId.length === 0 || !y(n.messageId) || !y(n.model) || !r || typeof r != "object" || !v(r.input) || !v(r.output)) return null;
+	let i;
+	if (r.cache !== void 0) {
+		if (!r.cache || typeof r.cache != "object" || Array.isArray(r.cache)) return null;
+		let e = r.cache;
+		if (e.read !== void 0 && !v(e.read) || e.write !== void 0 && !v(e.write)) return null;
+		i = {
+			...v(e.read) ? { read: e.read } : {},
+			...v(e.write) ? { write: e.write } : {}
+		};
+	}
+	return {
 		workspaceId: t,
 		sessionId: n.sessionId,
 		...typeof n.messageId == "string" ? { messageId: n.messageId } : {},
 		...typeof n.model == "string" ? { model: n.model } : {},
 		tokens: {
 			input: r.input,
-			output: r.output
+			output: r.output,
+			...i ? { cache: i } : {}
 		}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.1021.10",
+  "version": "2026.1021.11",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "bin": {