@belonguniverseai/react-sdk 0.6.10 → 0.6.12

package/dist/i18n/messages/surfaces/usage.d.ts

@@ -1,31 +1,79 @@
-/** Usage meter dock strings. */
+/** Usage meter + context-window panel dock strings. */
 export declare const usageEn: {
     readonly usage: {
         readonly tooltip: "Auto-compacts at {{chars}} chars; {{tokens}} tokens used this session";
+        readonly windowTooltip: "Context window: {{used}} of {{window}} tokens used ({{pct}}%)";
         readonly context: "Context {{pct}}%";
         readonly tokens: "{{count}} tokens";
-        readonly lastTurn: "Last turn: {{in}} in / {{out}} out";
+        readonly inOut: "Input {{in}} · output {{out}}";
         readonly turnsThisSessionOne: "{{count}} turn this session";
         readonly turnsThisSessionOther: "{{count}} turns this session";
+        readonly panel: {
+            readonly title: "Context window";
+            readonly segments: {
+                readonly messages: "Messages";
+                readonly system_prompt: "System prompt";
+                readonly tools: "Tools";
+                readonly skills: "Skills";
+                readonly memory: "Memory";
+            };
+            readonly freeSpace: "Free space";
+            readonly estimateNote: "Breakdown is estimated; the total is as reported by the model.";
+            readonly sessionTokens: "{{tokens}} tokens this session";
+            readonly cacheLine: "Cache: {{read}} read · {{write}} written";
+            readonly autoCompact: "Auto-compact: {{pct}}% of budget";
+        };
     };
 };
 export declare const usageEs: {
     usage: {
         tooltip: string;
+        windowTooltip: string;
         context: string;
         tokens: string;
-        lastTurn: string;
+        inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
+        panel: {
+            title: string;
+            segments: {
+                messages: string;
+                system_prompt: string;
+                tools: string;
+                skills: string;
+                memory: string;
+            };
+            freeSpace: string;
+            estimateNote: string;
+            sessionTokens: string;
+            cacheLine: string;
+            autoCompact: string;
+        };
     };
 };
 export declare const usagePt: {
     usage: {
         tooltip: string;
+        windowTooltip: string;
         context: string;
         tokens: string;
-        lastTurn: string;
+        inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
+        panel: {
+            title: string;
+            segments: {
+                messages: string;
+                system_prompt: string;
+                tools: string;
+                skills: string;
+                memory: string;
+            };
+            freeSpace: string;
+            estimateNote: string;
+            sessionTokens: string;
+            cacheLine: string;
+            autoCompact: string;
+        };
     };
 };

package/dist/stream/belong-chat-transport.d.ts

@@ -171,8 +171,19 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
         totalTokens: z.ZodNumber;
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         historyChars: z.ZodNumber;
         autoCompactThresholdChars: z.ZodNumber;
+        contextWindow: z.ZodOptional<z.ZodObject<{
+            contextWindowTokens: z.ZodNumber;
+            usedTokens: z.ZodNumber;
+            segments: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                tokens: z.ZodNumber;
+                count: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-choice-request">;

package/dist/stream/belong-data-parts.d.ts

@@ -199,18 +199,47 @@ export type StatusData = {
      */
     readonly retryable?: boolean | undefined;
 };
+/**
+ * One slice of the context-window breakdown. `key` is an open string on the
+ * wire; the KNOWN values are rendered as labeled rows (`messages`,
+ * `system_prompt`, `tools`, `skills`, `memory`) and unknown ones are skipped
+ * rather than failing the part (see the transport schema).
+ */
+export type ContextWindowSegmentData = {
+    readonly key: string;
+    readonly tokens: number;
+    readonly count?: number | undefined;
+};
+/**
+ * The turn-end snapshot of the model's context window (own-loop runtimes
+ * only). `usedTokens` is the REAL last-request prompt + its output as the
+ * provider reported it; `segments` are estimates scaled to sum to it. Free
+ * space is `contextWindowTokens - usedTokens`, computed at render.
+ */
+export type ContextWindowData = {
+    readonly contextWindowTokens: number;
+    readonly usedTokens: number;
+    readonly segments: readonly ContextWindowSegmentData[];
+};
 /**
  * F3 — per-turn token usage + compaction context. Emitted once per turn at
  * the end of the stream; the SDK renders the quiet context meter from this.
  * `historyChars / autoCompactThresholdChars` gives compaction proximity;
- * `threshold === 0` means no auto-compact is configured — hide the meter.
+ * `threshold === 0` means no auto-compact is configured — hide the meter
+ * unless a `contextWindow` report is present (the panel stands on its own).
+ * The optional fields are absent on rows persisted before they existed.
  */
 export type UsageData = {
     readonly inputTokens: number;
     readonly outputTokens: number;
     readonly totalTokens: number;
+    /** BEL-206 — the turn's prompt-cache reads/writes. */
+    readonly cacheReadInputTokens?: number | undefined;
+    readonly cacheWriteInputTokens?: number | undefined;
     readonly historyChars: number;
     readonly autoCompactThresholdChars: number;
+    /** The detailed context-window breakdown (own-loop runtimes only). */
+    readonly contextWindow?: ContextWindowData | undefined;
 };
 /**
  * Single source of truth for Belong's custom data parts. The record

package/dist/stream/select-session-usage.d.ts

@@ -1,4 +1,4 @@
-import { BelongUIMessage } from './belong-data-parts.ts';
+import { BelongUIMessage, ContextWindowData } from './belong-data-parts.ts';
 export type SessionUsageSummary = {
     /** Sum of all per-turn input tokens. */
     readonly totalInputTokens: number;
@@ -6,6 +6,9 @@ export type SessionUsageSummary = {
     readonly totalOutputTokens: number;
     /** Sum of all per-turn combined tokens. */
     readonly totalTokens: number;
+    /** BEL-206 — sums of the per-turn prompt-cache reads/writes (0 when unreported). */
+    readonly totalCacheReadInputTokens: number;
+    readonly totalCacheWriteInputTokens: number;
     /** How many turns have reported usage. */
     readonly turns: number;
     /**
@@ -16,8 +19,16 @@ export type SessionUsageSummary = {
     readonly historyChars: number;
     /**
      * Auto-compact threshold in chars (last-wins). 0 means auto-compact is
-     * not configured — the meter must be hidden when this is 0.
+     * not configured — the legacy meter is hidden when this is 0 AND no
+     * context-window report is present.
      */
     readonly autoCompactThresholdChars: number;
+    /**
+     * The most recent turn's context-window breakdown (last-wins — the
+     * current context IS the latest turn's context). Null when no turn has
+     * reported one (older sessions, or the claude-agent-sdk runtime); the
+     * panel then falls back to the session-usage view.
+     */
+    readonly contextWindow: ContextWindowData | null;
 };
 export declare const selectSessionUsage: (messages: readonly BelongUIMessage[]) => SessionUsageSummary | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",