@bitfab/sdk 0.36.13 → 0.38.0

package/dist/index.d.cts

@@ -223,6 +223,39 @@ interface DbBranchLease {
      */
     region?: string;
 }
+/**
+ * How long each phase of provisioning one replay branch took, measured
+ * server-side. A runner in another region sees these plus its own round trip.
+ *
+ * Durations, not instants: an instant is approximately `startedAt` plus the
+ * running sum, and per-phase wall-clock stamps would make clock skew between
+ * the server and your runner look like latency. Approximately, because
+ * `totalMs` is the resolve's true wall time and covers a little work no phase
+ * owns, so the phases account for it without summing to it exactly.
+ *
+ * `startedAt` and `totalMs` are always present. The phases are optional
+ * because a failed resolve reports only the ones it reached, and `totalMs` is
+ * then time-to-failure. On success every phase is present except `warmupMs`,
+ * which is absent when no warm-up SQL was supplied.
+ */
+interface DbBranchTimings {
+    /** When the resolve began, ISO. */
+    startedAt: string;
+    /** Resolving the project, plus its retention and region reads. */
+    projectResolveMs?: number;
+    /** Creating the branch, through its provider operations reaching terminal. */
+    branchCreateMs?: number;
+    /** Resolving the connection URI. 0 when the provider returns one inline. */
+    connectionUriMs?: number;
+    /** The compute accepting a connection. */
+    computeConnectMs?: number;
+    /** The branch answering a readiness query. */
+    baseProbeMs?: number;
+    /** Your warm-up SQL. Absent when you supplied none. */
+    warmupMs?: number;
+    /** The whole resolve, or time-to-failure when it threw. */
+    totalMs: number;
+}
 /**
  * Wire shape of the caller's `ReplayOptions.dbBranch`, sent to
  * `/api/sdk/replay/start` and applied per lease.
@@ -275,6 +308,14 @@ interface ReplayContext {
      */
     fetchSpanOutput?: (externalSpanId: string) => Promise<unknown>;
     dbBranchLease?: DbBranchLease;
+    /**
+     * Server-measured provisioning timings for this item's branch, echoed back
+     * on the trace completion so the trace records what it cost to set up. Kept
+     * off `ReplayBranch`: customer code reads that mid-replay to reach the
+     * branch, and provisioning latency is a property of the run, not of the
+     * connection.
+     */
+    dbBranchTimings?: DbBranchTimings;
     /**
      * Set to true by `ReplayBranch` the first time customer code actually
      * obtains `databaseUrl` for this item. Reported on the trace completion inside
@@ -570,6 +611,7 @@ declare class HttpClient {
             code: string;
             message: string;
         } | null;
+        timings: DbBranchTimings | null;
     }>;
     /** Release a previously-resolved DB branch by deleting its Neon branch. Idempotent server-side. */
     releaseDbBranchLease(neonBranchId: string): Promise<void>;
@@ -628,6 +670,13 @@ interface StartReplayResponse {
             code: string;
             message: string;
         };
+        /**
+         * How long provisioning took, per phase. Sits beside the two fields above
+         * rather than inside either: it is reported on both outcomes, complete on
+         * success and partial up to the failing phase on error. Absent from
+         * servers that predate it.
+         */
+        dbBranchTimings?: DbBranchTimings;
     }>;
 }
 interface ExternalSpanResponse {
@@ -1343,42 +1392,52 @@ interface ReplayItemFinishProgress {
     /** Of the completed items, how many have `item.error` set. */
     errored: number;
     /**
-     * The single item that just finished to produce this event. `traceId` is null
-     * at this stage (the server replay id isn't known until the run completes);
-     * `originalTraceId` is the original (historical) trace that was replayed (so
-     * a UI can identify or link it); `error` is its replay error, or null when it
-     * ran ok; `durationMs` is how long this one trace took to replay. Lets a
-     * progress UI show per-trace pass/fail and timing as the run streams, without
-     * waiting for the full {@link ReplayResult}.
+     * The single item that just finished to produce this event. Field-for-field
+     * the same shape and meaning as {@link ReplayItem}, so a progress UI and a
+     * final-result UI read one contract. `traceId` is null at this stage (the
+     * server replay id arrives at completion), and `tokens` is null for the same
+     * reason: the replayed run's usage is aggregated server-side by
+     * completeReplay. `durationMs` is how long this item took to replay; the
+     * `original*` fields describe the trace it replayed.
      */
-    item: {
-        /** Trace ID of the new replay trace (null during the run; the server id arrives at completion). */
-        traceId?: string | null;
-        /** Bitfab trace ID of the original (historical) trace being replayed. */
-        originalTraceId: string | null;
-        /** External span ID the recorded inputs were read from (the original root span). */
-        originalSpanId?: string | null;
-        /** @deprecated alias for `originalTraceId`. */
-        sourceTraceId: string | null;
-        /** @deprecated alias for `originalSpanId`. */
-        sourceSpanId?: string | null;
-        /** Deserialized inputs from the original trace. */
-        input?: unknown[];
-        /** The result returned by the replayed function, or undefined on error. */
-        result?: unknown;
-        /** The original output from the historical trace. */
-        originalOutput?: unknown;
-        /** Backward-compatible message for either error kind. */
-        error: string | null;
-        /** The actual value thrown by the replayed customer function. */
-        traceError: unknown | null;
-        /** The actual value thrown while Bitfab prepared this replay item. */
-        replayError: unknown | null;
-        durationMs: number | null;
-        tokens?: TokenUsage | null;
-        model?: string | null;
-        dbSnapshotRef?: DbSnapshotRef | null;
-    };
+    item: ReplayProgressItem;
+}
+/** See {@link ReplayItemFinishProgress.item}. Mirrors {@link ReplayItem}. */
+interface ReplayProgressItem {
+    /** Trace ID of the new replay trace (null during the run; the server id arrives at completion). */
+    traceId?: string | null;
+    /** Bitfab trace ID of the original (historical) trace being replayed. */
+    originalTraceId: string | null;
+    /** External span ID the recorded inputs were read from (the original root span). */
+    originalSpanId?: string | null;
+    /** @deprecated alias for `originalTraceId`. */
+    sourceTraceId: string | null;
+    /** @deprecated alias for `originalSpanId`. */
+    sourceSpanId?: string | null;
+    /** Deserialized inputs from the original trace. */
+    input?: unknown[];
+    /** The result returned by the replayed function, or undefined on error. */
+    result?: unknown;
+    /** The original output from the historical trace. */
+    originalOutput?: unknown;
+    /** Backward-compatible message for either error kind. */
+    error: string | null;
+    /** The actual value thrown by the replayed customer function. */
+    traceError?: unknown | null;
+    /** The actual value thrown while Bitfab prepared this replay item. */
+    replayError?: unknown | null;
+    /** How long the replayed function took on this run. */
+    durationMs?: number | null;
+    /** The original trace's duration, tokens, and model. */
+    originalDurationMs?: number | null;
+    originalTokens?: TokenUsage | null;
+    originalModel?: string | null;
+    /** Always null here: the replayed run's usage is only known at completion. */
+    tokens?: TokenUsage | null;
+    /** @deprecated renamed to `originalModel`. */
+    model?: string | null;
+    dbSnapshotRef?: DbSnapshotRef | null;
+    dbBranchTimings?: DbBranchTimings | null;
 }
 /**
  * @deprecated Use {@link ReplayItemFinishProgress}. This legacy shape also
@@ -1482,17 +1541,32 @@ interface ReplayItem<T> {
      * such as database warmup, input hydration, or mock preparation.
      */
     replayError: unknown | null;
-    /** Original trace duration in milliseconds, or null if timestamps are missing. */
+    /**
+     * How long the replayed function took on this run, in ms. Null if the item
+     * failed before it ran. Compare against
+     * {@link ReplayItem.originalDurationMs} for the before/after.
+     */
     durationMs: number | null;
+    /** The original trace's duration in ms, or null if its timestamps are missing. */
+    originalDurationMs: number | null;
+    /**
+     * Token usage recorded on the original trace, or null if it captured none.
+     * The "old" side of a token delta; {@link ReplayItem.tokens} is the new one.
+     */
+    originalTokens: TokenUsage | null;
+    /** Model name from the original trace, or null if not captured. */
+    originalModel: string | null;
     /**
      * Token usage from the REPLAYED run (this item's new execution), aggregated
      * server-side from the spans it produced, or null if the run captured no
-     * token data. This is the "new" side of a token delta: compare it against
-     * the original trace's recorded usage to see how the code change moved cost.
-     * Matches what Studio's experiments view shows.
+     * token data. Compare against {@link ReplayItem.originalTokens} to see how
+     * the code change moved cost. Matches what Studio's experiments view shows.
+     *
+     * Unprefixed because the replay is this item's subject: anything describing
+     * the trace being replayed carries `original`.
      */
     tokens: TokenUsage | null;
-    /** Model name from the original trace, or null if not captured. */
+    /** @deprecated renamed to {@link ReplayItem.originalModel}. */
     model: string | null;
     /**
      * The DB snapshot ref the SDK captured at trace open. Useful for debugging
@@ -1501,6 +1575,14 @@ interface ReplayItem<T> {
      * without `dbSnapshot` configured.
      */
     dbSnapshotRef: DbSnapshotRef | null;
+    /**
+     * How long this item's DB branch took to provision, per phase, measured
+     * server-side. Present whenever a branch was attempted, on both outcomes:
+     * complete on success, partial up to the failing phase when the resolve
+     * failed. Null when no branch was asked for, when the source trace carried
+     * no snapshot ref, or against a server that predates timings.
+     */
+    dbBranchTimings: DbBranchTimings | null;
 }
 
 interface ReplayResult<T> {
@@ -2581,7 +2663,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.13";
+declare const __version__ = "0.38.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -2649,4 +2731,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayProgress, type ReplayProgressItem, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };

package/dist/index.d.ts

@@ -223,6 +223,39 @@ interface DbBranchLease {
      */
     region?: string;
 }
+/**
+ * How long each phase of provisioning one replay branch took, measured
+ * server-side. A runner in another region sees these plus its own round trip.
+ *
+ * Durations, not instants: an instant is approximately `startedAt` plus the
+ * running sum, and per-phase wall-clock stamps would make clock skew between
+ * the server and your runner look like latency. Approximately, because
+ * `totalMs` is the resolve's true wall time and covers a little work no phase
+ * owns, so the phases account for it without summing to it exactly.
+ *
+ * `startedAt` and `totalMs` are always present. The phases are optional
+ * because a failed resolve reports only the ones it reached, and `totalMs` is
+ * then time-to-failure. On success every phase is present except `warmupMs`,
+ * which is absent when no warm-up SQL was supplied.
+ */
+interface DbBranchTimings {
+    /** When the resolve began, ISO. */
+    startedAt: string;
+    /** Resolving the project, plus its retention and region reads. */
+    projectResolveMs?: number;
+    /** Creating the branch, through its provider operations reaching terminal. */
+    branchCreateMs?: number;
+    /** Resolving the connection URI. 0 when the provider returns one inline. */
+    connectionUriMs?: number;
+    /** The compute accepting a connection. */
+    computeConnectMs?: number;
+    /** The branch answering a readiness query. */
+    baseProbeMs?: number;
+    /** Your warm-up SQL. Absent when you supplied none. */
+    warmupMs?: number;
+    /** The whole resolve, or time-to-failure when it threw. */
+    totalMs: number;
+}
 /**
  * Wire shape of the caller's `ReplayOptions.dbBranch`, sent to
  * `/api/sdk/replay/start` and applied per lease.
@@ -275,6 +308,14 @@ interface ReplayContext {
      */
     fetchSpanOutput?: (externalSpanId: string) => Promise<unknown>;
     dbBranchLease?: DbBranchLease;
+    /**
+     * Server-measured provisioning timings for this item's branch, echoed back
+     * on the trace completion so the trace records what it cost to set up. Kept
+     * off `ReplayBranch`: customer code reads that mid-replay to reach the
+     * branch, and provisioning latency is a property of the run, not of the
+     * connection.
+     */
+    dbBranchTimings?: DbBranchTimings;
     /**
      * Set to true by `ReplayBranch` the first time customer code actually
      * obtains `databaseUrl` for this item. Reported on the trace completion inside
@@ -570,6 +611,7 @@ declare class HttpClient {
             code: string;
             message: string;
         } | null;
+        timings: DbBranchTimings | null;
     }>;
     /** Release a previously-resolved DB branch by deleting its Neon branch. Idempotent server-side. */
     releaseDbBranchLease(neonBranchId: string): Promise<void>;
@@ -628,6 +670,13 @@ interface StartReplayResponse {
             code: string;
             message: string;
         };
+        /**
+         * How long provisioning took, per phase. Sits beside the two fields above
+         * rather than inside either: it is reported on both outcomes, complete on
+         * success and partial up to the failing phase on error. Absent from
+         * servers that predate it.
+         */
+        dbBranchTimings?: DbBranchTimings;
     }>;
 }
 interface ExternalSpanResponse {
@@ -1343,42 +1392,52 @@ interface ReplayItemFinishProgress {
     /** Of the completed items, how many have `item.error` set. */
     errored: number;
     /**
-     * The single item that just finished to produce this event. `traceId` is null
-     * at this stage (the server replay id isn't known until the run completes);
-     * `originalTraceId` is the original (historical) trace that was replayed (so
-     * a UI can identify or link it); `error` is its replay error, or null when it
-     * ran ok; `durationMs` is how long this one trace took to replay. Lets a
-     * progress UI show per-trace pass/fail and timing as the run streams, without
-     * waiting for the full {@link ReplayResult}.
+     * The single item that just finished to produce this event. Field-for-field
+     * the same shape and meaning as {@link ReplayItem}, so a progress UI and a
+     * final-result UI read one contract. `traceId` is null at this stage (the
+     * server replay id arrives at completion), and `tokens` is null for the same
+     * reason: the replayed run's usage is aggregated server-side by
+     * completeReplay. `durationMs` is how long this item took to replay; the
+     * `original*` fields describe the trace it replayed.
      */
-    item: {
-        /** Trace ID of the new replay trace (null during the run; the server id arrives at completion). */
-        traceId?: string | null;
-        /** Bitfab trace ID of the original (historical) trace being replayed. */
-        originalTraceId: string | null;
-        /** External span ID the recorded inputs were read from (the original root span). */
-        originalSpanId?: string | null;
-        /** @deprecated alias for `originalTraceId`. */
-        sourceTraceId: string | null;
-        /** @deprecated alias for `originalSpanId`. */
-        sourceSpanId?: string | null;
-        /** Deserialized inputs from the original trace. */
-        input?: unknown[];
-        /** The result returned by the replayed function, or undefined on error. */
-        result?: unknown;
-        /** The original output from the historical trace. */
-        originalOutput?: unknown;
-        /** Backward-compatible message for either error kind. */
-        error: string | null;
-        /** The actual value thrown by the replayed customer function. */
-        traceError: unknown | null;
-        /** The actual value thrown while Bitfab prepared this replay item. */
-        replayError: unknown | null;
-        durationMs: number | null;
-        tokens?: TokenUsage | null;
-        model?: string | null;
-        dbSnapshotRef?: DbSnapshotRef | null;
-    };
+    item: ReplayProgressItem;
+}
+/** See {@link ReplayItemFinishProgress.item}. Mirrors {@link ReplayItem}. */
+interface ReplayProgressItem {
+    /** Trace ID of the new replay trace (null during the run; the server id arrives at completion). */
+    traceId?: string | null;
+    /** Bitfab trace ID of the original (historical) trace being replayed. */
+    originalTraceId: string | null;
+    /** External span ID the recorded inputs were read from (the original root span). */
+    originalSpanId?: string | null;
+    /** @deprecated alias for `originalTraceId`. */
+    sourceTraceId: string | null;
+    /** @deprecated alias for `originalSpanId`. */
+    sourceSpanId?: string | null;
+    /** Deserialized inputs from the original trace. */
+    input?: unknown[];
+    /** The result returned by the replayed function, or undefined on error. */
+    result?: unknown;
+    /** The original output from the historical trace. */
+    originalOutput?: unknown;
+    /** Backward-compatible message for either error kind. */
+    error: string | null;
+    /** The actual value thrown by the replayed customer function. */
+    traceError?: unknown | null;
+    /** The actual value thrown while Bitfab prepared this replay item. */
+    replayError?: unknown | null;
+    /** How long the replayed function took on this run. */
+    durationMs?: number | null;
+    /** The original trace's duration, tokens, and model. */
+    originalDurationMs?: number | null;
+    originalTokens?: TokenUsage | null;
+    originalModel?: string | null;
+    /** Always null here: the replayed run's usage is only known at completion. */
+    tokens?: TokenUsage | null;
+    /** @deprecated renamed to `originalModel`. */
+    model?: string | null;
+    dbSnapshotRef?: DbSnapshotRef | null;
+    dbBranchTimings?: DbBranchTimings | null;
 }
 /**
  * @deprecated Use {@link ReplayItemFinishProgress}. This legacy shape also
@@ -1482,17 +1541,32 @@ interface ReplayItem<T> {
      * such as database warmup, input hydration, or mock preparation.
      */
     replayError: unknown | null;
-    /** Original trace duration in milliseconds, or null if timestamps are missing. */
+    /**
+     * How long the replayed function took on this run, in ms. Null if the item
+     * failed before it ran. Compare against
+     * {@link ReplayItem.originalDurationMs} for the before/after.
+     */
     durationMs: number | null;
+    /** The original trace's duration in ms, or null if its timestamps are missing. */
+    originalDurationMs: number | null;
+    /**
+     * Token usage recorded on the original trace, or null if it captured none.
+     * The "old" side of a token delta; {@link ReplayItem.tokens} is the new one.
+     */
+    originalTokens: TokenUsage | null;
+    /** Model name from the original trace, or null if not captured. */
+    originalModel: string | null;
     /**
      * Token usage from the REPLAYED run (this item's new execution), aggregated
      * server-side from the spans it produced, or null if the run captured no
-     * token data. This is the "new" side of a token delta: compare it against
-     * the original trace's recorded usage to see how the code change moved cost.
-     * Matches what Studio's experiments view shows.
+     * token data. Compare against {@link ReplayItem.originalTokens} to see how
+     * the code change moved cost. Matches what Studio's experiments view shows.
+     *
+     * Unprefixed because the replay is this item's subject: anything describing
+     * the trace being replayed carries `original`.
      */
     tokens: TokenUsage | null;
-    /** Model name from the original trace, or null if not captured. */
+    /** @deprecated renamed to {@link ReplayItem.originalModel}. */
     model: string | null;
     /**
      * The DB snapshot ref the SDK captured at trace open. Useful for debugging
@@ -1501,6 +1575,14 @@ interface ReplayItem<T> {
      * without `dbSnapshot` configured.
      */
     dbSnapshotRef: DbSnapshotRef | null;
+    /**
+     * How long this item's DB branch took to provision, per phase, measured
+     * server-side. Present whenever a branch was attempted, on both outcomes:
+     * complete on success, partial up to the failing phase when the resolve
+     * failed. Null when no branch was asked for, when the source trace carried
+     * no snapshot ref, or against a server that predates timings.
+     */
+    dbBranchTimings: DbBranchTimings | null;
 }
 
 interface ReplayResult<T> {
@@ -2581,7 +2663,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.13";
+declare const __version__ = "0.38.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -2649,4 +2731,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, HttpClient, type MockOverride, type MockOverrideCtx, type MockStrategy, type MockValue, type NodeMatcher, type ProviderDefinition, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayProgress, type ReplayProgressItem, type ReplayResult, SUPPORTED_PROVIDERS, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, serializeReplayResult };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-XAQJOZMJ.js";
+} from "./chunk-LCGQUVKR.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
@@ -23,7 +23,7 @@ import {
   flushTraces,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-VOUV7ZTS.js";
+} from "./chunk-SSNTMROV.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.36.13";
+    __version__ = "0.38.0";
   }
 });
 
@@ -2532,12 +2532,15 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
   let lease = includeDbBranchLease ? serverItem.dbBranchLease : void 0;
   let leaseError = includeDbBranchLease ? serverItem.dbBranchLeaseError : void 0;
   let dbSnapshotRef = serverItem.dbSnapshotRef;
+  let dbBranchTimings = includeDbBranchLease ? serverItem.dbBranchTimings : void 0;
   let inputs = [];
   let originalOutput;
   let result;
   let error = null;
   let traceError = null;
   let replayError = null;
+  let replayDurationMs = null;
+  let replayStarted = null;
   const originalTraceId = serverItem.originalTraceId ?? serverItem.sourceTraceId;
   const originalSpanId = serverItem.originalSpanId ?? serverItem.sourceSpanId;
   try {
@@ -2560,6 +2563,7 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
       lease = resolved.lease ?? void 0;
       leaseError = resolved.leaseError ?? void 0;
       dbSnapshotRef = resolved.dbSnapshotRef ?? dbSnapshotRef;
+      dbBranchTimings = resolved.timings ?? dbBranchTimings;
     }
     if (leaseError) {
       throw new DbBranchReplayError(
@@ -2620,6 +2624,7 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
       return pending;
     } : void 0;
     try {
+      replayStarted = performance.now();
       const maybePromise = runWithReplayContext(
         {
           testRunId,
@@ -2632,16 +2637,24 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
           mockStrategy,
           mockOverrides: hasOverrides ? resolvedOverrides : void 0,
           fetchSpanOutput,
-          dbBranchLease: lease
+          dbBranchLease: lease,
+          dbBranchTimings
         },
         () => fn(...inputs)
       );
       result = maybePromise instanceof Promise ? await maybePromise : maybePromise;
+      replayDurationMs = Math.round(performance.now() - replayStarted);
     } catch (e) {
+      if (replayStarted !== null) {
+        replayDurationMs = Math.round(performance.now() - replayStarted);
+      }
       traceError = e;
       error = errorMessage(e);
     }
   } catch (e) {
+    if (replayStarted !== null) {
+      replayDurationMs = Math.round(performance.now() - replayStarted);
+    }
     replayError = e;
     error = replayItemErrorMessage(e);
   } finally {
@@ -2658,6 +2671,8 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
       }
     }
   }
+  const originalDurationMs = serverItem.originalDurationMs ?? serverItem.durationMs ?? null;
+  const originalModel = serverItem.originalModel ?? serverItem.model ?? null;
   return {
     // Written in by replay() from the complete-replay response once the server
     // has minted this replay trace's row. Null until then: the client-side
@@ -2674,13 +2689,17 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
     error,
     traceError,
     replayError,
-    durationMs: serverItem.durationMs ?? null,
+    durationMs: replayDurationMs,
+    originalDurationMs,
+    originalTokens: serverItem.originalTokens ?? serverItem.tokens ?? null,
+    originalModel,
     // Filled in by replay() from the complete-replay response once the
     // replay traces are persisted and their spans aggregated server-side.
     // Null here (and on older servers) means "replay tokens not known".
     tokens: null,
-    model: serverItem.model ?? null,
-    dbSnapshotRef: dbSnapshotRef ?? null
+    model: originalModel,
+    dbSnapshotRef: dbSnapshotRef ?? null,
+    dbBranchTimings: dbBranchTimings ?? null
   };
 }
 async function waitForReplayPersistence(httpClient, testRunId, replayedTraceIds) {
@@ -2907,9 +2926,13 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
             traceError: item.traceError,
             replayError: item.replayError,
             durationMs: item.durationMs,
+            originalDurationMs: item.originalDurationMs,
+            originalTokens: item.originalTokens,
+            originalModel: item.originalModel,
             tokens: item.tokens,
             model: item.model,
-            dbSnapshotRef: item.dbSnapshotRef
+            dbSnapshotRef: item.dbSnapshotRef,
+            dbBranchTimings: item.dbBranchTimings
           }
         });
       } catch {
@@ -6095,7 +6118,8 @@ var Bitfab = class {
                     snapshotTimestamp: replayCtx.dbBranchLease.snapshotTimestamp,
                     region: replayCtx.dbBranchLease.region,
                     originalTraceId: replayCtx.sourceBitfabTraceId,
-                    accessed: replayCtx.dbSnapshotAccessed === true
+                    accessed: replayCtx.dbSnapshotAccessed === true,
+                    timings: replayCtx.dbBranchTimings
                   }
                 }
               });
@@ -6427,7 +6451,13 @@ var Bitfab = class {
           // against servers that predate the rename.
           source_trace_id: params.dbSnapshotUsage.originalTraceId
         },
-        accessed: params.dbSnapshotUsage.accessed
+        accessed: params.dbSnapshotUsage.accessed,
+        // Echoed verbatim (camelCase inside) rather than re-cased into this
+        // record's snake_case: it is the server's own object coming back, and
+        // a translation layer here is one more thing to drift.
+        ...params.dbSnapshotUsage.timings && {
+          timings: params.dbSnapshotUsage.timings
+        }
       };
     }
     this.httpClient.sendExternalTrace({