@bitfab/sdk 0.41.0 → 0.43.0

package/dist/index.d.cts

@@ -306,6 +306,7 @@ interface ReplayContext {
      * customer sees in the Bitfab dashboard.
      */
     sourceBitfabTraceId?: string;
+    replayAttempt?: number;
     mockTree?: MockTree;
     callCounters?: Map<string, number>;
     mockStrategy?: "none" | "all" | "marked";
@@ -584,7 +585,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): 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): Promise<StartReplayResponse>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -625,7 +626,7 @@ declare class HttpClient {
      * snapshot + preview branch and polls operations to readiness, which
      * can take seconds.
      */
-    resolveDbBranchLease(testRunId: string, traceId: string, dbBranchSettings?: DbBranchSettings): Promise<{
+    resolveDbBranchLease(testRunId: string, traceId: string, dbBranchSettings?: DbBranchSettings, attempt?: number): Promise<{
         dbSnapshotRef: DbSnapshotRef | null;
         lease: DbBranchLease | null;
         leaseError: {
@@ -658,6 +659,7 @@ interface CodeChangeFile {
 interface StartReplayResponse {
     testRunId: string;
     testRunUrl: string;
+    attempts?: number;
     items: Array<{
         /** Bitfab trace ID of the original (historical) trace being replayed. */
         originalTraceId?: string;
@@ -698,6 +700,7 @@ interface StartReplayResponse {
          * servers that predate it.
          */
         dbBranchTimings?: DbBranchTimings;
+        originalMetadata?: Record<string, unknown>;
     }>;
 }
 interface ExternalSpanResponse {
@@ -960,6 +963,7 @@ declare class BitfabClaudeAgentHandler {
 type LlmSpanOptions = {
     type: "llm";
     finalize: (result: unknown) => unknown | Promise<unknown>;
+    surface: "inherit";
 };
 type WithSpanFn$1 = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: LlmSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 /**
@@ -1265,6 +1269,7 @@ interface SpanClient {
         captureWhen?: "always" | "nested";
         mockOnReplay?: boolean;
         finalize?: (result: unknown) => unknown | Promise<unknown>;
+        surface?: "inherit";
     }, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 }
 interface LangGraphTool {
@@ -1371,6 +1376,7 @@ type RunResultLike = {
 type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
+    surface: "inherit";
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
@@ -1472,6 +1478,7 @@ interface ReplayOptions {
      * 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`. */
     traceIds?: string[];
     /** Optional display name for the resulting experiment/test run. */
@@ -1624,6 +1631,7 @@ interface ReplayItemStartProgress {
         sourceTraceId: string;
         /** @deprecated alias for `originalSpanId`. */
         sourceSpanId: string;
+        attempt: number;
     };
 }
 /** Running totals reported to {@link ReplayOptions.onItemFinish} as replay proceeds. */
@@ -1663,6 +1671,7 @@ interface ReplayProgressItem {
     sourceTraceId: string | null;
     /** @deprecated alias for `originalSpanId`. */
     sourceSpanId?: string | null;
+    attempt: number;
     /** Deserialized inputs from the original trace. */
     input?: unknown[];
     /** The result returned by the replayed function, or undefined on error. */
@@ -1741,6 +1750,7 @@ interface AdaptContext {
     sourceTraceId: string;
     /** @deprecated alias for {@link AdaptContext.originalSpanId}. */
     sourceSpanId: string;
+    metadata: Record<string, unknown>;
 }
 /**
  * The shape an adapter module must export as `adaptInputs`.
@@ -1772,6 +1782,7 @@ interface ReplayItem<T> {
     sourceTraceId: string;
     /** @deprecated alias for {@link ReplayItem.originalSpanId}. */
     sourceSpanId: string;
+    attempt: number;
     /** Deserialized inputs from the original trace. */
     input: unknown[];
     /** The result returned by the function during replay, or undefined on error. */
@@ -1850,6 +1861,7 @@ interface ReplayResult<T> {
     testRunId: string;
     /** Full URL to view the test run in the dashboard. */
     testRunUrl: string;
+    attempts: number;
 }
 /**
  * Whole-run replay failure that preserves every item collected before the run
@@ -2094,6 +2106,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
     private sendSpan;
 }
 
+type CaptureSurface = "opt-in" | "opt-out";
 /**
  * Options for wrapBAML.
  */
@@ -2229,6 +2242,22 @@ declare function getCurrentReplayBranch(): ReplayBranch | null;
  * Returns a no-op object if called outside of a span context (methods do nothing).
  */
 declare function getCurrentTrace(): CurrentTrace;
+interface SeedCaseOptions {
+    input: unknown[];
+    expected?: unknown;
+    fn?: (...args: any[]) => unknown;
+    metadata?: Record<string, unknown>;
+    sessionId?: string;
+    name?: string;
+    spanName?: string;
+    spanType?: SpanType;
+}
+interface SeedRunOptions<TArgs extends unknown[]> {
+    args?: TArgs;
+    metadata?: Record<string, unknown>;
+    sessionId?: string;
+    name?: string;
+}
 interface BitfabConfig {
     /**
      * The API key for Bitfab API authentication. Resolved lazily, the first
@@ -2249,7 +2278,7 @@ interface BitfabConfig {
     timeout?: number;
     /** Environment variables for LLM provider API keys (only OPENAI_API_KEY is supported) */
     envVars?: AllowedEnvVars;
-    /** Whether the client is enabled. Defaults to true. When false, withSpan returns the original function unwrapped. */
+    captureEnabled?: boolean;
     enabled?: boolean;
     /**
      * Fail loud instead of degrading quietly. When true, the first traced call
@@ -2410,8 +2439,7 @@ declare class Bitfab {
     private readonly serviceUrl;
     private readonly timeout;
     private readonly envVars;
-    /** The user's on/off intent. The effective enabled state ANDs this with "a key resolved" (see isTracingEnabled). */
-    private readonly explicitlyEnabled;
+    private readonly captureConfigured;
     private readonly strict;
     private readonly httpClient;
     /** Dataset operations for the authenticated organization. */
@@ -2526,12 +2554,9 @@ declare class Bitfab {
      * early resolve that found nothing never poisons a later one.
      */
     private resolveApiKey;
-    /**
-     * Whether tracing should run, decided lazily at call time (not frozen at
-     * construction). An explicit `enabled: false` short-circuits without ever
-     * touching the key.
-     */
-    private isTracingEnabled;
+    private isCaptureEnabled;
+    private shouldRecord;
+    get captureEnabled(): boolean;
     /**
      * Fetch the function with its current version and BAML prompt from the server.
      *
@@ -2885,46 +2910,10 @@ declare class Bitfab {
     registerMockOverride(traceFunctionKey: string, override: MockOverride | MockOverrideResolver): void;
     /** Remove all overrides registered via {@link registerMockOverride}. */
     clearMockOverrides(): void;
-    /**
-     * Write a replayable trace from a case, without running anything.
-     *
-     * Use this to turn a corpus you already hold (a Braintrust dataset, a
-     * spreadsheet, hand-written cases) into traces that {@link replay} can
-     * select. The recorded root span carries `input` as its input and `expected`
-     * as its output, so replay reports each item against the value you expected
-     * rather than against a previous run.
-     *
-     * A seeded trace has no child spans and no database pin, so replay mocking
-     * has nothing recorded to substitute and `dbBranch` refuses it. Pass
-     * `mockOverride` at replay time for calls that must not run.
-     *
-     * @returns The trace ID, usable with `replay({ traceIds: [...] })`.
-     */
-    seedTrace(traceFunctionKey: string, options: {
-        /** Arguments spread into the function at replay, as `fn(...input)`. */
-        input: unknown[];
-        /**
-         * The output this case should produce. Optional, but without it the
-         * replay has nothing to be judged against.
-         */
-        expected?: unknown;
-        /**
-         * The function these inputs will replay through. When given, the call is
-         * checked against its arity here, so a case that cannot supply the
-         * function's required arguments fails now instead of at replay. Omit it
-         * when the seeding script cannot import the function.
-         */
-        fn?: (...args: any[]) => unknown;
-        /**
-         * Recorded on the trace. Put the source row's id here so a seeded trace
-         * can be traced back to the case it came from.
-         */
-        metadata?: Record<string, unknown>;
-        sessionId?: string;
-        name?: string;
-        spanName?: string;
-        spanType?: SpanType;
-    }): string;
+    seedTrace(traceFunctionKey: string, options: SeedCaseOptions): string;
+    seedTrace<TArgs extends unknown[], TReturn>(traceFunctionKey: string, fn: (...args: TArgs) => TReturn, options?: SeedRunOptions<TArgs>): Promise<string>;
+    private seedTraceFromCase;
+    private seedTraceByRunning;
     replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
 }
 /**
@@ -3100,7 +3089,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.41.0";
+declare const __version__ = "0.43.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3226,6 +3215,8 @@ interface SeedResult {
  * Passing the registered function to `seedTrace` also means a case that cannot
  * supply its required arguments is rejected here rather than at replay.
  */
-declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, cases: readonly SeedCase[]): Promise<SeedResult>;
+declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, cases: readonly SeedCase[], options?: {
+    run?: boolean;
+}): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, HttpClient, type LangGraphIntegrationOptions, type ListDatasetsParams, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, SUPPORTED_PROVIDERS, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedResult, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceIngestionType, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, HttpClient, type LangGraphIntegrationOptions, type ListDatasetsParams, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, SUPPORTED_PROVIDERS, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceIngestionType, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, seedFromRegistry, serializeReplayResult };

package/dist/index.d.ts

@@ -306,6 +306,7 @@ interface ReplayContext {
      * customer sees in the Bitfab dashboard.
      */
     sourceBitfabTraceId?: string;
+    replayAttempt?: number;
     mockTree?: MockTree;
     callCounters?: Map<string, number>;
     mockStrategy?: "none" | "all" | "marked";
@@ -584,7 +585,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): 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): Promise<StartReplayResponse>;
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
@@ -625,7 +626,7 @@ declare class HttpClient {
      * snapshot + preview branch and polls operations to readiness, which
      * can take seconds.
      */
-    resolveDbBranchLease(testRunId: string, traceId: string, dbBranchSettings?: DbBranchSettings): Promise<{
+    resolveDbBranchLease(testRunId: string, traceId: string, dbBranchSettings?: DbBranchSettings, attempt?: number): Promise<{
         dbSnapshotRef: DbSnapshotRef | null;
         lease: DbBranchLease | null;
         leaseError: {
@@ -658,6 +659,7 @@ interface CodeChangeFile {
 interface StartReplayResponse {
     testRunId: string;
     testRunUrl: string;
+    attempts?: number;
     items: Array<{
         /** Bitfab trace ID of the original (historical) trace being replayed. */
         originalTraceId?: string;
@@ -698,6 +700,7 @@ interface StartReplayResponse {
          * servers that predate it.
          */
         dbBranchTimings?: DbBranchTimings;
+        originalMetadata?: Record<string, unknown>;
     }>;
 }
 interface ExternalSpanResponse {
@@ -960,6 +963,7 @@ declare class BitfabClaudeAgentHandler {
 type LlmSpanOptions = {
     type: "llm";
     finalize: (result: unknown) => unknown | Promise<unknown>;
+    surface: "inherit";
 };
 type WithSpanFn$1 = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: LlmSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 /**
@@ -1265,6 +1269,7 @@ interface SpanClient {
         captureWhen?: "always" | "nested";
         mockOnReplay?: boolean;
         finalize?: (result: unknown) => unknown | Promise<unknown>;
+        surface?: "inherit";
     }, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 }
 interface LangGraphTool {
@@ -1371,6 +1376,7 @@ type RunResultLike = {
 type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
+    surface: "inherit";
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
@@ -1472,6 +1478,7 @@ interface ReplayOptions {
      * 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`. */
     traceIds?: string[];
     /** Optional display name for the resulting experiment/test run. */
@@ -1624,6 +1631,7 @@ interface ReplayItemStartProgress {
         sourceTraceId: string;
         /** @deprecated alias for `originalSpanId`. */
         sourceSpanId: string;
+        attempt: number;
     };
 }
 /** Running totals reported to {@link ReplayOptions.onItemFinish} as replay proceeds. */
@@ -1663,6 +1671,7 @@ interface ReplayProgressItem {
     sourceTraceId: string | null;
     /** @deprecated alias for `originalSpanId`. */
     sourceSpanId?: string | null;
+    attempt: number;
     /** Deserialized inputs from the original trace. */
     input?: unknown[];
     /** The result returned by the replayed function, or undefined on error. */
@@ -1741,6 +1750,7 @@ interface AdaptContext {
     sourceTraceId: string;
     /** @deprecated alias for {@link AdaptContext.originalSpanId}. */
     sourceSpanId: string;
+    metadata: Record<string, unknown>;
 }
 /**
  * The shape an adapter module must export as `adaptInputs`.
@@ -1772,6 +1782,7 @@ interface ReplayItem<T> {
     sourceTraceId: string;
     /** @deprecated alias for {@link ReplayItem.originalSpanId}. */
     sourceSpanId: string;
+    attempt: number;
     /** Deserialized inputs from the original trace. */
     input: unknown[];
     /** The result returned by the function during replay, or undefined on error. */
@@ -1850,6 +1861,7 @@ interface ReplayResult<T> {
     testRunId: string;
     /** Full URL to view the test run in the dashboard. */
     testRunUrl: string;
+    attempts: number;
 }
 /**
  * Whole-run replay failure that preserves every item collected before the run
@@ -2094,6 +2106,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
     private sendSpan;
 }
 
+type CaptureSurface = "opt-in" | "opt-out";
 /**
  * Options for wrapBAML.
  */
@@ -2229,6 +2242,22 @@ declare function getCurrentReplayBranch(): ReplayBranch | null;
  * Returns a no-op object if called outside of a span context (methods do nothing).
  */
 declare function getCurrentTrace(): CurrentTrace;
+interface SeedCaseOptions {
+    input: unknown[];
+    expected?: unknown;
+    fn?: (...args: any[]) => unknown;
+    metadata?: Record<string, unknown>;
+    sessionId?: string;
+    name?: string;
+    spanName?: string;
+    spanType?: SpanType;
+}
+interface SeedRunOptions<TArgs extends unknown[]> {
+    args?: TArgs;
+    metadata?: Record<string, unknown>;
+    sessionId?: string;
+    name?: string;
+}
 interface BitfabConfig {
     /**
      * The API key for Bitfab API authentication. Resolved lazily, the first
@@ -2249,7 +2278,7 @@ interface BitfabConfig {
     timeout?: number;
     /** Environment variables for LLM provider API keys (only OPENAI_API_KEY is supported) */
     envVars?: AllowedEnvVars;
-    /** Whether the client is enabled. Defaults to true. When false, withSpan returns the original function unwrapped. */
+    captureEnabled?: boolean;
     enabled?: boolean;
     /**
      * Fail loud instead of degrading quietly. When true, the first traced call
@@ -2410,8 +2439,7 @@ declare class Bitfab {
     private readonly serviceUrl;
     private readonly timeout;
     private readonly envVars;
-    /** The user's on/off intent. The effective enabled state ANDs this with "a key resolved" (see isTracingEnabled). */
-    private readonly explicitlyEnabled;
+    private readonly captureConfigured;
     private readonly strict;
     private readonly httpClient;
     /** Dataset operations for the authenticated organization. */
@@ -2526,12 +2554,9 @@ declare class Bitfab {
      * early resolve that found nothing never poisons a later one.
      */
     private resolveApiKey;
-    /**
-     * Whether tracing should run, decided lazily at call time (not frozen at
-     * construction). An explicit `enabled: false` short-circuits without ever
-     * touching the key.
-     */
-    private isTracingEnabled;
+    private isCaptureEnabled;
+    private shouldRecord;
+    get captureEnabled(): boolean;
     /**
      * Fetch the function with its current version and BAML prompt from the server.
      *
@@ -2885,46 +2910,10 @@ declare class Bitfab {
     registerMockOverride(traceFunctionKey: string, override: MockOverride | MockOverrideResolver): void;
     /** Remove all overrides registered via {@link registerMockOverride}. */
     clearMockOverrides(): void;
-    /**
-     * Write a replayable trace from a case, without running anything.
-     *
-     * Use this to turn a corpus you already hold (a Braintrust dataset, a
-     * spreadsheet, hand-written cases) into traces that {@link replay} can
-     * select. The recorded root span carries `input` as its input and `expected`
-     * as its output, so replay reports each item against the value you expected
-     * rather than against a previous run.
-     *
-     * A seeded trace has no child spans and no database pin, so replay mocking
-     * has nothing recorded to substitute and `dbBranch` refuses it. Pass
-     * `mockOverride` at replay time for calls that must not run.
-     *
-     * @returns The trace ID, usable with `replay({ traceIds: [...] })`.
-     */
-    seedTrace(traceFunctionKey: string, options: {
-        /** Arguments spread into the function at replay, as `fn(...input)`. */
-        input: unknown[];
-        /**
-         * The output this case should produce. Optional, but without it the
-         * replay has nothing to be judged against.
-         */
-        expected?: unknown;
-        /**
-         * The function these inputs will replay through. When given, the call is
-         * checked against its arity here, so a case that cannot supply the
-         * function's required arguments fails now instead of at replay. Omit it
-         * when the seeding script cannot import the function.
-         */
-        fn?: (...args: any[]) => unknown;
-        /**
-         * Recorded on the trace. Put the source row's id here so a seeded trace
-         * can be traced back to the case it came from.
-         */
-        metadata?: Record<string, unknown>;
-        sessionId?: string;
-        name?: string;
-        spanName?: string;
-        spanType?: SpanType;
-    }): string;
+    seedTrace(traceFunctionKey: string, options: SeedCaseOptions): string;
+    seedTrace<TArgs extends unknown[], TReturn>(traceFunctionKey: string, fn: (...args: TArgs) => TReturn, options?: SeedRunOptions<TArgs>): Promise<string>;
+    private seedTraceFromCase;
+    private seedTraceByRunning;
     replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
 }
 /**
@@ -3100,7 +3089,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.41.0";
+declare const __version__ = "0.43.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3226,6 +3215,8 @@ interface SeedResult {
  * Passing the registered function to `seedTrace` also means a case that cannot
  * supply its required arguments is rejected here rather than at replay.
  */
-declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, cases: readonly SeedCase[]): Promise<SeedResult>;
+declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, cases: readonly SeedCase[], options?: {
+    run?: boolean;
+}): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, HttpClient, type LangGraphIntegrationOptions, type ListDatasetsParams, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, SUPPORTED_PROVIDERS, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedResult, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceIngestionType, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, HttpClient, type LangGraphIntegrationOptions, type ListDatasetsParams, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, SUPPORTED_PROVIDERS, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceIngestionType, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, seedFromRegistry, serializeReplayResult };

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   getCurrentSpan,
   getCurrentTrace,
   seedFromRegistry
-} from "./chunk-U3AKIFW3.js";
+} from "./chunk-5BBJ5BQD.js";
 import "./chunk-ZUD7OFYB.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -24,14 +24,14 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-RWZYZRYI.js";
+} from "./chunk-BXBRVWWW.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
   HttpClient,
   __version__,
   flushTraces
-} from "./chunk-IFYX3KW6.js";
+} from "./chunk-6EM2S5H5.js";
 import "./chunk-H6LZRFMN.js";
 export {
   BITFAB_PROGRESS_PREFIX,