braintrust 0.3.7 → 0.4.0

package/dist/index.d.mts

@@ -1,6 +1,48 @@
 import { z } from 'zod/v3';
 import { z as z$1 } from 'zod';
 
+/**
+ * Abstract base class for ID generators
+ */
+declare abstract class IDGenerator {
+    /**
+     * Generate a span ID
+     */
+    abstract getSpanId(): string;
+    /**
+     * Generate a trace ID
+     */
+    abstract getTraceId(): string;
+    /**
+     * Return true if the generator should use span_id as root_span_id for backwards compatibility
+     */
+    abstract shareRootSpanId(): boolean;
+}
+/**
+ * ID generator that uses UUID4 for both span and trace IDs
+ */
+declare class UUIDGenerator extends IDGenerator {
+    getSpanId(): string;
+    getTraceId(): string;
+    shareRootSpanId(): boolean;
+}
+/**
+ * ID generator that generates OpenTelemetry-compatible IDs
+ * Uses hex strings for compatibility with OpenTelemetry systems
+ */
+declare class OTELIDGenerator extends IDGenerator {
+    getSpanId(): string;
+    getTraceId(): string;
+    shareRootSpanId(): boolean;
+}
+/**
+ * Factory function that creates a new ID generator instance each time.
+ *
+ * This eliminates global state and makes tests parallelizable.
+ * Each caller gets their own generator instance.
+ */
+declare function getIdGenerator(): IDGenerator;
+
 declare const TRANSACTION_ID_FIELD = "_xact_id";
 declare const IS_MERGE_FIELD = "_is_merge";
 declare const MERGE_PATHS_FIELD = "_merge_paths";
@@ -14456,6 +14498,7 @@ declare class NoopSpan implements Span$1 {
     setAttributes(_args: Omit<StartSpanArgs, "event">): void;
     startSpanWithParents(_spanId: string, _spanParents: string[], _args?: StartSpanArgs): Span$1;
     state(): BraintrustState;
+    toString(): string;
 }
 declare const NOOP_SPAN: NoopSpan;
 declare const NOOP_SPAN_PERMALINK = "https://braintrust.dev/noop-span";
@@ -14529,8 +14572,11 @@ declare class BraintrustState {
     private _apiConn;
     private _proxyConn;
     promptCache: PromptCache;
+    private _idGenerator;
     constructor(loginParams: LoginOptions);
     resetLoginInfo(): void;
+    resetIdGenState(): void;
+    get idGenerator(): IDGenerator;
     copyLoginInfo(other: BraintrustState): void;
     serialize(): SerializedBraintrustState;
     static deserialize(serialized: unknown, opts?: LoginOptions): BraintrustState;
@@ -14548,6 +14594,8 @@ declare class BraintrustState {
     loginReplaceApiConn(apiConn: HTTPConnection): void;
     disable(): void;
     enforceQueueSizeLimit(enforce: boolean): void;
+    toJSON(): Record<string, any>;
+    toString(): string;
 }
 declare function useTestBackgroundLogger(): TestBackgroundLogger;
 declare function clearTestBackgroundLogger(): void;
@@ -14584,6 +14632,7 @@ declare class HTTPConnection {
     post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
     get_json(object_type: string, args?: Record<string, string | string[] | undefined> | undefined, retries?: number): Promise<any>;
     post_json(object_type: string, args?: Record<string, unknown> | string | undefined): Promise<any>;
+    toString(): string;
 }
 interface ObjectMetadata {
     id: string;
@@ -15567,6 +15616,7 @@ declare class SpanImpl implements Span$1 {
     flush(): Promise<void>;
     close(args?: EndSpanArgs): number;
     state(): BraintrustState;
+    toString(): string;
 }
 /**
  * A dataset is a collection of records, such as model inputs and expected outputs, which represent
@@ -15838,6 +15888,7 @@ declare function simulateLogoutForTests(): BraintrustState;
  * @returns Promise containing the version data
  */
 declare function getPromptVersions(projectId: string, promptId: string): Promise<any>;
+declare function resetIdGenStateForTests(): void;
 declare const _exportsForTestingOnly: {
     extractAttachments: typeof extractAttachments;
     deepCopyEvent: typeof deepCopyEvent;
@@ -15849,6 +15900,7 @@ declare const _exportsForTestingOnly: {
     initTestExperiment: typeof initTestExperiment;
     isGeneratorFunction: typeof isGeneratorFunction;
     isAsyncGeneratorFunction: typeof isAsyncGeneratorFunction;
+    resetIdGenStateForTests: typeof resetIdGenStateForTests;
 };
 
 declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
@@ -21236,6 +21288,44 @@ declare function wrapAISDK<T extends AISDKMethods>(ai: T): {
     streamObject: T["streamObject"];
 };
 
+interface MastraAgentMethods {
+    name?: string;
+    tools?: Record<string, unknown> | unknown[];
+    model?: any;
+    __setTools(tools: Record<string, unknown> | unknown[]): void;
+    generateVNext?: (params: any) => any;
+    streamVNext?: (params: any) => any;
+}
+/**
+ * Wraps a Mastra agent with Braintrust tracing. This function wraps the agent's
+ * underlying language model with BraintrustMiddleware and traces all agent method calls.
+ *
+ * **Important**: This wrapper only supports AI SDK v5 methods such as `generateVNext` and `streamVNext`.
+ *
+ * @param agent - The Mastra agent to wrap
+ * @param options - Optional configuration for the wrapper
+ * @returns The wrapped agent with Braintrust tracing
+ *
+ * @example
+ * ```typescript
+ * import { wrapMastraAgent } from "braintrust";
+ * import { Agent } from "@mastra/core/agent";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const agent = new Agent({
+ *   name: "Assistant",
+ *   model: openai("gpt-4"),
+ *   instructions: "You are a helpful assistant."
+ * });
+ *
+ * const wrappedAgent = wrapMastraAgent(agent);
+ * ```
+ */
+declare function wrapMastraAgent<T extends MastraAgentMethods>(agent: T, options?: {
+    name?: string;
+    span_name?: string;
+}): T;
+
 /**
  * Wrap an `Anthropic` object (created with `new Anthropic(...)`) to add tracing. If Braintrust is
  * not configured, nothing will be traced. If this is not an `Anthropic` object, this function is
@@ -21248,6 +21338,35 @@ declare function wrapAISDK<T extends AISDKMethods>(ai: T): {
  */
 declare function wrapAnthropic<T extends object>(anthropic: T): T;
 
+/**
+ * Wraps the Claude Agent SDK with Braintrust tracing. This returns wrapped versions
+ * of query and tool that automatically trace all agent interactions.
+ *
+ * @param sdk - The Claude Agent SDK module
+ * @returns Object with wrapped query, tool, and createSdkMcpServer functions
+ *
+ * @example
+ * ```typescript
+ * import * as claudeSDK from "@anthropic-ai/claude-agent-sdk";
+ * import { wrapClaudeAgentSDK } from "braintrust";
+ *
+ * // Wrap once - returns { query, tool, createSdkMcpServer } with tracing built-in
+ * const { query, tool, createSdkMcpServer } = wrapClaudeAgentSDK(claudeSDK);
+ *
+ * // Use normally - tracing is automatic
+ * for await (const message of query({
+ *   prompt: "Hello, Claude!",
+ *   options: { model: "claude-3-5-sonnet-20241022" }
+ * })) {
+ *   console.log(message);
+ * }
+ *
+ * // Tools created with wrapped tool() are automatically traced
+ * const calculator = tool("calculator", "Does math", schema, handler);
+ * ```
+ */
+declare function wrapClaudeAgentSDK<T extends object>(sdk: T): T;
+
 interface Context {
     [key: string]: any;
 }
@@ -21539,6 +21658,8 @@ declare const braintrust_FailedHTTPResponse: typeof FailedHTTPResponse;
 type braintrust_FullInitOptions<IsOpen extends boolean> = FullInitOptions<IsOpen>;
 type braintrust_FullLoginOptions = FullLoginOptions;
 type braintrust_FunctionEvent = FunctionEvent;
+type braintrust_IDGenerator = IDGenerator;
+declare const braintrust_IDGenerator: typeof IDGenerator;
 declare const braintrust_INTERNAL_BTQL_LIMIT: typeof INTERNAL_BTQL_LIMIT;
 type braintrust_InitOptions<IsOpen extends boolean> = InitOptions<IsOpen>;
 type braintrust_InvokeFunctionArgs<Input, Output, Stream extends boolean = false> = InvokeFunctionArgs<Input, Output, Stream>;
@@ -21555,6 +21676,8 @@ declare const braintrust_NOOP_SPAN: typeof NOOP_SPAN;
 declare const braintrust_NOOP_SPAN_PERMALINK: typeof NOOP_SPAN_PERMALINK;
 type braintrust_NoopSpan = NoopSpan;
 declare const braintrust_NoopSpan: typeof NoopSpan;
+type braintrust_OTELIDGenerator = OTELIDGenerator;
+declare const braintrust_OTELIDGenerator: typeof OTELIDGenerator;
 type braintrust_ObjectMetadata = ObjectMetadata;
 type braintrust_Project = Project;
 declare const braintrust_Project: typeof Project;
@@ -21590,6 +21713,8 @@ type braintrust_TestBackgroundLogger = TestBackgroundLogger;
 declare const braintrust_TestBackgroundLogger: typeof TestBackgroundLogger;
 type braintrust_ToolBuilder = ToolBuilder;
 declare const braintrust_ToolBuilder: typeof ToolBuilder;
+type braintrust_UUIDGenerator = UUIDGenerator;
+declare const braintrust_UUIDGenerator: typeof UUIDGenerator;
 type braintrust_WithTransactionId<R> = WithTransactionId<R>;
 declare const braintrust_X_CACHED_HEADER: typeof X_CACHED_HEADER;
 declare const braintrust__exportsForTestingOnly: typeof _exportsForTestingOnly;
@@ -21601,10 +21726,12 @@ declare const braintrust_createFinalValuePassThroughStream: typeof createFinalVa
 declare const braintrust_currentExperiment: typeof currentExperiment;
 declare const braintrust_currentLogger: typeof currentLogger;
 declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_deepCopyEvent: typeof deepCopyEvent;
 declare const braintrust_defaultErrorScoreHandler: typeof defaultErrorScoreHandler;
 declare const braintrust_deserializePlainStringAsJSON: typeof deserializePlainStringAsJSON;
 declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
 declare const braintrust_flush: typeof flush;
+declare const braintrust_getIdGenerator: typeof getIdGenerator;
 declare const braintrust_getPromptVersions: typeof getPromptVersions;
 declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
 declare const braintrust_init: typeof init;
@@ -21646,11 +21773,13 @@ declare const braintrust_withParent: typeof withParent;
 declare const braintrust_wrapAISDK: typeof wrapAISDK;
 declare const braintrust_wrapAISDKModel: typeof wrapAISDKModel;
 declare const braintrust_wrapAnthropic: typeof wrapAnthropic;
+declare const braintrust_wrapClaudeAgentSDK: typeof wrapClaudeAgentSDK;
+declare const braintrust_wrapMastraAgent: typeof wrapMastraAgent;
 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, 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_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, 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, 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, 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_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, 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_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, 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_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_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_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
 type EvaluatorManifest = Record<string, EvaluatorDef<unknown, unknown, unknown, BaseMetadata>>;
@@ -28707,4 +28836,4 @@ type EvaluatorDefinitions = z.infer<typeof evaluatorDefinitionsSchema>;
  * @module braintrust
  */
 
-export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, 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, 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, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, 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, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, 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, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, 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, 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, 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, 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, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };

package/dist/index.d.ts

@@ -1,6 +1,48 @@
 import { z } from 'zod/v3';
 import { z as z$1 } from 'zod';
 
+/**
+ * Abstract base class for ID generators
+ */
+declare abstract class IDGenerator {
+    /**
+     * Generate a span ID
+     */
+    abstract getSpanId(): string;
+    /**
+     * Generate a trace ID
+     */
+    abstract getTraceId(): string;
+    /**
+     * Return true if the generator should use span_id as root_span_id for backwards compatibility
+     */
+    abstract shareRootSpanId(): boolean;
+}
+/**
+ * ID generator that uses UUID4 for both span and trace IDs
+ */
+declare class UUIDGenerator extends IDGenerator {
+    getSpanId(): string;
+    getTraceId(): string;
+    shareRootSpanId(): boolean;
+}
+/**
+ * ID generator that generates OpenTelemetry-compatible IDs
+ * Uses hex strings for compatibility with OpenTelemetry systems
+ */
+declare class OTELIDGenerator extends IDGenerator {
+    getSpanId(): string;
+    getTraceId(): string;
+    shareRootSpanId(): boolean;
+}
+/**
+ * Factory function that creates a new ID generator instance each time.
+ *
+ * This eliminates global state and makes tests parallelizable.
+ * Each caller gets their own generator instance.
+ */
+declare function getIdGenerator(): IDGenerator;
+
 declare const TRANSACTION_ID_FIELD = "_xact_id";
 declare const IS_MERGE_FIELD = "_is_merge";
 declare const MERGE_PATHS_FIELD = "_merge_paths";
@@ -14456,6 +14498,7 @@ declare class NoopSpan implements Span$1 {
     setAttributes(_args: Omit<StartSpanArgs, "event">): void;
     startSpanWithParents(_spanId: string, _spanParents: string[], _args?: StartSpanArgs): Span$1;
     state(): BraintrustState;
+    toString(): string;
 }
 declare const NOOP_SPAN: NoopSpan;
 declare const NOOP_SPAN_PERMALINK = "https://braintrust.dev/noop-span";
@@ -14529,8 +14572,11 @@ declare class BraintrustState {
     private _apiConn;
     private _proxyConn;
     promptCache: PromptCache;
+    private _idGenerator;
     constructor(loginParams: LoginOptions);
     resetLoginInfo(): void;
+    resetIdGenState(): void;
+    get idGenerator(): IDGenerator;
     copyLoginInfo(other: BraintrustState): void;
     serialize(): SerializedBraintrustState;
     static deserialize(serialized: unknown, opts?: LoginOptions): BraintrustState;
@@ -14548,6 +14594,8 @@ declare class BraintrustState {
     loginReplaceApiConn(apiConn: HTTPConnection): void;
     disable(): void;
     enforceQueueSizeLimit(enforce: boolean): void;
+    toJSON(): Record<string, any>;
+    toString(): string;
 }
 declare function useTestBackgroundLogger(): TestBackgroundLogger;
 declare function clearTestBackgroundLogger(): void;
@@ -14584,6 +14632,7 @@ declare class HTTPConnection {
     post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
     get_json(object_type: string, args?: Record<string, string | string[] | undefined> | undefined, retries?: number): Promise<any>;
     post_json(object_type: string, args?: Record<string, unknown> | string | undefined): Promise<any>;
+    toString(): string;
 }
 interface ObjectMetadata {
     id: string;
@@ -15567,6 +15616,7 @@ declare class SpanImpl implements Span$1 {
     flush(): Promise<void>;
     close(args?: EndSpanArgs): number;
     state(): BraintrustState;
+    toString(): string;
 }
 /**
  * A dataset is a collection of records, such as model inputs and expected outputs, which represent
@@ -15838,6 +15888,7 @@ declare function simulateLogoutForTests(): BraintrustState;
  * @returns Promise containing the version data
  */
 declare function getPromptVersions(projectId: string, promptId: string): Promise<any>;
+declare function resetIdGenStateForTests(): void;
 declare const _exportsForTestingOnly: {
     extractAttachments: typeof extractAttachments;
     deepCopyEvent: typeof deepCopyEvent;
@@ -15849,6 +15900,7 @@ declare const _exportsForTestingOnly: {
     initTestExperiment: typeof initTestExperiment;
     isGeneratorFunction: typeof isGeneratorFunction;
     isAsyncGeneratorFunction: typeof isAsyncGeneratorFunction;
+    resetIdGenStateForTests: typeof resetIdGenStateForTests;
 };
 
 declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
@@ -21236,6 +21288,44 @@ declare function wrapAISDK<T extends AISDKMethods>(ai: T): {
     streamObject: T["streamObject"];
 };
 
+interface MastraAgentMethods {
+    name?: string;
+    tools?: Record<string, unknown> | unknown[];
+    model?: any;
+    __setTools(tools: Record<string, unknown> | unknown[]): void;
+    generateVNext?: (params: any) => any;
+    streamVNext?: (params: any) => any;
+}
+/**
+ * Wraps a Mastra agent with Braintrust tracing. This function wraps the agent's
+ * underlying language model with BraintrustMiddleware and traces all agent method calls.
+ *
+ * **Important**: This wrapper only supports AI SDK v5 methods such as `generateVNext` and `streamVNext`.
+ *
+ * @param agent - The Mastra agent to wrap
+ * @param options - Optional configuration for the wrapper
+ * @returns The wrapped agent with Braintrust tracing
+ *
+ * @example
+ * ```typescript
+ * import { wrapMastraAgent } from "braintrust";
+ * import { Agent } from "@mastra/core/agent";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const agent = new Agent({
+ *   name: "Assistant",
+ *   model: openai("gpt-4"),
+ *   instructions: "You are a helpful assistant."
+ * });
+ *
+ * const wrappedAgent = wrapMastraAgent(agent);
+ * ```
+ */
+declare function wrapMastraAgent<T extends MastraAgentMethods>(agent: T, options?: {
+    name?: string;
+    span_name?: string;
+}): T;
+
 /**
  * Wrap an `Anthropic` object (created with `new Anthropic(...)`) to add tracing. If Braintrust is
  * not configured, nothing will be traced. If this is not an `Anthropic` object, this function is
@@ -21248,6 +21338,35 @@ declare function wrapAISDK<T extends AISDKMethods>(ai: T): {
  */
 declare function wrapAnthropic<T extends object>(anthropic: T): T;
 
+/**
+ * Wraps the Claude Agent SDK with Braintrust tracing. This returns wrapped versions
+ * of query and tool that automatically trace all agent interactions.
+ *
+ * @param sdk - The Claude Agent SDK module
+ * @returns Object with wrapped query, tool, and createSdkMcpServer functions
+ *
+ * @example
+ * ```typescript
+ * import * as claudeSDK from "@anthropic-ai/claude-agent-sdk";
+ * import { wrapClaudeAgentSDK } from "braintrust";
+ *
+ * // Wrap once - returns { query, tool, createSdkMcpServer } with tracing built-in
+ * const { query, tool, createSdkMcpServer } = wrapClaudeAgentSDK(claudeSDK);
+ *
+ * // Use normally - tracing is automatic
+ * for await (const message of query({
+ *   prompt: "Hello, Claude!",
+ *   options: { model: "claude-3-5-sonnet-20241022" }
+ * })) {
+ *   console.log(message);
+ * }
+ *
+ * // Tools created with wrapped tool() are automatically traced
+ * const calculator = tool("calculator", "Does math", schema, handler);
+ * ```
+ */
+declare function wrapClaudeAgentSDK<T extends object>(sdk: T): T;
+
 interface Context {
     [key: string]: any;
 }
@@ -21539,6 +21658,8 @@ declare const braintrust_FailedHTTPResponse: typeof FailedHTTPResponse;
 type braintrust_FullInitOptions<IsOpen extends boolean> = FullInitOptions<IsOpen>;
 type braintrust_FullLoginOptions = FullLoginOptions;
 type braintrust_FunctionEvent = FunctionEvent;
+type braintrust_IDGenerator = IDGenerator;
+declare const braintrust_IDGenerator: typeof IDGenerator;
 declare const braintrust_INTERNAL_BTQL_LIMIT: typeof INTERNAL_BTQL_LIMIT;
 type braintrust_InitOptions<IsOpen extends boolean> = InitOptions<IsOpen>;
 type braintrust_InvokeFunctionArgs<Input, Output, Stream extends boolean = false> = InvokeFunctionArgs<Input, Output, Stream>;
@@ -21555,6 +21676,8 @@ declare const braintrust_NOOP_SPAN: typeof NOOP_SPAN;
 declare const braintrust_NOOP_SPAN_PERMALINK: typeof NOOP_SPAN_PERMALINK;
 type braintrust_NoopSpan = NoopSpan;
 declare const braintrust_NoopSpan: typeof NoopSpan;
+type braintrust_OTELIDGenerator = OTELIDGenerator;
+declare const braintrust_OTELIDGenerator: typeof OTELIDGenerator;
 type braintrust_ObjectMetadata = ObjectMetadata;
 type braintrust_Project = Project;
 declare const braintrust_Project: typeof Project;
@@ -21590,6 +21713,8 @@ type braintrust_TestBackgroundLogger = TestBackgroundLogger;
 declare const braintrust_TestBackgroundLogger: typeof TestBackgroundLogger;
 type braintrust_ToolBuilder = ToolBuilder;
 declare const braintrust_ToolBuilder: typeof ToolBuilder;
+type braintrust_UUIDGenerator = UUIDGenerator;
+declare const braintrust_UUIDGenerator: typeof UUIDGenerator;
 type braintrust_WithTransactionId<R> = WithTransactionId<R>;
 declare const braintrust_X_CACHED_HEADER: typeof X_CACHED_HEADER;
 declare const braintrust__exportsForTestingOnly: typeof _exportsForTestingOnly;
@@ -21601,10 +21726,12 @@ declare const braintrust_createFinalValuePassThroughStream: typeof createFinalVa
 declare const braintrust_currentExperiment: typeof currentExperiment;
 declare const braintrust_currentLogger: typeof currentLogger;
 declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_deepCopyEvent: typeof deepCopyEvent;
 declare const braintrust_defaultErrorScoreHandler: typeof defaultErrorScoreHandler;
 declare const braintrust_deserializePlainStringAsJSON: typeof deserializePlainStringAsJSON;
 declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
 declare const braintrust_flush: typeof flush;
+declare const braintrust_getIdGenerator: typeof getIdGenerator;
 declare const braintrust_getPromptVersions: typeof getPromptVersions;
 declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
 declare const braintrust_init: typeof init;
@@ -21646,11 +21773,13 @@ declare const braintrust_withParent: typeof withParent;
 declare const braintrust_wrapAISDK: typeof wrapAISDK;
 declare const braintrust_wrapAISDKModel: typeof wrapAISDKModel;
 declare const braintrust_wrapAnthropic: typeof wrapAnthropic;
+declare const braintrust_wrapClaudeAgentSDK: typeof wrapClaudeAgentSDK;
+declare const braintrust_wrapMastraAgent: typeof wrapMastraAgent;
 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, 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_INTERNAL_BTQL_LIMIT as INTERNAL_BTQL_LIMIT, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, 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, 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, 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_defaultErrorScoreHandler as defaultErrorScoreHandler, braintrust_deserializePlainStringAsJSON as deserializePlainStringAsJSON, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, 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_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, 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_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_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_wrapMastraAgent as wrapMastraAgent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
 type EvaluatorManifest = Record<string, EvaluatorDef<unknown, unknown, unknown, BaseMetadata>>;
@@ -28707,4 +28836,4 @@ type EvaluatorDefinitions = z.infer<typeof evaluatorDefinitionsSchema>;
  * @module braintrust
  */
 
-export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, 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, 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, INTERNAL_BTQL_LIMIT, type IdField, type InitOptions, type InputField, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, LazyValue, type LogCommentFullArgs, type LogFeedbackFullArgs, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, 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, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, buildLocalSummary, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, defaultErrorScoreHandler, deserializePlainStringAsJSON, devNullWritableStream, evaluatorDefinitionSchema, evaluatorDefinitionsSchema, flush, 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, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, 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, 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, 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, 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, wrapMastraAgent, wrapOpenAI, wrapOpenAIv4, wrapTraced };