@bitfab/sdk 0.50.0 → 0.51.0

package/dist/index.d.cts

@@ -556,7 +556,7 @@ declare class HttpClient {
      * Start a replay session by fetching historical traces.
      * Blocking call - creates a test run 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, datasetId?: string, graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean): 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): Promise<StartReplayResponse>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -1645,12 +1645,15 @@ interface DbBranchOptions {
 interface ReplayOptions {
     /**
      * Maximum number of traces to replay (1-5,000, default 5). Ignored when
-     * `traceIds` is passed (with a warning), or when `datasetId` is passed,
-     * because either source already determines how many traces replay.
+     * `traceIds` is passed (with a warning), or when `datasetId` / `datasetIds`
+     * is passed, because either source already determines how many traces replay.
      */
     limit?: number;
     attempts?: number;
-    /** Optional list of specific trace IDs to replay (max 100). Mutually exclusive with `datasetId`. */
+    /**
+     * Optional list of specific trace IDs to replay (max 100). Mutually exclusive
+     * with `datasetId` and `datasetIds`.
+     */
     traceIds?: string[];
     /** Optional display name for the resulting experiment/test run. */
     name?: string;
@@ -1707,13 +1710,14 @@ interface ReplayOptions {
     /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
     experimentGroupId?: string;
     /**
-     * Dataset this replay runs against. Mutually exclusive with `traceIds`. When
-     * set, the resulting experiment is
+     * Dataset this replay runs against. Mutually exclusive with `traceIds` and
+     * with `datasetIds`. When set, the resulting experiment is
      * durably attributed to the dataset (stored on the test run), so it appears
      * under the dataset's experiments even if the trace lineage can't be
      * reconstructed. Validated server-side against the org.
      */
     datasetId?: string;
+    datasetIds?: string[];
     /**
      * Graders to attach directly to this experiment (test run), independent of any
      * graders already on the dataset. The resulting experiment is graded by the
@@ -1726,7 +1730,7 @@ interface ReplayOptions {
     /**
      * Replay only the selected traces that carry at least one assertion.
      *
-     * Narrows whatever `limit`, `traceIds` or `datasetId` selected, so a run that
+     * Narrows whatever `limit`, `traceIds` or `datasetIds` selected, so a run that
      * measures assertion outcomes does not pay to re-execute traces nothing can
      * grade. The server applies it as part of selection, which is what makes it
      * compose with `limit`: `{ limit: 10, onlyWithAssertions: true }` is the ten
@@ -3275,7 +3279,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.50.0";
+declare const __version__ = "0.51.0";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -556,7 +556,7 @@ declare class HttpClient {
      * Start a replay session by fetching historical traces.
      * Blocking call - creates a test run 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, datasetId?: string, graderIds?: string[], dbBranchSettings?: DbBranchSettings, attempts?: number, includeOriginalMetadata?: boolean, onlyWithAssertions?: boolean): 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): Promise<StartReplayResponse>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -1645,12 +1645,15 @@ interface DbBranchOptions {
 interface ReplayOptions {
     /**
      * Maximum number of traces to replay (1-5,000, default 5). Ignored when
-     * `traceIds` is passed (with a warning), or when `datasetId` is passed,
-     * because either source already determines how many traces replay.
+     * `traceIds` is passed (with a warning), or when `datasetId` / `datasetIds`
+     * is passed, because either source already determines how many traces replay.
      */
     limit?: number;
     attempts?: number;
-    /** Optional list of specific trace IDs to replay (max 100). Mutually exclusive with `datasetId`. */
+    /**
+     * Optional list of specific trace IDs to replay (max 100). Mutually exclusive
+     * with `datasetId` and `datasetIds`.
+     */
     traceIds?: string[];
     /** Optional display name for the resulting experiment/test run. */
     name?: string;
@@ -1707,13 +1710,14 @@ interface ReplayOptions {
     /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
     experimentGroupId?: string;
     /**
-     * Dataset this replay runs against. Mutually exclusive with `traceIds`. When
-     * set, the resulting experiment is
+     * Dataset this replay runs against. Mutually exclusive with `traceIds` and
+     * with `datasetIds`. When set, the resulting experiment is
      * durably attributed to the dataset (stored on the test run), so it appears
      * under the dataset's experiments even if the trace lineage can't be
      * reconstructed. Validated server-side against the org.
      */
     datasetId?: string;
+    datasetIds?: string[];
     /**
      * Graders to attach directly to this experiment (test run), independent of any
      * graders already on the dataset. The resulting experiment is graded by the
@@ -1726,7 +1730,7 @@ interface ReplayOptions {
     /**
      * Replay only the selected traces that carry at least one assertion.
      *
-     * Narrows whatever `limit`, `traceIds` or `datasetId` selected, so a run that
+     * Narrows whatever `limit`, `traceIds` or `datasetIds` selected, so a run that
      * measures assertion outcomes does not pay to re-execute traces nothing can
      * grade. The server applies it as part of selection, which is what makes it
      * compose with `limit`: `{ limit: 10, onlyWithAssertions: true }` is the ten
@@ -3275,7 +3279,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.50.0";
+declare const __version__ = "0.51.0";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   getCurrentSpan,
   getCurrentTrace,
   seedFromRegistry
-} from "./chunk-BT4RNCQL.js";
+} from "./chunk-VXD27AJ3.js";
 import "./chunk-ZUD7OFYB.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -27,7 +27,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-6LG3OFIX.js";
+} from "./chunk-DNYZJLNY.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -35,7 +35,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-XZDYNFI5.js";
+} from "./chunk-RGC7IEOI.js";
 import "./chunk-H6LZRFMN.js";
 export {
   BITFAB_PROGRESS_PREFIX,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.50.0";
+    __version__ = "0.51.0";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -1854,7 +1854,7 @@ var init_http = __esm({
        * Start a replay session by fetching historical traces.
        * Blocking call - creates a test run and returns lightweight item references.
        */
-      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetId, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions) {
+      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetIds, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions) {
         const payload = { traceFunctionKey };
         if (limit !== void 0) {
           payload.limit = limit;
@@ -1878,8 +1878,12 @@ var init_http = __esm({
         if (experimentGroupId !== void 0) {
           payload.experimentGroupId = experimentGroupId;
         }
-        if (datasetId !== void 0) {
-          payload.datasetId = datasetId;
+        if (datasetIds !== void 0) {
+          if (datasetIds.length === 1) {
+            payload.datasetId = datasetIds[0];
+          } else {
+            payload.datasetIds = datasetIds;
+          }
         }
         if (graderIds !== void 0) {
           payload.graderIds = graderIds;
@@ -2481,6 +2485,23 @@ function resolveAttempts(attempts) {
   }
   return attempts;
 }
+function resolveDatasetIds(options) {
+  if (options?.datasetId !== void 0 && options?.datasetIds !== void 0) {
+    throw new BitfabError(
+      "datasetId and datasetIds are the same selector: pass one dataset through datasetId, or several through datasetIds."
+    );
+  }
+  if (options?.datasetId !== void 0) {
+    return [options.datasetId];
+  }
+  if (options?.datasetIds === void 0) {
+    return void 0;
+  }
+  if (options.datasetIds.length === 0) {
+    throw new BitfabError("datasetIds must contain at least one dataset ID.");
+  }
+  return [...new Set(options.datasetIds)];
+}
 function dbBranchEnabled(dbBranch) {
   return dbBranch !== void 0 && dbBranch !== false;
 }
@@ -2913,9 +2934,10 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       );
     }
   }
-  if (options?.traceIds !== void 0 && options?.datasetId !== void 0) {
+  const datasetIds = resolveDatasetIds(options);
+  if (options?.traceIds !== void 0 && datasetIds !== void 0) {
     throw new BitfabError(
-      "traceIds and datasetId select different replay sources and cannot be used together."
+      "traceIds and datasetIds select different replay sources and cannot be used together."
     );
   }
   if (options?.limit !== void 0 && options?.traceIds !== void 0) {
@@ -2957,7 +2979,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
     // before it could report its resolved inputs.
     dbBranchEnabled(options?.dbBranch) && options?.dryRun !== true,
     options?.experimentGroupId,
-    options?.datasetId,
+    datasetIds,
     options?.graderIds,
     resolveDbBranchSettings(options?.dbBranch),
     attempts,