braintrust 0.4.7 → 0.4.8

package/dist/cli.js

@@ -10233,7 +10233,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "braintrust",
-      version: "0.4.7",
+      version: "0.4.8",
       description: "SDK for integrating Braintrust",
       repository: {
         type: "git",
@@ -10289,12 +10289,17 @@ var require_package = __commonJS({
         watch: "tsup --watch",
         clean: "rm -r dist/* && rm -r dev/dist/*",
         docs: "npx typedoc --options typedoc.json src/index.ts",
-        test: "vitest run --exclude src/wrappers/anthropic.test.ts --exclude src/wrappers/oai.test.ts --exclude src/otel.test.ts --exclude src/otel-no-deps.test.ts  --exclude src/wrappers/google-genai.test.ts",
+        test: 'vitest run --exclude "src/wrappers/**/*.test.ts" --exclude "src/otel/**/*.test.ts"',
         "test:anthropic": "vitest run src/wrappers/anthropic.test.ts",
         "test:openai": "vitest run src/wrappers/oai.test.ts",
-        "test:otel": "vitest run src/otel.test.ts",
+        "test:otel": "vitest run --dir src/otel",
+        "test:otel-no-deps": "vitest run src/otel-no-deps.test.ts --reporter=verbose",
         "test:google-genai": "vitest run src/wrappers/google-genai.test.ts",
-        "test:otel-no-deps": "vitest run src/otel-no-deps.test.ts --reporter=verbose"
+        "test:ai-sdk-v1": "vitest run src/wrappers/ai-sdk-v1.test.ts",
+        "test:ai-sdk-v2": "vitest run src/wrappers/ai-sdk-v2.test.ts src/wrappers/ai-sdk-v1.test.ts",
+        "test:ai-sdk-v3": "vitest run src/wrappers/ai-sdk-v3.test.ts",
+        "test:mastra": "vitest run src/wrappers/mastra.test.ts",
+        "test:claude-agent-sdk": "vitest run src/wrappers/claude-agent-sdk.test.ts"
       },
       author: "",
       license: "MIT",

package/dist/index.d.mts

@@ -21694,6 +21694,43 @@ declare class BraintrustSpanProcessor {
     shutdown(): Promise<void>;
     forceFlush(): Promise<void>;
 }
+/**
+ * Create an OTEL context from a Braintrust span export string.
+ *
+ * Used for distributed tracing scenarios where a Braintrust span in one service
+ * needs to be the parent of an OTEL span in another service.
+ *
+ * @param exportStr - The string returned from span.export()
+ * @returns OTEL context that can be used when creating child spans
+ *
+ * @example
+ * ```typescript
+ * // Service A: Create BT span and export
+ * const span = logger.startSpan({ name: "service-a" });
+ * const exportStr = await span.export();
+ * // Send exportStr to Service B (e.g., via HTTP header)
+ *
+ * // Service B: Import context and create OTEL child
+ * import * as api from '@opentelemetry/api';
+ * const ctx = otelContextFromSpanExport(exportStr);
+ * await api.context.with(ctx, async () => {
+ *   await tracer.startActiveSpan("service-b", async (span) => {
+ *     // This span is now a child of the Service A span
+ *     span.end();
+ *   });
+ * });
+ * ```
+ */
+declare function otelContextFromSpanExport(exportStr: string): unknown;
+/**
+ * Construct a braintrust.parent identifier string from span components.
+ *
+ * @param objectType - Type of parent object (PROJECT_LOGS or EXPERIMENT)
+ * @param objectId - Resolved object ID (project_id or experiment_id)
+ * @param computeArgs - Optional dict with project_name/project_id for unresolved cases
+ * @returns String like "project_id:abc", "project_name:my-proj", "experiment_id:exp-123", or undefined
+ */
+declare function getBraintrustParent(objectType: number, objectId?: string | null, computeArgs?: Record<string, unknown> | null): string | undefined;
 /**
  * A trace exporter that sends OpenTelemetry spans to Braintrust.
  *
@@ -21760,6 +21797,111 @@ declare class BraintrustExporter {
      */
     forceFlush(): Promise<void>;
 }
+/**
+ * Add braintrust.parent to OTEL baggage.
+ *
+ * This ensures that when using propagation inject() for distributed tracing,
+ * the braintrust.parent will be propagated via baggage to downstream services.
+ *
+ * @param parent - Braintrust parent identifier (e.g., "project_name:my-project",
+ *                 "project_id:abc123", "experiment_id:exp-456")
+ * @param ctx - Optional OTEL context to use. If not provided, uses current context.
+ * @returns Updated context with braintrust.parent in baggage
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ * import { propagation } from "@opentelemetry/api";
+ *
+ * // Set braintrust.parent in baggage
+ * otel.addParentToBaggage("project_name:my-project");
+ *
+ * // Export headers (will include braintrust.parent in baggage)
+ * const headers = {};
+ * propagation.inject(context.active(), headers);
+ * ```
+ */
+declare function addParentToBaggage(parent: string, ctx?: Context): Context;
+/**
+ * Copy braintrust.parent from span attribute to OTEL baggage.
+ *
+ * BraintrustSpanProcessor automatically sets braintrust.parent as a span attribute
+ * when OTEL spans are created within Braintrust contexts. This function copies that
+ * attribute to OTEL baggage so it propagates when using inject() for distributed tracing.
+ *
+ * @param span - OTEL span that has braintrust.parent attribute set
+ * @param ctx - Optional OTEL context to use. If not provided, uses current context.
+ * @returns Updated context with braintrust.parent in baggage, or undefined if attribute not found
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ * import { propagation } from "@opentelemetry/api";
+ *
+ * tracer.startActiveSpan("service_b", (span) => {
+ *   // Copy braintrust.parent from span attribute to baggage
+ *   otel.addSpanParentToBaggage(span);
+ *
+ *   // Export headers (will include braintrust.parent in baggage)
+ *   const headers = {};
+ *   propagation.inject(context.active(), headers);
+ *   span.end();
+ * });
+ * ```
+ */
+declare function addSpanParentToBaggage(span: Span, ctx?: Context): Context | undefined;
+/**
+ * Extract a Braintrust-compatible parent string from W3C Trace Context headers.
+ *
+ * This converts OTEL trace context headers (traceparent/baggage) into a format
+ * that can be passed as the 'parent' parameter to Braintrust's traced() method.
+ *
+ * @param headers - Dictionary with 'traceparent' and optionally 'baggage' keys
+ * @returns Braintrust V4 export string that can be used as parent parameter,
+ *          or undefined if no valid span context is found or braintrust.parent is missing.
+ *
+ * @example
+ * ```typescript
+ * import { otel, initLogger } from "braintrust";
+ *
+ * // Service C receives headers from Service B
+ * const headers = { traceparent: '00-trace_id-span_id-01', baggage: '...' };
+ * const parent = otel.parentFromHeaders(headers);
+ *
+ * const logger = initLogger({ projectName: "my-project" });
+ * await logger.traced(async (span) => {
+ *   span.log({ input: "BT span as child of OTEL parent" });
+ * }, { name: "service_c", parent });
+ * ```
+ */
+declare function parentFromHeaders(headers: Record<string, string>): string | undefined;
+/**
+ * OTEL namespace containing distributed tracing helper functions.
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ *
+ * // Export Braintrust span context for OTEL
+ * const ctx = otel.contextFromSpanExport(exportStr);
+ *
+ * // Add parent to baggage before propagating
+ * otel.addParentToBaggage("project_name:my-project");
+ *
+ * // Copy span attribute to baggage
+ * otel.addSpanParentToBaggage(span);
+ *
+ * // Create Braintrust parent from OTEL headers
+ * const parent = otel.parentFromHeaders(headers);
+ * ```
+ */
+declare const otel: {
+    contextFromSpanExport: typeof otelContextFromSpanExport;
+    getBraintrustParent: typeof getBraintrustParent;
+    addParentToBaggage: typeof addParentToBaggage;
+    addSpanParentToBaggage: typeof addSpanParentToBaggage;
+    parentFromHeaders: typeof parentFromHeaders;
+};
 
 type braintrust_AISpanProcessor = AISpanProcessor;
 declare const braintrust_AISpanProcessor: typeof AISpanProcessor;
@@ -21918,6 +22060,7 @@ declare const braintrust_logError: typeof logError;
 declare const braintrust_login: typeof login;
 declare const braintrust_loginToState: typeof loginToState;
 declare const braintrust_newId: typeof newId;
+declare const braintrust_otel: typeof otel;
 declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
 declare const braintrust_permalink: typeof permalink;
 declare const braintrust_projects: typeof projects;
@@ -21952,7 +22095,7 @@ declare const braintrust_wrapOpenAI: typeof wrapOpenAI;
 declare const braintrust_wrapOpenAIv4: typeof wrapOpenAIv4;
 declare const braintrust_wrapTraced: typeof wrapTraced;
 declare namespace braintrust {
-  export { braintrust_AISpanProcessor as AISpanProcessor, type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, braintrust_BaseAttachment as BaseAttachment, braintrust_BaseExperiment as BaseExperiment, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustExporter as BraintrustExporter, braintrust_BraintrustMiddleware as BraintrustMiddleware, braintrust_BraintrustSpanProcessor as BraintrustSpanProcessor, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, braintrust_CodeFunction as CodeFunction, type braintrust_CodeOpts as CodeOpts, braintrust_CodePrompt as CodePrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, braintrust_ContextManager as ContextManager, type braintrust_ContextParentSpanIds as ContextParentSpanIds, type braintrust_CreateProjectOpts as CreateProjectOpts, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, braintrust_ERR_PERMALINK as ERR_PERMALINK, type braintrust_EndSpanArgs as EndSpanArgs, braintrust_Eval as Eval, type braintrust_EvalCase as EvalCase, type braintrust_EvalHooks as EvalHooks, type braintrust_EvalResult as EvalResult, braintrust_EvalResultWithSummary as EvalResultWithSummary, type braintrust_EvalScorer as EvalScorer, type braintrust_EvalScorerArgs as EvalScorerArgs, type braintrust_EvalTask as EvalTask, type braintrust_Evaluator as Evaluator, type braintrust_EvaluatorDef as EvaluatorDef, type braintrust_EvaluatorFile as EvaluatorFile, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_ExternalAttachment as ExternalAttachment, type braintrust_ExternalAttachmentParams as ExternalAttachmentParams, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_FunctionEvent as FunctionEvent, braintrust_IDGenerator as IDGenerator, braintrust_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_JSONAttachment as JSONAttachment, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, braintrust_LazyValue as LazyValue, type braintrust_LogOptions as LogOptions, braintrust_Logger as Logger, type braintrust_LoginOptions as LoginOptions, type braintrust_MetricSummary as MetricSummary, braintrust_NOOP_SPAN as NOOP_SPAN, braintrust_NOOP_SPAN_PERMALINK as NOOP_SPAN_PERMALINK, braintrust_NoopSpan as NoopSpan, braintrust_OTELIDGenerator as OTELIDGenerator, type braintrust_ObjectMetadata as ObjectMetadata, braintrust_Project as Project, braintrust_ProjectNameIdMap as ProjectNameIdMap, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, braintrust_PromptBuilder as PromptBuilder, type braintrust_PromptContents as PromptContents, type braintrust_PromptDefinition as PromptDefinition, type braintrust_PromptDefinitionWithTools as PromptDefinitionWithTools, type braintrust_PromptOpts as PromptOpts, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyAttachment as ReadonlyAttachment, braintrust_ReadonlyExperiment as ReadonlyExperiment, braintrust_Reporter as Reporter, type braintrust_ReporterBody as ReporterBody, type braintrust_ScoreSummary as ScoreSummary, braintrust_ScorerBuilder as ScorerBuilder, type braintrust_ScorerOpts as ScorerOpts, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type Span$1 as Span, type braintrust_SpanContext as SpanContext, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, braintrust_TestBackgroundLogger as TestBackgroundLogger, braintrust_ToolBuilder as ToolBuilder, braintrust_UUIDGenerator as UUIDGenerator, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__exportsForTestingOnly as _exportsForTestingOnly, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_buildLocalSummary as buildLocalSummary, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_deepCopyEvent as deepCopyEvent, braintrust_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getContextManager as getContextManager, braintrust_getIdGenerator as getIdGenerator, braintrust_getPromptVersions as getPromptVersions, braintrust_getSpanParentObject as getSpanParentObject, graphFramework as graph, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, braintrust_initFunction as initFunction, braintrust_initLogger as initLogger, braintrust_invoke as invoke, braintrust_loadPrompt as loadPrompt, braintrust_log as log, braintrust_logError as logError, braintrust_login as login, braintrust_loginToState as loginToState, braintrust_newId as newId, braintrust_parseCachedHeader as parseCachedHeader, braintrust_permalink as permalink, braintrust_projects as projects, braintrust_promptContentsSchema as promptContentsSchema, braintrust_promptDefinitionSchema as promptDefinitionSchema, braintrust_promptDefinitionToPromptData as promptDefinitionToPromptData, braintrust_promptDefinitionWithToolsSchema as promptDefinitionWithToolsSchema, braintrust_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_reportFailures as reportFailures, braintrust_runEvaluator as runEvaluator, braintrust_setFetch as setFetch, braintrust_setMaskingFunction as setMaskingFunction, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, braintrust_traceable as traceable, braintrust_traced as traced, braintrust_updateSpan as updateSpan, braintrust_withCurrent as withCurrent, braintrust_withDataset as withDataset, braintrust_withExperiment as withExperiment, braintrust_withLogger as withLogger, braintrust_withParent as withParent, braintrust_wrapAISDK as wrapAISDK, braintrust_wrapAISDKModel as wrapAISDKModel, braintrust_wrapAnthropic as wrapAnthropic, braintrust_wrapClaudeAgentSDK as wrapClaudeAgentSDK, braintrust_wrapGoogleGenAI as wrapGoogleGenAI, braintrust_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+  export { braintrust_AISpanProcessor as AISpanProcessor, type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, braintrust_BaseAttachment as BaseAttachment, braintrust_BaseExperiment as BaseExperiment, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustExporter as BraintrustExporter, braintrust_BraintrustMiddleware as BraintrustMiddleware, braintrust_BraintrustSpanProcessor as BraintrustSpanProcessor, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, braintrust_CodeFunction as CodeFunction, type braintrust_CodeOpts as CodeOpts, braintrust_CodePrompt as CodePrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, braintrust_ContextManager as ContextManager, type braintrust_ContextParentSpanIds as ContextParentSpanIds, type braintrust_CreateProjectOpts as CreateProjectOpts, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, braintrust_ERR_PERMALINK as ERR_PERMALINK, type braintrust_EndSpanArgs as EndSpanArgs, braintrust_Eval as Eval, type braintrust_EvalCase as EvalCase, type braintrust_EvalHooks as EvalHooks, type braintrust_EvalResult as EvalResult, braintrust_EvalResultWithSummary as EvalResultWithSummary, type braintrust_EvalScorer as EvalScorer, type braintrust_EvalScorerArgs as EvalScorerArgs, type braintrust_EvalTask as EvalTask, type braintrust_Evaluator as Evaluator, type braintrust_EvaluatorDef as EvaluatorDef, type braintrust_EvaluatorFile as EvaluatorFile, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_ExternalAttachment as ExternalAttachment, type braintrust_ExternalAttachmentParams as ExternalAttachmentParams, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_FunctionEvent as FunctionEvent, braintrust_IDGenerator as IDGenerator, braintrust_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_JSONAttachment as JSONAttachment, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, braintrust_LazyValue as LazyValue, type braintrust_LogOptions as LogOptions, braintrust_Logger as Logger, type braintrust_LoginOptions as LoginOptions, type braintrust_MetricSummary as MetricSummary, braintrust_NOOP_SPAN as NOOP_SPAN, braintrust_NOOP_SPAN_PERMALINK as NOOP_SPAN_PERMALINK, braintrust_NoopSpan as NoopSpan, braintrust_OTELIDGenerator as OTELIDGenerator, type braintrust_ObjectMetadata as ObjectMetadata, braintrust_Project as Project, braintrust_ProjectNameIdMap as ProjectNameIdMap, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, braintrust_PromptBuilder as PromptBuilder, type braintrust_PromptContents as PromptContents, type braintrust_PromptDefinition as PromptDefinition, type braintrust_PromptDefinitionWithTools as PromptDefinitionWithTools, type braintrust_PromptOpts as PromptOpts, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyAttachment as ReadonlyAttachment, braintrust_ReadonlyExperiment as ReadonlyExperiment, braintrust_Reporter as Reporter, type braintrust_ReporterBody as ReporterBody, type braintrust_ScoreSummary as ScoreSummary, braintrust_ScorerBuilder as ScorerBuilder, type braintrust_ScorerOpts as ScorerOpts, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type Span$1 as Span, type braintrust_SpanContext as SpanContext, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, braintrust_TestBackgroundLogger as TestBackgroundLogger, braintrust_ToolBuilder as ToolBuilder, braintrust_UUIDGenerator as UUIDGenerator, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__exportsForTestingOnly as _exportsForTestingOnly, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_buildLocalSummary as buildLocalSummary, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_deepCopyEvent as deepCopyEvent, braintrust_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getContextManager as getContextManager, braintrust_getIdGenerator as getIdGenerator, braintrust_getPromptVersions as getPromptVersions, braintrust_getSpanParentObject as getSpanParentObject, graphFramework as graph, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, braintrust_initFunction as initFunction, braintrust_initLogger as initLogger, braintrust_invoke as invoke, braintrust_loadPrompt as loadPrompt, braintrust_log as log, braintrust_logError as logError, braintrust_login as login, braintrust_loginToState as loginToState, braintrust_newId as newId, braintrust_otel as otel, braintrust_parseCachedHeader as parseCachedHeader, braintrust_permalink as permalink, braintrust_projects as projects, braintrust_promptContentsSchema as promptContentsSchema, braintrust_promptDefinitionSchema as promptDefinitionSchema, braintrust_promptDefinitionToPromptData as promptDefinitionToPromptData, braintrust_promptDefinitionWithToolsSchema as promptDefinitionWithToolsSchema, braintrust_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_reportFailures as reportFailures, braintrust_runEvaluator as runEvaluator, braintrust_setFetch as setFetch, braintrust_setMaskingFunction as setMaskingFunction, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, braintrust_traceable as traceable, braintrust_traced as traced, braintrust_updateSpan as updateSpan, braintrust_withCurrent as withCurrent, braintrust_withDataset as withDataset, braintrust_withExperiment as withExperiment, braintrust_withLogger as withLogger, braintrust_withParent as withParent, braintrust_wrapAISDK as wrapAISDK, braintrust_wrapAISDKModel as wrapAISDKModel, braintrust_wrapAnthropic as wrapAnthropic, braintrust_wrapClaudeAgentSDK as wrapClaudeAgentSDK, braintrust_wrapGoogleGenAI as wrapGoogleGenAI, braintrust_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
 type EvaluatorManifest = Record<string, EvaluatorDef<unknown, unknown, unknown, BaseMetadata>>;
@@ -29009,4 +29152,4 @@ type EvaluatorDefinitions = z.infer<typeof evaluatorDefinitionsSchema>;
  * @module braintrust
  */
 
-export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, AttachmentReference, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustExporter, BraintrustMiddleware, BraintrustSpanProcessor, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CommentEvent, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, ContextManager, type ContextParentSpanIds, type CreateProjectOpts, type DataSummary, Dataset, type DatasetRecord, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, ERR_PERMALINK, type EndSpanArgs, Eval, type EvalCase, type EvalHooks, type EvalParameterSerializedSchema, type EvalParameters, type EvalResult, EvalResultWithSummary, type EvalScorer, type EvalScorerArgs, type EvalTask, type Evaluator, type EvaluatorDef, type EvaluatorDefinition, type EvaluatorDefinitions, type EvaluatorFile, type EvaluatorManifest, Experiment, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, type ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, IDGenerator, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, JSONAttachment, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, OTELIDGenerator, type ObjectMetadata, type OtherExperimentLogFields, type ParentExperimentIds, type ParentProjectLogIds, Project, ProjectNameIdMap, type PromiseUnless, Prompt, PromptBuilder, type PromptContents, type PromptDefinition, type PromptDefinitionWithTools, type PromptOpts, type PromptRowWithId, ReadonlyAttachment, ReadonlyExperiment, Reporter, type ReporterBody, type ScoreSummary, ScorerBuilder, type ScorerOpts, type SerializedBraintrustState, type SetCurrentArg, type Span$1 as Span, type SpanContext, SpanImpl, type StartSpanArgs, TestBackgroundLogger, ToolBuilder, UUIDGenerator, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, deepCopyEvent, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, getContextManager, getIdGenerator, getPromptVersions, getSpanParentObject, graphFramework as graph, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, projects, promptContentsSchema, promptDefinitionSchema, promptDefinitionToPromptData, promptDefinitionWithToolsSchema, renderMessage, renderPromptParams, reportFailures, runEvaluator, setFetch, setMaskingFunction, spanComponentsToObjectId, startSpan, summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDK, wrapAISDKModel, wrapAnthropic, wrapClaudeAgentSDK, wrapGoogleGenAI, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, AttachmentReference, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustExporter, BraintrustMiddleware, BraintrustSpanProcessor, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CommentEvent, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, ContextManager, type ContextParentSpanIds, type CreateProjectOpts, type DataSummary, Dataset, type DatasetRecord, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, ERR_PERMALINK, type EndSpanArgs, Eval, type EvalCase, type EvalHooks, type EvalParameterSerializedSchema, type EvalParameters, type EvalResult, EvalResultWithSummary, type EvalScorer, type EvalScorerArgs, type EvalTask, type Evaluator, type EvaluatorDef, type EvaluatorDefinition, type EvaluatorDefinitions, type EvaluatorFile, type EvaluatorManifest, Experiment, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, type ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, IDGenerator, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, JSONAttachment, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, OTELIDGenerator, type ObjectMetadata, type OtherExperimentLogFields, type ParentExperimentIds, type ParentProjectLogIds, Project, ProjectNameIdMap, type PromiseUnless, Prompt, PromptBuilder, type PromptContents, type PromptDefinition, type PromptDefinitionWithTools, type PromptOpts, type PromptRowWithId, ReadonlyAttachment, ReadonlyExperiment, Reporter, type ReporterBody, type ScoreSummary, ScorerBuilder, type ScorerOpts, type SerializedBraintrustState, type SetCurrentArg, type Span$1 as Span, type SpanContext, SpanImpl, type StartSpanArgs, TestBackgroundLogger, ToolBuilder, UUIDGenerator, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, deepCopyEvent, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, getContextManager, getIdGenerator, getPromptVersions, getSpanParentObject, graphFramework as graph, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, otel, parseCachedHeader, permalink, projects, promptContentsSchema, promptDefinitionSchema, promptDefinitionToPromptData, promptDefinitionWithToolsSchema, renderMessage, renderPromptParams, reportFailures, runEvaluator, setFetch, setMaskingFunction, spanComponentsToObjectId, startSpan, summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDK, wrapAISDKModel, wrapAnthropic, wrapClaudeAgentSDK, wrapGoogleGenAI, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };

package/dist/index.d.ts

@@ -21694,6 +21694,43 @@ declare class BraintrustSpanProcessor {
     shutdown(): Promise<void>;
     forceFlush(): Promise<void>;
 }
+/**
+ * Create an OTEL context from a Braintrust span export string.
+ *
+ * Used for distributed tracing scenarios where a Braintrust span in one service
+ * needs to be the parent of an OTEL span in another service.
+ *
+ * @param exportStr - The string returned from span.export()
+ * @returns OTEL context that can be used when creating child spans
+ *
+ * @example
+ * ```typescript
+ * // Service A: Create BT span and export
+ * const span = logger.startSpan({ name: "service-a" });
+ * const exportStr = await span.export();
+ * // Send exportStr to Service B (e.g., via HTTP header)
+ *
+ * // Service B: Import context and create OTEL child
+ * import * as api from '@opentelemetry/api';
+ * const ctx = otelContextFromSpanExport(exportStr);
+ * await api.context.with(ctx, async () => {
+ *   await tracer.startActiveSpan("service-b", async (span) => {
+ *     // This span is now a child of the Service A span
+ *     span.end();
+ *   });
+ * });
+ * ```
+ */
+declare function otelContextFromSpanExport(exportStr: string): unknown;
+/**
+ * Construct a braintrust.parent identifier string from span components.
+ *
+ * @param objectType - Type of parent object (PROJECT_LOGS or EXPERIMENT)
+ * @param objectId - Resolved object ID (project_id or experiment_id)
+ * @param computeArgs - Optional dict with project_name/project_id for unresolved cases
+ * @returns String like "project_id:abc", "project_name:my-proj", "experiment_id:exp-123", or undefined
+ */
+declare function getBraintrustParent(objectType: number, objectId?: string | null, computeArgs?: Record<string, unknown> | null): string | undefined;
 /**
  * A trace exporter that sends OpenTelemetry spans to Braintrust.
  *
@@ -21760,6 +21797,111 @@ declare class BraintrustExporter {
      */
     forceFlush(): Promise<void>;
 }
+/**
+ * Add braintrust.parent to OTEL baggage.
+ *
+ * This ensures that when using propagation inject() for distributed tracing,
+ * the braintrust.parent will be propagated via baggage to downstream services.
+ *
+ * @param parent - Braintrust parent identifier (e.g., "project_name:my-project",
+ *                 "project_id:abc123", "experiment_id:exp-456")
+ * @param ctx - Optional OTEL context to use. If not provided, uses current context.
+ * @returns Updated context with braintrust.parent in baggage
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ * import { propagation } from "@opentelemetry/api";
+ *
+ * // Set braintrust.parent in baggage
+ * otel.addParentToBaggage("project_name:my-project");
+ *
+ * // Export headers (will include braintrust.parent in baggage)
+ * const headers = {};
+ * propagation.inject(context.active(), headers);
+ * ```
+ */
+declare function addParentToBaggage(parent: string, ctx?: Context): Context;
+/**
+ * Copy braintrust.parent from span attribute to OTEL baggage.
+ *
+ * BraintrustSpanProcessor automatically sets braintrust.parent as a span attribute
+ * when OTEL spans are created within Braintrust contexts. This function copies that
+ * attribute to OTEL baggage so it propagates when using inject() for distributed tracing.
+ *
+ * @param span - OTEL span that has braintrust.parent attribute set
+ * @param ctx - Optional OTEL context to use. If not provided, uses current context.
+ * @returns Updated context with braintrust.parent in baggage, or undefined if attribute not found
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ * import { propagation } from "@opentelemetry/api";
+ *
+ * tracer.startActiveSpan("service_b", (span) => {
+ *   // Copy braintrust.parent from span attribute to baggage
+ *   otel.addSpanParentToBaggage(span);
+ *
+ *   // Export headers (will include braintrust.parent in baggage)
+ *   const headers = {};
+ *   propagation.inject(context.active(), headers);
+ *   span.end();
+ * });
+ * ```
+ */
+declare function addSpanParentToBaggage(span: Span, ctx?: Context): Context | undefined;
+/**
+ * Extract a Braintrust-compatible parent string from W3C Trace Context headers.
+ *
+ * This converts OTEL trace context headers (traceparent/baggage) into a format
+ * that can be passed as the 'parent' parameter to Braintrust's traced() method.
+ *
+ * @param headers - Dictionary with 'traceparent' and optionally 'baggage' keys
+ * @returns Braintrust V4 export string that can be used as parent parameter,
+ *          or undefined if no valid span context is found or braintrust.parent is missing.
+ *
+ * @example
+ * ```typescript
+ * import { otel, initLogger } from "braintrust";
+ *
+ * // Service C receives headers from Service B
+ * const headers = { traceparent: '00-trace_id-span_id-01', baggage: '...' };
+ * const parent = otel.parentFromHeaders(headers);
+ *
+ * const logger = initLogger({ projectName: "my-project" });
+ * await logger.traced(async (span) => {
+ *   span.log({ input: "BT span as child of OTEL parent" });
+ * }, { name: "service_c", parent });
+ * ```
+ */
+declare function parentFromHeaders(headers: Record<string, string>): string | undefined;
+/**
+ * OTEL namespace containing distributed tracing helper functions.
+ *
+ * @example
+ * ```typescript
+ * import { otel } from "braintrust";
+ *
+ * // Export Braintrust span context for OTEL
+ * const ctx = otel.contextFromSpanExport(exportStr);
+ *
+ * // Add parent to baggage before propagating
+ * otel.addParentToBaggage("project_name:my-project");
+ *
+ * // Copy span attribute to baggage
+ * otel.addSpanParentToBaggage(span);
+ *
+ * // Create Braintrust parent from OTEL headers
+ * const parent = otel.parentFromHeaders(headers);
+ * ```
+ */
+declare const otel: {
+    contextFromSpanExport: typeof otelContextFromSpanExport;
+    getBraintrustParent: typeof getBraintrustParent;
+    addParentToBaggage: typeof addParentToBaggage;
+    addSpanParentToBaggage: typeof addSpanParentToBaggage;
+    parentFromHeaders: typeof parentFromHeaders;
+};
 
 type braintrust_AISpanProcessor = AISpanProcessor;
 declare const braintrust_AISpanProcessor: typeof AISpanProcessor;
@@ -21918,6 +22060,7 @@ declare const braintrust_logError: typeof logError;
 declare const braintrust_login: typeof login;
 declare const braintrust_loginToState: typeof loginToState;
 declare const braintrust_newId: typeof newId;
+declare const braintrust_otel: typeof otel;
 declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
 declare const braintrust_permalink: typeof permalink;
 declare const braintrust_projects: typeof projects;
@@ -21952,7 +22095,7 @@ declare const braintrust_wrapOpenAI: typeof wrapOpenAI;
 declare const braintrust_wrapOpenAIv4: typeof wrapOpenAIv4;
 declare const braintrust_wrapTraced: typeof wrapTraced;
 declare namespace braintrust {
-  export { braintrust_AISpanProcessor as AISpanProcessor, type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, braintrust_BaseAttachment as BaseAttachment, braintrust_BaseExperiment as BaseExperiment, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustExporter as BraintrustExporter, braintrust_BraintrustMiddleware as BraintrustMiddleware, braintrust_BraintrustSpanProcessor as BraintrustSpanProcessor, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, braintrust_CodeFunction as CodeFunction, type braintrust_CodeOpts as CodeOpts, braintrust_CodePrompt as CodePrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, braintrust_ContextManager as ContextManager, type braintrust_ContextParentSpanIds as ContextParentSpanIds, type braintrust_CreateProjectOpts as CreateProjectOpts, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, braintrust_ERR_PERMALINK as ERR_PERMALINK, type braintrust_EndSpanArgs as EndSpanArgs, braintrust_Eval as Eval, type braintrust_EvalCase as EvalCase, type braintrust_EvalHooks as EvalHooks, type braintrust_EvalResult as EvalResult, braintrust_EvalResultWithSummary as EvalResultWithSummary, type braintrust_EvalScorer as EvalScorer, type braintrust_EvalScorerArgs as EvalScorerArgs, type braintrust_EvalTask as EvalTask, type braintrust_Evaluator as Evaluator, type braintrust_EvaluatorDef as EvaluatorDef, type braintrust_EvaluatorFile as EvaluatorFile, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_ExternalAttachment as ExternalAttachment, type braintrust_ExternalAttachmentParams as ExternalAttachmentParams, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_FunctionEvent as FunctionEvent, braintrust_IDGenerator as IDGenerator, braintrust_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_JSONAttachment as JSONAttachment, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, braintrust_LazyValue as LazyValue, type braintrust_LogOptions as LogOptions, braintrust_Logger as Logger, type braintrust_LoginOptions as LoginOptions, type braintrust_MetricSummary as MetricSummary, braintrust_NOOP_SPAN as NOOP_SPAN, braintrust_NOOP_SPAN_PERMALINK as NOOP_SPAN_PERMALINK, braintrust_NoopSpan as NoopSpan, braintrust_OTELIDGenerator as OTELIDGenerator, type braintrust_ObjectMetadata as ObjectMetadata, braintrust_Project as Project, braintrust_ProjectNameIdMap as ProjectNameIdMap, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, braintrust_PromptBuilder as PromptBuilder, type braintrust_PromptContents as PromptContents, type braintrust_PromptDefinition as PromptDefinition, type braintrust_PromptDefinitionWithTools as PromptDefinitionWithTools, type braintrust_PromptOpts as PromptOpts, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyAttachment as ReadonlyAttachment, braintrust_ReadonlyExperiment as ReadonlyExperiment, braintrust_Reporter as Reporter, type braintrust_ReporterBody as ReporterBody, type braintrust_ScoreSummary as ScoreSummary, braintrust_ScorerBuilder as ScorerBuilder, type braintrust_ScorerOpts as ScorerOpts, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type Span$1 as Span, type braintrust_SpanContext as SpanContext, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, braintrust_TestBackgroundLogger as TestBackgroundLogger, braintrust_ToolBuilder as ToolBuilder, braintrust_UUIDGenerator as UUIDGenerator, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__exportsForTestingOnly as _exportsForTestingOnly, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_buildLocalSummary as buildLocalSummary, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_deepCopyEvent as deepCopyEvent, braintrust_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getContextManager as getContextManager, braintrust_getIdGenerator as getIdGenerator, braintrust_getPromptVersions as getPromptVersions, braintrust_getSpanParentObject as getSpanParentObject, graphFramework as graph, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, braintrust_initFunction as initFunction, braintrust_initLogger as initLogger, braintrust_invoke as invoke, braintrust_loadPrompt as loadPrompt, braintrust_log as log, braintrust_logError as logError, braintrust_login as login, braintrust_loginToState as loginToState, braintrust_newId as newId, braintrust_parseCachedHeader as parseCachedHeader, braintrust_permalink as permalink, braintrust_projects as projects, braintrust_promptContentsSchema as promptContentsSchema, braintrust_promptDefinitionSchema as promptDefinitionSchema, braintrust_promptDefinitionToPromptData as promptDefinitionToPromptData, braintrust_promptDefinitionWithToolsSchema as promptDefinitionWithToolsSchema, braintrust_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_reportFailures as reportFailures, braintrust_runEvaluator as runEvaluator, braintrust_setFetch as setFetch, braintrust_setMaskingFunction as setMaskingFunction, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, braintrust_traceable as traceable, braintrust_traced as traced, braintrust_updateSpan as updateSpan, braintrust_withCurrent as withCurrent, braintrust_withDataset as withDataset, braintrust_withExperiment as withExperiment, braintrust_withLogger as withLogger, braintrust_withParent as withParent, braintrust_wrapAISDK as wrapAISDK, braintrust_wrapAISDKModel as wrapAISDKModel, braintrust_wrapAnthropic as wrapAnthropic, braintrust_wrapClaudeAgentSDK as wrapClaudeAgentSDK, braintrust_wrapGoogleGenAI as wrapGoogleGenAI, braintrust_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+  export { braintrust_AISpanProcessor as AISpanProcessor, type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, braintrust_BaseAttachment as BaseAttachment, braintrust_BaseExperiment as BaseExperiment, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustExporter as BraintrustExporter, braintrust_BraintrustMiddleware as BraintrustMiddleware, braintrust_BraintrustSpanProcessor as BraintrustSpanProcessor, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, braintrust_CodeFunction as CodeFunction, type braintrust_CodeOpts as CodeOpts, braintrust_CodePrompt as CodePrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, braintrust_ContextManager as ContextManager, type braintrust_ContextParentSpanIds as ContextParentSpanIds, type braintrust_CreateProjectOpts as CreateProjectOpts, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, braintrust_ERR_PERMALINK as ERR_PERMALINK, type braintrust_EndSpanArgs as EndSpanArgs, braintrust_Eval as Eval, type braintrust_EvalCase as EvalCase, type braintrust_EvalHooks as EvalHooks, type braintrust_EvalResult as EvalResult, braintrust_EvalResultWithSummary as EvalResultWithSummary, type braintrust_EvalScorer as EvalScorer, type braintrust_EvalScorerArgs as EvalScorerArgs, type braintrust_EvalTask as EvalTask, type braintrust_Evaluator as Evaluator, type braintrust_EvaluatorDef as EvaluatorDef, type braintrust_EvaluatorFile as EvaluatorFile, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_ExternalAttachment as ExternalAttachment, type braintrust_ExternalAttachmentParams as ExternalAttachmentParams, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_FunctionEvent as FunctionEvent, braintrust_IDGenerator as IDGenerator, braintrust_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_JSONAttachment as JSONAttachment, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, braintrust_LazyValue as LazyValue, type braintrust_LogOptions as LogOptions, braintrust_Logger as Logger, type braintrust_LoginOptions as LoginOptions, type braintrust_MetricSummary as MetricSummary, braintrust_NOOP_SPAN as NOOP_SPAN, braintrust_NOOP_SPAN_PERMALINK as NOOP_SPAN_PERMALINK, braintrust_NoopSpan as NoopSpan, braintrust_OTELIDGenerator as OTELIDGenerator, type braintrust_ObjectMetadata as ObjectMetadata, braintrust_Project as Project, braintrust_ProjectNameIdMap as ProjectNameIdMap, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, braintrust_PromptBuilder as PromptBuilder, type braintrust_PromptContents as PromptContents, type braintrust_PromptDefinition as PromptDefinition, type braintrust_PromptDefinitionWithTools as PromptDefinitionWithTools, type braintrust_PromptOpts as PromptOpts, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyAttachment as ReadonlyAttachment, braintrust_ReadonlyExperiment as ReadonlyExperiment, braintrust_Reporter as Reporter, type braintrust_ReporterBody as ReporterBody, type braintrust_ScoreSummary as ScoreSummary, braintrust_ScorerBuilder as ScorerBuilder, type braintrust_ScorerOpts as ScorerOpts, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type Span$1 as Span, type braintrust_SpanContext as SpanContext, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, braintrust_TestBackgroundLogger as TestBackgroundLogger, braintrust_ToolBuilder as ToolBuilder, braintrust_UUIDGenerator as UUIDGenerator, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__exportsForTestingOnly as _exportsForTestingOnly, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_buildLocalSummary as buildLocalSummary, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_deepCopyEvent as deepCopyEvent, braintrust_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getContextManager as getContextManager, braintrust_getIdGenerator as getIdGenerator, braintrust_getPromptVersions as getPromptVersions, braintrust_getSpanParentObject as getSpanParentObject, graphFramework as graph, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, braintrust_initFunction as initFunction, braintrust_initLogger as initLogger, braintrust_invoke as invoke, braintrust_loadPrompt as loadPrompt, braintrust_log as log, braintrust_logError as logError, braintrust_login as login, braintrust_loginToState as loginToState, braintrust_newId as newId, braintrust_otel as otel, braintrust_parseCachedHeader as parseCachedHeader, braintrust_permalink as permalink, braintrust_projects as projects, braintrust_promptContentsSchema as promptContentsSchema, braintrust_promptDefinitionSchema as promptDefinitionSchema, braintrust_promptDefinitionToPromptData as promptDefinitionToPromptData, braintrust_promptDefinitionWithToolsSchema as promptDefinitionWithToolsSchema, braintrust_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_reportFailures as reportFailures, braintrust_runEvaluator as runEvaluator, braintrust_setFetch as setFetch, braintrust_setMaskingFunction as setMaskingFunction, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, braintrust_traceable as traceable, braintrust_traced as traced, braintrust_updateSpan as updateSpan, braintrust_withCurrent as withCurrent, braintrust_withDataset as withDataset, braintrust_withExperiment as withExperiment, braintrust_withLogger as withLogger, braintrust_withParent as withParent, braintrust_wrapAISDK as wrapAISDK, braintrust_wrapAISDKModel as wrapAISDKModel, braintrust_wrapAnthropic as wrapAnthropic, braintrust_wrapClaudeAgentSDK as wrapClaudeAgentSDK, braintrust_wrapGoogleGenAI as wrapGoogleGenAI, braintrust_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
 type EvaluatorManifest = Record<string, EvaluatorDef<unknown, unknown, unknown, BaseMetadata>>;
@@ -29009,4 +29152,4 @@ type EvaluatorDefinitions = z.infer<typeof evaluatorDefinitionsSchema>;
  * @module braintrust
  */
 
-export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, AttachmentReference, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustExporter, BraintrustMiddleware, BraintrustSpanProcessor, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CommentEvent, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, ContextManager, type ContextParentSpanIds, type CreateProjectOpts, type DataSummary, Dataset, type DatasetRecord, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, ERR_PERMALINK, type EndSpanArgs, Eval, type EvalCase, type EvalHooks, type EvalParameterSerializedSchema, type EvalParameters, type EvalResult, EvalResultWithSummary, type EvalScorer, type EvalScorerArgs, type EvalTask, type Evaluator, type EvaluatorDef, type EvaluatorDefinition, type EvaluatorDefinitions, type EvaluatorFile, type EvaluatorManifest, Experiment, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, type ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, IDGenerator, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, JSONAttachment, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, OTELIDGenerator, type ObjectMetadata, type OtherExperimentLogFields, type ParentExperimentIds, type ParentProjectLogIds, Project, ProjectNameIdMap, type PromiseUnless, Prompt, PromptBuilder, type PromptContents, type PromptDefinition, type PromptDefinitionWithTools, type PromptOpts, type PromptRowWithId, ReadonlyAttachment, ReadonlyExperiment, Reporter, type ReporterBody, type ScoreSummary, ScorerBuilder, type ScorerOpts, type SerializedBraintrustState, type SetCurrentArg, type Span$1 as Span, type SpanContext, SpanImpl, type StartSpanArgs, TestBackgroundLogger, ToolBuilder, UUIDGenerator, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, deepCopyEvent, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, getContextManager, getIdGenerator, getPromptVersions, getSpanParentObject, graphFramework as graph, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, projects, promptContentsSchema, promptDefinitionSchema, promptDefinitionToPromptData, promptDefinitionWithToolsSchema, renderMessage, renderPromptParams, reportFailures, runEvaluator, setFetch, setMaskingFunction, spanComponentsToObjectId, startSpan, summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDK, wrapAISDKModel, wrapAnthropic, wrapClaudeAgentSDK, wrapGoogleGenAI, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, AttachmentReference, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustExporter, BraintrustMiddleware, BraintrustSpanProcessor, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CommentEvent, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, ContextManager, type ContextParentSpanIds, type CreateProjectOpts, type DataSummary, Dataset, type DatasetRecord, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, ERR_PERMALINK, type EndSpanArgs, Eval, type EvalCase, type EvalHooks, type EvalParameterSerializedSchema, type EvalParameters, type EvalResult, EvalResultWithSummary, type EvalScorer, type EvalScorerArgs, type EvalTask, type Evaluator, type EvaluatorDef, type EvaluatorDefinition, type EvaluatorDefinitions, type EvaluatorFile, type EvaluatorManifest, Experiment, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, type ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, IDGenerator, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, JSONAttachment, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, OTELIDGenerator, type ObjectMetadata, type OtherExperimentLogFields, type ParentExperimentIds, type ParentProjectLogIds, Project, ProjectNameIdMap, type PromiseUnless, Prompt, PromptBuilder, type PromptContents, type PromptDefinition, type PromptDefinitionWithTools, type PromptOpts, type PromptRowWithId, ReadonlyAttachment, ReadonlyExperiment, Reporter, type ReporterBody, type ScoreSummary, ScorerBuilder, type ScorerOpts, type SerializedBraintrustState, type SetCurrentArg, type Span$1 as Span, type SpanContext, SpanImpl, type StartSpanArgs, TestBackgroundLogger, ToolBuilder, UUIDGenerator, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, deepCopyEvent, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, getContextManager, getIdGenerator, getPromptVersions, getSpanParentObject, graphFramework as graph, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, otel, parseCachedHeader, permalink, projects, promptContentsSchema, promptDefinitionSchema, promptDefinitionToPromptData, promptDefinitionWithToolsSchema, renderMessage, renderPromptParams, reportFailures, runEvaluator, setFetch, setMaskingFunction, spanComponentsToObjectId, startSpan, summarize, ToolFunctionDefinition as toolFunctionDefinitionSchema, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDK, wrapAISDKModel, wrapAnthropic, wrapClaudeAgentSDK, wrapGoogleGenAI, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };

package/dist/index.js

@@ -10026,6 +10026,7 @@ __export(exports_node_exports, {
   login: () => login,
   loginToState: () => loginToState,
   newId: () => newId,
+  otel: () => otel,
   parseCachedHeader: () => parseCachedHeader,
   permalink: () => permalink,
   projects: () => projects,
@@ -15523,6 +15524,8 @@ function tryToDict(obj) {
 }
 
 // src/otel.ts
+init_span_identifier_v4();
+init_span_identifier_v3();
 var otelApi = null;
 var otelSdk = null;
 var OTEL_AVAILABLE2 = false;
@@ -15776,6 +15779,80 @@ var BraintrustSpanProcessor = class _BraintrustSpanProcessor {
     return this.aiSpanProcessor.forceFlush();
   }
 };
+function otelContextFromSpanExport(exportStr) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    return void 0;
+  }
+  const components = SpanComponentsV4.fromStr(exportStr);
+  const traceIdHex = components.data.root_span_id;
+  const spanIdHex = components.data.span_id;
+  if (!traceIdHex || !spanIdHex) {
+    throw new Error(
+      "Export string must contain root_span_id and span_id for distributed tracing"
+    );
+  }
+  const otelTrace2 = otelApi.trace;
+  const spanContext = {
+    traceId: traceIdHex,
+    spanId: spanIdHex,
+    isRemote: true,
+    traceFlags: _nullishCoalesce(_optionalChain([otelApi, 'access', _269 => _269.TraceFlags, 'optionalAccess', _270 => _270.SAMPLED]), () => ( 1))
+    // SAMPLED flag
+  };
+  const nonRecordingSpan = otelTrace2.wrapSpanContext(spanContext);
+  let ctx = otelTrace2.setSpan(otelApi.context.active(), nonRecordingSpan);
+  const braintrustParent = getBraintrustParent(
+    components.data.object_type,
+    components.data.object_id,
+    components.data.compute_object_metadata_args
+  );
+  if (braintrustParent) {
+    try {
+      const propagation2 = otelApi.propagation;
+      if (propagation2) {
+        const baggage = propagation2.getBaggage(ctx) || propagation2.createBaggage();
+        ctx = propagation2.setBaggage(
+          ctx,
+          baggage.setEntry("braintrust.parent", { value: braintrustParent })
+        );
+      }
+    } catch (error2) {
+      console.error(
+        "Failed to set braintrust.parent in baggage during context import:",
+        error2
+      );
+    }
+  }
+  return ctx;
+}
+function getBraintrustParent(objectType, objectId, computeArgs) {
+  if (!objectType) {
+    return void 0;
+  }
+  if (objectType === 2 /* PROJECT_LOGS */) {
+    if (objectId) {
+      return `project_id:${objectId}`;
+    } else if (computeArgs) {
+      const projectId = computeArgs["project_id"];
+      const projectName = computeArgs["project_name"];
+      if (typeof projectId === "string") {
+        return `project_id:${projectId}`;
+      } else if (typeof projectName === "string") {
+        return `project_name:${projectName}`;
+      }
+    }
+  } else if (objectType === 1 /* EXPERIMENT */) {
+    if (objectId) {
+      return `experiment_id:${objectId}`;
+    } else if (computeArgs) {
+      const experimentId = computeArgs["experiment_id"];
+      if (typeof experimentId === "string") {
+        return `experiment_id:${experimentId}`;
+      }
+    }
+  }
+  return void 0;
+}
 var BraintrustExporter = (_class21 = class _BraintrustExporter {
   static checkOtelAvailable() {
     if (!OTEL_AVAILABLE2) {
@@ -15821,6 +15898,140 @@ var BraintrustExporter = (_class21 = class _BraintrustExporter {
     return this.processor.forceFlush();
   }
 }, _class21);
+function addParentToBaggage(parent, ctx) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    console.error("OpenTelemetry not available");
+    return ctx || _optionalChain([otelApi, 'optionalAccess', _271 => _271.context, 'access', _272 => _272.active, 'call', _273 => _273()]);
+  }
+  try {
+    const propagation2 = otelApi.propagation;
+    if (!propagation2) {
+      console.error("OTEL propagation API not available");
+      return ctx || otelApi.context.active();
+    }
+    const currentCtx = ctx || otelApi.context.active();
+    const baggage = propagation2.getBaggage(currentCtx) || propagation2.createBaggage();
+    return propagation2.setBaggage(
+      currentCtx,
+      baggage.setEntry("braintrust.parent", { value: parent })
+    );
+  } catch (error2) {
+    console.error("Failed to add braintrust.parent to baggage:", error2);
+    return ctx || otelApi.context.active();
+  }
+}
+function addSpanParentToBaggage(span, ctx) {
+  if (!span || !span.attributes) {
+    console.warn("addSpanParentToBaggage: span has no attributes");
+    return void 0;
+  }
+  const parentValue = span.attributes["braintrust.parent"];
+  if (!parentValue || typeof parentValue !== "string") {
+    console.warn(
+      "addSpanParentToBaggage: braintrust.parent attribute not found. Ensure BraintrustSpanProcessor is configured or span is created within Braintrust context."
+    );
+    return void 0;
+  }
+  return addParentToBaggage(parentValue, ctx);
+}
+function parentFromHeaders(headers) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    console.error("OpenTelemetry not available");
+    return void 0;
+  }
+  try {
+    const propagation2 = otelApi.propagation;
+    if (!propagation2) {
+      console.error("OTEL propagation API not available");
+      return void 0;
+    }
+    const ctx = propagation2.extract(otelApi.context.active(), headers);
+    const spanContext = otelApi.trace.getSpanContext(ctx);
+    if (!spanContext) {
+      console.error("parentFromHeaders: No valid span context in headers");
+      return void 0;
+    }
+    const traceIdHex = spanContext.traceId;
+    const spanIdHex = spanContext.spanId;
+    if (!traceIdHex || typeof traceIdHex !== "string" || traceIdHex === "00000000000000000000000000000000") {
+      console.error("parentFromHeaders: Invalid trace_id (all zeros)");
+      return void 0;
+    }
+    if (!spanIdHex || typeof spanIdHex !== "string" || spanIdHex === "0000000000000000") {
+      console.error("parentFromHeaders: Invalid span_id (all zeros)");
+      return void 0;
+    }
+    const baggage = propagation2.getBaggage(ctx);
+    const braintrustParent = _optionalChain([baggage, 'optionalAccess', _274 => _274.getEntry, 'call', _275 => _275("braintrust.parent"), 'optionalAccess', _276 => _276.value]);
+    if (!braintrustParent) {
+      console.warn(
+        "parentFromHeaders: braintrust.parent not found in OTEL baggage. Cannot create Braintrust parent without project information. Ensure the OTEL span sets braintrust.parent in baggage before exporting headers."
+      );
+      return void 0;
+    }
+    let objectType;
+    let objectId;
+    let computeArgs;
+    if (braintrustParent.startsWith("project_id:")) {
+      objectType = 2 /* PROJECT_LOGS */;
+      objectId = braintrustParent.substring("project_id:".length);
+      if (!objectId) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty project_id): ${braintrustParent}`
+        );
+        return void 0;
+      }
+    } else if (braintrustParent.startsWith("project_name:")) {
+      objectType = 2 /* PROJECT_LOGS */;
+      const projectName = braintrustParent.substring("project_name:".length);
+      if (!projectName) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty project_name): ${braintrustParent}`
+        );
+        return void 0;
+      }
+      computeArgs = { project_name: projectName };
+    } else if (braintrustParent.startsWith("experiment_id:")) {
+      objectType = 1 /* EXPERIMENT */;
+      objectId = braintrustParent.substring("experiment_id:".length);
+      if (!objectId) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty experiment_id): ${braintrustParent}`
+        );
+        return void 0;
+      }
+    } else {
+      console.error(
+        `parentFromHeaders: Invalid braintrust.parent format: ${braintrustParent}. Expected format: 'project_id:ID', 'project_name:NAME', or 'experiment_id:ID'`
+      );
+      return void 0;
+    }
+    const componentsData = {
+      object_type: objectType,
+      row_id: "otel",
+      // Dummy row_id to enable span_id/root_span_id fields
+      span_id: spanIdHex,
+      root_span_id: traceIdHex
+    };
+    if (computeArgs) {
+      componentsData.compute_object_metadata_args = computeArgs;
+    } else {
+      componentsData.object_id = objectId;
+    }
+    const components = new SpanComponentsV4(componentsData);
+    return components.toStr();
+  } catch (error2) {
+    console.error("parentFromHeaders: Error parsing headers:", error2);
+    return void 0;
+  }
+}
+var otel = {
+  contextFromSpanExport: otelContextFromSpanExport,
+  getBraintrustParent,
+  addParentToBaggage,
+  addSpanParentToBaggage,
+  parentFromHeaders
+};
 
 // dev/types.ts
 init_generated_types();
@@ -15979,4 +16190,5 @@ var index_default = exports_node_exports;
 
 
 
-exports.AISpanProcessor = AISpanProcessor; exports.Attachment = Attachment; exports.BaseAttachment = BaseAttachment; exports.BaseExperiment = BaseExperiment; exports.BraintrustExporter = BraintrustExporter; exports.BraintrustMiddleware = BraintrustMiddleware; exports.BraintrustSpanProcessor = BraintrustSpanProcessor; exports.BraintrustState = BraintrustState; exports.BraintrustStream = BraintrustStream; exports.CodeFunction = CodeFunction; exports.CodePrompt = CodePrompt; exports.ContextManager = ContextManager; exports.Dataset = Dataset2; exports.ERR_PERMALINK = ERR_PERMALINK; exports.Eval = Eval; exports.EvalResultWithSummary = EvalResultWithSummary; exports.Experiment = Experiment2; exports.ExternalAttachment = ExternalAttachment; exports.FailedHTTPResponse = FailedHTTPResponse; exports.IDGenerator = IDGenerator; exports.INTERNAL_BTQL_LIMIT = INTERNAL_BTQL_LIMIT; exports.JSONAttachment = JSONAttachment; exports.LEGACY_CACHED_HEADER = LEGACY_CACHED_HEADER; exports.LazyValue = LazyValue; exports.Logger = Logger; exports.NOOP_SPAN = NOOP_SPAN; exports.NOOP_SPAN_PERMALINK = NOOP_SPAN_PERMALINK; exports.NoopSpan = NoopSpan; exports.OTELIDGenerator = OTELIDGenerator; exports.Project = Project2; exports.ProjectNameIdMap = ProjectNameIdMap; exports.Prompt = Prompt2; exports.PromptBuilder = PromptBuilder; exports.ReadonlyAttachment = ReadonlyAttachment; exports.ReadonlyExperiment = ReadonlyExperiment; exports.Reporter = Reporter; exports.ScorerBuilder = ScorerBuilder; exports.SpanImpl = SpanImpl; exports.TestBackgroundLogger = TestBackgroundLogger; exports.ToolBuilder = ToolBuilder; exports.UUIDGenerator = UUIDGenerator; exports.X_CACHED_HEADER = X_CACHED_HEADER; exports._exportsForTestingOnly = _exportsForTestingOnly; exports._internalGetGlobalState = _internalGetGlobalState; exports._internalSetInitialState = _internalSetInitialState; exports.braintrustStreamChunkSchema = braintrustStreamChunkSchema; exports.buildLocalSummary = buildLocalSummary; exports.createFinalValuePassThroughStream = createFinalValuePassThroughStream; exports.currentExperiment = currentExperiment; exports.currentLogger = currentLogger; exports.currentSpan = currentSpan; exports.deepCopyEvent = deepCopyEvent; exports.default = index_default; exports.defaultErrorScoreHandler = defaultErrorScoreHandler; exports.deserializePlainStringAsJSON = deserializePlainStringAsJSON; exports.devNullWritableStream = devNullWritableStream; exports.evaluatorDefinitionSchema = evaluatorDefinitionSchema; exports.evaluatorDefinitionsSchema = evaluatorDefinitionsSchema; exports.flush = flush; exports.getContextManager = getContextManager; exports.getIdGenerator = getIdGenerator; exports.getPromptVersions = getPromptVersions; exports.getSpanParentObject = getSpanParentObject; exports.graph = graph_framework_exports; exports.init = init; exports.initDataset = initDataset; exports.initExperiment = initExperiment; exports.initFunction = initFunction; exports.initLogger = initLogger; exports.invoke = invoke; exports.loadPrompt = loadPrompt; exports.log = log; exports.logError = logError; exports.login = login; exports.loginToState = loginToState; exports.newId = newId; exports.parseCachedHeader = parseCachedHeader; exports.permalink = permalink; exports.projects = projects; exports.promptContentsSchema = promptContentsSchema; exports.promptDefinitionSchema = promptDefinitionSchema; exports.promptDefinitionToPromptData = promptDefinitionToPromptData; exports.promptDefinitionWithToolsSchema = promptDefinitionWithToolsSchema; exports.renderMessage = renderMessage; exports.renderPromptParams = renderPromptParams; exports.reportFailures = reportFailures; exports.runEvaluator = runEvaluator; exports.setFetch = setFetch; exports.setMaskingFunction = setMaskingFunction; exports.spanComponentsToObjectId = spanComponentsToObjectId; exports.startSpan = startSpan; exports.summarize = summarize; exports.toolFunctionDefinitionSchema = ToolFunctionDefinition; exports.traceable = traceable; exports.traced = traced; exports.updateSpan = updateSpan; exports.withCurrent = withCurrent; exports.withDataset = withDataset; exports.withExperiment = withExperiment; exports.withLogger = withLogger; exports.withParent = withParent; exports.wrapAISDK = wrapAISDK; exports.wrapAISDKModel = wrapAISDKModel; exports.wrapAnthropic = wrapAnthropic; exports.wrapClaudeAgentSDK = wrapClaudeAgentSDK; exports.wrapGoogleGenAI = wrapGoogleGenAI; exports.wrapMastraAgent = wrapMastraAgent; exports.wrapOpenAI = wrapOpenAI; exports.wrapOpenAIv4 = wrapOpenAIv4; exports.wrapTraced = wrapTraced;
+
+exports.AISpanProcessor = AISpanProcessor; exports.Attachment = Attachment; exports.BaseAttachment = BaseAttachment; exports.BaseExperiment = BaseExperiment; exports.BraintrustExporter = BraintrustExporter; exports.BraintrustMiddleware = BraintrustMiddleware; exports.BraintrustSpanProcessor = BraintrustSpanProcessor; exports.BraintrustState = BraintrustState; exports.BraintrustStream = BraintrustStream; exports.CodeFunction = CodeFunction; exports.CodePrompt = CodePrompt; exports.ContextManager = ContextManager; exports.Dataset = Dataset2; exports.ERR_PERMALINK = ERR_PERMALINK; exports.Eval = Eval; exports.EvalResultWithSummary = EvalResultWithSummary; exports.Experiment = Experiment2; exports.ExternalAttachment = ExternalAttachment; exports.FailedHTTPResponse = FailedHTTPResponse; exports.IDGenerator = IDGenerator; exports.INTERNAL_BTQL_LIMIT = INTERNAL_BTQL_LIMIT; exports.JSONAttachment = JSONAttachment; exports.LEGACY_CACHED_HEADER = LEGACY_CACHED_HEADER; exports.LazyValue = LazyValue; exports.Logger = Logger; exports.NOOP_SPAN = NOOP_SPAN; exports.NOOP_SPAN_PERMALINK = NOOP_SPAN_PERMALINK; exports.NoopSpan = NoopSpan; exports.OTELIDGenerator = OTELIDGenerator; exports.Project = Project2; exports.ProjectNameIdMap = ProjectNameIdMap; exports.Prompt = Prompt2; exports.PromptBuilder = PromptBuilder; exports.ReadonlyAttachment = ReadonlyAttachment; exports.ReadonlyExperiment = ReadonlyExperiment; exports.Reporter = Reporter; exports.ScorerBuilder = ScorerBuilder; exports.SpanImpl = SpanImpl; exports.TestBackgroundLogger = TestBackgroundLogger; exports.ToolBuilder = ToolBuilder; exports.UUIDGenerator = UUIDGenerator; exports.X_CACHED_HEADER = X_CACHED_HEADER; exports._exportsForTestingOnly = _exportsForTestingOnly; exports._internalGetGlobalState = _internalGetGlobalState; exports._internalSetInitialState = _internalSetInitialState; exports.braintrustStreamChunkSchema = braintrustStreamChunkSchema; exports.buildLocalSummary = buildLocalSummary; exports.createFinalValuePassThroughStream = createFinalValuePassThroughStream; exports.currentExperiment = currentExperiment; exports.currentLogger = currentLogger; exports.currentSpan = currentSpan; exports.deepCopyEvent = deepCopyEvent; exports.default = index_default; exports.defaultErrorScoreHandler = defaultErrorScoreHandler; exports.deserializePlainStringAsJSON = deserializePlainStringAsJSON; exports.devNullWritableStream = devNullWritableStream; exports.evaluatorDefinitionSchema = evaluatorDefinitionSchema; exports.evaluatorDefinitionsSchema = evaluatorDefinitionsSchema; exports.flush = flush; exports.getContextManager = getContextManager; exports.getIdGenerator = getIdGenerator; exports.getPromptVersions = getPromptVersions; exports.getSpanParentObject = getSpanParentObject; exports.graph = graph_framework_exports; exports.init = init; exports.initDataset = initDataset; exports.initExperiment = initExperiment; exports.initFunction = initFunction; exports.initLogger = initLogger; exports.invoke = invoke; exports.loadPrompt = loadPrompt; exports.log = log; exports.logError = logError; exports.login = login; exports.loginToState = loginToState; exports.newId = newId; exports.otel = otel; exports.parseCachedHeader = parseCachedHeader; exports.permalink = permalink; exports.projects = projects; exports.promptContentsSchema = promptContentsSchema; exports.promptDefinitionSchema = promptDefinitionSchema; exports.promptDefinitionToPromptData = promptDefinitionToPromptData; exports.promptDefinitionWithToolsSchema = promptDefinitionWithToolsSchema; exports.renderMessage = renderMessage; exports.renderPromptParams = renderPromptParams; exports.reportFailures = reportFailures; exports.runEvaluator = runEvaluator; exports.setFetch = setFetch; exports.setMaskingFunction = setMaskingFunction; exports.spanComponentsToObjectId = spanComponentsToObjectId; exports.startSpan = startSpan; exports.summarize = summarize; exports.toolFunctionDefinitionSchema = ToolFunctionDefinition; exports.traceable = traceable; exports.traced = traced; exports.updateSpan = updateSpan; exports.withCurrent = withCurrent; exports.withDataset = withDataset; exports.withExperiment = withExperiment; exports.withLogger = withLogger; exports.withParent = withParent; exports.wrapAISDK = wrapAISDK; exports.wrapAISDKModel = wrapAISDKModel; exports.wrapAnthropic = wrapAnthropic; exports.wrapClaudeAgentSDK = wrapClaudeAgentSDK; exports.wrapGoogleGenAI = wrapGoogleGenAI; exports.wrapMastraAgent = wrapMastraAgent; exports.wrapOpenAI = wrapOpenAI; exports.wrapOpenAIv4 = wrapOpenAIv4; exports.wrapTraced = wrapTraced;

package/dist/index.mjs

@@ -10026,6 +10026,7 @@ __export(exports_node_exports, {
   login: () => login,
   loginToState: () => loginToState,
   newId: () => newId,
+  otel: () => otel,
   parseCachedHeader: () => parseCachedHeader,
   permalink: () => permalink,
   projects: () => projects,
@@ -15523,6 +15524,8 @@ function tryToDict(obj) {
 }
 
 // src/otel.ts
+init_span_identifier_v4();
+init_span_identifier_v3();
 var otelApi = null;
 var otelSdk = null;
 var OTEL_AVAILABLE2 = false;
@@ -15776,6 +15779,80 @@ var BraintrustSpanProcessor = class _BraintrustSpanProcessor {
     return this.aiSpanProcessor.forceFlush();
   }
 };
+function otelContextFromSpanExport(exportStr) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    return void 0;
+  }
+  const components = SpanComponentsV4.fromStr(exportStr);
+  const traceIdHex = components.data.root_span_id;
+  const spanIdHex = components.data.span_id;
+  if (!traceIdHex || !spanIdHex) {
+    throw new Error(
+      "Export string must contain root_span_id and span_id for distributed tracing"
+    );
+  }
+  const otelTrace2 = otelApi.trace;
+  const spanContext = {
+    traceId: traceIdHex,
+    spanId: spanIdHex,
+    isRemote: true,
+    traceFlags: otelApi.TraceFlags?.SAMPLED ?? 1
+    // SAMPLED flag
+  };
+  const nonRecordingSpan = otelTrace2.wrapSpanContext(spanContext);
+  let ctx = otelTrace2.setSpan(otelApi.context.active(), nonRecordingSpan);
+  const braintrustParent = getBraintrustParent(
+    components.data.object_type,
+    components.data.object_id,
+    components.data.compute_object_metadata_args
+  );
+  if (braintrustParent) {
+    try {
+      const propagation2 = otelApi.propagation;
+      if (propagation2) {
+        const baggage = propagation2.getBaggage(ctx) || propagation2.createBaggage();
+        ctx = propagation2.setBaggage(
+          ctx,
+          baggage.setEntry("braintrust.parent", { value: braintrustParent })
+        );
+      }
+    } catch (error2) {
+      console.error(
+        "Failed to set braintrust.parent in baggage during context import:",
+        error2
+      );
+    }
+  }
+  return ctx;
+}
+function getBraintrustParent(objectType, objectId, computeArgs) {
+  if (!objectType) {
+    return void 0;
+  }
+  if (objectType === 2 /* PROJECT_LOGS */) {
+    if (objectId) {
+      return `project_id:${objectId}`;
+    } else if (computeArgs) {
+      const projectId = computeArgs["project_id"];
+      const projectName = computeArgs["project_name"];
+      if (typeof projectId === "string") {
+        return `project_id:${projectId}`;
+      } else if (typeof projectName === "string") {
+        return `project_name:${projectName}`;
+      }
+    }
+  } else if (objectType === 1 /* EXPERIMENT */) {
+    if (objectId) {
+      return `experiment_id:${objectId}`;
+    } else if (computeArgs) {
+      const experimentId = computeArgs["experiment_id"];
+      if (typeof experimentId === "string") {
+        return `experiment_id:${experimentId}`;
+      }
+    }
+  }
+  return void 0;
+}
 var BraintrustExporter = class _BraintrustExporter {
   static checkOtelAvailable() {
     if (!OTEL_AVAILABLE2) {
@@ -15821,6 +15898,140 @@ var BraintrustExporter = class _BraintrustExporter {
     return this.processor.forceFlush();
   }
 };
+function addParentToBaggage(parent, ctx) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    console.error("OpenTelemetry not available");
+    return ctx || otelApi?.context.active();
+  }
+  try {
+    const propagation2 = otelApi.propagation;
+    if (!propagation2) {
+      console.error("OTEL propagation API not available");
+      return ctx || otelApi.context.active();
+    }
+    const currentCtx = ctx || otelApi.context.active();
+    const baggage = propagation2.getBaggage(currentCtx) || propagation2.createBaggage();
+    return propagation2.setBaggage(
+      currentCtx,
+      baggage.setEntry("braintrust.parent", { value: parent })
+    );
+  } catch (error2) {
+    console.error("Failed to add braintrust.parent to baggage:", error2);
+    return ctx || otelApi.context.active();
+  }
+}
+function addSpanParentToBaggage(span, ctx) {
+  if (!span || !span.attributes) {
+    console.warn("addSpanParentToBaggage: span has no attributes");
+    return void 0;
+  }
+  const parentValue = span.attributes["braintrust.parent"];
+  if (!parentValue || typeof parentValue !== "string") {
+    console.warn(
+      "addSpanParentToBaggage: braintrust.parent attribute not found. Ensure BraintrustSpanProcessor is configured or span is created within Braintrust context."
+    );
+    return void 0;
+  }
+  return addParentToBaggage(parentValue, ctx);
+}
+function parentFromHeaders(headers) {
+  if (!OTEL_AVAILABLE2 || !otelApi) {
+    console.error("OpenTelemetry not available");
+    return void 0;
+  }
+  try {
+    const propagation2 = otelApi.propagation;
+    if (!propagation2) {
+      console.error("OTEL propagation API not available");
+      return void 0;
+    }
+    const ctx = propagation2.extract(otelApi.context.active(), headers);
+    const spanContext = otelApi.trace.getSpanContext(ctx);
+    if (!spanContext) {
+      console.error("parentFromHeaders: No valid span context in headers");
+      return void 0;
+    }
+    const traceIdHex = spanContext.traceId;
+    const spanIdHex = spanContext.spanId;
+    if (!traceIdHex || typeof traceIdHex !== "string" || traceIdHex === "00000000000000000000000000000000") {
+      console.error("parentFromHeaders: Invalid trace_id (all zeros)");
+      return void 0;
+    }
+    if (!spanIdHex || typeof spanIdHex !== "string" || spanIdHex === "0000000000000000") {
+      console.error("parentFromHeaders: Invalid span_id (all zeros)");
+      return void 0;
+    }
+    const baggage = propagation2.getBaggage(ctx);
+    const braintrustParent = baggage?.getEntry("braintrust.parent")?.value;
+    if (!braintrustParent) {
+      console.warn(
+        "parentFromHeaders: braintrust.parent not found in OTEL baggage. Cannot create Braintrust parent without project information. Ensure the OTEL span sets braintrust.parent in baggage before exporting headers."
+      );
+      return void 0;
+    }
+    let objectType;
+    let objectId;
+    let computeArgs;
+    if (braintrustParent.startsWith("project_id:")) {
+      objectType = 2 /* PROJECT_LOGS */;
+      objectId = braintrustParent.substring("project_id:".length);
+      if (!objectId) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty project_id): ${braintrustParent}`
+        );
+        return void 0;
+      }
+    } else if (braintrustParent.startsWith("project_name:")) {
+      objectType = 2 /* PROJECT_LOGS */;
+      const projectName = braintrustParent.substring("project_name:".length);
+      if (!projectName) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty project_name): ${braintrustParent}`
+        );
+        return void 0;
+      }
+      computeArgs = { project_name: projectName };
+    } else if (braintrustParent.startsWith("experiment_id:")) {
+      objectType = 1 /* EXPERIMENT */;
+      objectId = braintrustParent.substring("experiment_id:".length);
+      if (!objectId) {
+        console.error(
+          `parentFromHeaders: Invalid braintrust.parent format (empty experiment_id): ${braintrustParent}`
+        );
+        return void 0;
+      }
+    } else {
+      console.error(
+        `parentFromHeaders: Invalid braintrust.parent format: ${braintrustParent}. Expected format: 'project_id:ID', 'project_name:NAME', or 'experiment_id:ID'`
+      );
+      return void 0;
+    }
+    const componentsData = {
+      object_type: objectType,
+      row_id: "otel",
+      // Dummy row_id to enable span_id/root_span_id fields
+      span_id: spanIdHex,
+      root_span_id: traceIdHex
+    };
+    if (computeArgs) {
+      componentsData.compute_object_metadata_args = computeArgs;
+    } else {
+      componentsData.object_id = objectId;
+    }
+    const components = new SpanComponentsV4(componentsData);
+    return components.toStr();
+  } catch (error2) {
+    console.error("parentFromHeaders: Error parsing headers:", error2);
+    return void 0;
+  }
+}
+var otel = {
+  contextFromSpanExport: otelContextFromSpanExport,
+  getBraintrustParent,
+  addParentToBaggage,
+  addSpanParentToBaggage,
+  parentFromHeaders
+};
 
 // dev/types.ts
 init_generated_types();
@@ -15945,6 +16156,7 @@ export {
   login,
   loginToState,
   newId,
+  otel,
   parseCachedHeader,
   permalink,
   projects,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "braintrust",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "SDK for integrating Braintrust",
   "repository": {
     "type": "git",
@@ -56,12 +56,17 @@
     "watch": "tsup --watch",
     "clean": "rm -r dist/* && rm -r dev/dist/*",
     "docs": "npx typedoc --options typedoc.json src/index.ts",
-    "test": "vitest run --exclude src/wrappers/anthropic.test.ts --exclude src/wrappers/oai.test.ts --exclude src/otel.test.ts --exclude src/otel-no-deps.test.ts  --exclude src/wrappers/google-genai.test.ts",
+    "test": "vitest run --exclude \"src/wrappers/**/*.test.ts\" --exclude \"src/otel/**/*.test.ts\"",
     "test:anthropic": "vitest run src/wrappers/anthropic.test.ts",
     "test:openai": "vitest run src/wrappers/oai.test.ts",
-    "test:otel": "vitest run src/otel.test.ts",
+    "test:otel": "vitest run --dir src/otel",
+    "test:otel-no-deps": "vitest run src/otel-no-deps.test.ts --reporter=verbose",
     "test:google-genai": "vitest run src/wrappers/google-genai.test.ts",
-    "test:otel-no-deps": "vitest run src/otel-no-deps.test.ts --reporter=verbose"
+    "test:ai-sdk-v1": "vitest run src/wrappers/ai-sdk-v1.test.ts",
+    "test:ai-sdk-v2": "vitest run src/wrappers/ai-sdk-v2.test.ts src/wrappers/ai-sdk-v1.test.ts",
+    "test:ai-sdk-v3": "vitest run src/wrappers/ai-sdk-v3.test.ts",
+    "test:mastra": "vitest run src/wrappers/mastra.test.ts",
+    "test:claude-agent-sdk": "vitest run src/wrappers/claude-agent-sdk.test.ts"
   },
   "author": "",
   "license": "MIT",