@bitfab/sdk 0.64.26 → 0.64.28

package/dist/index.d.cts

@@ -733,7 +733,7 @@ declare class HttpClient {
      * Start a replay session by fetching historical traces.
      * Blocking call - creates an experiment and returns lightweight item references.
      */
-    startReplay(traceFunctionKey: string, limit: number | undefined, traceIds?: string[], name?: string, codeChangeDescription?: string | null, codeChangeFiles?: CodeChangeFile[] | null, includeDbBranchLease?: boolean, experimentGroupId?: string, datasetIds?: string[], graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean, skipAssertionJudging?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string, metadata?: Record<string, string>, dryRun?: boolean, invocation?: ReplayInvocation): Promise<StartReplayResponse>;
+    startReplay(traceFunctionKey: string, limit: number | undefined, traceIds?: string[], name?: string, codeChangeDescription?: string | null, codeChangeFiles?: CodeChangeFile[] | null, includeDbBranchLease?: boolean, experimentGroupId?: string, datasetIds?: string[], graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean, skipAssertionJudging?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string, metadata?: Record<string, string>, dryRun?: boolean, experimentGroupName?: string, invocation?: ReplayInvocation): Promise<StartReplayResponse>;
     resumeReplay(experimentId: string, traceFunctionKey: string, codeChangeFiles?: CodeChangeFile[] | null, force?: boolean): Promise<ResumeReplayResponse>;
     /**
      * Fetch an external span by ID.
@@ -1569,6 +1569,8 @@ type TraceSearchFilters = {
     callerMetadata?: Record<string, string>;
     name?: string;
     nameContains?: string;
+    /** Only the replay traces this experiment produced. */
+    experimentId?: string;
 };
 type TraceSearchParams = TraceSearchFilters & ({
     callerMetadata: Record<string, string>;
@@ -1576,6 +1578,8 @@ type TraceSearchParams = TraceSearchFilters & ({
     name: string;
 } | {
     nameContains: string;
+} | {
+    experimentId: string;
 }) & {
     traceFunctionKey?: string;
     cursor?: string | null;
@@ -1589,6 +1593,12 @@ type TraceSearchResult = {
         status: "pending" | "completed" | "failed" | "dropped";
         createdAt: string;
         callerMetadata: Record<string, string>;
+        /** The experiment that produced this trace, or null for a captured trace. */
+        experimentId: string | null;
+        /** Wall-clock time of the whole trace, or null when it has no end time. */
+        durationMs: number | null;
+        /** Token usage summed across the trace, or null when none was recorded. */
+        tokens: TokenUsage | null;
     }>;
     nextCursor: string | null;
     hasMore: boolean;
@@ -2383,8 +2393,17 @@ interface ReplayOptions {
      * not use the historical data you asked for.
      */
     dbBranch?: DbBranchOptions | boolean;
-    /** Group ID to associate this replay with an experiment group for live streaming on the experiments page. */
+    /**
+     * Experiment group this replay joins, shown together on the experiments
+     * page. An ID with no group yet creates the group.
+     */
     experimentGroupId?: string;
+    /**
+     * Name for the experiment group in `experimentGroupId`. Applied when this
+     * replay creates the group, or when the group exists without a name. A group
+     * that already has a name keeps it. Requires `experimentGroupId`.
+     */
+    experimentGroupName?: string;
     /**
      * Dataset this replay runs against. Mutually exclusive with `datasetIds`.
      * Alone it replays the dataset's full membership, and with `traceIds` it
@@ -4212,7 +4231,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.64.26";
+declare const __version__ = "0.64.28";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -733,7 +733,7 @@ declare class HttpClient {
      * Start a replay session by fetching historical traces.
      * Blocking call - creates an experiment and returns lightweight item references.
      */
-    startReplay(traceFunctionKey: string, limit: number | undefined, traceIds?: string[], name?: string, codeChangeDescription?: string | null, codeChangeFiles?: CodeChangeFile[] | null, includeDbBranchLease?: boolean, experimentGroupId?: string, datasetIds?: string[], graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean, skipAssertionJudging?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string, metadata?: Record<string, string>, dryRun?: boolean, invocation?: ReplayInvocation): Promise<StartReplayResponse>;
+    startReplay(traceFunctionKey: string, limit: number | undefined, traceIds?: string[], name?: string, codeChangeDescription?: string | null, codeChangeFiles?: CodeChangeFile[] | null, includeDbBranchLease?: boolean, experimentGroupId?: string, datasetIds?: string[], graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean, skipAssertionJudging?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string, metadata?: Record<string, string>, dryRun?: boolean, experimentGroupName?: string, invocation?: ReplayInvocation): Promise<StartReplayResponse>;
     resumeReplay(experimentId: string, traceFunctionKey: string, codeChangeFiles?: CodeChangeFile[] | null, force?: boolean): Promise<ResumeReplayResponse>;
     /**
      * Fetch an external span by ID.
@@ -1569,6 +1569,8 @@ type TraceSearchFilters = {
     callerMetadata?: Record<string, string>;
     name?: string;
     nameContains?: string;
+    /** Only the replay traces this experiment produced. */
+    experimentId?: string;
 };
 type TraceSearchParams = TraceSearchFilters & ({
     callerMetadata: Record<string, string>;
@@ -1576,6 +1578,8 @@ type TraceSearchParams = TraceSearchFilters & ({
     name: string;
 } | {
     nameContains: string;
+} | {
+    experimentId: string;
 }) & {
     traceFunctionKey?: string;
     cursor?: string | null;
@@ -1589,6 +1593,12 @@ type TraceSearchResult = {
         status: "pending" | "completed" | "failed" | "dropped";
         createdAt: string;
         callerMetadata: Record<string, string>;
+        /** The experiment that produced this trace, or null for a captured trace. */
+        experimentId: string | null;
+        /** Wall-clock time of the whole trace, or null when it has no end time. */
+        durationMs: number | null;
+        /** Token usage summed across the trace, or null when none was recorded. */
+        tokens: TokenUsage | null;
     }>;
     nextCursor: string | null;
     hasMore: boolean;
@@ -2383,8 +2393,17 @@ interface ReplayOptions {
      * not use the historical data you asked for.
      */
     dbBranch?: DbBranchOptions | boolean;
-    /** Group ID to associate this replay with an experiment group for live streaming on the experiments page. */
+    /**
+     * Experiment group this replay joins, shown together on the experiments
+     * page. An ID with no group yet creates the group.
+     */
     experimentGroupId?: string;
+    /**
+     * Name for the experiment group in `experimentGroupId`. Applied when this
+     * replay creates the group, or when the group exists without a name. A group
+     * that already has a name keeps it. Requires `experimentGroupId`.
+     */
+    experimentGroupName?: string;
     /**
      * Dataset this replay runs against. Mutually exclusive with `datasetIds`.
      * Alone it replays the dataset's full membership, and with `traceIds` it
@@ -4212,7 +4231,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.64.26";
+declare const __version__ = "0.64.28";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-26WDOYFS.js";
+} from "./chunk-76JZFING.js";
 import "./chunk-YWXQM6J3.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -37,7 +37,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-FSVGIKQT.js";
+} from "./chunk-45NVW5X6.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -45,7 +45,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-IHQKJWNN.js";
+} from "./chunk-PRL7RHVH.js";
 import "./chunk-MT36GJMW.js";
 export {
   AssertionCategoriesClient,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.64.26";
+    __version__ = "0.64.28";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2926,7 +2926,7 @@ var init_http = __esm({
        * Start a replay session by fetching historical traces.
        * Blocking call - creates an experiment and returns lightweight item references.
        */
-      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetIds, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions, skipAssertionJudging, experimentalSelectiveReplay, notes, metadata, dryRun, invocation) {
+      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetIds, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions, skipAssertionJudging, experimentalSelectiveReplay, notes, metadata, dryRun, experimentGroupName, invocation) {
         const payload = { traceFunctionKey };
         if (experimentalSelectiveReplay !== void 0) {
           payload.experimentalSelectiveReplay = experimentalSelectiveReplay;
@@ -2959,6 +2959,9 @@ var init_http = __esm({
         if (experimentGroupId !== void 0) {
           payload.experimentGroupId = experimentGroupId;
         }
+        if (experimentGroupName !== void 0) {
+          payload.experimentGroupName = experimentGroupName;
+        }
         if (datasetIds !== void 0) {
           if (datasetIds.length === 1) {
             payload.datasetId = datasetIds[0];
@@ -4778,6 +4781,11 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       "force only applies when resuming an experiment. Pass it together with resume."
     );
   }
+  if (options?.experimentGroupName !== void 0 && options.experimentGroupId === void 0) {
+    throw new BitfabError(
+      "experimentGroupName only applies with experimentGroupId. Pass it together with experimentGroupId."
+    );
+  }
   if (options?.experimentalSelectiveReplay !== void 0) {
     validateSelectiveReplayOptions(options.experimentalSelectiveReplay);
     if ((options.mock ?? "marked") !== "marked" || normalizeMockOverrides(options.mockOverride).length > 0 || registeredOverrides.length > 0) {
@@ -4852,6 +4860,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       options?.notes,
       options?.metadata,
       options?.dryRun === true,
+      options?.experimentGroupName,
       safeReplayInvocation(
         () => buildReplayInvocation(
           Object.entries(cliFlags(options) ?? explicitReplayOptions(options))
@@ -5304,6 +5313,7 @@ var init_replay = __esm({
       "mockOverride",
       "dbBranch",
       "experimentGroupId",
+      "experimentGroupName",
       "datasetId",
       "datasetIds",
       "graderIds",