@bitfab/sdk 0.46.0 → 0.48.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): Promise<StartReplayResponse>;
+    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>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -1259,7 +1259,7 @@ declare class DatasetsClient {
 
 type LabelConfidence = "VeryLow" | "Low" | "Medium" | "High" | "VeryHigh";
 type LabelAction = "set" | "archived" | "no-active-label" | "skipped";
-type LabelTarget = {
+type LabelTarget = ({
     traceId: string;
     originalTraceId?: never;
     attempt?: never;
@@ -1267,6 +1267,8 @@ type LabelTarget = {
     originalTraceId: string;
     attempt?: number;
     traceId?: never;
+}) & {
+    assertionId?: string;
 };
 type LabelVerdict = {
     label: boolean;
@@ -1658,6 +1660,18 @@ interface ReplayOptions {
      * organization and trace function, otherwise the server rejects the replay.
      */
     graderIds?: string[];
+    /**
+     * Replay only the selected traces that carry at least one assertion.
+     *
+     * Narrows whatever `limit`, `traceIds` or `datasetId` 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
+     * most recent traces that HAVE assertions, not the ten most recent filtered
+     * down to however few do. An archived assertion does not count, and a
+     * selection that narrows to nothing replays nothing.
+     */
+    onlyWithAssertions?: boolean;
     /**
      * Reshape recorded inputs before they are spread into `fn`.
      *
@@ -3197,7 +3211,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.46.0";
+declare const __version__ = "0.48.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): Promise<StartReplayResponse>;
+    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>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -1259,7 +1259,7 @@ declare class DatasetsClient {
 
 type LabelConfidence = "VeryLow" | "Low" | "Medium" | "High" | "VeryHigh";
 type LabelAction = "set" | "archived" | "no-active-label" | "skipped";
-type LabelTarget = {
+type LabelTarget = ({
     traceId: string;
     originalTraceId?: never;
     attempt?: never;
@@ -1267,6 +1267,8 @@ type LabelTarget = {
     originalTraceId: string;
     attempt?: number;
     traceId?: never;
+}) & {
+    assertionId?: string;
 };
 type LabelVerdict = {
     label: boolean;
@@ -1658,6 +1660,18 @@ interface ReplayOptions {
      * organization and trace function, otherwise the server rejects the replay.
      */
     graderIds?: string[];
+    /**
+     * Replay only the selected traces that carry at least one assertion.
+     *
+     * Narrows whatever `limit`, `traceIds` or `datasetId` 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
+     * most recent traces that HAVE assertions, not the ten most recent filtered
+     * down to however few do. An archived assertion does not count, and a
+     * selection that narrows to nothing replays nothing.
+     */
+    onlyWithAssertions?: boolean;
     /**
      * Reshape recorded inputs before they are spread into `fn`.
      *
@@ -3197,7 +3211,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.46.0";
+declare const __version__ = "0.48.0";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   getCurrentSpan,
   getCurrentTrace,
   seedFromRegistry
-} from "./chunk-OS62EZ6Y.js";
+} from "./chunk-ZIPITG22.js";
 import "./chunk-ZUD7OFYB.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -26,7 +26,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-WVGPOCCT.js";
+} from "./chunk-LUDC6WMA.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -34,7 +34,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-HSLKCBA3.js";
+} from "./chunk-OKSCUFJ6.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.46.0";
+    __version__ = "0.48.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) {
+      async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetId, graderIds, dbBranchSettings, attempts, includeOriginalMetadata, onlyWithAssertions) {
         const payload = { traceFunctionKey };
         if (limit !== void 0) {
           payload.limit = limit;
@@ -1893,6 +1893,9 @@ var init_http = __esm({
         if (includeOriginalMetadata) {
           payload.includeOriginalMetadata = true;
         }
+        if (onlyWithAssertions) {
+          payload.onlyWithAssertions = true;
+        }
         const timeout = includeDbBranchLease ? REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS : 3e4;
         return this.request("/api/sdk/replay/start", payload, {
           timeout
@@ -2958,7 +2961,8 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
     options?.graderIds,
     resolveDbBranchSettings(options?.dbBranch),
     attempts,
-    options?.adaptInputs !== void 0
+    options?.adaptInputs !== void 0,
+    options?.onlyWithAssertions
   );
   if (serverItems.length === 0) {
     try {