@bitfab/sdk 0.54.5 → 0.54.7

package/dist/index.d.cts

@@ -426,6 +426,8 @@ declare class HttpClient {
      * the function form if one was supplied. Never read at construction.
      */
     private resolveApiKey;
+    /** @internal Whether this client currently has credentials for trace delivery. */
+    hasApiKey(): boolean;
     /**
      * This client's span transport, built on first use.
      *
@@ -917,6 +919,7 @@ declare class BitfabClaudeAgentHandler {
     private readonly ownsHttpClient;
     private readonly traceFunctionKey;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private runToSpan;
     private traceId;
     private rootSpanId;
@@ -941,6 +944,7 @@ declare class BitfabClaudeAgentHandler {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext$2 | null;
+        shouldRecord?: () => boolean;
         /**
          * The owning `Bitfab` client's HTTP client. Supplied by
          * `getClaudeAgentHandler()` so this handler shares that client's single
@@ -1412,6 +1416,7 @@ declare class BitfabLangGraphCallbackHandler {
     private readonly ownsHttpClient;
     private readonly traceFunctionKey;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private readonly captureTools;
     private runToSpan;
     private invocations;
@@ -1421,6 +1426,7 @@ declare class BitfabLangGraphCallbackHandler {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext$1 | null;
+        shouldRecord?: () => boolean;
         /** Whether callback tool events should emit spans. Defaults to true. */
         captureTools?: boolean;
         /**
@@ -2178,14 +2184,20 @@ type TraceTarget = {
     occurrence?: TraceTargetOccurrence;
 };
 type TraceAssertionSource = "human" | "agent";
-type TraceSearchParams = {
-    /** Exact, case-insensitive key/value matches. Multiple entries are ANDed. */
+type TraceSearchFilters = {
+    callerMetadata?: Record<string, string>;
+    name?: string;
+    nameContains?: string;
+};
+type TraceSearchParams = TraceSearchFilters & ({
     callerMetadata: Record<string, string>;
-    /** Optionally restrict results to one traced function. */
+} | {
+    name: string;
+} | {
+    nameContains: string;
+}) & {
     traceFunctionKey?: string;
-    /** Opaque cursor returned by the previous page. */
     cursor?: string | null;
-    /** Page size (default 50, maximum 500). */
     limit?: number;
 };
 type TraceSearchResult = {
@@ -2247,12 +2259,6 @@ type ArchiveAssertionsParams = {
 declare class TracesClient {
     private readonly httpClient;
     constructor(httpClient: HttpClient);
-    /**
-     * Search traces by exact caller metadata.
-     *
-     * Keys and values are matched case-insensitively. Up to 10 supplied pairs
-     * must match. Use `nextCursor` from the result to fetch another page.
-     */
     search(params: TraceSearchParams): Promise<TraceSearchResult>;
     getAssertions(traceId: string): Promise<TraceAssertionsResult>;
     saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
@@ -2322,6 +2328,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
     private readonly ownsHttpClient;
     private activeTraces;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private activeSpanMappings;
     private canonicalTraceIds;
     private getCanonicalTraceId;
@@ -2335,6 +2342,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext | null;
+        shouldRecord?: () => boolean;
         /**
          * The owning `Bitfab` client's HTTP client. Supplied by
          * `getOpenAiTracingProcessor()` so this processor shares that client's
@@ -2878,6 +2886,7 @@ declare class Bitfab {
     private resolveApiKey;
     private isCaptureEnabled;
     private shouldRecord;
+    private prepareFrameworkIntegration;
     get captureEnabled(): boolean;
     /**
      * Fetch the function with its current version and BAML prompt from the server.
@@ -3420,7 +3429,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.54.5";
+declare const __version__ = "0.54.7";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3559,4 +3568,4 @@ declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, ca
     run?: boolean;
 }): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionVerdict, 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 CommitRef, 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 GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, 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, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, 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 TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionVerdict, 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 CommitRef, 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 GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, 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, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, 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 TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };

package/dist/index.d.ts

@@ -426,6 +426,8 @@ declare class HttpClient {
      * the function form if one was supplied. Never read at construction.
      */
     private resolveApiKey;
+    /** @internal Whether this client currently has credentials for trace delivery. */
+    hasApiKey(): boolean;
     /**
      * This client's span transport, built on first use.
      *
@@ -917,6 +919,7 @@ declare class BitfabClaudeAgentHandler {
     private readonly ownsHttpClient;
     private readonly traceFunctionKey;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private runToSpan;
     private traceId;
     private rootSpanId;
@@ -941,6 +944,7 @@ declare class BitfabClaudeAgentHandler {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext$2 | null;
+        shouldRecord?: () => boolean;
         /**
          * The owning `Bitfab` client's HTTP client. Supplied by
          * `getClaudeAgentHandler()` so this handler shares that client's single
@@ -1412,6 +1416,7 @@ declare class BitfabLangGraphCallbackHandler {
     private readonly ownsHttpClient;
     private readonly traceFunctionKey;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private readonly captureTools;
     private runToSpan;
     private invocations;
@@ -1421,6 +1426,7 @@ declare class BitfabLangGraphCallbackHandler {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext$1 | null;
+        shouldRecord?: () => boolean;
         /** Whether callback tool events should emit spans. Defaults to true. */
         captureTools?: boolean;
         /**
@@ -2178,14 +2184,20 @@ type TraceTarget = {
     occurrence?: TraceTargetOccurrence;
 };
 type TraceAssertionSource = "human" | "agent";
-type TraceSearchParams = {
-    /** Exact, case-insensitive key/value matches. Multiple entries are ANDed. */
+type TraceSearchFilters = {
+    callerMetadata?: Record<string, string>;
+    name?: string;
+    nameContains?: string;
+};
+type TraceSearchParams = TraceSearchFilters & ({
     callerMetadata: Record<string, string>;
-    /** Optionally restrict results to one traced function. */
+} | {
+    name: string;
+} | {
+    nameContains: string;
+}) & {
     traceFunctionKey?: string;
-    /** Opaque cursor returned by the previous page. */
     cursor?: string | null;
-    /** Page size (default 50, maximum 500). */
     limit?: number;
 };
 type TraceSearchResult = {
@@ -2247,12 +2259,6 @@ type ArchiveAssertionsParams = {
 declare class TracesClient {
     private readonly httpClient;
     constructor(httpClient: HttpClient);
-    /**
-     * Search traces by exact caller metadata.
-     *
-     * Keys and values are matched case-insensitively. Up to 10 supplied pairs
-     * must match. Use `nextCursor` from the result to fetch another page.
-     */
     search(params: TraceSearchParams): Promise<TraceSearchResult>;
     getAssertions(traceId: string): Promise<TraceAssertionsResult>;
     saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
@@ -2322,6 +2328,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
     private readonly ownsHttpClient;
     private activeTraces;
     private readonly getActiveSpanContext;
+    private readonly shouldRecord;
     private activeSpanMappings;
     private canonicalTraceIds;
     private getCanonicalTraceId;
@@ -2335,6 +2342,7 @@ declare class BitfabOpenAITracingProcessor implements TracingProcessor {
         serviceUrl?: string;
         timeout?: number;
         getActiveSpanContext?: () => ActiveSpanContext | null;
+        shouldRecord?: () => boolean;
         /**
          * The owning `Bitfab` client's HTTP client. Supplied by
          * `getOpenAiTracingProcessor()` so this processor shares that client's
@@ -2878,6 +2886,7 @@ declare class Bitfab {
     private resolveApiKey;
     private isCaptureEnabled;
     private shouldRecord;
+    private prepareFrameworkIntegration;
     get captureEnabled(): boolean;
     /**
      * Fetch the function with its current version and BAML prompt from the server.
@@ -3420,7 +3429,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.54.5";
+declare const __version__ = "0.54.7";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3559,4 +3568,4 @@ declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, ca
     run?: boolean;
 }): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionVerdict, 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 CommitRef, 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 GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, 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, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, 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 TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionVerdict, 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 CommitRef, 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 GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, 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, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, 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 TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };

package/dist/index.js

@@ -20,7 +20,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-7DSNNK5I.js";
+} from "./chunk-X6AIRJJX.js";
 import "./chunk-EGWJYCNT.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -29,7 +29,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-YH6YO2WS.js";
+} from "./chunk-27WMHYUI.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -37,7 +37,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-PIF5HH3Z.js";
+} from "./chunk-JF56DBPP.js";
 import "./chunk-VCRFFCLY.js";
 export {
   AssertionCategoriesClient,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.54.5";
+    __version__ = "0.54.7";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2320,6 +2320,15 @@ var init_http = __esm({
       resolveApiKey() {
         return typeof this.apiKey === "function" ? this.apiKey() : this.apiKey;
       }
+      /** @internal Whether this client currently has credentials for trace delivery. */
+      hasApiKey() {
+        try {
+          const apiKey = this.resolveApiKey();
+          return apiKey !== void 0 && apiKey.trim() !== "";
+        } catch {
+          return false;
+        }
+      }
       /**
        * This client's span transport, built on first use.
        *
@@ -4504,6 +4513,7 @@ var BitfabClaudeAgentHandler = class {
     });
     this.traceFunctionKey = config.traceFunctionKey;
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
     this.preToolUseHook = this.preToolUseHook.bind(this);
     this.postToolUseHook = this.postToolUseHook.bind(this);
     this.postToolUseFailureHook = this.postToolUseFailureHook.bind(this);
@@ -4608,6 +4618,9 @@ var BitfabClaudeAgentHandler = class {
     this.httpClient.traceCompletion.end(spanInfo.traceId, spanInfo.spanId);
   }
   sendSpan(spanInfo) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const spanData = {
       name: spanInfo.name,
       type: spanInfo.type
@@ -4651,6 +4664,9 @@ var BitfabClaudeAgentHandler = class {
     }
   }
   sendTraceCompletion(endedAt, metadata) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     if (this.traceId === null) {
       return;
     }
@@ -6192,6 +6208,7 @@ var BitfabLangGraphCallbackHandler = class {
     });
     this.traceFunctionKey = config.traceFunctionKey;
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
     this.captureTools = config.captureTools ?? true;
   }
   /**
@@ -6300,6 +6317,9 @@ var BitfabLangGraphCallbackHandler = class {
     this.httpClient.traceCompletion.end(spanInfo.traceId, spanInfo.spanId);
   }
   sendSpan(spanInfo) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const spanData = {
       name: spanInfo.name,
       type: spanInfo.type
@@ -6343,6 +6363,9 @@ var BitfabLangGraphCallbackHandler = class {
     }
   }
   sendTraceCompletion(rootSpan, activeContext) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const completed = activeContext === null;
     const traceData = {
       id: rootSpan.traceId,
@@ -6363,6 +6386,9 @@ var BitfabLangGraphCallbackHandler = class {
     }
   }
   sendTraceStart(rootSpan) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const traceData = {
       id: rootSpan.traceId,
       type: "sdk-function",
@@ -7014,12 +7040,6 @@ var TracesClient = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /**
-   * Search traces by exact caller metadata.
-   *
-   * Keys and values are matched case-insensitively. Up to 10 supplied pairs
-   * must match. Use `nextCursor` from the result to fetch another page.
-   */
   async search(params) {
     return this.httpClient.request(SEARCH_PATH, params);
   }
@@ -7077,6 +7097,7 @@ var BitfabOpenAITracingProcessor = class {
       timeout: config.timeout ?? 1e4
     });
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
   }
   getCanonicalTraceId(sourceTraceId) {
     const existing = this.canonicalTraceIds[sourceTraceId];
@@ -7197,6 +7218,9 @@ var BitfabOpenAITracingProcessor = class {
    * the OpenAI trace into an outer withSpan trace.
    */
   sendTrace(trace, options = {}) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     try {
       const traceData = trace.toJSON();
       if (options.sourceTraceId) {
@@ -7311,6 +7335,9 @@ var BitfabOpenAITracingProcessor = class {
    * and parent_id are rewritten to link the span into the withSpan tree.
    */
   sendSpan(span) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const errors = [];
     const [serializedSpan, exportErrors] = this.exportSpan(span);
     errors.push(...exportErrors);
@@ -8408,6 +8435,11 @@ var Bitfab = class {
     }
     return this.resolveApiKey() !== void 0;
   }
+  prepareFrameworkIntegration() {
+    if (this.captureConfigured && this.strict) {
+      this.resolveApiKey();
+    }
+  }
   get captureEnabled() {
     return this.isCaptureEnabled();
   }
@@ -8465,14 +8497,16 @@ var Bitfab = class {
           resultStr = String(executionResult.result);
         }
       }
-      this.httpClient.sendInternalTrace(functionVersion.id, {
-        result: resultStr,
-        source: "typescript-sdk",
-        ...Object.keys(inputs).length > 0 && { inputs },
-        ...executionResult.rawCollector != null && {
-          rawCollector: executionResult.rawCollector
-        }
-      });
+      if (this.shouldRecord()) {
+        this.httpClient.sendInternalTrace(functionVersion.id, {
+          result: resultStr,
+          source: "typescript-sdk",
+          ...Object.keys(inputs).length > 0 && { inputs },
+          ...executionResult.rawCollector != null && {
+            rawCollector: executionResult.rawCollector
+          }
+        });
+      }
       return executionResult.result;
     } catch (error) {
       if (error instanceof BitfabError) {
@@ -8502,11 +8536,10 @@ var Bitfab = class {
    * @returns A BitfabOpenAITracingProcessor instance configured for this client
    */
   getOpenAiTracingProcessor() {
+    this.prepareFrameworkIntegration();
     return new BitfabOpenAITracingProcessor({
-      // Resolved at getter-call time (framework handlers are set up after env
-      // loads); the withSpan path stays lazy via the constructor HttpClient thunk.
-      apiKey: this.resolveApiKey(),
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8564,10 +8597,11 @@ var Bitfab = class {
    * @returns A BitfabLangGraphCallbackHandler configured for this client
    */
   getLangGraphCallbackHandler(traceFunctionKey) {
+    this.prepareFrameworkIntegration();
     return new BitfabLangGraphCallbackHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8606,10 +8640,11 @@ var Bitfab = class {
    * @experimental This API may change before it is stable.
    */
   getLangGraphIntegration(traceFunctionKey, options) {
+    this.prepareFrameworkIntegration();
     const callbackHandler = new BitfabLangGraphCallbackHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8648,10 +8683,11 @@ var Bitfab = class {
    * @returns A BitfabClaudeAgentHandler configured for this client
    */
   getClaudeAgentHandler(traceFunctionKey) {
+    this.prepareFrameworkIntegration();
     return new BitfabClaudeAgentHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;