@bitfab/sdk 0.61.4 → 0.61.6

package/dist/index.d.cts

@@ -697,7 +697,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, judgeAssertions?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions): 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, judgeAssertions?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string): Promise<StartReplayResponse>;
     resumeReplay(experimentId: string, traceFunctionKey: string, codeChangeFiles?: CodeChangeFile[] | null, force?: boolean): Promise<ResumeReplayResponse>;
     /**
      * Fetch an external span by ID.
@@ -2028,8 +2028,17 @@ interface ReplayOptions {
      * it selects by ID with no dataset attribution.
      */
     traceIds?: string[];
-    /** Optional display name for the resulting experiment. */
+    /**
+     * What this run is testing, in a few words, such as 'baseline' or 'shorter
+     * system prompt'. Bitfab records the commit, branch, tree state, datasets,
+     * and who ran it with every experiment, so do not repeat them here.
+     */
     name?: string;
+    /**
+     * Run conditions Bitfab cannot see on its own, such as an environment
+     * override or a forced feature flag. Kept on the experiment next to its name.
+     */
+    notes?: string;
     /** Positive integer limiting parallel items. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
     /**
@@ -3873,7 +3882,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.61.4";
+declare const __version__ = "0.61.6";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -697,7 +697,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, judgeAssertions?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions): 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, judgeAssertions?: boolean, experimentalSelectiveReplay?: SelectiveReplayOptions, notes?: string): Promise<StartReplayResponse>;
     resumeReplay(experimentId: string, traceFunctionKey: string, codeChangeFiles?: CodeChangeFile[] | null, force?: boolean): Promise<ResumeReplayResponse>;
     /**
      * Fetch an external span by ID.
@@ -2028,8 +2028,17 @@ interface ReplayOptions {
      * it selects by ID with no dataset attribution.
      */
     traceIds?: string[];
-    /** Optional display name for the resulting experiment. */
+    /**
+     * What this run is testing, in a few words, such as 'baseline' or 'shorter
+     * system prompt'. Bitfab records the commit, branch, tree state, datasets,
+     * and who ran it with every experiment, so do not repeat them here.
+     */
     name?: string;
+    /**
+     * Run conditions Bitfab cannot see on its own, such as an environment
+     * override or a forced feature flag. Kept on the experiment next to its name.
+     */
+    notes?: string;
     /** Positive integer limiting parallel items. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
     /**
@@ -3873,7 +3882,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.61.4";
+declare const __version__ = "0.61.6";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -26,7 +26,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-2ZZBNQVA.js";
+} from "./chunk-2FX6Q72M.js";
 import "./chunk-K4XCWQBC.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -35,7 +35,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-FL6BNPSO.js";
+} from "./chunk-WMVXFHWY.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -43,7 +43,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-THGHTVB6.js";
+} from "./chunk-6SGSL4DI.js";
 import "./chunk-BAOIRE5T.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.61.4";
+    __version__ = "0.61.6";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2892,7 +2892,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, judgeAssertions, experimentalSelectiveReplay) {
+      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetIds, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions, judgeAssertions, experimentalSelectiveReplay, notes) {
         const payload = { traceFunctionKey };
         if (experimentalSelectiveReplay !== void 0) {
           payload.experimentalSelectiveReplay = experimentalSelectiveReplay;
@@ -2906,6 +2906,9 @@ var init_http = __esm({
         if (name !== void 0) {
           payload.name = name;
         }
+        if (notes !== void 0) {
+          payload.notes = notes;
+        }
         if (codeChangeDescription !== void 0) {
           payload.codeChangeDescription = codeChangeDescription;
         }
@@ -4560,6 +4563,7 @@ async function waitForReplayPersistence(httpClient, experimentId, replayedTraceI
       expectedSpanCounts
     );
     const ready = status.traceIds ?? {};
+    Object.assign(readBackTraceIds, ready);
     missing = Object.keys(expectedSpanCounts).filter(
       (traceId) => ready[traceId] === void 0
     ).length;
@@ -4680,7 +4684,8 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       options?.adaptInputs !== void 0,
       options?.onlyWithAssertions,
       options?.judgeAssertions,
-      options?.experimentalSelectiveReplay
+      options?.experimentalSelectiveReplay,
+      options?.notes
     );
     if (started.items.length === 0) {
       try {