braintrust 2.2.0 → 3.0.0-rc.29

package/README.md

@@ -50,3 +50,22 @@ async function main() {
 
 main().catch(console.error);
 ```
+
+### Browser Support
+
+**For browser-only applications, use the dedicated browser package:**
+
+```bash
+npm install @braintrust/browser
+```
+
+The `@braintrust/browser` package is optimized for browser environments and includes the `als-browser` polyfill for AsyncLocalStorage support. It's a standalone package with no peer dependencies.
+
+**When to use each package:**
+
+- **`braintrust`** (this package) - For Node.js applications, full-stack frameworks (Next.js, etc.), and edge runtimes with native AsyncLocalStorage (Cloudflare Workers, Vercel Edge)
+- **`@braintrust/browser`** - For browser-only applications that need AsyncLocalStorage support in standard browsers
+
+See the [@braintrust/browser README](../integrations/browser-js/README.md) for more details.
+
+**Breaking change in v3.0.0:** The `braintrust/browser` subpath export has been deprecated. Browser users should migrate to the `@braintrust/browser` package.

package/dev/dist/index.d.mts

@@ -8109,6 +8109,12 @@ type ToolFunctionDefinitionType = z.infer<typeof ToolFunctionDefinition>;
 
 type GenericFunction<Input, Output> = ((input: Input) => Output) | ((input: Input) => Promise<Output>);
 
+interface IsoAsyncLocalStorage<T> {
+    enterWith(store: T): void;
+    run<R>(store: T | undefined, callback: () => R): R;
+    getStore(): T | undefined;
+}
+
 /**
  * Abstract base class for ID generators
  */
@@ -8129,12 +8135,6 @@ declare abstract class IDGenerator {
 
 type TemplateFormat = "mustache" | "nunjucks" | "none";
 
-interface IsoAsyncLocalStorage<T> {
-    enterWith(store: T): void;
-    run<R>(store: T | undefined, callback: () => R): R;
-    getStore(): T | undefined;
-}
-
 /**
  * Options for configuring an LRUCache instance.
  */
@@ -8438,8 +8438,6 @@ declare class SpanCache {
     dispose(): void;
 }
 
-/// <reference lib="dom" />
-
 interface ContextParentSpanIds {
     rootSpanId: string;
     spanParents: string[];
@@ -8903,7 +8901,8 @@ declare class HTTPBackgroundLogger implements BackgroundLogger {
     private onFlushError?;
     private maskingFunction;
     syncFlush: boolean;
-    maxRequestSize: number;
+    private maxRequestSizeOverride;
+    private _maxRequestSizePromise;
     defaultBatchSize: number;
     numTries: number;
     queueDropExceedingMaxsize: number;
@@ -8916,10 +8915,13 @@ declare class HTTPBackgroundLogger implements BackgroundLogger {
     constructor(apiConn: LazyValue<HTTPConnection>, opts?: BackgroundLoggerOpts);
     setMaskingFunction(maskingFunction: ((value: unknown) => unknown) | null): void;
     log(items: LazyValue<BackgroundLogEvent>[]): void;
+    private getMaxRequestSize;
     flush(): Promise<void>;
     private flushOnce;
     private flushWrappedItemsChunk;
     private unwrapLazyValues;
+    private requestLogs3OverflowUpload;
+    private _uploadLogs3OverflowPayload;
     private submitLogsRequest;
     private registerDroppedItemCount;
     private dumpDroppedEvents;
@@ -9426,6 +9428,17 @@ interface SpanData {
     };
     [key: string]: unknown;
 }
+/**
+ * Options for getThread().
+ */
+interface GetThreadOptions {
+    /**
+     * The preprocessor to use for extracting the thread.
+     * If not specified, uses the project default preprocessor,
+     * falling back to the global "thread" preprocessor.
+     */
+    preprocessor?: string;
+}
 /**
  * Interface for trace objects that can be used by scorers.
  * Both the SDK's LocalTrace class and the API wrapper's WrapperTrace implement this.
@@ -9439,6 +9452,13 @@ interface Trace {
     getSpans(options?: {
         spanType?: string[];
     }): Promise<SpanData[]>;
+    /**
+     * Get the thread (preprocessed messages) for this trace.
+     * Uses the project default preprocessor, falling back to the global "thread" preprocessor.
+     * @param options Options for the thread extraction.
+     * @returns The preprocessed thread as an array of messages.
+     */
+    getThread(options?: GetThreadOptions): Promise<unknown[]>;
 }
 
 interface BaseFnOpts {
@@ -12682,6 +12702,10 @@ interface Evaluator<Input, Output, Expected, Metadata extends BaseMetadata = Def
      * Defaults to true.
      */
     summarizeScores?: boolean;
+    /**
+     * Flushes spans before calling scoring functions
+     */
+    flushBeforeScoring?: boolean;
 }
 declare class EvalResultWithSummary<Input, Output, Expected, Metadata extends BaseMetadata = DefaultMetadataType> {
     summary: ExperimentSummary;

package/dev/dist/index.d.ts

@@ -8109,6 +8109,12 @@ type ToolFunctionDefinitionType = z.infer<typeof ToolFunctionDefinition>;
 
 type GenericFunction<Input, Output> = ((input: Input) => Output) | ((input: Input) => Promise<Output>);
 
+interface IsoAsyncLocalStorage<T> {
+    enterWith(store: T): void;
+    run<R>(store: T | undefined, callback: () => R): R;
+    getStore(): T | undefined;
+}
+
 /**
  * Abstract base class for ID generators
  */
@@ -8129,12 +8135,6 @@ declare abstract class IDGenerator {
 
 type TemplateFormat = "mustache" | "nunjucks" | "none";
 
-interface IsoAsyncLocalStorage<T> {
-    enterWith(store: T): void;
-    run<R>(store: T | undefined, callback: () => R): R;
-    getStore(): T | undefined;
-}
-
 /**
  * Options for configuring an LRUCache instance.
  */
@@ -8438,8 +8438,6 @@ declare class SpanCache {
     dispose(): void;
 }
 
-/// <reference lib="dom" />
-
 interface ContextParentSpanIds {
     rootSpanId: string;
     spanParents: string[];
@@ -8903,7 +8901,8 @@ declare class HTTPBackgroundLogger implements BackgroundLogger {
     private onFlushError?;
     private maskingFunction;
     syncFlush: boolean;
-    maxRequestSize: number;
+    private maxRequestSizeOverride;
+    private _maxRequestSizePromise;
     defaultBatchSize: number;
     numTries: number;
     queueDropExceedingMaxsize: number;
@@ -8916,10 +8915,13 @@ declare class HTTPBackgroundLogger implements BackgroundLogger {
     constructor(apiConn: LazyValue<HTTPConnection>, opts?: BackgroundLoggerOpts);
     setMaskingFunction(maskingFunction: ((value: unknown) => unknown) | null): void;
     log(items: LazyValue<BackgroundLogEvent>[]): void;
+    private getMaxRequestSize;
     flush(): Promise<void>;
     private flushOnce;
     private flushWrappedItemsChunk;
     private unwrapLazyValues;
+    private requestLogs3OverflowUpload;
+    private _uploadLogs3OverflowPayload;
     private submitLogsRequest;
     private registerDroppedItemCount;
     private dumpDroppedEvents;
@@ -9426,6 +9428,17 @@ interface SpanData {
     };
     [key: string]: unknown;
 }
+/**
+ * Options for getThread().
+ */
+interface GetThreadOptions {
+    /**
+     * The preprocessor to use for extracting the thread.
+     * If not specified, uses the project default preprocessor,
+     * falling back to the global "thread" preprocessor.
+     */
+    preprocessor?: string;
+}
 /**
  * Interface for trace objects that can be used by scorers.
  * Both the SDK's LocalTrace class and the API wrapper's WrapperTrace implement this.
@@ -9439,6 +9452,13 @@ interface Trace {
     getSpans(options?: {
         spanType?: string[];
     }): Promise<SpanData[]>;
+    /**
+     * Get the thread (preprocessed messages) for this trace.
+     * Uses the project default preprocessor, falling back to the global "thread" preprocessor.
+     * @param options Options for the thread extraction.
+     * @returns The preprocessed thread as an array of messages.
+     */
+    getThread(options?: GetThreadOptions): Promise<unknown[]>;
 }
 
 interface BaseFnOpts {
@@ -12682,6 +12702,10 @@ interface Evaluator<Input, Output, Expected, Metadata extends BaseMetadata = Def
      * Defaults to true.
      */
     summarizeScores?: boolean;
+    /**
+     * Flushes spans before calling scoring functions
+     */
+    flushBeforeScoring?: boolean;
 }
 declare class EvalResultWithSummary<Input, Output, Expected, Metadata extends BaseMetadata = DefaultMetadataType> {
     summary: ExperimentSummary;