@bitfab/sdk 0.16.1 → 0.17.0

package/dist/index.d.cts

@@ -147,9 +147,12 @@ declare class BitfabClaudeAgentHandler {
 /**
  * Per-trace database snapshot ref capture.
  *
- * When the customer configures `dbSnapshot`, every root span carries a
- * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
- * timestamp. The Bitfab service uses that timestamp at replay time to
+ * Every root span carries a `DbSnapshotRef` that pins the DB state at trace
+ * open by wall-clock timestamp. Capturing the timestamp is free (no IO) and
+ * harmless, so it happens on every trace regardless of configuration: that
+ * lets any trace be replayed against a historical branch later. A `provider`
+ * is attached only when the customer configured `dbSnapshot`; when absent it
+ * is resolved at replay time. The Bitfab service uses the timestamp to
  * materialize an ephemeral branch from `customer-main`.
  */
 declare const SUPPORTED_PROVIDERS: readonly ["neon"];
@@ -159,14 +162,19 @@ interface DbSnapshotConfig {
     provider: DbSnapshotProvider;
 }
 interface DbSnapshotRef {
-    provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
      * invoking the wrapped function. The name encodes its provenance:
      * SDK-observed, wall clock (not monotonic), captured before user code
-     * began executing.
+     * began executing. Always present.
      */
     sdkWallClockBeforeFn: string;
+    /**
+     * The configured provider for server-side branch resolution. Only set when
+     * the customer configured `dbSnapshot`; otherwise the provider is resolved
+     * at replay time.
+     */
+    provider?: DbSnapshotProvider;
 }
 
 /**
@@ -812,6 +820,22 @@ declare class Bitfab {
      * @returns A BitfabLangGraphCallbackHandler configured for this client
      */
     getLangGraphCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
+    /**
+     * Get a LangChain callback handler for tracing.
+     *
+     * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+     * LangGraph graphs share the same callback system, so one handler serves
+     * both.
+     *
+     * ```typescript
+     * const handler = client.getLangChainCallbackHandler("my-chain");
+     * const result = await chain.invoke(input, { callbacks: [handler] });
+     * ```
+     *
+     * @param traceFunctionKey - Groups traces under this key in Bitfab
+     * @returns A BitfabLangGraphCallbackHandler configured for this client
+     */
+    getLangChainCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
     /**
      * Get a Claude Agent SDK handler for tracing.
      *
@@ -1027,7 +1051,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.16.1";
+declare const __version__ = "0.17.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1037,4 +1061,4 @@ declare const __version__ = "0.16.1";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.d.ts

@@ -147,9 +147,12 @@ declare class BitfabClaudeAgentHandler {
 /**
  * Per-trace database snapshot ref capture.
  *
- * When the customer configures `dbSnapshot`, every root span carries a
- * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
- * timestamp. The Bitfab service uses that timestamp at replay time to
+ * Every root span carries a `DbSnapshotRef` that pins the DB state at trace
+ * open by wall-clock timestamp. Capturing the timestamp is free (no IO) and
+ * harmless, so it happens on every trace regardless of configuration: that
+ * lets any trace be replayed against a historical branch later. A `provider`
+ * is attached only when the customer configured `dbSnapshot`; when absent it
+ * is resolved at replay time. The Bitfab service uses the timestamp to
  * materialize an ephemeral branch from `customer-main`.
  */
 declare const SUPPORTED_PROVIDERS: readonly ["neon"];
@@ -159,14 +162,19 @@ interface DbSnapshotConfig {
     provider: DbSnapshotProvider;
 }
 interface DbSnapshotRef {
-    provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
      * invoking the wrapped function. The name encodes its provenance:
      * SDK-observed, wall clock (not monotonic), captured before user code
-     * began executing.
+     * began executing. Always present.
      */
     sdkWallClockBeforeFn: string;
+    /**
+     * The configured provider for server-side branch resolution. Only set when
+     * the customer configured `dbSnapshot`; otherwise the provider is resolved
+     * at replay time.
+     */
+    provider?: DbSnapshotProvider;
 }
 
 /**
@@ -812,6 +820,22 @@ declare class Bitfab {
      * @returns A BitfabLangGraphCallbackHandler configured for this client
      */
     getLangGraphCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
+    /**
+     * Get a LangChain callback handler for tracing.
+     *
+     * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+     * LangGraph graphs share the same callback system, so one handler serves
+     * both.
+     *
+     * ```typescript
+     * const handler = client.getLangChainCallbackHandler("my-chain");
+     * const result = await chain.invoke(input, { callbacks: [handler] });
+     * ```
+     *
+     * @param traceFunctionKey - Groups traces under this key in Bitfab
+     * @returns A BitfabLangGraphCallbackHandler configured for this client
+     */
+    getLangChainCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
     /**
      * Get a Claude Agent SDK handler for tracing.
      *
@@ -1027,7 +1051,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.16.1";
+declare const __version__ = "0.17.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1037,4 +1061,4 @@ declare const __version__ = "0.16.1";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-P4WFJ5O3.js";
+} from "./chunk-M6N633CX.js";
 import {
   BitfabError
 } from "./chunk-QT7HWOKU.js";
@@ -20,6 +20,7 @@ export {
   BitfabClaudeAgentHandler,
   BitfabError,
   BitfabFunction,
+  BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler,
   BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL,

package/dist/node.cjs

@@ -426,6 +426,7 @@ __export(node_exports, {
   BitfabClaudeAgentHandler: () => BitfabClaudeAgentHandler,
   BitfabError: () => BitfabError,
   BitfabFunction: () => BitfabFunction,
+  BitfabLangChainCallbackHandler: () => BitfabLangGraphCallbackHandler,
   BitfabLangGraphCallbackHandler: () => BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor: () => BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL: () => DEFAULT_SERVICE_URL,
@@ -446,7 +447,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.16.1";
+var __version__ = "0.17.0";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -1561,8 +1562,8 @@ function validateDbSnapshotConfig(config) {
 }
 function buildSnapshotRef(config, sdkWallClockBeforeFn) {
   return {
-    provider: config.provider,
-    sdkWallClockBeforeFn
+    sdkWallClockBeforeFn,
+    ...config && { provider: config.provider }
   };
 }
 
@@ -2733,6 +2734,24 @@ var Bitfab = class {
       }
     });
   }
+  /**
+   * Get a LangChain callback handler for tracing.
+   *
+   * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+   * LangGraph graphs share the same callback system, so one handler serves
+   * both.
+   *
+   * ```typescript
+   * const handler = client.getLangChainCallbackHandler("my-chain");
+   * const result = await chain.invoke(input, { callbacks: [handler] });
+   * ```
+   *
+   * @param traceFunctionKey - Groups traces under this key in Bitfab
+   * @returns A BitfabLangGraphCallbackHandler configured for this client
+   */
+  getLangChainCallbackHandler(traceFunctionKey) {
+    return this.getLangGraphCallbackHandler(traceFunctionKey);
+  }
   /**
    * Get a Claude Agent SDK handler for tracing.
    *
@@ -2919,7 +2938,7 @@ var Bitfab = class {
       const startedAt = (/* @__PURE__ */ new Date()).toISOString();
       if (isRootSpan && !activeTraceStates.has(traceId)) {
         const replayCtxAtRoot = getReplayContext();
-        const dbSnapshotRef = self.dbSnapshot ? buildSnapshotRef(self.dbSnapshot, startedAt) : void 0;
+        const dbSnapshotRef = buildSnapshotRef(self.dbSnapshot, startedAt);
         activeTraceStates.set(traceId, {
           traceId,
           startedAt,
@@ -2930,7 +2949,7 @@ var Bitfab = class {
           ...replayCtxAtRoot?.inputSourceTraceId && {
             inputSourceTraceId: replayCtxAtRoot.inputSourceTraceId
           },
-          ...dbSnapshotRef && { dbSnapshotRef }
+          dbSnapshotRef
         });
         pendingSpanPromises.set(traceId, []);
       }
@@ -3316,6 +3335,7 @@ assertAsyncStorageRegistered();
   BitfabClaudeAgentHandler,
   BitfabError,
   BitfabFunction,
+  BitfabLangChainCallbackHandler,
   BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL,