braintrust 0.0.158 → 0.0.159

package/dist/browser.d.mts

@@ -1,5 +1,5 @@
 import { GitMetadataSettings, LogFeedbackFullArgs, ExperimentEvent, BackgroundLogEvent, ExperimentLogFullArgs, ExperimentLogPartialArgs, IdField, SpanType, RepoInfo, DEFAULT_IS_LEGACY_DATASET, TRANSACTION_ID_FIELD, TransactionId, SpanObjectTypeV3, DatasetRecord } from '@braintrust/core';
-import { PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent } from '@braintrust/core/typespecs';
+import { PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent, StreamingMode } from '@braintrust/core/typespecs';
 import { z } from 'zod';
 
 interface IsoAsyncLocalStorage<T> {
@@ -213,6 +213,12 @@ declare class BraintrustState {
 }
 declare function _internalSetInitialState(): void;
 declare const _internalGetGlobalState: () => BraintrustState;
+declare class FailedHTTPResponse extends Error {
+    status: number;
+    text: string;
+    data: any;
+    constructor(status: number, text: string, data?: any);
+}
 declare class HTTPConnection {
     base_url: string;
     token: string | null;
@@ -225,9 +231,9 @@ declare class HTTPConnection {
     static sanitize_token(token: string): string;
     set_token(token: string): void;
     _reset(): void;
-    get(path: string, params?: Record<string, string | undefined> | undefined, config?: RequestInit): Promise<Response>;
+    get(path: string, params?: Record<string, string | string[] | undefined> | undefined, config?: RequestInit): Promise<Response>;
     post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
-    get_json(object_type: string, args?: Record<string, string | undefined> | undefined, retries?: number): Promise<any>;
+    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>;
 }
 interface ObjectMetadata {
@@ -538,7 +544,7 @@ type LoadPromptOptions = FullLoginOptions & {
  * });
  * ```
  */
-declare function loadPrompt({ projectName, projectId, slug, version, defaults, noTrace, appUrl, apiKey, orgName, fetch, forceLogin, state: stateArg, }: LoadPromptOptions): Promise<Prompt>;
+declare function loadPrompt({ projectName, projectId, slug, version, defaults, noTrace, appUrl, apiKey, orgName, fetch, forceLogin, state: stateArg, }: LoadPromptOptions): Promise<Prompt<true, true>>;
 /**
  * Options for logging in to Braintrust.
  */
@@ -982,19 +988,20 @@ type CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPromptParams
 } & (Flavor extends "chat" ? ChatPrompt : Flavor extends "completion" ? CompletionPrompt : {});
 type DefaultPromptArgs = Partial<CompiledPromptParams & AnyModelParam & ChatPrompt & CompletionPrompt>;
 declare function renderMessage<T extends Message>(render: (template: string) => string, message: T): T;
-declare class Prompt {
+type PromptRowWithId<HasId extends boolean = true, HasVersion extends boolean = true> = Omit<Prompt$1, "log_id" | "org_id" | "project_id" | "id" | "_xact_id"> & Partial<Pick<Prompt$1, "project_id">> & (HasId extends true ? Pick<Prompt$1, "id"> : Partial<Pick<Prompt$1, "id">>) & (HasVersion extends true ? Pick<Prompt$1, "_xact_id"> : Partial<Pick<Prompt$1, "_xact_id">>);
+declare class Prompt<HasId extends boolean = true, HasVersion extends boolean = true> {
     private metadata;
     private defaults;
     private noTrace;
     private parsedPromptData;
     private hasParsedPromptData;
-    constructor(metadata: Omit<Prompt$1, "log_id"> | PromptSessionEvent, defaults: DefaultPromptArgs, noTrace: boolean);
-    get id(): string;
-    get projectId(): string;
+    constructor(metadata: PromptRowWithId<HasId, HasVersion> | PromptSessionEvent, defaults: DefaultPromptArgs, noTrace: boolean);
+    get id(): HasId extends true ? string : string | undefined;
+    get projectId(): string | undefined;
     get name(): string;
     get slug(): string;
     get prompt(): PromptData["prompt"];
-    get version(): TransactionId;
+    get version(): HasId extends true ? TransactionId : TransactionId | undefined;
     get options(): NonNullable<PromptData["options"]>;
     /**
      * Build the prompt with the given formatting options. The args you pass in will
@@ -1005,6 +1012,7 @@ declare class Prompt {
      */
     build<Flavor extends "chat" | "completion" = "chat">(buildArgs: unknown, options?: {
         flavor?: Flavor;
+        messages?: Message[];
     }): CompiledPrompt<Flavor>;
     private runBuild;
     private getParsedPromptData;
@@ -1108,6 +1116,82 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
 }, {
     data: string;
     type: "json_delta";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "error";
+}, {
+    data: string;
+    type: "error";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    data: z.ZodObject<{
+        id: z.ZodString;
+        object_type: z.ZodEnum<["prompt", "tool", "scorer", "task"]>;
+        format: z.ZodEnum<["llm", "code", "global"]>;
+        output_type: z.ZodEnum<["completion", "score", "any"]>;
+        name: z.ZodString;
+        event: z.ZodEnum<["text_delta", "json_delta", "error", "start", "done"]>;
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    }, {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    };
+    type: "progress";
+}, {
+    data: {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    };
+    type: "progress";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "start";
+}, {
+    data: string;
+    type: "start";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "done";
+}, {
+    data: string;
+    type: "done";
 }>]>;
 /**
  * A chunk of data from a Braintrust stream. Each chunk type matches
@@ -1168,7 +1252,7 @@ declare class BraintrustStream {
  * @param onFinal A function to call with the final value of the stream.
  * @returns A new stream that passes through the final value of the stream.
  */
-declare function createFinalValuePassThroughStream<T extends BraintrustStreamChunk | string | Uint8Array>(onFinal: (result: unknown) => void): TransformStream<T, BraintrustStreamChunk>;
+declare function createFinalValuePassThroughStream<T extends BraintrustStreamChunk | string | Uint8Array>(onFinal: (result: unknown) => void, onError: (error: unknown) => void): TransformStream<T, BraintrustStreamChunk>;
 declare function devNullWritableStream(): WritableStream;
 
 /**
@@ -1207,6 +1291,10 @@ interface InvokeFunctionArgs<Input, Output, Stream extends boolean = false> {
      * The input to the function. This will be logged as the `input` field in the span.
      */
     input: Input;
+    /**
+     * Additional OpenAI-style messages to add to the prompt (only works for llm functions).
+     */
+    messages?: Message[];
     /**
      * The parent of the function. This can be an existing span, logger, or experiment, or
      * the output of `.export()` if you are distributed tracing. If unspecified, will use
@@ -1220,6 +1308,12 @@ interface InvokeFunctionArgs<Input, Output, Stream extends boolean = false> {
      * object.
      */
     stream?: Stream;
+    /**
+     * The mode of the function. If "auto", will return a string if the function returns a string,
+     * and a JSON object otherwise. If "parallel", will return an array of JSON objects with one
+     * object per tool call.
+     */
+    mode?: StreamingMode;
     /**
      * A Zod schema to validate the output of the function and return a typed value. This
      * is only used if `stream` is false.
@@ -1281,4 +1375,100 @@ declare const LEGACY_CACHED_HEADER = "x-cached";
 declare const X_CACHED_HEADER = "x-bt-cached";
 declare function parseCachedHeader(value: string | null | undefined): number | undefined;
 
-export { type AnyDataset, type BackgroundLoggerOpts, type BaseMetadata, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type DataSummary, Dataset, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, type EndSpanArgs, type EvalCase, Experiment, type ExperimentSummary, type Exportable, type FullInitOptions, type FullLoginOptions, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NoopSpan, type ObjectMetadata, type PromiseUnless, Prompt, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, renderMessage, setFetch, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+type braintrust_AnyDataset = AnyDataset;
+type braintrust_BackgroundLoggerOpts = BackgroundLoggerOpts;
+type braintrust_BaseMetadata = BaseMetadata;
+type braintrust_BraintrustState = BraintrustState;
+declare const braintrust_BraintrustState: typeof BraintrustState;
+type braintrust_BraintrustStream = BraintrustStream;
+declare const braintrust_BraintrustStream: typeof BraintrustStream;
+type braintrust_BraintrustStreamChunk = BraintrustStreamChunk;
+type braintrust_ChatPrompt = ChatPrompt;
+type braintrust_CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPrompt<Flavor>;
+type braintrust_CompiledPromptParams = CompiledPromptParams;
+type braintrust_CompletionPrompt = CompletionPrompt;
+type braintrust_DataSummary = DataSummary;
+type braintrust_Dataset<IsLegacyDataset extends boolean = typeof DEFAULT_IS_LEGACY_DATASET> = Dataset<IsLegacyDataset>;
+declare const braintrust_Dataset: typeof Dataset;
+type braintrust_DatasetSummary = DatasetSummary;
+type braintrust_DefaultMetadataType = DefaultMetadataType;
+type braintrust_DefaultPromptArgs = DefaultPromptArgs;
+type braintrust_EndSpanArgs = EndSpanArgs;
+type braintrust_EvalCase<Input, Expected, Metadata> = EvalCase<Input, Expected, Metadata>;
+type braintrust_Experiment = Experiment;
+declare const braintrust_Experiment: typeof Experiment;
+type braintrust_ExperimentSummary = ExperimentSummary;
+type braintrust_Exportable = Exportable;
+type braintrust_FailedHTTPResponse = FailedHTTPResponse;
+declare const braintrust_FailedHTTPResponse: typeof FailedHTTPResponse;
+type braintrust_FullInitOptions<IsOpen extends boolean> = FullInitOptions<IsOpen>;
+type braintrust_FullLoginOptions = FullLoginOptions;
+type braintrust_InitOptions<IsOpen extends boolean> = InitOptions<IsOpen>;
+type braintrust_InvokeFunctionArgs<Input, Output, Stream extends boolean = false> = InvokeFunctionArgs<Input, Output, Stream>;
+type braintrust_InvokeReturn<Stream extends boolean, Output> = InvokeReturn<Stream, Output>;
+declare const braintrust_LEGACY_CACHED_HEADER: typeof LEGACY_CACHED_HEADER;
+type braintrust_LogOptions<IsAsyncFlush> = LogOptions<IsAsyncFlush>;
+type braintrust_Logger<IsAsyncFlush extends boolean> = Logger<IsAsyncFlush>;
+declare const braintrust_Logger: typeof Logger;
+type braintrust_LoginOptions = LoginOptions;
+type braintrust_MetricSummary = MetricSummary;
+declare const braintrust_NOOP_SPAN: typeof NOOP_SPAN;
+type braintrust_NoopSpan = NoopSpan;
+declare const braintrust_NoopSpan: typeof NoopSpan;
+type braintrust_ObjectMetadata = ObjectMetadata;
+type braintrust_PromiseUnless<B, R> = PromiseUnless<B, R>;
+type braintrust_Prompt<HasId extends boolean = true, HasVersion extends boolean = true> = Prompt<HasId, HasVersion>;
+declare const braintrust_Prompt: typeof Prompt;
+type braintrust_PromptRowWithId<HasId extends boolean = true, HasVersion extends boolean = true> = PromptRowWithId<HasId, HasVersion>;
+type braintrust_ReadonlyExperiment = ReadonlyExperiment;
+declare const braintrust_ReadonlyExperiment: typeof ReadonlyExperiment;
+type braintrust_ScoreSummary = ScoreSummary;
+type braintrust_SerializedBraintrustState = SerializedBraintrustState;
+type braintrust_SetCurrentArg = SetCurrentArg;
+type braintrust_Span = Span;
+type braintrust_SpanImpl = SpanImpl;
+declare const braintrust_SpanImpl: typeof SpanImpl;
+type braintrust_StartSpanArgs = StartSpanArgs;
+type braintrust_WithTransactionId<R> = WithTransactionId<R>;
+declare const braintrust_X_CACHED_HEADER: typeof X_CACHED_HEADER;
+declare const braintrust__internalGetGlobalState: typeof _internalGetGlobalState;
+declare const braintrust__internalSetInitialState: typeof _internalSetInitialState;
+declare const braintrust_braintrustStreamChunkSchema: typeof braintrustStreamChunkSchema;
+declare const braintrust_createFinalValuePassThroughStream: typeof createFinalValuePassThroughStream;
+declare const braintrust_currentExperiment: typeof currentExperiment;
+declare const braintrust_currentLogger: typeof currentLogger;
+declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
+declare const braintrust_flush: typeof flush;
+declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
+declare const braintrust_init: typeof init;
+declare const braintrust_initDataset: typeof initDataset;
+declare const braintrust_initExperiment: typeof initExperiment;
+declare const braintrust_initLogger: typeof initLogger;
+declare const braintrust_invoke: typeof invoke;
+declare const braintrust_loadPrompt: typeof loadPrompt;
+declare const braintrust_log: typeof log;
+declare const braintrust_logError: typeof logError;
+declare const braintrust_login: typeof login;
+declare const braintrust_loginToState: typeof loginToState;
+declare const braintrust_newId: typeof newId;
+declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
+declare const braintrust_renderMessage: typeof renderMessage;
+declare const braintrust_setFetch: typeof setFetch;
+declare const braintrust_startSpan: typeof startSpan;
+declare const braintrust_summarize: typeof summarize;
+declare const braintrust_traceable: typeof traceable;
+declare const braintrust_traced: typeof traced;
+declare const braintrust_updateSpan: typeof updateSpan;
+declare const braintrust_withCurrent: typeof withCurrent;
+declare const braintrust_withDataset: typeof withDataset;
+declare const braintrust_withExperiment: typeof withExperiment;
+declare const braintrust_withLogger: typeof withLogger;
+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, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, type braintrust_EndSpanArgs as EndSpanArgs, type braintrust_EvalCase as EvalCase, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, 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_NoopSpan as NoopSpan, type braintrust_ObjectMetadata as ObjectMetadata, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyExperiment as ReadonlyExperiment, type braintrust_ScoreSummary as ScoreSummary, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type braintrust_Span as Span, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getSpanParentObject as getSpanParentObject, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, 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_renderMessage as renderMessage, braintrust_setFetch as setFetch, braintrust_startSpan as startSpan, braintrust_summarize as summarize, 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_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+}
+
+export { type AnyDataset, type BackgroundLoggerOpts, type BaseMetadata, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type DataSummary, Dataset, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, type EndSpanArgs, type EvalCase, Experiment, type ExperimentSummary, type Exportable, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NoopSpan, type ObjectMetadata, type PromiseUnless, Prompt, type PromptRowWithId, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, renderMessage, setFetch, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, wrapOpenAI, wrapOpenAIv4, wrapTraced };

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
 import { GitMetadataSettings, LogFeedbackFullArgs, ExperimentEvent, BackgroundLogEvent, ExperimentLogFullArgs, ExperimentLogPartialArgs, IdField, SpanType, RepoInfo, DEFAULT_IS_LEGACY_DATASET, TRANSACTION_ID_FIELD, TransactionId, SpanObjectTypeV3, DatasetRecord } from '@braintrust/core';
-import { PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent } from '@braintrust/core/typespecs';
+import { PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent, StreamingMode } from '@braintrust/core/typespecs';
 import { z } from 'zod';
 
 interface IsoAsyncLocalStorage<T> {
@@ -213,6 +213,12 @@ declare class BraintrustState {
 }
 declare function _internalSetInitialState(): void;
 declare const _internalGetGlobalState: () => BraintrustState;
+declare class FailedHTTPResponse extends Error {
+    status: number;
+    text: string;
+    data: any;
+    constructor(status: number, text: string, data?: any);
+}
 declare class HTTPConnection {
     base_url: string;
     token: string | null;
@@ -225,9 +231,9 @@ declare class HTTPConnection {
     static sanitize_token(token: string): string;
     set_token(token: string): void;
     _reset(): void;
-    get(path: string, params?: Record<string, string | undefined> | undefined, config?: RequestInit): Promise<Response>;
+    get(path: string, params?: Record<string, string | string[] | undefined> | undefined, config?: RequestInit): Promise<Response>;
     post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
-    get_json(object_type: string, args?: Record<string, string | undefined> | undefined, retries?: number): Promise<any>;
+    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>;
 }
 interface ObjectMetadata {
@@ -538,7 +544,7 @@ type LoadPromptOptions = FullLoginOptions & {
  * });
  * ```
  */
-declare function loadPrompt({ projectName, projectId, slug, version, defaults, noTrace, appUrl, apiKey, orgName, fetch, forceLogin, state: stateArg, }: LoadPromptOptions): Promise<Prompt>;
+declare function loadPrompt({ projectName, projectId, slug, version, defaults, noTrace, appUrl, apiKey, orgName, fetch, forceLogin, state: stateArg, }: LoadPromptOptions): Promise<Prompt<true, true>>;
 /**
  * Options for logging in to Braintrust.
  */
@@ -982,19 +988,20 @@ type CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPromptParams
 } & (Flavor extends "chat" ? ChatPrompt : Flavor extends "completion" ? CompletionPrompt : {});
 type DefaultPromptArgs = Partial<CompiledPromptParams & AnyModelParam & ChatPrompt & CompletionPrompt>;
 declare function renderMessage<T extends Message>(render: (template: string) => string, message: T): T;
-declare class Prompt {
+type PromptRowWithId<HasId extends boolean = true, HasVersion extends boolean = true> = Omit<Prompt$1, "log_id" | "org_id" | "project_id" | "id" | "_xact_id"> & Partial<Pick<Prompt$1, "project_id">> & (HasId extends true ? Pick<Prompt$1, "id"> : Partial<Pick<Prompt$1, "id">>) & (HasVersion extends true ? Pick<Prompt$1, "_xact_id"> : Partial<Pick<Prompt$1, "_xact_id">>);
+declare class Prompt<HasId extends boolean = true, HasVersion extends boolean = true> {
     private metadata;
     private defaults;
     private noTrace;
     private parsedPromptData;
     private hasParsedPromptData;
-    constructor(metadata: Omit<Prompt$1, "log_id"> | PromptSessionEvent, defaults: DefaultPromptArgs, noTrace: boolean);
-    get id(): string;
-    get projectId(): string;
+    constructor(metadata: PromptRowWithId<HasId, HasVersion> | PromptSessionEvent, defaults: DefaultPromptArgs, noTrace: boolean);
+    get id(): HasId extends true ? string : string | undefined;
+    get projectId(): string | undefined;
     get name(): string;
     get slug(): string;
     get prompt(): PromptData["prompt"];
-    get version(): TransactionId;
+    get version(): HasId extends true ? TransactionId : TransactionId | undefined;
     get options(): NonNullable<PromptData["options"]>;
     /**
      * Build the prompt with the given formatting options. The args you pass in will
@@ -1005,6 +1012,7 @@ declare class Prompt {
      */
     build<Flavor extends "chat" | "completion" = "chat">(buildArgs: unknown, options?: {
         flavor?: Flavor;
+        messages?: Message[];
     }): CompiledPrompt<Flavor>;
     private runBuild;
     private getParsedPromptData;
@@ -1108,6 +1116,82 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
 }, {
     data: string;
     type: "json_delta";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "error";
+}, {
+    data: string;
+    type: "error";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    data: z.ZodObject<{
+        id: z.ZodString;
+        object_type: z.ZodEnum<["prompt", "tool", "scorer", "task"]>;
+        format: z.ZodEnum<["llm", "code", "global"]>;
+        output_type: z.ZodEnum<["completion", "score", "any"]>;
+        name: z.ZodString;
+        event: z.ZodEnum<["text_delta", "json_delta", "error", "start", "done"]>;
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    }, {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    };
+    type: "progress";
+}, {
+    data: {
+        format: "code" | "global" | "llm";
+        data: string;
+        name: string;
+        id: string;
+        object_type: "prompt" | "tool" | "scorer" | "task";
+        event: "error" | "text_delta" | "json_delta" | "start" | "done";
+        output_type: "completion" | "score" | "any";
+    };
+    type: "progress";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"start">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "start";
+}, {
+    data: string;
+    type: "start";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    type: "done";
+}, {
+    data: string;
+    type: "done";
 }>]>;
 /**
  * A chunk of data from a Braintrust stream. Each chunk type matches
@@ -1168,7 +1252,7 @@ declare class BraintrustStream {
  * @param onFinal A function to call with the final value of the stream.
  * @returns A new stream that passes through the final value of the stream.
  */
-declare function createFinalValuePassThroughStream<T extends BraintrustStreamChunk | string | Uint8Array>(onFinal: (result: unknown) => void): TransformStream<T, BraintrustStreamChunk>;
+declare function createFinalValuePassThroughStream<T extends BraintrustStreamChunk | string | Uint8Array>(onFinal: (result: unknown) => void, onError: (error: unknown) => void): TransformStream<T, BraintrustStreamChunk>;
 declare function devNullWritableStream(): WritableStream;
 
 /**
@@ -1207,6 +1291,10 @@ interface InvokeFunctionArgs<Input, Output, Stream extends boolean = false> {
      * The input to the function. This will be logged as the `input` field in the span.
      */
     input: Input;
+    /**
+     * Additional OpenAI-style messages to add to the prompt (only works for llm functions).
+     */
+    messages?: Message[];
     /**
      * The parent of the function. This can be an existing span, logger, or experiment, or
      * the output of `.export()` if you are distributed tracing. If unspecified, will use
@@ -1220,6 +1308,12 @@ interface InvokeFunctionArgs<Input, Output, Stream extends boolean = false> {
      * object.
      */
     stream?: Stream;
+    /**
+     * The mode of the function. If "auto", will return a string if the function returns a string,
+     * and a JSON object otherwise. If "parallel", will return an array of JSON objects with one
+     * object per tool call.
+     */
+    mode?: StreamingMode;
     /**
      * A Zod schema to validate the output of the function and return a typed value. This
      * is only used if `stream` is false.
@@ -1281,4 +1375,100 @@ declare const LEGACY_CACHED_HEADER = "x-cached";
 declare const X_CACHED_HEADER = "x-bt-cached";
 declare function parseCachedHeader(value: string | null | undefined): number | undefined;
 
-export { type AnyDataset, type BackgroundLoggerOpts, type BaseMetadata, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type DataSummary, Dataset, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, type EndSpanArgs, type EvalCase, Experiment, type ExperimentSummary, type Exportable, type FullInitOptions, type FullLoginOptions, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NoopSpan, type ObjectMetadata, type PromiseUnless, Prompt, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, renderMessage, setFetch, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+type braintrust_AnyDataset = AnyDataset;
+type braintrust_BackgroundLoggerOpts = BackgroundLoggerOpts;
+type braintrust_BaseMetadata = BaseMetadata;
+type braintrust_BraintrustState = BraintrustState;
+declare const braintrust_BraintrustState: typeof BraintrustState;
+type braintrust_BraintrustStream = BraintrustStream;
+declare const braintrust_BraintrustStream: typeof BraintrustStream;
+type braintrust_BraintrustStreamChunk = BraintrustStreamChunk;
+type braintrust_ChatPrompt = ChatPrompt;
+type braintrust_CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPrompt<Flavor>;
+type braintrust_CompiledPromptParams = CompiledPromptParams;
+type braintrust_CompletionPrompt = CompletionPrompt;
+type braintrust_DataSummary = DataSummary;
+type braintrust_Dataset<IsLegacyDataset extends boolean = typeof DEFAULT_IS_LEGACY_DATASET> = Dataset<IsLegacyDataset>;
+declare const braintrust_Dataset: typeof Dataset;
+type braintrust_DatasetSummary = DatasetSummary;
+type braintrust_DefaultMetadataType = DefaultMetadataType;
+type braintrust_DefaultPromptArgs = DefaultPromptArgs;
+type braintrust_EndSpanArgs = EndSpanArgs;
+type braintrust_EvalCase<Input, Expected, Metadata> = EvalCase<Input, Expected, Metadata>;
+type braintrust_Experiment = Experiment;
+declare const braintrust_Experiment: typeof Experiment;
+type braintrust_ExperimentSummary = ExperimentSummary;
+type braintrust_Exportable = Exportable;
+type braintrust_FailedHTTPResponse = FailedHTTPResponse;
+declare const braintrust_FailedHTTPResponse: typeof FailedHTTPResponse;
+type braintrust_FullInitOptions<IsOpen extends boolean> = FullInitOptions<IsOpen>;
+type braintrust_FullLoginOptions = FullLoginOptions;
+type braintrust_InitOptions<IsOpen extends boolean> = InitOptions<IsOpen>;
+type braintrust_InvokeFunctionArgs<Input, Output, Stream extends boolean = false> = InvokeFunctionArgs<Input, Output, Stream>;
+type braintrust_InvokeReturn<Stream extends boolean, Output> = InvokeReturn<Stream, Output>;
+declare const braintrust_LEGACY_CACHED_HEADER: typeof LEGACY_CACHED_HEADER;
+type braintrust_LogOptions<IsAsyncFlush> = LogOptions<IsAsyncFlush>;
+type braintrust_Logger<IsAsyncFlush extends boolean> = Logger<IsAsyncFlush>;
+declare const braintrust_Logger: typeof Logger;
+type braintrust_LoginOptions = LoginOptions;
+type braintrust_MetricSummary = MetricSummary;
+declare const braintrust_NOOP_SPAN: typeof NOOP_SPAN;
+type braintrust_NoopSpan = NoopSpan;
+declare const braintrust_NoopSpan: typeof NoopSpan;
+type braintrust_ObjectMetadata = ObjectMetadata;
+type braintrust_PromiseUnless<B, R> = PromiseUnless<B, R>;
+type braintrust_Prompt<HasId extends boolean = true, HasVersion extends boolean = true> = Prompt<HasId, HasVersion>;
+declare const braintrust_Prompt: typeof Prompt;
+type braintrust_PromptRowWithId<HasId extends boolean = true, HasVersion extends boolean = true> = PromptRowWithId<HasId, HasVersion>;
+type braintrust_ReadonlyExperiment = ReadonlyExperiment;
+declare const braintrust_ReadonlyExperiment: typeof ReadonlyExperiment;
+type braintrust_ScoreSummary = ScoreSummary;
+type braintrust_SerializedBraintrustState = SerializedBraintrustState;
+type braintrust_SetCurrentArg = SetCurrentArg;
+type braintrust_Span = Span;
+type braintrust_SpanImpl = SpanImpl;
+declare const braintrust_SpanImpl: typeof SpanImpl;
+type braintrust_StartSpanArgs = StartSpanArgs;
+type braintrust_WithTransactionId<R> = WithTransactionId<R>;
+declare const braintrust_X_CACHED_HEADER: typeof X_CACHED_HEADER;
+declare const braintrust__internalGetGlobalState: typeof _internalGetGlobalState;
+declare const braintrust__internalSetInitialState: typeof _internalSetInitialState;
+declare const braintrust_braintrustStreamChunkSchema: typeof braintrustStreamChunkSchema;
+declare const braintrust_createFinalValuePassThroughStream: typeof createFinalValuePassThroughStream;
+declare const braintrust_currentExperiment: typeof currentExperiment;
+declare const braintrust_currentLogger: typeof currentLogger;
+declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
+declare const braintrust_flush: typeof flush;
+declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
+declare const braintrust_init: typeof init;
+declare const braintrust_initDataset: typeof initDataset;
+declare const braintrust_initExperiment: typeof initExperiment;
+declare const braintrust_initLogger: typeof initLogger;
+declare const braintrust_invoke: typeof invoke;
+declare const braintrust_loadPrompt: typeof loadPrompt;
+declare const braintrust_log: typeof log;
+declare const braintrust_logError: typeof logError;
+declare const braintrust_login: typeof login;
+declare const braintrust_loginToState: typeof loginToState;
+declare const braintrust_newId: typeof newId;
+declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
+declare const braintrust_renderMessage: typeof renderMessage;
+declare const braintrust_setFetch: typeof setFetch;
+declare const braintrust_startSpan: typeof startSpan;
+declare const braintrust_summarize: typeof summarize;
+declare const braintrust_traceable: typeof traceable;
+declare const braintrust_traced: typeof traced;
+declare const braintrust_updateSpan: typeof updateSpan;
+declare const braintrust_withCurrent: typeof withCurrent;
+declare const braintrust_withDataset: typeof withDataset;
+declare const braintrust_withExperiment: typeof withExperiment;
+declare const braintrust_withLogger: typeof withLogger;
+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, type braintrust_BackgroundLoggerOpts as BackgroundLoggerOpts, type braintrust_BaseMetadata as BaseMetadata, braintrust_BraintrustState as BraintrustState, braintrust_BraintrustStream as BraintrustStream, type braintrust_BraintrustStreamChunk as BraintrustStreamChunk, type braintrust_ChatPrompt as ChatPrompt, type braintrust_CompiledPrompt as CompiledPrompt, type braintrust_CompiledPromptParams as CompiledPromptParams, type braintrust_CompletionPrompt as CompletionPrompt, type braintrust_DataSummary as DataSummary, braintrust_Dataset as Dataset, type braintrust_DatasetSummary as DatasetSummary, type braintrust_DefaultMetadataType as DefaultMetadataType, type braintrust_DefaultPromptArgs as DefaultPromptArgs, type braintrust_EndSpanArgs as EndSpanArgs, type braintrust_EvalCase as EvalCase, braintrust_Experiment as Experiment, type braintrust_ExperimentSummary as ExperimentSummary, type braintrust_Exportable as Exportable, braintrust_FailedHTTPResponse as FailedHTTPResponse, type braintrust_FullInitOptions as FullInitOptions, type braintrust_FullLoginOptions as FullLoginOptions, type braintrust_InitOptions as InitOptions, type braintrust_InvokeFunctionArgs as InvokeFunctionArgs, type braintrust_InvokeReturn as InvokeReturn, braintrust_LEGACY_CACHED_HEADER as LEGACY_CACHED_HEADER, 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_NoopSpan as NoopSpan, type braintrust_ObjectMetadata as ObjectMetadata, type braintrust_PromiseUnless as PromiseUnless, braintrust_Prompt as Prompt, type braintrust_PromptRowWithId as PromptRowWithId, braintrust_ReadonlyExperiment as ReadonlyExperiment, type braintrust_ScoreSummary as ScoreSummary, type braintrust_SerializedBraintrustState as SerializedBraintrustState, type braintrust_SetCurrentArg as SetCurrentArg, type braintrust_Span as Span, braintrust_SpanImpl as SpanImpl, type braintrust_StartSpanArgs as StartSpanArgs, type braintrust_WithTransactionId as WithTransactionId, braintrust_X_CACHED_HEADER as X_CACHED_HEADER, braintrust__internalGetGlobalState as _internalGetGlobalState, braintrust__internalSetInitialState as _internalSetInitialState, braintrust_braintrustStreamChunkSchema as braintrustStreamChunkSchema, braintrust_createFinalValuePassThroughStream as createFinalValuePassThroughStream, braintrust_currentExperiment as currentExperiment, braintrust_currentLogger as currentLogger, braintrust_currentSpan as currentSpan, braintrust_devNullWritableStream as devNullWritableStream, braintrust_flush as flush, braintrust_getSpanParentObject as getSpanParentObject, braintrust_init as init, braintrust_initDataset as initDataset, braintrust_initExperiment as initExperiment, 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_renderMessage as renderMessage, braintrust_setFetch as setFetch, braintrust_startSpan as startSpan, braintrust_summarize as summarize, 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_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+}
+
+export { type AnyDataset, type BackgroundLoggerOpts, type BaseMetadata, BraintrustState, BraintrustStream, type BraintrustStreamChunk, type ChatPrompt, type CompiledPrompt, type CompiledPromptParams, type CompletionPrompt, type DataSummary, Dataset, type DatasetSummary, type DefaultMetadataType, type DefaultPromptArgs, type EndSpanArgs, type EvalCase, Experiment, type ExperimentSummary, type Exportable, FailedHTTPResponse, type FullInitOptions, type FullLoginOptions, type InitOptions, type InvokeFunctionArgs, type InvokeReturn, LEGACY_CACHED_HEADER, type LogOptions, Logger, type LoginOptions, type MetricSummary, NOOP_SPAN, NoopSpan, type ObjectMetadata, type PromiseUnless, Prompt, type PromptRowWithId, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, renderMessage, setFetch, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, wrapOpenAI, wrapOpenAIv4, wrapTraced };