braintrust 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -220,7 +220,7 @@ interface Exportable {
  *
  * We suggest using one of the various `traced` methods, instead of creating Spans directly. See {@link Span.traced} for full details.
  */
-interface Span extends Exportable {
+interface Span$1 extends Exportable {
     /**
      * Row ID of the span.
      */
@@ -264,7 +264,7 @@ interface Span extends Exportable {
      * @param args.event Data to be logged. See {@link Experiment.log} for full details.
      * @returns The result of running `callback`.
      */
-    traced<R>(callback: (span: Span) => R, args?: StartSpanArgs & SetCurrentArg): R;
+    traced<R>(callback: (span: Span$1) => R, args?: StartSpanArgs & SetCurrentArg): R;
     /**
      * Lower-level alternative to `traced`. This allows you to start a span yourself, and can be useful in situations
      * where you cannot use callbacks. However, spans started with `startSpan` will not be marked as the "current span",
@@ -274,7 +274,7 @@ interface Span extends Exportable {
      *
      * @returns The newly-created `Span`
      */
-    startSpan(args?: StartSpanArgs): Span;
+    startSpan(args?: StartSpanArgs): Span$1;
     /**
      * Log an end time to the span (defaults to the current time). Returns the logged time.
      *
@@ -337,14 +337,14 @@ interface Span extends Exportable {
     /**
      * Start a span with a specific id and parent span ids.
      */
-    startSpanWithParents(spanId: string, spanParents: string[], args?: StartSpanArgs): Span;
+    startSpanWithParents(spanId: string, spanParents: string[], args?: StartSpanArgs): Span$1;
     state(): BraintrustState;
     kind: "span";
 }
 /**
  * A fake implementation of the Span API which does nothing. This can be used as the default span.
  */
-declare class NoopSpan implements Span {
+declare class NoopSpan implements Span$1 {
     id: string;
     spanId: string;
     rootSpanId: string;
@@ -353,7 +353,7 @@ declare class NoopSpan implements Span {
     constructor();
     log(_: ExperimentLogPartialArgs): void;
     logFeedback(_event: Omit<LogFeedbackFullArgs, "id">): void;
-    traced<R>(callback: (span: Span) => R, _1?: StartSpanArgs & SetCurrentArg): R;
+    traced<R>(callback: (span: Span$1) => R, _1?: StartSpanArgs & SetCurrentArg): R;
     startSpan(_1?: StartSpanArgs): this;
     end(args?: EndSpanArgs): number;
     export(): Promise<string>;
@@ -362,7 +362,7 @@ declare class NoopSpan implements Span {
     flush(): Promise<void>;
     close(args?: EndSpanArgs): number;
     setAttributes(_args: Omit<StartSpanArgs, "event">): void;
-    startSpanWithParents(_spanId: string, _spanParents: string[], _args?: StartSpanArgs): Span;
+    startSpanWithParents(_spanId: string, _spanParents: string[], _args?: StartSpanArgs): Span$1;
     state(): BraintrustState;
 }
 declare const NOOP_SPAN: NoopSpan;
@@ -420,7 +420,7 @@ declare class BraintrustState {
     currentExperiment: Experiment | undefined;
     currentLogger: Logger<false> | undefined;
     currentParent: IsoAsyncLocalStorage<string>;
-    currentSpan: IsoAsyncLocalStorage<Span>;
+    currentSpan: IsoAsyncLocalStorage<Span$1>;
     private _bgLogger;
     private _overrideBgLogger;
     appUrl: string | null;
@@ -797,7 +797,7 @@ declare class Logger<IsAsyncFlush extends boolean> implements Exportable {
      *
      * See {@link Span.traced} for full details.
      */
-    traced<R>(callback: (span: Span) => R, args?: StartSpanArgs & SetCurrentArg): PromiseUnless<IsAsyncFlush, R>;
+    traced<R>(callback: (span: Span$1) => R, args?: StartSpanArgs & SetCurrentArg): PromiseUnless<IsAsyncFlush, R>;
     /**
      * Lower-level alternative to `traced`. This allows you to start a span yourself, and can be useful in situations
      * where you cannot use callbacks. However, spans started with `startSpan` will not be marked as the "current span",
@@ -805,7 +805,7 @@ declare class Logger<IsAsyncFlush extends boolean> implements Exportable {
      *
      * See {@link traced} for full details.
      */
-    startSpan(args?: StartSpanArgs): Span;
+    startSpan(args?: StartSpanArgs): Span$1;
     private startSpanImpl;
     /**
      * Log feedback to an event. Feedback is used to save feedback scores, set an expected value, or add a comment.
@@ -1139,12 +1139,12 @@ declare function currentLogger<IsAsyncFlush extends boolean>(options?: AsyncFlus
  *
  * See {@link Span} for full details.
  */
-declare function currentSpan(options?: OptionalStateArg): Span;
+declare function currentSpan(options?: OptionalStateArg): Span$1;
 /**
  * Mainly for internal use. Return the parent object for starting a span in a global context.
  */
-declare function getSpanParentObject<IsAsyncFlush extends boolean>(options?: AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): Span | Experiment | Logger<IsAsyncFlush>;
-declare function logError(span: Span, error: unknown): void;
+declare function getSpanParentObject<IsAsyncFlush extends boolean>(options?: AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): Span$1 | Experiment | Logger<IsAsyncFlush>;
+declare function logError(span: Span$1, error: unknown): void;
 /**
  * Toplevel function for starting a span. It checks the following (in precedence order):
  *  * Currently-active span
@@ -1155,7 +1155,7 @@ declare function logError(span: Span, error: unknown): void;
  *
  * See {@link Span.traced} for full details.
  */
-declare function traced<IsAsyncFlush extends boolean = true, R = void>(callback: (span: Span) => R, args?: StartSpanArgs & SetCurrentArg & AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): PromiseUnless<IsAsyncFlush, R>;
+declare function traced<IsAsyncFlush extends boolean = true, R = void>(callback: (span: Span$1) => R, args?: StartSpanArgs & SetCurrentArg & AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): PromiseUnless<IsAsyncFlush, R>;
 /**
  * Wrap a function with `traced`, using the arguments as `input` and return value as `output`.
  * Any functions wrapped this way will automatically be traced, similar to the `@traced` decorator
@@ -1194,7 +1194,7 @@ declare const traceable: typeof wrapTraced;
  *
  * See {@link traced} for full details.
  */
-declare function startSpan<IsAsyncFlush extends boolean = true>(args?: StartSpanArgs & AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): Span;
+declare function startSpan<IsAsyncFlush extends boolean = true>(args?: StartSpanArgs & AsyncFlushArg<IsAsyncFlush> & OptionalStateArg): Span$1;
 /**
  * Flush any pending rows to the server.
  */
@@ -1209,7 +1209,7 @@ declare function setFetch(fetch: typeof globalThis.fetch): void;
 /**
  * Runs the provided callback with the span as the current span.
  */
-declare function withCurrent<R>(span: Span, callback: (span: Span) => R, state?: BraintrustState | undefined): R;
+declare function withCurrent<R>(span: Span$1, callback: (span: Span$1) => R, state?: BraintrustState | undefined): R;
 declare function withParent<R>(parent: string, callback: () => R, state?: BraintrustState | undefined): R;
 /**
  * Creates a deep copy of the given event. Replaces references to user objects
@@ -1311,7 +1311,7 @@ declare class Experiment extends ObjectFetcher<ExperimentEvent> implements Expor
      *
      * See {@link Span.traced} for full details.
      */
-    traced<R>(callback: (span: Span) => R, args?: StartSpanArgs & SetCurrentArg): R;
+    traced<R>(callback: (span: Span$1) => R, args?: StartSpanArgs & SetCurrentArg): R;
     /**
      * Lower-level alternative to `traced`. This allows you to start a span yourself, and can be useful in situations
      * where you cannot use callbacks. However, spans started with `startSpan` will not be marked as the "current span",
@@ -1319,7 +1319,7 @@ declare class Experiment extends ObjectFetcher<ExperimentEvent> implements Expor
      *
      * See {@link traced} for full details.
      */
-    startSpan(args?: StartSpanArgs): Span;
+    startSpan(args?: StartSpanArgs): Span$1;
     private startSpanImpl;
     fetchBaseExperiment(): Promise<{
         id: any;
@@ -1389,7 +1389,7 @@ declare function newId(): string;
  *
  * We suggest using one of the various `traced` methods, instead of creating Spans directly. See {@link Span.startSpan} for full details.
  */
-declare class SpanImpl implements Span {
+declare class SpanImpl implements Span$1 {
     private _state;
     private isMerge;
     private loggedEndTime;
@@ -1420,9 +1420,9 @@ declare class SpanImpl implements Span {
     log(event: ExperimentLogPartialArgs): void;
     private logInternal;
     logFeedback(event: Omit<LogFeedbackFullArgs, "id">): void;
-    traced<R>(callback: (span: Span) => R, args?: StartSpanArgs & SetCurrentArg): R;
-    startSpan(args?: StartSpanArgs): Span;
-    startSpanWithParents(spanId: string, spanParents: string[], args?: StartSpanArgs): Span;
+    traced<R>(callback: (span: Span$1) => R, args?: StartSpanArgs & SetCurrentArg): R;
+    startSpan(args?: StartSpanArgs): Span$1;
+    startSpanWithParents(spanId: string, spanParents: string[], args?: StartSpanArgs): Span$1;
     end(args?: EndSpanArgs): number;
     export(): Promise<string>;
     permalink(): Promise<string>;
@@ -2555,6 +2555,52 @@ declare const promptContentsSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         content: string | null;
         role: "function";
+    }>, z.ZodObject<{
+        content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+            text: z.ZodDefault<z.ZodString>;
+            type: z.ZodLiteral<"text">;
+            cache_control: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["ephemeral"]>;
+            }, "strip", z.ZodTypeAny, {
+                type: "ephemeral";
+            }, {
+                type: "ephemeral";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }, {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }>, "many">]>;
+        role: z.ZodLiteral<"developer">;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
+    }, {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     }>]>, z.ZodObject<{
         role: z.ZodEnum<["model"]>;
         content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2632,6 +2678,16 @@ declare const promptContentsSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -2703,6 +2759,16 @@ declare const promptContentsSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -3054,6 +3120,52 @@ declare const promptDefinitionSchema: z.ZodIntersection<z.ZodUnion<[z.ZodObject<
         name: string;
         content: string | null;
         role: "function";
+    }>, z.ZodObject<{
+        content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+            text: z.ZodDefault<z.ZodString>;
+            type: z.ZodLiteral<"text">;
+            cache_control: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["ephemeral"]>;
+            }, "strip", z.ZodTypeAny, {
+                type: "ephemeral";
+            }, {
+                type: "ephemeral";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }, {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }>, "many">]>;
+        role: z.ZodLiteral<"developer">;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
+    }, {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     }>]>, z.ZodObject<{
         role: z.ZodEnum<["model"]>;
         content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -3131,6 +3243,16 @@ declare const promptDefinitionSchema: z.ZodIntersection<z.ZodUnion<[z.ZodObject<
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -3202,6 +3324,16 @@ declare const promptDefinitionSchema: z.ZodIntersection<z.ZodUnion<[z.ZodObject<
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -4107,6 +4239,52 @@ declare const promptDefinitionWithToolsSchema: z.ZodIntersection<z.ZodIntersecti
         name: string;
         content: string | null;
         role: "function";
+    }>, z.ZodObject<{
+        content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+            text: z.ZodDefault<z.ZodString>;
+            type: z.ZodLiteral<"text">;
+            cache_control: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["ephemeral"]>;
+            }, "strip", z.ZodTypeAny, {
+                type: "ephemeral";
+            }, {
+                type: "ephemeral";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }, {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }>, "many">]>;
+        role: z.ZodLiteral<"developer">;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
+    }, {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     }>]>, z.ZodObject<{
         role: z.ZodEnum<["model"]>;
         content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4184,6 +4362,16 @@ declare const promptDefinitionWithToolsSchema: z.ZodIntersection<z.ZodIntersecti
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        content: string | {
+            type: "text";
+            text: string;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[];
+        role: "developer";
+        name?: string | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -4255,6 +4443,16 @@ declare const promptDefinitionWithToolsSchema: z.ZodIntersection<z.ZodIntersecti
         name: string;
         content: string | null;
         role: "function";
+    } | {
+        role: "developer";
+        name?: string | undefined;
+        content?: string | {
+            type: "text";
+            text?: string | undefined;
+            cache_control?: {
+                type: "ephemeral";
+            } | undefined;
+        }[] | undefined;
     } | {
         role: "model";
         content?: string | null | undefined;
@@ -5251,6 +5449,52 @@ declare const evalParametersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodOb
             name: string;
             content: string | null;
             role: "function";
+        }>, z.ZodObject<{
+            content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+                text: z.ZodDefault<z.ZodString>;
+                type: z.ZodLiteral<"text">;
+                cache_control: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<["ephemeral"]>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "ephemeral";
+                }, {
+                    type: "ephemeral";
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                type: "text";
+                text: string;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }, {
+                type: "text";
+                text?: string | undefined;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }>, "many">]>;
+            role: z.ZodLiteral<"developer">;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content: string | {
+                type: "text";
+                text: string;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[];
+            role: "developer";
+            name?: string | undefined;
+        }, {
+            role: "developer";
+            name?: string | undefined;
+            content?: string | {
+                type: "text";
+                text?: string | undefined;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[] | undefined;
         }>]>, z.ZodObject<{
             role: z.ZodEnum<["model"]>;
             content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -5328,6 +5572,16 @@ declare const evalParametersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodOb
             name: string;
             content: string | null;
             role: "function";
+        } | {
+            content: string | {
+                type: "text";
+                text: string;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[];
+            role: "developer";
+            name?: string | undefined;
         } | {
             role: "model";
             content?: string | null | undefined;
@@ -5399,6 +5653,16 @@ declare const evalParametersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodOb
             name: string;
             content: string | null;
             role: "function";
+        } | {
+            role: "developer";
+            name?: string | undefined;
+            content?: string | {
+                type: "text";
+                text?: string | undefined;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[] | undefined;
         } | {
             role: "model";
             content?: string | null | undefined;
@@ -6086,6 +6350,16 @@ declare const evalParametersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodOb
             name: string;
             content: string | null;
             role: "function";
+        } | {
+            content: string | {
+                type: "text";
+                text: string;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[];
+            role: "developer";
+            name?: string | undefined;
         } | {
             role: "model";
             content?: string | null | undefined;
@@ -6285,6 +6559,16 @@ declare const evalParametersSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodOb
             name: string;
             content: string | null;
             role: "function";
+        } | {
+            role: "developer";
+            name?: string | undefined;
+            content?: string | {
+                type: "text";
+                text?: string | undefined;
+                cache_control?: {
+                    type: "ephemeral";
+                } | undefined;
+            }[] | undefined;
         } | {
             role: "model";
             content?: string | null | undefined;
@@ -6459,7 +6743,7 @@ interface EvalHooks<Expected, Metadata extends BaseMetadata, Parameters extends
     /**
      * The task's span.
      */
-    span: Span;
+    span: Span$1;
     /**
      * The current parameters being used for this specific task execution.
      * Array parameters are converted to single values.
@@ -6469,6 +6753,10 @@ interface EvalHooks<Expected, Metadata extends BaseMetadata, Parameters extends
      * Report progress that will show up in the playground.
      */
     reportProgress: (progress: TaskProgressEvent) => void;
+    /**
+     * The index of the current trial (0-based). This is useful when trialCount > 1.
+     */
+    trialIndex: number;
 }
 type EvalScorerArgs<Input, Output, Expected, Metadata extends BaseMetadata = DefaultMetadataType> = EvalCase<Input, Expected, Metadata> & {
     output: Output;
@@ -6482,7 +6770,7 @@ type EvalResult<Input, Output, Expected, Metadata extends BaseMetadata = Default
     origin?: ObjectReference;
 };
 type ErrorScoreHandler = (args: {
-    rootSpan: Span;
+    rootSpan: Span$1;
     data: EvalCase<any, any, any>;
     unhandledScores: string[];
 }) => Record<string, number> | undefined | void;
@@ -6878,6 +7166,235 @@ declare function wrapAISDKModel<T extends object>(model: T): T;
  */
 declare function wrapAnthropic<T extends object>(anthropic: T): T;
 
+interface Context {
+    [key: string]: any;
+}
+interface SpanProcessor {
+    onStart(span: Span, parentContext?: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+interface ReadableSpan {
+    name: string;
+    parentSpanContext?: {
+        spanId: string;
+        traceId: string;
+    };
+    attributes?: Record<string, any>;
+    spanContext(): {
+        spanId: string;
+        traceId: string;
+    };
+}
+interface Span extends ReadableSpan {
+    end(): void;
+    setAttributes(attributes: Record<string, any>): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+}
+/**
+ * Custom filter function type for span filtering.
+ * @param span - The span to evaluate
+ * @returns true to definitely keep, false to definitely drop, null/undefined to not influence the decision
+ */
+type CustomSpanFilter = (span: ReadableSpan) => boolean | null | undefined;
+/**
+ * A span processor that filters spans to only export filtered telemetry.
+ *
+ * Only filtered spans and root spans will be forwarded to the inner processor.
+ * This dramatically reduces telemetry volume while preserving important observability.
+ *
+ * @example
+ * ```typescript
+ * const processor = new AISpanProcessor(new BatchSpanProcessor(new OTLPTraceExporter()));
+ * const provider = new TracerProvider();
+ * provider.addSpanProcessor(processor);
+ * ```
+ */
+declare class AISpanProcessor {
+    private static checkOtelAvailable;
+    private readonly processor;
+    private readonly customFilter;
+    /**
+     * Initialize the filter span processor.
+     *
+     * @param processor - The wrapped span processor that will receive filtered spans
+     * @param customFilter - Optional function that takes a span and returns:
+     *                      true to keep, false to drop,
+     *                      null/undefined to not influence the decision
+     */
+    constructor(processor: SpanProcessor, customFilter?: CustomSpanFilter);
+    /**
+     * Forward span start events to the inner processor.
+     */
+    onStart(span: Span, parentContext: Context): void;
+    /**
+     * Apply filtering logic and conditionally forward span end events.
+     */
+    onEnd(span: ReadableSpan): void;
+    /**
+     * Shutdown the inner processor.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush the inner processor.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Determine if a span should be kept based on filtering criteria.
+     *
+     * Keep spans if:
+     * 1. It's a root span (no parent)
+     * 2. Custom filter returns true/false (if provided)
+     * 3. Span name starts with 'gen_ai.', 'braintrust.', 'llm.', or 'ai.'
+     * 4. Any attribute name starts with those prefixes
+     */
+    private shouldKeepFilteredSpan;
+}
+interface BraintrustSpanProcessorOptions {
+    /**
+     * Braintrust API key. If not provided, will use BRAINTRUST_API_KEY environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Braintrust API URL. If not provided, will use BRAINTRUST_API_URL environment variable. Defaults to https://api.braintrust.dev
+     */
+    apiUrl?: string;
+    /**
+     * Braintrust parent project name (e.g., "project_name:otel_examples"). If not provided, will use BRAINTRUST_PARENT environment variable.
+     */
+    parent?: string;
+    /**
+     * Whether to enable AI span filtering. Defaults to false.
+     */
+    filterAISpans?: boolean;
+    /**
+     * Custom filter function for span filtering
+     */
+    customFilter?: CustomSpanFilter;
+    /**
+     * Additional headers to send with telemetry data
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * A span processor that sends OpenTelemetry spans to Braintrust.
+ *
+ * This processor uses a BatchSpanProcessor and an OTLP exporter configured
+ * to send data to Braintrust's telemetry endpoint. Span filtering is disabled
+ * by default but can be enabled with the filterAISpans option.
+ *
+ * Environment Variables:
+ * - BRAINTRUST_API_KEY: Your Braintrust API key
+ * - BRAINTRUST_PARENT: Parent identifier (e.g., "project_name:test")
+ * - BRAINTRUST_API_URL: Base URL for Braintrust API (defaults to https://api.braintrust.dev)
+ *
+ * @example
+ * ```typescript
+ * const processor = new BraintrustSpanProcessor({
+ *   apiKey: 'your-api-key',
+ *   apiUrl: 'https://api.braintrust.dev'
+ * });
+ * const provider = new TracerProvider();
+ * provider.addSpanProcessor(processor);
+ * ```
+ *
+ * @example With span filtering enabled:
+ * ```typescript
+ * const processor = new BraintrustSpanProcessor({
+ *   apiKey: 'your-api-key',
+ *   filterAISpans: true
+ * });
+ * ```
+ *
+ * @example Using environment variables:
+ * ```typescript
+ * // Set environment variables:
+ * // BRAINTRUST_API_KEY=your-api-key
+ * // BRAINTRUST_PARENT=project_name:test
+ * // BRAINTRUST_API_URL=https://api.braintrust.dev
+ * const processor = new BraintrustSpanProcessor();
+ * ```
+ */
+declare class BraintrustSpanProcessor {
+    private static checkOtelAvailable;
+    private readonly processor;
+    private readonly aiSpanProcessor;
+    constructor(options?: BraintrustSpanProcessorOptions);
+    onStart(span: Span, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+/**
+ * A trace exporter that sends OpenTelemetry spans to Braintrust.
+ *
+ * This exporter wraps the standard OTLP trace exporter and can be used with
+ * any OpenTelemetry setup, including @vercel/otel's registerOTel function,
+ * NodeSDK, or custom tracer providers. It can optionally filter spans to
+ * only send AI-related telemetry.
+ *
+ * Environment Variables:
+ * - BRAINTRUST_API_KEY: Your Braintrust API key
+ * - BRAINTRUST_PARENT: Parent identifier (e.g., "project_name:test")
+ * - BRAINTRUST_API_URL: Base URL for Braintrust API (defaults to https://api.braintrust.dev)
+ *
+ * @example With @vercel/otel:
+ * ```typescript
+ * import { registerOTel } from '@vercel/otel';
+ * import { BraintrustExporter } from 'braintrust';
+ *
+ * export function register() {
+ *   registerOTel({
+ *     serviceName: 'my-app',
+ *     traceExporter: new BraintrustExporter({
+ *       filterAISpans: true,
+ *     }),
+ *   });
+ * }
+ * ```
+ *
+ * @example With NodeSDK:
+ * ```typescript
+ * import { NodeSDK } from '@opentelemetry/sdk-node';
+ * import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+ * import { BraintrustExporter } from 'braintrust';
+ *
+ * const sdk = new NodeSDK({
+ *   spanProcessors: [
+ *     new BatchSpanProcessor(new BraintrustExporter({
+ *       apiKey: 'your-api-key',
+ *       parent: 'project_name:test'
+ *     }))
+ *   ]
+ * });
+ * ```
+ */
+declare class BraintrustExporter {
+    private static checkOtelAvailable;
+    private readonly processor;
+    private readonly spans;
+    private readonly callbacks;
+    constructor(options?: BraintrustSpanProcessorOptions);
+    /**
+     * Export spans to Braintrust by simulating span processor behavior.
+     */
+    export(spans: ReadableSpan[], resultCallback: (result: any) => void): void;
+    /**
+     * Shutdown the exporter.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush the exporter.
+     */
+    forceFlush(): Promise<void>;
+}
+
+type braintrust_AISpanProcessor = AISpanProcessor;
+declare const braintrust_AISpanProcessor: typeof AISpanProcessor;
 type braintrust_AnyDataset = AnyDataset;
 type braintrust_Attachment = Attachment;
 declare const braintrust_Attachment: typeof Attachment;
@@ -6887,6 +7404,10 @@ type braintrust_BaseAttachment = BaseAttachment;
 declare const braintrust_BaseAttachment: typeof BaseAttachment;
 declare const braintrust_BaseExperiment: typeof BaseExperiment;
 type braintrust_BaseMetadata = BaseMetadata;
+type braintrust_BraintrustExporter = BraintrustExporter;
+declare const braintrust_BraintrustExporter: typeof BraintrustExporter;
+type braintrust_BraintrustSpanProcessor = BraintrustSpanProcessor;
+declare const braintrust_BraintrustSpanProcessor: typeof BraintrustSpanProcessor;
 type braintrust_BraintrustState = BraintrustState;
 declare const braintrust_BraintrustState: typeof BraintrustState;
 type braintrust_BraintrustStream = BraintrustStream;
@@ -6977,7 +7498,6 @@ declare const braintrust_ScorerBuilder: typeof ScorerBuilder;
 type braintrust_ScorerOpts<Output, Input, Params, Returns, Fn extends GenericFunction<Exact<Params, ScorerArgs<Output, Input>>, Returns>> = ScorerOpts<Output, Input, Params, Returns, Fn>;
 type braintrust_SerializedBraintrustState = SerializedBraintrustState;
 type braintrust_SetCurrentArg = SetCurrentArg;
-type braintrust_Span = Span;
 type braintrust_SpanContext = SpanContext;
 type braintrust_SpanImpl = SpanImpl;
 declare const braintrust_SpanImpl: typeof SpanImpl;
@@ -7044,7 +7564,7 @@ declare const braintrust_wrapOpenAI: typeof wrapOpenAI;
 declare const braintrust_wrapOpenAIv4: typeof wrapOpenAIv4;
 declare const braintrust_wrapTraced: typeof wrapTraced;
 declare namespace braintrust {
-  export { 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_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 braintrust_Span 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_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_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, braintrust_toolFunctionDefinitionSchema 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_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_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_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_spanComponentsToObjectId as spanComponentsToObjectId, braintrust_startSpan as startSpan, braintrust_summarize as summarize, braintrust_toolFunctionDefinitionSchema 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_wrapAISDKModel as wrapAISDKModel, braintrust_wrapAnthropic as wrapAnthropic, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
 type EvaluatorManifest = Record<string, EvaluatorDef<unknown, unknown, unknown, BaseMetadata>>;
@@ -7400,6 +7920,52 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                 name: string;
                 content: string | null;
                 role: "function";
+            }>, z.ZodObject<{
+                content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+                    text: z.ZodDefault<z.ZodString>;
+                    type: z.ZodLiteral<"text">;
+                    cache_control: z.ZodOptional<z.ZodObject<{
+                        type: z.ZodEnum<["ephemeral"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "ephemeral";
+                    }, {
+                        type: "ephemeral";
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "text";
+                    text: string;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }, {
+                    type: "text";
+                    text?: string | undefined;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }>, "many">]>;
+                role: z.ZodLiteral<"developer">;
+                name: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                content: string | {
+                    type: "text";
+                    text: string;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[];
+                role: "developer";
+                name?: string | undefined;
+            }, {
+                role: "developer";
+                name?: string | undefined;
+                content?: string | {
+                    type: "text";
+                    text?: string | undefined;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[] | undefined;
             }>]>, z.ZodObject<{
                 role: z.ZodEnum<["model"]>;
                 content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7423,6 +7989,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                 }[];
                 role: "system";
                 name?: string | undefined;
+            } | {
+                content: string | {
+                    type: "text";
+                    text: string;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[];
+                role: "developer";
+                name?: string | undefined;
             } | {
                 content: string | ({
                     type: "text";
@@ -7496,6 +8072,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                         type: "ephemeral";
                     } | undefined;
                 }[] | undefined;
+            } | {
+                role: "developer";
+                name?: string | undefined;
+                content?: string | {
+                    type: "text";
+                    text?: string | undefined;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[] | undefined;
             } | {
                 role: "user";
                 name?: string | undefined;
@@ -8291,6 +8877,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                 }[];
                 role: "system";
                 name?: string | undefined;
+            } | {
+                content: string | {
+                    type: "text";
+                    text: string;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[];
+                role: "developer";
+                name?: string | undefined;
             } | {
                 content: string | ({
                     type: "text";
@@ -8500,6 +9096,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                         type: "ephemeral";
                     } | undefined;
                 }[] | undefined;
+            } | {
+                role: "developer";
+                name?: string | undefined;
+                content?: string | {
+                    type: "text";
+                    text?: string | undefined;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[] | undefined;
             } | {
                 role: "user";
                 name?: string | undefined;
@@ -8713,6 +9319,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                 }[];
                 role: "system";
                 name?: string | undefined;
+            } | {
+                content: string | {
+                    type: "text";
+                    text: string;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[];
+                role: "developer";
+                name?: string | undefined;
             } | {
                 content: string | ({
                     type: "text";
@@ -8926,6 +9542,16 @@ declare const evalParametersSerializedSchema: z.ZodRecord<z.ZodString, z.ZodUnio
                         type: "ephemeral";
                     } | undefined;
                 }[] | undefined;
+            } | {
+                role: "developer";
+                name?: string | undefined;
+                content?: string | {
+                    type: "text";
+                    text?: string | undefined;
+                    cache_control?: {
+                        type: "ephemeral";
+                    } | undefined;
+                }[] | undefined;
             } | {
                 role: "user";
                 name?: string | undefined;
@@ -9377,6 +10003,52 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                     name: string;
                     content: string | null;
                     role: "function";
+                }>, z.ZodObject<{
+                    content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+                        text: z.ZodDefault<z.ZodString>;
+                        type: z.ZodLiteral<"text">;
+                        cache_control: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodEnum<["ephemeral"]>;
+                        }, "strip", z.ZodTypeAny, {
+                            type: "ephemeral";
+                        }, {
+                            type: "ephemeral";
+                        }>>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }, {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }>, "many">]>;
+                    role: z.ZodLiteral<"developer">;
+                    name: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
+                }, {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 }>]>, z.ZodObject<{
                     role: z.ZodEnum<["model"]>;
                     content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -9400,6 +10072,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -9473,6 +10155,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -10268,6 +10960,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -10477,6 +11179,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -10690,6 +11402,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -10903,6 +11625,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -11133,6 +11865,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -11353,6 +12095,16 @@ declare const evaluatorDefinitionSchema: z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -11795,6 +12547,52 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                     name: string;
                     content: string | null;
                     role: "function";
+                }>, z.ZodObject<{
+                    content: z.ZodUnion<[z.ZodDefault<z.ZodString>, z.ZodArray<z.ZodObject<{
+                        text: z.ZodDefault<z.ZodString>;
+                        type: z.ZodLiteral<"text">;
+                        cache_control: z.ZodOptional<z.ZodObject<{
+                            type: z.ZodEnum<["ephemeral"]>;
+                        }, "strip", z.ZodTypeAny, {
+                            type: "ephemeral";
+                        }, {
+                            type: "ephemeral";
+                        }>>;
+                    }, "strip", z.ZodTypeAny, {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }, {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }>, "many">]>;
+                    role: z.ZodLiteral<"developer">;
+                    name: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
+                }, {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 }>]>, z.ZodObject<{
                     role: z.ZodEnum<["model"]>;
                     content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -11818,6 +12616,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -11891,6 +12699,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -12686,6 +13504,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -12895,6 +13723,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -13108,6 +13946,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -13321,6 +14169,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -13551,6 +14409,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                     }[];
                     role: "system";
                     name?: string | undefined;
+                } | {
+                    content: string | {
+                        type: "text";
+                        text: string;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[];
+                    role: "developer";
+                    name?: string | undefined;
                 } | {
                     content: string | ({
                         type: "text";
@@ -13771,6 +14639,16 @@ declare const evaluatorDefinitionsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
                             type: "ephemeral";
                         } | undefined;
                     }[] | undefined;
+                } | {
+                    role: "developer";
+                    name?: string | undefined;
+                    content?: string | {
+                        type: "text";
+                        text?: string | undefined;
+                        cache_control?: {
+                            type: "ephemeral";
+                        } | undefined;
+                    }[] | undefined;
                 } | {
                     role: "user";
                     name?: string | undefined;
@@ -13914,4 +14792,4 @@ type EvaluatorDefinitions = z.infer<typeof evaluatorDefinitionsSchema>;
  * @module braintrust
  */
 
-export { type AnyDataset, Attachment, type AttachmentParams, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type CreateProjectOpts, type DataSummary, Dataset, 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 ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, INTERNAL_BTQL_LIMIT, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, LazyValue, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, type ObjectMetadata, 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, 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, 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, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDKModel, wrapAnthropic, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { AISpanProcessor, type AnyDataset, Attachment, type AttachmentParams, type BackgroundLoggerOpts, BaseAttachment, BaseExperiment, type BaseMetadata, BraintrustExporter, BraintrustSpanProcessor, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, CodeFunction, type CodeOpts, CodePrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type CreateProjectOpts, type DataSummary, Dataset, 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 ExperimentSummary, type Exportable, ExternalAttachment, type ExternalAttachmentParams, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type FunctionEvent, INTERNAL_BTQL_LIMIT, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, LazyValue, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NOOP_SPAN_PERMALINK, NoopSpan, type ObjectMetadata, 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, 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, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapAISDKModel, wrapAnthropic, wrapOpenAI, wrapOpenAIv4, wrapTraced };