braintrust 0.0.183 → 0.0.185

package/dist/browser.d.mts

@@ -1,5 +1,5 @@
 import { LogFeedbackFullArgs, ExperimentEvent, BackgroundLogEvent, ExperimentLogFullArgs, ExperimentLogPartialArgs, IdField, SpanType, SpanComponentsV3, DEFAULT_IS_LEGACY_DATASET, TRANSACTION_ID_FIELD, TransactionId, SpanObjectTypeV3, DatasetRecord } from '@braintrust/core';
-import { GitMetadataSettings, AttachmentReference, AttachmentStatus, RepoInfo, PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent, CallEventSchema, StreamingMode } from '@braintrust/core/typespecs';
+import { GitMetadataSettings, AttachmentReference, AttachmentStatus, RepoInfo, PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, ModelParams, PromptSessionEvent, CallEventSchema, StreamingMode } from '@braintrust/core/typespecs';
 import { z } from 'zod';
 
 interface IsoAsyncLocalStorage<T> {
@@ -8,14 +8,6 @@ interface IsoAsyncLocalStorage<T> {
     getStore(): T | undefined;
 }
 
-declare class LazyValue<T> {
-    private callable;
-    private value;
-    constructor(callable: () => Promise<T>);
-    get(): Promise<T>;
-    get hasComputed(): boolean;
-}
-
 /**
  * Options for configuring an LRUCache instance.
  */
@@ -183,6 +175,14 @@ declare class PromptCache {
     set(key: PromptKey, value: Prompt): Promise<void>;
 }
 
+declare class LazyValue<T> {
+    private callable;
+    private value;
+    constructor(callable: () => Promise<T>);
+    get(): Promise<T>;
+    get hasSucceeded(): boolean;
+}
+
 type SetCurrentArg = {
     setCurrent?: boolean;
 };
@@ -215,6 +215,18 @@ interface Span extends Exportable {
      * Row ID of the span.
      */
     id: string;
+    /**
+     * Span ID of the span.
+     */
+    spanId: string;
+    /**
+     * Root span ID of the span.
+     */
+    rootSpanId: string;
+    /**
+     * Parent span IDs of the span.
+     */
+    spanParents: string[];
     /**
      * Incrementally update the current span with new data. The event will be batched and uploaded behind the scenes.
      *
@@ -303,6 +315,9 @@ interface Span extends Exportable {
  */
 declare class NoopSpan implements Span {
     id: string;
+    spanId: string;
+    rootSpanId: string;
+    spanParents: string[];
     kind: "span";
     constructor();
     log(_: ExperimentLogPartialArgs): void;
@@ -811,6 +826,7 @@ type InitDatasetOptions<IsLegacyDataset extends boolean> = FullLoginOptions & {
     projectId?: string;
     metadata?: Record<string, unknown>;
     state?: BraintrustState;
+    _internal_btql?: Record<string, unknown>;
 } & UseOutputOption<IsLegacyDataset>;
 type FullInitDatasetOptions<IsLegacyDataset extends boolean> = {
     project?: string;
@@ -1078,8 +1094,9 @@ declare class ObjectFetcher<RecordType> implements AsyncIterable<WithTransaction
     private objectType;
     private pinnedVersion;
     private mutateRecord?;
+    private _internal_btql?;
     private _fetchedData;
-    constructor(objectType: "dataset" | "experiment", pinnedVersion: string | undefined, mutateRecord?: ((r: any) => RecordType) | undefined);
+    constructor(objectType: "dataset" | "experiment", pinnedVersion: string | undefined, mutateRecord?: ((r: any) => RecordType) | undefined, _internal_btql?: Record<string, unknown> | undefined);
     get id(): Promise<string>;
     protected getState(): Promise<BraintrustState>;
     fetch(): AsyncGenerator<WithTransactionId<RecordType>>;
@@ -1095,6 +1112,7 @@ type EvalCase<Input, Expected, Metadata> = {
     tags?: string[];
     id?: string;
     _xact_id?: TransactionId;
+    created?: string | null;
     upsert_id?: string;
 } & (Expected extends void ? object : {
     expected: Expected;
@@ -1239,9 +1257,9 @@ declare class SpanImpl implements Span {
     private parentObjectId;
     private parentComputeObjectMetadataArgs;
     private _id;
-    private spanId;
-    private rootSpanId;
-    private spanParents;
+    private _spanId;
+    private _rootSpanId;
+    private _spanParents;
     kind: "span";
     constructor(args: {
         state: BraintrustState;
@@ -1252,6 +1270,9 @@ declare class SpanImpl implements Span {
         defaultRootType?: SpanType;
     } & Omit<StartSpanArgs, "parent">);
     get id(): string;
+    get spanId(): string;
+    get rootSpanId(): string;
+    get spanParents(): string[];
     setAttributes(args: Omit<StartSpanArgs, "event">): void;
     log(event: ExperimentLogPartialArgs): void;
     private logInternal;
@@ -1275,7 +1296,8 @@ declare class Dataset<IsLegacyDataset extends boolean = typeof DEFAULT_IS_LEGACY
     private state;
     private readonly lazyMetadata;
     private readonly __braintrust_dataset_marker;
-    constructor(state: BraintrustState, lazyMetadata: LazyValue<ProjectDatasetMetadata>, pinnedVersion?: string, legacy?: IsLegacyDataset);
+    private newRecords;
+    constructor(state: BraintrustState, lazyMetadata: LazyValue<ProjectDatasetMetadata>, pinnedVersion?: string, legacy?: IsLegacyDataset, _internal_btql?: Record<string, unknown>);
     get id(): Promise<string>;
     get name(): Promise<string>;
     get project(): Promise<ObjectMetadata>;
@@ -1373,6 +1395,14 @@ type CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPromptParams
 type DefaultPromptArgs = Partial<CompiledPromptParams & AnyModelParam & ChatPrompt & CompletionPrompt>;
 declare function renderMessage<T extends Message>(render: (template: string) => string, message: T): T;
 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 function deserializePlainStringAsJSON(s: string): {
+    value: any;
+    error: undefined;
+} | {
+    value: string;
+    error: unknown;
+};
+declare function renderPromptParams(params: ModelParams | undefined, args: unknown): ModelParams | undefined;
 declare class Prompt<HasId extends boolean = true, HasVersion extends boolean = true> {
     private metadata;
     private defaults;
@@ -1458,11 +1488,16 @@ interface ExperimentSummary {
 /**
  * Summary of a dataset's data.
  *
- * @property newRecords New or updated records added in this session.
  * @property totalRecords Total records in the dataset.
  */
 interface DataSummary {
+    /**
+     * New or updated records added in this session.
+     */
     newRecords: number;
+    /**
+     * Total records in the dataset.
+     */
     totalRecords: number;
 }
 /**
@@ -1479,7 +1514,7 @@ interface DatasetSummary {
     datasetName: string;
     projectUrl: string;
     datasetUrl: string;
-    dataSummary: DataSummary;
+    dataSummary: DataSummary | undefined;
 }
 /**
  * Allows accessing helper functions for testing.
@@ -1551,16 +1586,19 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: z.ZodString;
             id: z.ZodString;
             _xact_id: z.ZodString;
+            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
             object_type: "function" | "experiment" | "dataset" | "prompt" | "prompt_session" | "project_logs";
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         }, {
             object_type: "function" | "experiment" | "dataset" | "prompt" | "prompt_session" | "project_logs";
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         }>>>;
         format: z.ZodEnum<["llm", "code", "global"]>;
         output_type: z.ZodEnum<["completion", "score", "any"]>;
@@ -1580,6 +1618,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     }, {
         format: "code" | "global" | "llm";
@@ -1594,6 +1633,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -1610,6 +1650,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     };
     type: "progress";
@@ -1627,6 +1668,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     };
     type: "progress";
@@ -1937,6 +1979,7 @@ declare const braintrust_createFinalValuePassThroughStream: typeof createFinalVa
 declare const braintrust_currentExperiment: typeof currentExperiment;
 declare const braintrust_currentLogger: typeof currentLogger;
 declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_deserializePlainStringAsJSON: typeof deserializePlainStringAsJSON;
 declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
 declare const braintrust_flush: typeof flush;
 declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
@@ -1955,6 +1998,7 @@ declare const braintrust_newId: typeof newId;
 declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
 declare const braintrust_permalink: typeof permalink;
 declare const braintrust_renderMessage: typeof renderMessage;
+declare const braintrust_renderPromptParams: typeof renderPromptParams;
 declare const braintrust_setFetch: typeof setFetch;
 declare const braintrust_spanComponentsToObjectId: typeof spanComponentsToObjectId;
 declare const braintrust_startSpan: typeof startSpan;
@@ -1971,7 +2015,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, 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_ReadonlyAttachment as ReadonlyAttachment, 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__exportsForTestingOnly as _exportsForTestingOnly, 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_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_renderMessage as renderMessage, braintrust_setFetch as setFetch, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, 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_withParent as withParent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+  export { type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, 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_ReadonlyAttachment as ReadonlyAttachment, 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__exportsForTestingOnly as _exportsForTestingOnly, 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_deserializePlainStringAsJSON as deserializePlainStringAsJSON, 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_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_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_setFetch as setFetch, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, 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_withParent as withParent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
-export { type AnyDataset, Attachment, type AttachmentParams, 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, ReadonlyAttachment, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, renderMessage, setFetch, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { type AnyDataset, Attachment, type AttachmentParams, 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, ReadonlyAttachment, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, deserializePlainStringAsJSON, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, renderMessage, renderPromptParams, setFetch, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapOpenAI, wrapOpenAIv4, wrapTraced };

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
 import { LogFeedbackFullArgs, ExperimentEvent, BackgroundLogEvent, ExperimentLogFullArgs, ExperimentLogPartialArgs, IdField, SpanType, SpanComponentsV3, DEFAULT_IS_LEGACY_DATASET, TRANSACTION_ID_FIELD, TransactionId, SpanObjectTypeV3, DatasetRecord } from '@braintrust/core';
-import { GitMetadataSettings, AttachmentReference, AttachmentStatus, RepoInfo, PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, PromptSessionEvent, CallEventSchema, StreamingMode } from '@braintrust/core/typespecs';
+import { GitMetadataSettings, AttachmentReference, AttachmentStatus, RepoInfo, PromptData, OpenAIMessage, Tools, AnyModelParam, Message, Prompt as Prompt$1, ModelParams, PromptSessionEvent, CallEventSchema, StreamingMode } from '@braintrust/core/typespecs';
 import { z } from 'zod';
 
 interface IsoAsyncLocalStorage<T> {
@@ -8,14 +8,6 @@ interface IsoAsyncLocalStorage<T> {
     getStore(): T | undefined;
 }
 
-declare class LazyValue<T> {
-    private callable;
-    private value;
-    constructor(callable: () => Promise<T>);
-    get(): Promise<T>;
-    get hasComputed(): boolean;
-}
-
 /**
  * Options for configuring an LRUCache instance.
  */
@@ -183,6 +175,14 @@ declare class PromptCache {
     set(key: PromptKey, value: Prompt): Promise<void>;
 }
 
+declare class LazyValue<T> {
+    private callable;
+    private value;
+    constructor(callable: () => Promise<T>);
+    get(): Promise<T>;
+    get hasSucceeded(): boolean;
+}
+
 type SetCurrentArg = {
     setCurrent?: boolean;
 };
@@ -215,6 +215,18 @@ interface Span extends Exportable {
      * Row ID of the span.
      */
     id: string;
+    /**
+     * Span ID of the span.
+     */
+    spanId: string;
+    /**
+     * Root span ID of the span.
+     */
+    rootSpanId: string;
+    /**
+     * Parent span IDs of the span.
+     */
+    spanParents: string[];
     /**
      * Incrementally update the current span with new data. The event will be batched and uploaded behind the scenes.
      *
@@ -303,6 +315,9 @@ interface Span extends Exportable {
  */
 declare class NoopSpan implements Span {
     id: string;
+    spanId: string;
+    rootSpanId: string;
+    spanParents: string[];
     kind: "span";
     constructor();
     log(_: ExperimentLogPartialArgs): void;
@@ -811,6 +826,7 @@ type InitDatasetOptions<IsLegacyDataset extends boolean> = FullLoginOptions & {
     projectId?: string;
     metadata?: Record<string, unknown>;
     state?: BraintrustState;
+    _internal_btql?: Record<string, unknown>;
 } & UseOutputOption<IsLegacyDataset>;
 type FullInitDatasetOptions<IsLegacyDataset extends boolean> = {
     project?: string;
@@ -1078,8 +1094,9 @@ declare class ObjectFetcher<RecordType> implements AsyncIterable<WithTransaction
     private objectType;
     private pinnedVersion;
     private mutateRecord?;
+    private _internal_btql?;
     private _fetchedData;
-    constructor(objectType: "dataset" | "experiment", pinnedVersion: string | undefined, mutateRecord?: ((r: any) => RecordType) | undefined);
+    constructor(objectType: "dataset" | "experiment", pinnedVersion: string | undefined, mutateRecord?: ((r: any) => RecordType) | undefined, _internal_btql?: Record<string, unknown> | undefined);
     get id(): Promise<string>;
     protected getState(): Promise<BraintrustState>;
     fetch(): AsyncGenerator<WithTransactionId<RecordType>>;
@@ -1095,6 +1112,7 @@ type EvalCase<Input, Expected, Metadata> = {
     tags?: string[];
     id?: string;
     _xact_id?: TransactionId;
+    created?: string | null;
     upsert_id?: string;
 } & (Expected extends void ? object : {
     expected: Expected;
@@ -1239,9 +1257,9 @@ declare class SpanImpl implements Span {
     private parentObjectId;
     private parentComputeObjectMetadataArgs;
     private _id;
-    private spanId;
-    private rootSpanId;
-    private spanParents;
+    private _spanId;
+    private _rootSpanId;
+    private _spanParents;
     kind: "span";
     constructor(args: {
         state: BraintrustState;
@@ -1252,6 +1270,9 @@ declare class SpanImpl implements Span {
         defaultRootType?: SpanType;
     } & Omit<StartSpanArgs, "parent">);
     get id(): string;
+    get spanId(): string;
+    get rootSpanId(): string;
+    get spanParents(): string[];
     setAttributes(args: Omit<StartSpanArgs, "event">): void;
     log(event: ExperimentLogPartialArgs): void;
     private logInternal;
@@ -1275,7 +1296,8 @@ declare class Dataset<IsLegacyDataset extends boolean = typeof DEFAULT_IS_LEGACY
     private state;
     private readonly lazyMetadata;
     private readonly __braintrust_dataset_marker;
-    constructor(state: BraintrustState, lazyMetadata: LazyValue<ProjectDatasetMetadata>, pinnedVersion?: string, legacy?: IsLegacyDataset);
+    private newRecords;
+    constructor(state: BraintrustState, lazyMetadata: LazyValue<ProjectDatasetMetadata>, pinnedVersion?: string, legacy?: IsLegacyDataset, _internal_btql?: Record<string, unknown>);
     get id(): Promise<string>;
     get name(): Promise<string>;
     get project(): Promise<ObjectMetadata>;
@@ -1373,6 +1395,14 @@ type CompiledPrompt<Flavor extends "chat" | "completion"> = CompiledPromptParams
 type DefaultPromptArgs = Partial<CompiledPromptParams & AnyModelParam & ChatPrompt & CompletionPrompt>;
 declare function renderMessage<T extends Message>(render: (template: string) => string, message: T): T;
 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 function deserializePlainStringAsJSON(s: string): {
+    value: any;
+    error: undefined;
+} | {
+    value: string;
+    error: unknown;
+};
+declare function renderPromptParams(params: ModelParams | undefined, args: unknown): ModelParams | undefined;
 declare class Prompt<HasId extends boolean = true, HasVersion extends boolean = true> {
     private metadata;
     private defaults;
@@ -1458,11 +1488,16 @@ interface ExperimentSummary {
 /**
  * Summary of a dataset's data.
  *
- * @property newRecords New or updated records added in this session.
  * @property totalRecords Total records in the dataset.
  */
 interface DataSummary {
+    /**
+     * New or updated records added in this session.
+     */
     newRecords: number;
+    /**
+     * Total records in the dataset.
+     */
     totalRecords: number;
 }
 /**
@@ -1479,7 +1514,7 @@ interface DatasetSummary {
     datasetName: string;
     projectUrl: string;
     datasetUrl: string;
-    dataSummary: DataSummary;
+    dataSummary: DataSummary | undefined;
 }
 /**
  * Allows accessing helper functions for testing.
@@ -1551,16 +1586,19 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: z.ZodString;
             id: z.ZodString;
             _xact_id: z.ZodString;
+            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
             object_type: "function" | "experiment" | "dataset" | "prompt" | "prompt_session" | "project_logs";
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         }, {
             object_type: "function" | "experiment" | "dataset" | "prompt" | "prompt_session" | "project_logs";
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         }>>>;
         format: z.ZodEnum<["llm", "code", "global"]>;
         output_type: z.ZodEnum<["completion", "score", "any"]>;
@@ -1580,6 +1618,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     }, {
         format: "code" | "global" | "llm";
@@ -1594,6 +1633,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -1610,6 +1650,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     };
     type: "progress";
@@ -1627,6 +1668,7 @@ declare const braintrustStreamChunkSchema: z.ZodUnion<[z.ZodObject<{
             object_id: string;
             id: string;
             _xact_id: string;
+            created?: string | null | undefined;
         } | null | undefined;
     };
     type: "progress";
@@ -1937,6 +1979,7 @@ declare const braintrust_createFinalValuePassThroughStream: typeof createFinalVa
 declare const braintrust_currentExperiment: typeof currentExperiment;
 declare const braintrust_currentLogger: typeof currentLogger;
 declare const braintrust_currentSpan: typeof currentSpan;
+declare const braintrust_deserializePlainStringAsJSON: typeof deserializePlainStringAsJSON;
 declare const braintrust_devNullWritableStream: typeof devNullWritableStream;
 declare const braintrust_flush: typeof flush;
 declare const braintrust_getSpanParentObject: typeof getSpanParentObject;
@@ -1955,6 +1998,7 @@ declare const braintrust_newId: typeof newId;
 declare const braintrust_parseCachedHeader: typeof parseCachedHeader;
 declare const braintrust_permalink: typeof permalink;
 declare const braintrust_renderMessage: typeof renderMessage;
+declare const braintrust_renderPromptParams: typeof renderPromptParams;
 declare const braintrust_setFetch: typeof setFetch;
 declare const braintrust_spanComponentsToObjectId: typeof spanComponentsToObjectId;
 declare const braintrust_startSpan: typeof startSpan;
@@ -1971,7 +2015,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, 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_ReadonlyAttachment as ReadonlyAttachment, 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__exportsForTestingOnly as _exportsForTestingOnly, 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_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_renderMessage as renderMessage, braintrust_setFetch as setFetch, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, 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_withParent as withParent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
+  export { type braintrust_AnyDataset as AnyDataset, braintrust_Attachment as Attachment, type braintrust_AttachmentParams as AttachmentParams, 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_ReadonlyAttachment as ReadonlyAttachment, 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__exportsForTestingOnly as _exportsForTestingOnly, 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_deserializePlainStringAsJSON as deserializePlainStringAsJSON, 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_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_renderMessage as renderMessage, braintrust_renderPromptParams as renderPromptParams, braintrust_setFetch as setFetch, braintrust_spanComponentsToObjectId as spanComponentsToObjectId, 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_withParent as withParent, braintrust_wrapOpenAI as wrapOpenAI, braintrust_wrapOpenAIv4 as wrapOpenAIv4, braintrust_wrapTraced as wrapTraced };
 }
 
-export { type AnyDataset, Attachment, type AttachmentParams, 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, ReadonlyAttachment, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, renderMessage, setFetch, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapOpenAI, wrapOpenAIv4, wrapTraced };
+export { type AnyDataset, Attachment, type AttachmentParams, 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, ReadonlyAttachment, ReadonlyExperiment, type ScoreSummary, type SerializedBraintrustState, type SetCurrentArg, type Span, SpanImpl, type StartSpanArgs, type WithTransactionId, X_CACHED_HEADER, _exportsForTestingOnly, _internalGetGlobalState, _internalSetInitialState, braintrustStreamChunkSchema, createFinalValuePassThroughStream, currentExperiment, currentLogger, currentSpan, braintrust as default, deserializePlainStringAsJSON, devNullWritableStream, flush, getSpanParentObject, init, initDataset, initExperiment, initFunction, initLogger, invoke, loadPrompt, log, logError, login, loginToState, newId, parseCachedHeader, permalink, renderMessage, renderPromptParams, setFetch, spanComponentsToObjectId, startSpan, summarize, traceable, traced, updateSpan, withCurrent, withDataset, withExperiment, withLogger, withParent, wrapOpenAI, wrapOpenAIv4, wrapTraced };