braintrust 0.4.1 → 0.4.3

package/dist/browser.js

@@ -5124,7 +5124,6 @@ var init_context3 = __esm({
   "src/otel/context.ts"() {
     "use strict";
     init_logger();
-    init_util();
     OTEL_NOT_INSTALLED_MESSAGE = "OpenTelemetry packages are not installed. Install them with: npm install @opentelemetry/api @opentelemetry/sdk-trace-base";
     otelTrace = null;
     otelContext = null;
@@ -5187,6 +5186,10 @@ var init_context3 = __esm({
             const currentContext = otelContext.active();
             let newContext = otelTrace.setSpan(currentContext, wrappedContext);
             newContext = newContext.setValue("braintrust_span", span);
+            const parentValue = span._getOtelParent();
+            if (parentValue) {
+              newContext = newContext.setValue("braintrust.parent", parentValue);
+            }
             return otelContext.with(newContext, callback);
           }
         } catch (error) {
@@ -5202,34 +5205,6 @@ var init_context3 = __esm({
         }
         return void 0;
       }
-      _getOtelParent(span) {
-        if (!span.parentObjectType || !span.parentObjectId) {
-          return void 0;
-        }
-        try {
-          const parentType = span.parentObjectType;
-          const parentId = span.parentObjectId;
-          if (parentType === 2 /* PROJECT_LOGS */) {
-            const id = typeof parentId === "object" && parentId !== null && "get" in parentId ? (
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Type guard ensures object has get method
-              parentId.get()
-            ) : parentId;
-            if (typeof id === "string") {
-              return `project_id:${id}`;
-            }
-          } else if (parentType === 1 /* EXPERIMENT */) {
-            const id = typeof parentId === "object" && parentId !== null && "get" in parentId ? (
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Type guard ensures object has get method
-              parentId.get()
-            ) : parentId;
-            if (typeof id === "string") {
-              return `experiment_id:${id}`;
-            }
-          }
-        } catch (e9) {
-        }
-        return void 0;
-      }
     };
   }
 });
@@ -5265,7 +5240,7 @@ function getContextManager() {
     try {
       const { OtelContextManager: OtelContextManager2 } = (init_context3(), __toCommonJS(context_exports));
       return new OtelContextManager2();
-    } catch (e10) {
+    } catch (e9) {
       console.warn(
         "OTEL not available, falling back to Braintrust-only context manager"
       );
@@ -6931,7 +6906,7 @@ function resetIdGenStateForTests() {
     state.resetIdGenState();
   }
 }
-var BRAINTRUST_ATTACHMENT, EXTERNAL_ATTACHMENT, BRAINTRUST_PARAMS, REDACTION_FIELDS, MaskingError, ContextManager, BraintrustContextManager, NoopSpan, NOOP_SPAN, NOOP_SPAN_PERMALINK, loginSchema, stateNonce, BraintrustState, _globalState, _internalGetGlobalState, FailedHTTPResponse, HTTPConnection, BaseAttachment, Attachment, ExternalAttachment, attachmentMetadataSchema, ReadonlyAttachment, ERR_PERMALINK, Logger, TestBackgroundLogger, BACKGROUND_LOGGER_BASE_SLEEP_TIME_S, HTTPBackgroundLogger, traceable, INTERNAL_BTQL_LIMIT, MAX_BTQL_ITERATIONS, ObjectFetcher, Experiment2, ReadonlyExperiment, executionCounter, SpanImpl, Dataset2, Prompt2, TEST_API_KEY, _exportsForTestingOnly;
+var BRAINTRUST_ATTACHMENT, EXTERNAL_ATTACHMENT, BRAINTRUST_PARAMS, REDACTION_FIELDS, MaskingError, ContextManager, BraintrustContextManager, NoopSpan, NOOP_SPAN, NOOP_SPAN_PERMALINK, loginSchema, stateNonce, BraintrustState, _globalState, _internalGetGlobalState, FailedHTTPResponse, HTTPConnection, BaseAttachment, Attachment, ExternalAttachment, attachmentMetadataSchema, ReadonlyAttachment, JSONAttachment, ERR_PERMALINK, Logger, TestBackgroundLogger, BACKGROUND_LOGGER_BASE_SLEEP_TIME_S, HTTPBackgroundLogger, traceable, INTERNAL_BTQL_LIMIT, MAX_BTQL_ITERATIONS, ObjectFetcher, Experiment2, ReadonlyExperiment, executionCounter, SpanImpl, Dataset2, Prompt2, TEST_API_KEY, _exportsForTestingOnly;
 var init_logger = __esm({
   "src/logger.ts"() {
     "use strict";
@@ -7040,6 +7015,9 @@ var init_logger = __esm({
       state() {
         return _internalGetGlobalState();
       }
+      _getOtelParent() {
+        return void 0;
+      }
       // Custom inspect for Node.js console.log
       [Symbol.for("nodejs.util.inspect.custom")]() {
         return `NoopSpan {
@@ -7801,6 +7779,44 @@ with a Blob/ArrayBuffer, or run the program on Node.js.`
         return new LazyValue(download);
       }
     };
+    JSONAttachment = exports.JSONAttachment = class extends Attachment {
+      /**
+       * Construct a JSONAttachment from a JSON-serializable object.
+       *
+       * @param data The JSON object to attach. Must be JSON-serializable.
+       * @param options Additional options:
+       * - `filename`: The filename for the attachment (defaults to "data.json")
+       * - `pretty`: Whether to pretty-print the JSON (defaults to false)
+       * - `state`: (Optional) For internal use.
+       *
+       * @example
+       * ```typescript
+       * const largeTranscript = [
+       *   { role: "user", content: "..." },
+       *   { role: "assistant", content: "..." },
+       *   // ... many more messages
+       * ];
+       *
+       * logger.log({
+       *   input: {
+       *     type: "chat",
+       *     transcript: new JSONAttachment(largeTranscript, { filename: "transcript.json" })
+       *   }
+       * });
+       * ```
+       */
+      constructor(data, options) {
+        const { filename = "data.json", pretty = false, state } = _nullishCoalesce(options, () => ( {}));
+        const jsonString = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+        const blob = new Blob([jsonString], { type: "application/json" });
+        super({
+          data: blob,
+          filename,
+          contentType: "application/json",
+          state
+        });
+      }
+    };
     ERR_PERMALINK = exports.ERR_PERMALINK = "https://braintrust.dev/error-generating-link";
     Logger = exports.Logger = (_class6 = class {
       
@@ -7834,6 +7850,9 @@ with a Blob/ArrayBuffer, or run the program on Node.js.`
       get id() {
         return (async () => (await this.project).id)();
       }
+      get loggingState() {
+        return this.state;
+      }
       parentObjectType() {
         return 2 /* PROJECT_LOGS */;
       }
@@ -8547,6 +8566,18 @@ Error: ${errorText}`;
           return (await this.lazyMetadata.get()).experiment.id;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
+      /**
+       * Wait for the experiment ID to be resolved. This is useful for ensuring the ID
+       * is available synchronously in child spans (for OTEL parent attributes).
+       * @internal
+       */
+      async _waitForId() {
+        await this.lazyId.get().catch(() => {
+        });
+      }
       get name() {
         return (async () => {
           return (await this.lazyMetadata.get()).experiment.name;
@@ -8803,6 +8834,9 @@ View complete results in Braintrust or run experiment.summarize() again.`
           return (await this.lazyMetadata.get()).experiment.name;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
       async getState() {
         await this.lazyMetadata.get();
         return this.state;
@@ -9099,6 +9133,42 @@ View complete results in Braintrust or run experiment.summarize() again.`
       state() {
         return this._state;
       }
+      /**
+       * Internal method to get the OTEL parent string for this span.
+       * This is used by OtelContextManager to set the braintrust.parent attribute.
+       * @returns A string like "project_id:X" or "experiment_id:X", or undefined if no parent
+       */
+      _getOtelParent() {
+        if (!this.parentObjectType) {
+          return void 0;
+        }
+        try {
+          if (this.parentObjectType === 2 /* PROJECT_LOGS */) {
+            const syncResult = this.parentObjectId.getSync();
+            const id = syncResult.value;
+            const args = this.parentComputeObjectMetadataArgs;
+            if (id) {
+              return `project_id:${id}`;
+            }
+            const projectName = _optionalChain([args, 'optionalAccess', _106 => _106.project_name]);
+            if (projectName) {
+              return `project_name:${projectName}`;
+            }
+          } else if (this.parentObjectType === 1 /* EXPERIMENT */) {
+            const syncResult = this.parentObjectId.getSync();
+            const id = syncResult.value;
+            if (!syncResult.resolved) {
+              this.parentObjectId.get().catch(() => {
+              });
+            }
+            if (id) {
+              return `experiment_id:${id}`;
+            }
+          }
+        } catch (e) {
+        }
+        return void 0;
+      }
       // Custom inspect for Node.js console.log
       [Symbol.for("nodejs.util.inspect.custom")]() {
         return `SpanImpl {
@@ -9155,6 +9225,9 @@ View complete results in Braintrust or run experiment.summarize() again.`
           return (await this.lazyMetadata.get()).project;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
       async getState() {
         await this.lazyMetadata.get();
         return this.state;
@@ -9377,13 +9450,13 @@ View complete results in Braintrust or run experiment.summarize() again.`
         return "slug" in this.metadata ? this.metadata.slug : this.metadata.id;
       }
       get prompt() {
-        return _optionalChain([this, 'access', _106 => _106.getParsedPromptData, 'call', _107 => _107(), 'optionalAccess', _108 => _108.prompt]);
+        return _optionalChain([this, 'access', _107 => _107.getParsedPromptData, 'call', _108 => _108(), 'optionalAccess', _109 => _109.prompt]);
       }
       get version() {
         return this.metadata[TRANSACTION_ID_FIELD];
       }
       get options() {
-        return _optionalChain([this, 'access', _109 => _109.getParsedPromptData, 'call', _110 => _110(), 'optionalAccess', _111 => _111.options]) || {};
+        return _optionalChain([this, 'access', _110 => _110.getParsedPromptData, 'call', _111 => _111(), 'optionalAccess', _112 => _112.options]) || {};
       }
       get promptData() {
         return this.getParsedPromptData();
@@ -9534,7 +9607,7 @@ View complete results in Braintrust or run experiment.summarize() again.`
           return {
             type: "chat",
             messages,
-            ..._optionalChain([prompt, 'access', _112 => _112.tools, 'optionalAccess', _113 => _113.trim, 'call', _114 => _114()]) ? {
+            ..._optionalChain([prompt, 'access', _113 => _113.tools, 'optionalAccess', _114 => _114.trim, 'call', _115 => _115()]) ? {
               tools: render(prompt.tools)
             } : void 0
           };
@@ -9609,7 +9682,7 @@ function configureBrowser() {
     if (typeof AsyncLocalStorage !== "undefined") {
       isomorph_default.newAsyncLocalStorage = () => new AsyncLocalStorage();
     }
-  } catch (e11) {
+  } catch (e10) {
   }
   isomorph_default.getEnv = (name) => {
     if (typeof process === "undefined" || typeof process.env === "undefined") {
@@ -9645,6 +9718,7 @@ __export(exports_browser_exports, {
   ExternalAttachment: () => ExternalAttachment,
   FailedHTTPResponse: () => FailedHTTPResponse,
   INTERNAL_BTQL_LIMIT: () => INTERNAL_BTQL_LIMIT,
+  JSONAttachment: () => JSONAttachment,
   LEGACY_CACHED_HEADER: () => LEGACY_CACHED_HEADER,
   LazyValue: () => LazyValue,
   Logger: () => Logger,
@@ -9862,7 +9936,7 @@ function parseSpanFromResponseCreateParams(params) {
 }
 function parseEventFromResponseCreateResult(result) {
   const data = {};
-  if (_optionalChain([result, 'optionalAccess', _115 => _115.output]) !== void 0) {
+  if (_optionalChain([result, 'optionalAccess', _116 => _116.output]) !== void 0) {
     data.output = processImagesInOutput(result.output);
   }
   if (result) {
@@ -9871,7 +9945,7 @@ function parseEventFromResponseCreateResult(result) {
       data.metadata = metadata;
     }
   }
-  data.metrics = parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _116 => _116.usage]));
+  data.metrics = parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _117 => _117.usage]));
   return data;
 }
 function processImagesInOutput(output) {
@@ -9925,7 +9999,7 @@ function parseSpanFromResponseParseParams(params) {
 }
 function parseEventFromResponseParseResult(result) {
   const data = {};
-  if (_optionalChain([result, 'optionalAccess', _117 => _117.output]) !== void 0) {
+  if (_optionalChain([result, 'optionalAccess', _118 => _118.output]) !== void 0) {
     data.output = processImagesInOutput(result.output);
   }
   if (result) {
@@ -9934,7 +10008,7 @@ function parseEventFromResponseParseResult(result) {
       data.metadata = metadata;
     }
   }
-  data.metrics = parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _118 => _118.usage]));
+  data.metrics = parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _119 => _119.usage]));
   return data;
 }
 function traceResponseCreateStream(stream, timedSpan) {
@@ -9951,7 +10025,7 @@ function traceResponseCreateStream(stream, timedSpan) {
       return result;
     }
     const item = result.value;
-    if (!item || !_optionalChain([item, 'optionalAccess', _119 => _119.type]) || !_optionalChain([item, 'optionalAccess', _120 => _120.response])) {
+    if (!item || !_optionalChain([item, 'optionalAccess', _120 => _120.type]) || !_optionalChain([item, 'optionalAccess', _121 => _121.response])) {
       return result;
     }
     const event = parseLogFromItem(item);
@@ -9962,14 +10036,14 @@ function traceResponseCreateStream(stream, timedSpan) {
   };
 }
 function parseLogFromItem(item) {
-  if (!item || !_optionalChain([item, 'optionalAccess', _121 => _121.type]) || !_optionalChain([item, 'optionalAccess', _122 => _122.response])) {
+  if (!item || !_optionalChain([item, 'optionalAccess', _122 => _122.type]) || !_optionalChain([item, 'optionalAccess', _123 => _123.response])) {
     return {};
   }
   const response = item.response;
   switch (item.type) {
     case "response.completed":
       const data = {};
-      if (_optionalChain([response, 'optionalAccess', _123 => _123.output]) !== void 0) {
+      if (_optionalChain([response, 'optionalAccess', _124 => _124.output]) !== void 0) {
         data.output = processImagesInOutput(response.output);
       }
       if (response) {
@@ -9978,7 +10052,7 @@ function parseLogFromItem(item) {
           data.metadata = metadata;
         }
       }
-      data.metrics = parseMetricsFromUsage(_optionalChain([response, 'optionalAccess', _124 => _124.usage]));
+      data.metrics = parseMetricsFromUsage(_optionalChain([response, 'optionalAccess', _125 => _125.usage]));
       return data;
     default:
       return {};
@@ -10162,8 +10236,8 @@ function wrapOpenAIv4(openai) {
   const embeddingProxy = createEndpointProxy(openai.embeddings, wrapEmbeddings);
   const moderationProxy = createEndpointProxy(openai.moderations, wrapModerations);
   let betaProxy;
-  if (_optionalChain([openai, 'access', _125 => _125.beta, 'optionalAccess', _126 => _126.chat, 'optionalAccess', _127 => _127.completions, 'optionalAccess', _128 => _128.stream])) {
-    const betaChatCompletionProxy = new Proxy(_optionalChain([openai, 'optionalAccess', _129 => _129.beta, 'optionalAccess', _130 => _130.chat, 'access', _131 => _131.completions]), {
+  if (_optionalChain([openai, 'access', _126 => _126.beta, 'optionalAccess', _127 => _127.chat, 'optionalAccess', _128 => _128.completions, 'optionalAccess', _129 => _129.stream])) {
+    const betaChatCompletionProxy = new Proxy(_optionalChain([openai, 'optionalAccess', _130 => _130.beta, 'optionalAccess', _131 => _131.chat, 'access', _132 => _132.completions]), {
       get(target, name, receiver) {
         const baseVal = Reflect.get(target, name, receiver);
         if (name === "parse") {
@@ -10211,7 +10285,7 @@ function wrapOpenAIv4(openai) {
   });
 }
 function logCompletionResponse(startTime, response, span) {
-  const metrics2 = parseMetricsFromUsage(_optionalChain([response, 'optionalAccess', _132 => _132.usage]));
+  const metrics2 = parseMetricsFromUsage(_optionalChain([response, 'optionalAccess', _133 => _133.usage]));
   metrics2.time_to_first_token = getCurrentUnixTimestamp() - startTime;
   span.log({
     output: response.choices,
@@ -10441,7 +10515,7 @@ function parseChatCompletionParams(params) {
 function processEmbeddingResponse(result, span) {
   span.log({
     output: { embedding_length: result.data[0].embedding.length },
-    metrics: parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _133 => _133.usage]))
+    metrics: parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _134 => _134.usage]))
   });
 }
 function processModerationResponse(result, span) {
@@ -10471,10 +10545,10 @@ function postprocessStreamingResults(allResults) {
     if (result.usage) {
       metrics2 = {
         ...metrics2,
-        ...parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _134 => _134.usage]))
+        ...parseMetricsFromUsage(_optionalChain([result, 'optionalAccess', _135 => _135.usage]))
       };
     }
-    const delta = _optionalChain([result, 'access', _135 => _135.choices, 'optionalAccess', _136 => _136[0], 'optionalAccess', _137 => _137.delta]);
+    const delta = _optionalChain([result, 'access', _136 => _136.choices, 'optionalAccess', _137 => _137[0], 'optionalAccess', _138 => _138.delta]);
     if (!delta) {
       continue;
     }
@@ -10674,4 +10748,5 @@ var browser_default = exports_browser_exports;
 
 
 
-exports.Attachment = Attachment; exports.BaseAttachment = BaseAttachment; exports.BraintrustState = BraintrustState; exports.BraintrustStream = BraintrustStream; exports.ContextManager = ContextManager; exports.Dataset = Dataset2; exports.ERR_PERMALINK = ERR_PERMALINK; exports.Experiment = Experiment2; exports.ExternalAttachment = ExternalAttachment; exports.FailedHTTPResponse = FailedHTTPResponse; exports.INTERNAL_BTQL_LIMIT = INTERNAL_BTQL_LIMIT; exports.LEGACY_CACHED_HEADER = LEGACY_CACHED_HEADER; exports.LazyValue = LazyValue; exports.Logger = Logger; exports.NOOP_SPAN = NOOP_SPAN; exports.NOOP_SPAN_PERMALINK = NOOP_SPAN_PERMALINK; exports.NoopSpan = NoopSpan; exports.Prompt = Prompt2; exports.ReadonlyAttachment = ReadonlyAttachment; exports.ReadonlyExperiment = ReadonlyExperiment; exports.SpanImpl = SpanImpl; exports.TestBackgroundLogger = TestBackgroundLogger; exports.X_CACHED_HEADER = X_CACHED_HEADER; exports._exportsForTestingOnly = _exportsForTestingOnly; exports._internalGetGlobalState = _internalGetGlobalState; exports._internalSetInitialState = _internalSetInitialState; exports.braintrustStreamChunkSchema = braintrustStreamChunkSchema; exports.createFinalValuePassThroughStream = createFinalValuePassThroughStream; exports.currentExperiment = currentExperiment; exports.currentLogger = currentLogger; exports.currentSpan = currentSpan; exports.deepCopyEvent = deepCopyEvent; exports.default = browser_default; exports.deserializePlainStringAsJSON = deserializePlainStringAsJSON; exports.devNullWritableStream = devNullWritableStream; exports.evaluatorDefinitionSchema = evaluatorDefinitionSchema; exports.evaluatorDefinitionsSchema = evaluatorDefinitionsSchema; exports.flush = flush; exports.getContextManager = getContextManager; exports.getPromptVersions = getPromptVersions; exports.getSpanParentObject = getSpanParentObject; exports.init = init; exports.initDataset = initDataset; exports.initExperiment = initExperiment; exports.initFunction = initFunction; exports.initLogger = initLogger; exports.invoke = invoke; exports.loadPrompt = loadPrompt; exports.log = log; exports.logError = logError; exports.login = login; exports.loginToState = loginToState; exports.newId = newId; exports.parseCachedHeader = parseCachedHeader; exports.permalink = permalink; exports.renderMessage = renderMessage; exports.renderPromptParams = renderPromptParams; exports.setFetch = setFetch; exports.setMaskingFunction = setMaskingFunction; exports.spanComponentsToObjectId = spanComponentsToObjectId; exports.startSpan = startSpan; exports.summarize = summarize; exports.traceable = traceable; exports.traced = traced; exports.updateSpan = updateSpan; exports.withCurrent = withCurrent; exports.withDataset = withDataset; exports.withExperiment = withExperiment; exports.withLogger = withLogger; exports.withParent = withParent; exports.wrapOpenAI = wrapOpenAI; exports.wrapOpenAIv4 = wrapOpenAIv4; exports.wrapTraced = wrapTraced;
+
+exports.Attachment = Attachment; exports.BaseAttachment = BaseAttachment; exports.BraintrustState = BraintrustState; exports.BraintrustStream = BraintrustStream; exports.ContextManager = ContextManager; exports.Dataset = Dataset2; exports.ERR_PERMALINK = ERR_PERMALINK; exports.Experiment = Experiment2; exports.ExternalAttachment = ExternalAttachment; exports.FailedHTTPResponse = FailedHTTPResponse; exports.INTERNAL_BTQL_LIMIT = INTERNAL_BTQL_LIMIT; exports.JSONAttachment = JSONAttachment; exports.LEGACY_CACHED_HEADER = LEGACY_CACHED_HEADER; exports.LazyValue = LazyValue; exports.Logger = Logger; exports.NOOP_SPAN = NOOP_SPAN; exports.NOOP_SPAN_PERMALINK = NOOP_SPAN_PERMALINK; exports.NoopSpan = NoopSpan; exports.Prompt = Prompt2; exports.ReadonlyAttachment = ReadonlyAttachment; exports.ReadonlyExperiment = ReadonlyExperiment; exports.SpanImpl = SpanImpl; exports.TestBackgroundLogger = TestBackgroundLogger; exports.X_CACHED_HEADER = X_CACHED_HEADER; exports._exportsForTestingOnly = _exportsForTestingOnly; exports._internalGetGlobalState = _internalGetGlobalState; exports._internalSetInitialState = _internalSetInitialState; exports.braintrustStreamChunkSchema = braintrustStreamChunkSchema; exports.createFinalValuePassThroughStream = createFinalValuePassThroughStream; exports.currentExperiment = currentExperiment; exports.currentLogger = currentLogger; exports.currentSpan = currentSpan; exports.deepCopyEvent = deepCopyEvent; exports.default = browser_default; exports.deserializePlainStringAsJSON = deserializePlainStringAsJSON; exports.devNullWritableStream = devNullWritableStream; exports.evaluatorDefinitionSchema = evaluatorDefinitionSchema; exports.evaluatorDefinitionsSchema = evaluatorDefinitionsSchema; exports.flush = flush; exports.getContextManager = getContextManager; exports.getPromptVersions = getPromptVersions; exports.getSpanParentObject = getSpanParentObject; exports.init = init; exports.initDataset = initDataset; exports.initExperiment = initExperiment; exports.initFunction = initFunction; exports.initLogger = initLogger; exports.invoke = invoke; exports.loadPrompt = loadPrompt; exports.log = log; exports.logError = logError; exports.login = login; exports.loginToState = loginToState; exports.newId = newId; exports.parseCachedHeader = parseCachedHeader; exports.permalink = permalink; exports.renderMessage = renderMessage; exports.renderPromptParams = renderPromptParams; exports.setFetch = setFetch; exports.setMaskingFunction = setMaskingFunction; exports.spanComponentsToObjectId = spanComponentsToObjectId; exports.startSpan = startSpan; exports.summarize = summarize; exports.traceable = traceable; exports.traced = traced; exports.updateSpan = updateSpan; exports.withCurrent = withCurrent; exports.withDataset = withDataset; exports.withExperiment = withExperiment; exports.withLogger = withLogger; exports.withParent = withParent; exports.wrapOpenAI = wrapOpenAI; exports.wrapOpenAIv4 = wrapOpenAIv4; exports.wrapTraced = wrapTraced;

package/dist/browser.mjs

@@ -5124,7 +5124,6 @@ var init_context3 = __esm({
   "src/otel/context.ts"() {
     "use strict";
     init_logger();
-    init_util();
     OTEL_NOT_INSTALLED_MESSAGE = "OpenTelemetry packages are not installed. Install them with: npm install @opentelemetry/api @opentelemetry/sdk-trace-base";
     otelTrace = null;
     otelContext = null;
@@ -5187,6 +5186,10 @@ var init_context3 = __esm({
             const currentContext = otelContext.active();
             let newContext = otelTrace.setSpan(currentContext, wrappedContext);
             newContext = newContext.setValue("braintrust_span", span);
+            const parentValue = span._getOtelParent();
+            if (parentValue) {
+              newContext = newContext.setValue("braintrust.parent", parentValue);
+            }
             return otelContext.with(newContext, callback);
           }
         } catch (error) {
@@ -5202,34 +5205,6 @@ var init_context3 = __esm({
         }
         return void 0;
       }
-      _getOtelParent(span) {
-        if (!span.parentObjectType || !span.parentObjectId) {
-          return void 0;
-        }
-        try {
-          const parentType = span.parentObjectType;
-          const parentId = span.parentObjectId;
-          if (parentType === 2 /* PROJECT_LOGS */) {
-            const id = typeof parentId === "object" && parentId !== null && "get" in parentId ? (
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Type guard ensures object has get method
-              parentId.get()
-            ) : parentId;
-            if (typeof id === "string") {
-              return `project_id:${id}`;
-            }
-          } else if (parentType === 1 /* EXPERIMENT */) {
-            const id = typeof parentId === "object" && parentId !== null && "get" in parentId ? (
-              // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- Type guard ensures object has get method
-              parentId.get()
-            ) : parentId;
-            if (typeof id === "string") {
-              return `experiment_id:${id}`;
-            }
-          }
-        } catch {
-        }
-        return void 0;
-      }
     };
   }
 });
@@ -6931,7 +6906,7 @@ function resetIdGenStateForTests() {
     state.resetIdGenState();
   }
 }
-var BRAINTRUST_ATTACHMENT, EXTERNAL_ATTACHMENT, BRAINTRUST_PARAMS, REDACTION_FIELDS, MaskingError, ContextManager, BraintrustContextManager, NoopSpan, NOOP_SPAN, NOOP_SPAN_PERMALINK, loginSchema, stateNonce, BraintrustState, _globalState, _internalGetGlobalState, FailedHTTPResponse, HTTPConnection, BaseAttachment, Attachment, ExternalAttachment, attachmentMetadataSchema, ReadonlyAttachment, ERR_PERMALINK, Logger, TestBackgroundLogger, BACKGROUND_LOGGER_BASE_SLEEP_TIME_S, HTTPBackgroundLogger, traceable, INTERNAL_BTQL_LIMIT, MAX_BTQL_ITERATIONS, ObjectFetcher, Experiment2, ReadonlyExperiment, executionCounter, SpanImpl, Dataset2, Prompt2, TEST_API_KEY, _exportsForTestingOnly;
+var BRAINTRUST_ATTACHMENT, EXTERNAL_ATTACHMENT, BRAINTRUST_PARAMS, REDACTION_FIELDS, MaskingError, ContextManager, BraintrustContextManager, NoopSpan, NOOP_SPAN, NOOP_SPAN_PERMALINK, loginSchema, stateNonce, BraintrustState, _globalState, _internalGetGlobalState, FailedHTTPResponse, HTTPConnection, BaseAttachment, Attachment, ExternalAttachment, attachmentMetadataSchema, ReadonlyAttachment, JSONAttachment, ERR_PERMALINK, Logger, TestBackgroundLogger, BACKGROUND_LOGGER_BASE_SLEEP_TIME_S, HTTPBackgroundLogger, traceable, INTERNAL_BTQL_LIMIT, MAX_BTQL_ITERATIONS, ObjectFetcher, Experiment2, ReadonlyExperiment, executionCounter, SpanImpl, Dataset2, Prompt2, TEST_API_KEY, _exportsForTestingOnly;
 var init_logger = __esm({
   "src/logger.ts"() {
     "use strict";
@@ -7040,6 +7015,9 @@ var init_logger = __esm({
       state() {
         return _internalGetGlobalState();
       }
+      _getOtelParent() {
+        return void 0;
+      }
       // Custom inspect for Node.js console.log
       [Symbol.for("nodejs.util.inspect.custom")]() {
         return `NoopSpan {
@@ -7801,6 +7779,44 @@ with a Blob/ArrayBuffer, or run the program on Node.js.`
         return new LazyValue(download);
       }
     };
+    JSONAttachment = class extends Attachment {
+      /**
+       * Construct a JSONAttachment from a JSON-serializable object.
+       *
+       * @param data The JSON object to attach. Must be JSON-serializable.
+       * @param options Additional options:
+       * - `filename`: The filename for the attachment (defaults to "data.json")
+       * - `pretty`: Whether to pretty-print the JSON (defaults to false)
+       * - `state`: (Optional) For internal use.
+       *
+       * @example
+       * ```typescript
+       * const largeTranscript = [
+       *   { role: "user", content: "..." },
+       *   { role: "assistant", content: "..." },
+       *   // ... many more messages
+       * ];
+       *
+       * logger.log({
+       *   input: {
+       *     type: "chat",
+       *     transcript: new JSONAttachment(largeTranscript, { filename: "transcript.json" })
+       *   }
+       * });
+       * ```
+       */
+      constructor(data, options) {
+        const { filename = "data.json", pretty = false, state } = options ?? {};
+        const jsonString = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+        const blob = new Blob([jsonString], { type: "application/json" });
+        super({
+          data: blob,
+          filename,
+          contentType: "application/json",
+          state
+        });
+      }
+    };
     ERR_PERMALINK = "https://braintrust.dev/error-generating-link";
     Logger = class {
       state;
@@ -7834,6 +7850,9 @@ with a Blob/ArrayBuffer, or run the program on Node.js.`
       get id() {
         return (async () => (await this.project).id)();
       }
+      get loggingState() {
+        return this.state;
+      }
       parentObjectType() {
         return 2 /* PROJECT_LOGS */;
       }
@@ -8547,6 +8566,18 @@ Error: ${errorText}`;
           return (await this.lazyMetadata.get()).experiment.id;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
+      /**
+       * Wait for the experiment ID to be resolved. This is useful for ensuring the ID
+       * is available synchronously in child spans (for OTEL parent attributes).
+       * @internal
+       */
+      async _waitForId() {
+        await this.lazyId.get().catch(() => {
+        });
+      }
       get name() {
         return (async () => {
           return (await this.lazyMetadata.get()).experiment.name;
@@ -8803,6 +8834,9 @@ View complete results in Braintrust or run experiment.summarize() again.`
           return (await this.lazyMetadata.get()).experiment.name;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
       async getState() {
         await this.lazyMetadata.get();
         return this.state;
@@ -9099,6 +9133,42 @@ View complete results in Braintrust or run experiment.summarize() again.`
       state() {
         return this._state;
       }
+      /**
+       * Internal method to get the OTEL parent string for this span.
+       * This is used by OtelContextManager to set the braintrust.parent attribute.
+       * @returns A string like "project_id:X" or "experiment_id:X", or undefined if no parent
+       */
+      _getOtelParent() {
+        if (!this.parentObjectType) {
+          return void 0;
+        }
+        try {
+          if (this.parentObjectType === 2 /* PROJECT_LOGS */) {
+            const syncResult = this.parentObjectId.getSync();
+            const id = syncResult.value;
+            const args = this.parentComputeObjectMetadataArgs;
+            if (id) {
+              return `project_id:${id}`;
+            }
+            const projectName = args?.project_name;
+            if (projectName) {
+              return `project_name:${projectName}`;
+            }
+          } else if (this.parentObjectType === 1 /* EXPERIMENT */) {
+            const syncResult = this.parentObjectId.getSync();
+            const id = syncResult.value;
+            if (!syncResult.resolved) {
+              this.parentObjectId.get().catch(() => {
+              });
+            }
+            if (id) {
+              return `experiment_id:${id}`;
+            }
+          }
+        } catch (e) {
+        }
+        return void 0;
+      }
       // Custom inspect for Node.js console.log
       [Symbol.for("nodejs.util.inspect.custom")]() {
         return `SpanImpl {
@@ -9155,6 +9225,9 @@ View complete results in Braintrust or run experiment.summarize() again.`
           return (await this.lazyMetadata.get()).project;
         })();
       }
+      get loggingState() {
+        return this.state;
+      }
       async getState() {
         await this.lazyMetadata.get();
         return this.state;
@@ -9645,6 +9718,7 @@ __export(exports_browser_exports, {
   ExternalAttachment: () => ExternalAttachment,
   FailedHTTPResponse: () => FailedHTTPResponse,
   INTERNAL_BTQL_LIMIT: () => INTERNAL_BTQL_LIMIT,
+  JSONAttachment: () => JSONAttachment,
   LEGACY_CACHED_HEADER: () => LEGACY_CACHED_HEADER,
   LazyValue: () => LazyValue,
   Logger: () => Logger,
@@ -10612,6 +10686,7 @@ export {
   ExternalAttachment,
   FailedHTTPResponse,
   INTERNAL_BTQL_LIMIT,
+  JSONAttachment,
   LEGACY_CACHED_HEADER,
   LazyValue,
   Logger,