@bitfab/sdk 0.51.0 → 0.52.1

package/dist/index.d.cts

@@ -536,7 +536,7 @@ declare class HttpClient {
      * {@link HttpClient.sendExternalSpan}; replay confirms persistence with the
      * server-authoritative barrier in `replay.ts`, not by awaiting this call.
      */
-    sendExternalTrace(payload: Record<string, unknown>): void;
+    sendExternalTrace(rawPayload: Record<string, unknown>): void;
     /**
      * Partial update of an existing trace identified by its Bitfab trace ID.
      * Used by the detached `client.getTrace(id)` handle.
@@ -802,11 +802,19 @@ type TraceAssertionsResult = {
     assertions: TraceAssertion[];
     inheritedFrom: string | null;
 };
+type TraceAssertionsUpdate = {
+    traceId: string;
+    assertions: SaveAssertion[];
+};
 type SaveAssertionsParams = {
     traceId: string;
     assertions: SaveAssertion[];
     source?: TraceAssertionSource;
 };
+type SaveAssertionsAllParams = {
+    updates: TraceAssertionsUpdate[];
+    source?: TraceAssertionSource;
+};
 type ArchiveAssertionsParams = {
     traceId: string;
     assertionIds: string[];
@@ -816,6 +824,7 @@ declare class TracesClient {
     constructor(httpClient: HttpClient);
     getAssertions(traceId: string): Promise<TraceAssertionsResult>;
     saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
+    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
     archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
 }
 
@@ -3279,7 +3288,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.51.0";
+declare const __version__ = "0.52.1";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3409,4 +3418,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, 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 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, SUPPORTED_PROVIDERS, type SaveAssertion, 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 TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, 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, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, 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 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, SUPPORTED_PROVIDERS, type SaveAssertion, 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 TraceTarget, type TraceTargetOccurrence, TracesClient, 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

@@ -536,7 +536,7 @@ declare class HttpClient {
      * {@link HttpClient.sendExternalSpan}; replay confirms persistence with the
      * server-authoritative barrier in `replay.ts`, not by awaiting this call.
      */
-    sendExternalTrace(payload: Record<string, unknown>): void;
+    sendExternalTrace(rawPayload: Record<string, unknown>): void;
     /**
      * Partial update of an existing trace identified by its Bitfab trace ID.
      * Used by the detached `client.getTrace(id)` handle.
@@ -802,11 +802,19 @@ type TraceAssertionsResult = {
     assertions: TraceAssertion[];
     inheritedFrom: string | null;
 };
+type TraceAssertionsUpdate = {
+    traceId: string;
+    assertions: SaveAssertion[];
+};
 type SaveAssertionsParams = {
     traceId: string;
     assertions: SaveAssertion[];
     source?: TraceAssertionSource;
 };
+type SaveAssertionsAllParams = {
+    updates: TraceAssertionsUpdate[];
+    source?: TraceAssertionSource;
+};
 type ArchiveAssertionsParams = {
     traceId: string;
     assertionIds: string[];
@@ -816,6 +824,7 @@ declare class TracesClient {
     constructor(httpClient: HttpClient);
     getAssertions(traceId: string): Promise<TraceAssertionsResult>;
     saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
+    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
     archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
 }
 
@@ -3279,7 +3288,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.51.0";
+declare const __version__ = "0.52.1";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3409,4 +3418,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, 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 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, SUPPORTED_PROVIDERS, type SaveAssertion, 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 TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, 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, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ArchiveAssertionsParams, 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 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, SUPPORTED_PROVIDERS, type SaveAssertion, 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 TraceTarget, type TraceTargetOccurrence, TracesClient, 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

@@ -18,7 +18,7 @@ import {
   getCurrentSpan,
   getCurrentTrace,
   seedFromRegistry
-} from "./chunk-VXD27AJ3.js";
+} from "./chunk-XAT6WLCS.js";
 import "./chunk-ZUD7OFYB.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -27,7 +27,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-DNYZJLNY.js";
+} from "./chunk-A5UGSRMK.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -35,7 +35,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-RGC7IEOI.js";
+} from "./chunk-6DIR65JW.js";
 import "./chunk-H6LZRFMN.js";
 export {
   BITFAB_PROGRESS_PREFIX,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.51.0";
+    __version__ = "0.52.1";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -541,6 +541,69 @@ var init_serializePayload = __esm({
   }
 });
 
+// src/traceMetadata.ts
+function recordCallerTraceMetadata(traceId, metadata) {
+  if (typeof traceId !== "string" || traceId === "") {
+    return;
+  }
+  if (typeof metadata !== "object" || metadata === null) {
+    return;
+  }
+  if (Object.keys(metadata).length === 0) {
+    return;
+  }
+  callerMetadata.set(traceId, { ...callerMetadata.get(traceId), ...metadata });
+}
+function callerTraceMetadata(traceId) {
+  const recorded = callerMetadata.get(traceId);
+  return recorded ? { ...recorded } : void 0;
+}
+function forgetTraceMetadata(traceId) {
+  callerMetadata.delete(traceId);
+  derivedMetadata.delete(traceId);
+}
+function mergeCallerMetadataIntoTracePayload(payload) {
+  const externalTrace = payload.externalTrace;
+  if (typeof externalTrace !== "object" || externalTrace === null) {
+    return payload;
+  }
+  const external = externalTrace;
+  const traceId = typeof payload.id === "string" && payload.id !== "" ? payload.id : external.id;
+  if (typeof traceId !== "string" || traceId === "") {
+    return payload;
+  }
+  const caller = callerMetadata.get(traceId);
+  if (!caller) {
+    return payload;
+  }
+  const derived = derivedMetadata.get(traceId) ?? {};
+  const exported = external.metadata;
+  if (typeof exported === "object" && exported !== null) {
+    Object.assign(derived, exported);
+  }
+  derivedMetadata.set(traceId, derived);
+  const shadowed = Object.keys(derived).filter((key) => key in caller && caller[key] !== derived[key]).sort();
+  if (shadowed.length > 0) {
+    warnOnce(
+      `trace-metadata-shadowed:${shadowed.join(",")}`,
+      `trace metadata key(s) ${shadowed.join(", ")} were set both by the caller and by an integration's own trace export; the caller's value is the one kept on the trace.`
+    );
+  }
+  return {
+    ...payload,
+    externalTrace: { ...external, metadata: { ...derived, ...caller } }
+  };
+}
+var callerMetadata, derivedMetadata;
+var init_traceMetadata = __esm({
+  "src/traceMetadata.ts"() {
+    "use strict";
+    init_warnOnce();
+    callerMetadata = /* @__PURE__ */ new Map();
+    derivedMetadata = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/transportTypes.ts
 var DeliveryError;
 var init_transportTypes = __esm({
@@ -1359,6 +1422,7 @@ var init_http = __esm({
     init_errors();
     init_replayContext();
     init_serializePayload();
+    init_traceMetadata();
     init_transport();
     init_transportTypes();
     init_unrefTimer();
@@ -1822,7 +1886,8 @@ var init_http = __esm({
        * {@link HttpClient.sendExternalSpan}; replay confirms persistence with the
        * server-authoritative barrier in `replay.ts`, not by awaiting this call.
        */
-      sendExternalTrace(payload) {
+      sendExternalTrace(rawPayload) {
+        const payload = mergeCallerMetadataIntoTracePayload(rawPayload);
         this.getTraceTransport()?.submit(
           "external_trace",
           {
@@ -3330,7 +3395,8 @@ registerAsyncLocalStorageClass(
 );
 
 // src/assertions.ts
-function expectationsPath(traceId, suffix = "") {
+var ASSERTIONS_PATH = "/api/sdk/traces/assertions";
+function traceAssertionsPath(traceId, suffix = "") {
   return `/api/sdk/traces/${encodeURIComponent(traceId)}/assertions${suffix}`;
 }
 var TracesClient = class {
@@ -3338,18 +3404,29 @@ var TracesClient = class {
     this.httpClient = httpClient;
   }
   async getAssertions(traceId) {
-    return this.httpClient.get(expectationsPath(traceId));
+    return this.httpClient.get(
+      traceAssertionsPath(traceId)
+    );
   }
   async saveAssertions(params) {
-    const response = await this.httpClient.request(expectationsPath(params.traceId), {
-      assertions: params.assertions,
+    return this.saveAssertionsAll({
+      updates: [{ traceId: params.traceId, assertions: params.assertions }],
+      source: params.source
+    });
+  }
+  async saveAssertionsAll(params) {
+    if (params.updates.length === 0) {
+      return [];
+    }
+    const response = await this.httpClient.request(ASSERTIONS_PATH, {
+      updates: params.updates,
       source: params.source ?? "agent"
     });
     return response.assertions;
   }
   async archiveAssertions(params) {
     const response = await this.httpClient.request(
-      expectationsPath(params.traceId, "/archive"),
+      traceAssertionsPath(params.traceId, "/archive"),
       { assertionIds: params.assertionIds }
     );
     return response.archived;
@@ -5702,6 +5779,7 @@ function runWithSeedContext(ctx, fn) {
 
 // src/client.ts
 init_serialize();
+init_traceMetadata();
 
 // src/tracing.ts
 init_constants();
@@ -6382,8 +6460,7 @@ function getCurrentTrace() {
         if (typeof metadata !== "object" || metadata === null) {
           return;
         }
-        const traceState = getOrCreateTraceState();
-        traceState.metadata = { ...traceState.metadata, ...metadata };
+        recordCallerTraceMetadata(traceId, metadata);
       } catch {
       }
     },
@@ -7376,7 +7453,7 @@ var Bitfab = class {
                 endedAt,
                 sessionId: traceState?.sessionId,
                 name: traceState?.name,
-                metadata: traceState?.metadata,
+                metadata: callerTraceMetadata(traceId),
                 contexts: traceState?.contexts ?? [],
                 testRunId: traceState?.testRunId,
                 inputSourceTraceId: traceState?.inputSourceTraceId,
@@ -7400,6 +7477,7 @@ var Bitfab = class {
                 }
               });
               activeTraceStates.delete(traceId);
+              forgetTraceMetadata(traceId);
             }
           } catch {
           }
@@ -7592,6 +7670,7 @@ var Bitfab = class {
       } catch (setupError) {
         if (registeredTraceId) {
           activeTraceStates.delete(registeredTraceId);
+          forgetTraceMetadata(registeredTraceId);
         }
         if (setupError instanceof MixedTracingError) {
           throw setupError;
@@ -7952,14 +8031,16 @@ var Bitfab = class {
     }
     const traceId = randomUuid();
     const startedAt = nowIsoTimestamp();
+    if (options.metadata !== void 0) {
+      recordCallerTraceMetadata(traceId, options.metadata);
+    }
     activeTraceStates.set(traceId, {
       traceId,
       startedAt,
       contexts: [],
       ingestionType: "seeded",
       ...options.sessionId !== void 0 && { sessionId: options.sessionId },
-      ...options.name !== void 0 && { name: options.name },
-      ...options.metadata !== void 0 && { metadata: options.metadata }
+      ...options.name !== void 0 && { name: options.name }
     });
     try {
       this.sendWrapperSpan({
@@ -7982,12 +8063,13 @@ var Bitfab = class {
         endedAt: startedAt,
         sessionId: options.sessionId,
         name: options.name,
-        metadata: options.metadata,
+        metadata: callerTraceMetadata(traceId),
         contexts: [],
         ingestionType: "seeded"
       });
     } finally {
       activeTraceStates.delete(traceId);
+      forgetTraceMetadata(traceId);
     }
     return traceId;
   }
@@ -8012,14 +8094,16 @@ var Bitfab = class {
     }
     await seedContextReady;
     const traceId = randomUuid();
+    if (options?.metadata !== void 0) {
+      recordCallerTraceMetadata(traceId, options.metadata);
+    }
     activeTraceStates.set(traceId, {
       traceId,
       startedAt: nowIsoTimestamp(),
       contexts: [],
       ingestionType: "seeded",
       ...options?.sessionId !== void 0 && { sessionId: options.sessionId },
-      ...options?.name !== void 0 && { name: options.name },
-      ...options?.metadata !== void 0 && { metadata: options.metadata }
+      ...options?.name !== void 0 && { name: options.name }
     });
     const args = options?.args ?? [];
     let unrecorded = true;
@@ -8031,6 +8115,7 @@ var Bitfab = class {
         await flushTraces2(3e4);
       } finally {
         unrecorded = activeTraceStates.delete(traceId);
+        forgetTraceMetadata(traceId);
       }
     }
     if (unrecorded) {