@bitfab/sdk 0.24.0 → 0.24.1

package/dist/index.d.cts

@@ -684,7 +684,13 @@ interface ReplayItem<T> {
     error: string | null;
     /** Original trace duration in milliseconds, or null if timestamps are missing. */
     durationMs: number | null;
-    /** Token usage from the original trace, or null if not captured. */
+    /**
+     * Token usage from the REPLAYED run (this item's new execution), aggregated
+     * server-side from the spans it produced, or null if the run captured no
+     * token data. This is the "new" side of a token delta: compare it against
+     * the original trace's recorded usage to see how the code change moved cost.
+     * Matches what Studio's experiments view shows.
+     */
     tokens: TokenUsage | null;
     /** Model name from the original trace, or null if not captured. */
     model: string | null;
@@ -1374,7 +1380,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.24.0";
+declare const __version__ = "0.24.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -684,7 +684,13 @@ interface ReplayItem<T> {
     error: string | null;
     /** Original trace duration in milliseconds, or null if timestamps are missing. */
     durationMs: number | null;
-    /** Token usage from the original trace, or null if not captured. */
+    /**
+     * Token usage from the REPLAYED run (this item's new execution), aggregated
+     * server-side from the spans it produced, or null if the run captured no
+     * token data. This is the "new" side of a token delta: compare it against
+     * the original trace's recorded usage to see how the code change moved cost.
+     * Matches what Studio's experiments view shows.
+     */
     tokens: TokenUsage | null;
     /** Model name from the original trace, or null if not captured. */
     model: string | null;
@@ -1374,7 +1380,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.24.0";
+declare const __version__ = "0.24.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-S3PN26RH.js";
+} from "./chunk-J4D6PRM4.js";
 import {
   BitfabError
 } from "./chunk-26MUT4IP.js";

package/dist/node.cjs

@@ -412,7 +412,10 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
     originalOutput,
     error,
     durationMs: serverItem.durationMs ?? null,
-    tokens: serverItem.tokens ?? null,
+    // Filled in by replay() from the complete-replay response once the
+    // replay traces are persisted and their spans aggregated server-side.
+    // Null here (and on older servers) means "replay tokens not known".
+    tokens: null,
     model: serverItem.model ?? null,
     dbSnapshotRef: serverItem.dbSnapshotRef ?? null
   };
@@ -486,6 +489,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
   const resultItems = await mapWithConcurrency(tasks, maxConcurrency);
   const completeResult = await httpClient.completeReplay(testRunId);
   const serverTraceIds = completeResult.traceIds;
+  const replayTokens = completeResult.tokens;
   if (serverTraceIds === void 0) {
     try {
       console.warn(
@@ -508,6 +512,9 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
             missing.push(item.traceId);
           }
         }
+        if (mapped !== void 0) {
+          item.tokens = replayTokens?.[mapped] ?? null;
+        }
         item.traceId = mapped ?? null;
       }
     }
@@ -573,7 +580,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.24.0";
+var __version__ = "0.24.1";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";