braintrust 3.7.0 → 3.7.1

package/dist/index.d.mts

@@ -15756,7 +15756,7 @@ interface IsoTracingChannel<M = any> extends IsoTracingChannelCollection<M> {
     subscribe(handlers: IsoChannelHandlers<M>): void;
     unsubscribe(handlers: IsoChannelHandlers<M>): boolean;
     traceSync<F extends (...args: any[]) => any>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
-    tracePromise<F extends (...args: any[]) => any>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): Promise<Awaited<ReturnType<F>>>;
+    tracePromise<F extends (...args: any[]) => PromiseLike<any>>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
     traceCallback<F extends (...args: any[]) => any>(fn: F, position?: number, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
 }
 interface IsoChannelHandlers<M = any> {
@@ -20988,12 +20988,10 @@ interface WrapAISDKOptions {
     denyOutputPaths?: string[];
 }
 /**
- * Wraps Vercel AI SDK methods with Braintrust tracing. Returns wrapped versions
- * of generateText, streamText, generateObject, streamObject, Agent, experimental_Agent,
- * and ToolLoopAgent that automatically create spans and log inputs, outputs, and metrics.
+ * Wraps Vercel AI SDK methods with Braintrust tracing.
  *
  * @param ai - The AI SDK namespace (e.g., import * as ai from "ai")
- * @returns Object with AI SDK methods with Braintrust tracing
+ * @returns AI SDK with Braintrust tracing.
  *
  * @example
  * ```typescript
@@ -21074,9 +21072,8 @@ interface MiddlewareConfig {
 declare function BraintrustMiddleware(config?: MiddlewareConfig): LanguageModelV2Middleware<any, any>;
 
 /**
- * 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
- * a no-op.
+ * Wrap an `Anthropic` object (created with `new Anthropic(...)`) so calls emit
+ * tracing-channel events that Braintrust plugins can consume.
  *
  * Currently, this only supports the `v4` API.
  *
@@ -21094,31 +21091,12 @@ declare function wrapMastraAgent<T>(agent: T, _options?: {
 }): T;
 
 /**
- * Wraps the Claude Agent SDK with Braintrust tracing. This returns wrapped versions
- * of query and tool that automatically trace all agent interactions.
+ * Wraps the Claude Agent SDK with Braintrust tracing. Query calls only publish
+ * tracing-channel events; the Claude Agent SDK plugin owns all span lifecycle
+ * work, including root/task spans, LLM spans, tool spans, and sub-agent spans.
  *
  * @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-haiku-4-5-20251001" }
- * })) {
- *   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;
 

package/dist/index.d.ts

@@ -15756,7 +15756,7 @@ interface IsoTracingChannel<M = any> extends IsoTracingChannelCollection<M> {
     subscribe(handlers: IsoChannelHandlers<M>): void;
     unsubscribe(handlers: IsoChannelHandlers<M>): boolean;
     traceSync<F extends (...args: any[]) => any>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
-    tracePromise<F extends (...args: any[]) => any>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): Promise<Awaited<ReturnType<F>>>;
+    tracePromise<F extends (...args: any[]) => PromiseLike<any>>(fn: F, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
     traceCallback<F extends (...args: any[]) => any>(fn: F, position?: number, message?: M, thisArg?: ThisParameterType<F>, ...args: Parameters<F>): ReturnType<F>;
 }
 interface IsoChannelHandlers<M = any> {
@@ -20988,12 +20988,10 @@ interface WrapAISDKOptions {
     denyOutputPaths?: string[];
 }
 /**
- * Wraps Vercel AI SDK methods with Braintrust tracing. Returns wrapped versions
- * of generateText, streamText, generateObject, streamObject, Agent, experimental_Agent,
- * and ToolLoopAgent that automatically create spans and log inputs, outputs, and metrics.
+ * Wraps Vercel AI SDK methods with Braintrust tracing.
  *
  * @param ai - The AI SDK namespace (e.g., import * as ai from "ai")
- * @returns Object with AI SDK methods with Braintrust tracing
+ * @returns AI SDK with Braintrust tracing.
  *
  * @example
  * ```typescript
@@ -21074,9 +21072,8 @@ interface MiddlewareConfig {
 declare function BraintrustMiddleware(config?: MiddlewareConfig): LanguageModelV2Middleware<any, any>;
 
 /**
- * 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
- * a no-op.
+ * Wrap an `Anthropic` object (created with `new Anthropic(...)`) so calls emit
+ * tracing-channel events that Braintrust plugins can consume.
  *
  * Currently, this only supports the `v4` API.
  *
@@ -21094,31 +21091,12 @@ declare function wrapMastraAgent<T>(agent: T, _options?: {
 }): T;
 
 /**
- * Wraps the Claude Agent SDK with Braintrust tracing. This returns wrapped versions
- * of query and tool that automatically trace all agent interactions.
+ * Wraps the Claude Agent SDK with Braintrust tracing. Query calls only publish
+ * tracing-channel events; the Claude Agent SDK plugin owns all span lifecycle
+ * work, including root/task spans, LLM spans, tool spans, and sub-agent spans.
  *
  * @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-haiku-4-5-20251001" }
- * })) {
- *   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;