braintrust 0.3.7 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "braintrust",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "description": "SDK for integrating Braintrust",
   "repository": {
     "type": "git",
@@ -56,14 +56,16 @@
     "watch": "tsup --watch",
     "clean": "rm -r dist/* && rm -r dev/dist/*",
     "docs": "npx typedoc --options typedoc.json src/index.ts",
-    "test": "vitest run --exclude src/wrappers/anthropic.test.ts --exclude src/wrappers/oai.test.ts --exclude src/otel.test.ts --exclude src/otel-no-deps.test.ts  --exclude src/wrappers/ai-sdk-v1.test.ts --exclude src/wrappers/ai-sdk-v2.test.ts --exclude src/wrappers/ai-sdk-v3.test.ts",
+    "test": "vitest run --exclude src/wrappers/anthropic.test.ts --exclude src/wrappers/oai.test.ts --exclude src/otel.test.ts --exclude src/otel-no-deps.test.ts  --exclude src/wrappers/ai-sdk-v1.test.ts --exclude src/wrappers/ai-sdk-v2.test.ts --exclude src/wrappers/ai-sdk-v3.test.ts --exclude src/wrappers/mastra.test.ts --exclude src/wrappers/claude-agent-sdk.test.ts",
     "test:anthropic": "vitest run src/wrappers/anthropic.test.ts",
     "test:openai": "vitest run src/wrappers/oai.test.ts",
     "test:otel": "vitest run src/otel.test.ts",
     "test:otel-no-deps": "vitest run src/otel-no-deps.test.ts --reporter=verbose",
     "test:ai-sdk-v1": "vitest run src/wrappers/ai-sdk-v1.test.ts",
     "test:ai-sdk-v2": "vitest run src/wrappers/ai-sdk-v2.test.ts src/wrappers/ai-sdk-v1.test.ts",
-    "test:ai-sdk-v3": "vitest run src/wrappers/ai-sdk-v3.test.ts"
+    "test:ai-sdk-v3": "vitest run src/wrappers/ai-sdk-v3.test.ts",
+    "test:mastra": "vitest run src/wrappers/mastra.test.ts",
+    "test:claude-agent-sdk": "vitest run src/wrappers/claude-agent-sdk.test.ts"
   },
   "author": "",
   "license": "MIT",
@@ -109,7 +111,7 @@
     "cli-progress": "^3.12.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.5",
-    "esbuild": "^0.25.9",
+    "esbuild": "^0.25.10",
     "eventsource-parser": "^1.1.2",
     "express": "^4.21.2",
     "graceful-fs": "^4.2.11",

package/util/dist/index.d.mts

@@ -5005,7 +5005,6 @@ declare class SpanComponentsV3 {
     export(): Promise<string>;
     private static fromJsonObj;
 }
-declare function parseParent(parent: InvokeFunctionType["parent"]): string | undefined;
 
 declare const BT_FOUND_EXISTING_HEADER = "x-bt-found-existing";
 declare const BT_CURSOR_HEADER = "x-bt-cursor";
@@ -5194,6 +5193,70 @@ declare class SpanComponentsV2 {
     };
 }
 
+declare const spanComponentsV4Schema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
+    object_type: z.ZodNativeEnum<typeof SpanObjectTypeV3>;
+    propagated_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    object_type: SpanObjectTypeV3;
+    propagated_event?: Record<string, unknown> | null | undefined;
+}, {
+    object_type: SpanObjectTypeV3;
+    propagated_event?: Record<string, unknown> | null | undefined;
+}>, z.ZodUnion<[z.ZodObject<{
+    object_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compute_object_metadata_args: z.ZodOptional<z.ZodNull>;
+}, "strip", z.ZodTypeAny, {
+    object_id?: string | null | undefined;
+    compute_object_metadata_args?: null | undefined;
+}, {
+    object_id?: string | null | undefined;
+    compute_object_metadata_args?: null | undefined;
+}>, z.ZodObject<{
+    object_id: z.ZodOptional<z.ZodNull>;
+    compute_object_metadata_args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    compute_object_metadata_args: Record<string, unknown>;
+    object_id?: null | undefined;
+}, {
+    compute_object_metadata_args: Record<string, unknown>;
+    object_id?: null | undefined;
+}>]>>, z.ZodUnion<[z.ZodObject<{
+    row_id: z.ZodString;
+    span_id: z.ZodString;
+    root_span_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    span_id: string;
+    root_span_id: string;
+    row_id: string;
+}, {
+    span_id: string;
+    root_span_id: string;
+    row_id: string;
+}>, z.ZodObject<{
+    row_id: z.ZodOptional<z.ZodNull>;
+    span_id: z.ZodOptional<z.ZodNull>;
+    root_span_id: z.ZodOptional<z.ZodNull>;
+}, "strip", z.ZodTypeAny, {
+    span_id?: null | undefined;
+    root_span_id?: null | undefined;
+    row_id?: null | undefined;
+}, {
+    span_id?: null | undefined;
+    root_span_id?: null | undefined;
+    row_id?: null | undefined;
+}>]>>;
+type SpanComponentsV4Data = z.infer<typeof spanComponentsV4Schema>;
+declare class SpanComponentsV4 {
+    data: SpanComponentsV4Data;
+    constructor(data: SpanComponentsV4Data);
+    toStr(): string;
+    static fromStr(s: string): SpanComponentsV4;
+    objectIdFields(): ParentExperimentIds | ParentProjectLogIds | ParentPlaygroundLogIds;
+    export(): Promise<string>;
+    private static fromJsonObj;
+}
+declare function parseParent(parent: InvokeFunctionType["parent"]): string | undefined;
+
 declare const spanTypeAttributeValues: readonly ["llm", "score", "function", "eval", "task", "tool"];
 declare enum SpanTypeAttribute {
     LLM = "llm",
@@ -5226,4 +5289,4 @@ declare function base64ToUint8Array(base64: string): Uint8Array;
 declare function uint8ArrayToString(uint8Array: Uint8Array): string;
 declare function stringToUint8Array(str: string): Uint8Array;
 
-export { ASYNC_SCORING_CONTROL_FIELD, AUDIT_METADATA_FIELD, AUDIT_SOURCE_FIELD, type AnyDatasetRecord, BT_CURSOR_HEADER, BT_FOUND_EXISTING_HEADER, BT_IMPERSONATE_USER, BT_PARENT, type BackgroundLogEvent, CREATED_FIELD, type CommentEvent, DEFAULT_IS_LEGACY_DATASET, type DatasetEvent, type DatasetRecord, type ExperimentEvent, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, ExtraFieldsError, ID_FIELD, IS_MERGE_FIELD, type IdField, type InputField, type LogCommentFullArgs, type LogFeedbackFullArgs, type LoggingEvent, MERGE_PATHS_FIELD, OBJECT_DELETE_FIELD, type OtherExperimentLogFields, PARENT_ID_FIELD, type ParentExperimentIds, type ParentPlaygroundLogIds, type ParentProjectLogIds, type PlaygroundLogEvent, SKIP_ASYNC_SCORING_FIELD, type SanitizedExperimentLogPartialArgs, type Score, type Scorer, type ScorerArgs, type Source, SpanComponentsV1, SpanComponentsV2, SpanComponentsV3, type SpanComponentsV3Data, SpanObjectTypeV1, SpanObjectTypeV2, SpanObjectTypeV3, type SpanPurpose, SpanRowIdsV1, SpanRowIdsV2, type SpanType, SpanTypeAttribute, TRANSACTION_ID_FIELD, type TransactionId, VALID_SOURCES, _urljoin, base64ToUint8Array, batchItems, camelToSnakeCase, capitalize, concatUint8Arrays, constructJsonArray, deterministicReplacer, ensureDatasetRecord, ensureLegacyDatasetRecord, ensureNewDatasetRecord, forEachMissingKey, getObjValueByPath, getRecordKeys, isArray, isEmpty, isNumber, isObject, isObjectOrArray, loadPrettyXact, lowercase, mapAt, mapSetDefault, mapSetNotPresent, mergeDicts, mergeDictsWithPaths, mergeGitMetadataSettings, mergeRowBatch, notEmpty, objectNullish, parseNoStrip, parseParent, prettifyXact, recordAt, recordFind, recordSetDefault, resolveParentHeader, snakeToCamelCase, snakeToTitleCase, spanComponentsV3Schema, spanObjectTypeV3EnumSchema, spanObjectTypeV3ToString, spanPurposeAttributeValues, spanTypeAttributeValues, stringToUint8Array, uint8ArrayToBase64, uint8ArrayToString };
+export { ASYNC_SCORING_CONTROL_FIELD, AUDIT_METADATA_FIELD, AUDIT_SOURCE_FIELD, type AnyDatasetRecord, BT_CURSOR_HEADER, BT_FOUND_EXISTING_HEADER, BT_IMPERSONATE_USER, BT_PARENT, type BackgroundLogEvent, CREATED_FIELD, type CommentEvent, DEFAULT_IS_LEGACY_DATASET, type DatasetEvent, type DatasetRecord, type ExperimentEvent, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, ExtraFieldsError, ID_FIELD, IS_MERGE_FIELD, type IdField, type InputField, type LogCommentFullArgs, type LogFeedbackFullArgs, type LoggingEvent, MERGE_PATHS_FIELD, OBJECT_DELETE_FIELD, type OtherExperimentLogFields, PARENT_ID_FIELD, type ParentExperimentIds, type ParentPlaygroundLogIds, type ParentProjectLogIds, type PlaygroundLogEvent, SKIP_ASYNC_SCORING_FIELD, type SanitizedExperimentLogPartialArgs, type Score, type Scorer, type ScorerArgs, type Source, SpanComponentsV1, SpanComponentsV2, SpanComponentsV3, type SpanComponentsV3Data, SpanComponentsV4, type SpanComponentsV4Data, SpanObjectTypeV1, SpanObjectTypeV2, SpanObjectTypeV3, type SpanPurpose, SpanRowIdsV1, SpanRowIdsV2, type SpanType, SpanTypeAttribute, TRANSACTION_ID_FIELD, type TransactionId, VALID_SOURCES, _urljoin, base64ToUint8Array, batchItems, camelToSnakeCase, capitalize, concatUint8Arrays, constructJsonArray, deterministicReplacer, ensureDatasetRecord, ensureLegacyDatasetRecord, ensureNewDatasetRecord, forEachMissingKey, getObjValueByPath, getRecordKeys, isArray, isEmpty, isNumber, isObject, isObjectOrArray, loadPrettyXact, lowercase, mapAt, mapSetDefault, mapSetNotPresent, mergeDicts, mergeDictsWithPaths, mergeGitMetadataSettings, mergeRowBatch, notEmpty, objectNullish, parseNoStrip, parseParent, prettifyXact, recordAt, recordFind, recordSetDefault, resolveParentHeader, snakeToCamelCase, snakeToTitleCase, spanComponentsV3Schema, spanComponentsV4Schema, spanObjectTypeV3EnumSchema, spanObjectTypeV3ToString, spanPurposeAttributeValues, spanTypeAttributeValues, stringToUint8Array, uint8ArrayToBase64, uint8ArrayToString };

package/util/dist/index.d.ts

@@ -5005,7 +5005,6 @@ declare class SpanComponentsV3 {
     export(): Promise<string>;
     private static fromJsonObj;
 }
-declare function parseParent(parent: InvokeFunctionType["parent"]): string | undefined;
 
 declare const BT_FOUND_EXISTING_HEADER = "x-bt-found-existing";
 declare const BT_CURSOR_HEADER = "x-bt-cursor";
@@ -5194,6 +5193,70 @@ declare class SpanComponentsV2 {
     };
 }
 
+declare const spanComponentsV4Schema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
+    object_type: z.ZodNativeEnum<typeof SpanObjectTypeV3>;
+    propagated_event: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    object_type: SpanObjectTypeV3;
+    propagated_event?: Record<string, unknown> | null | undefined;
+}, {
+    object_type: SpanObjectTypeV3;
+    propagated_event?: Record<string, unknown> | null | undefined;
+}>, z.ZodUnion<[z.ZodObject<{
+    object_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compute_object_metadata_args: z.ZodOptional<z.ZodNull>;
+}, "strip", z.ZodTypeAny, {
+    object_id?: string | null | undefined;
+    compute_object_metadata_args?: null | undefined;
+}, {
+    object_id?: string | null | undefined;
+    compute_object_metadata_args?: null | undefined;
+}>, z.ZodObject<{
+    object_id: z.ZodOptional<z.ZodNull>;
+    compute_object_metadata_args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    compute_object_metadata_args: Record<string, unknown>;
+    object_id?: null | undefined;
+}, {
+    compute_object_metadata_args: Record<string, unknown>;
+    object_id?: null | undefined;
+}>]>>, z.ZodUnion<[z.ZodObject<{
+    row_id: z.ZodString;
+    span_id: z.ZodString;
+    root_span_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    span_id: string;
+    root_span_id: string;
+    row_id: string;
+}, {
+    span_id: string;
+    root_span_id: string;
+    row_id: string;
+}>, z.ZodObject<{
+    row_id: z.ZodOptional<z.ZodNull>;
+    span_id: z.ZodOptional<z.ZodNull>;
+    root_span_id: z.ZodOptional<z.ZodNull>;
+}, "strip", z.ZodTypeAny, {
+    span_id?: null | undefined;
+    root_span_id?: null | undefined;
+    row_id?: null | undefined;
+}, {
+    span_id?: null | undefined;
+    root_span_id?: null | undefined;
+    row_id?: null | undefined;
+}>]>>;
+type SpanComponentsV4Data = z.infer<typeof spanComponentsV4Schema>;
+declare class SpanComponentsV4 {
+    data: SpanComponentsV4Data;
+    constructor(data: SpanComponentsV4Data);
+    toStr(): string;
+    static fromStr(s: string): SpanComponentsV4;
+    objectIdFields(): ParentExperimentIds | ParentProjectLogIds | ParentPlaygroundLogIds;
+    export(): Promise<string>;
+    private static fromJsonObj;
+}
+declare function parseParent(parent: InvokeFunctionType["parent"]): string | undefined;
+
 declare const spanTypeAttributeValues: readonly ["llm", "score", "function", "eval", "task", "tool"];
 declare enum SpanTypeAttribute {
     LLM = "llm",
@@ -5226,4 +5289,4 @@ declare function base64ToUint8Array(base64: string): Uint8Array;
 declare function uint8ArrayToString(uint8Array: Uint8Array): string;
 declare function stringToUint8Array(str: string): Uint8Array;
 
-export { ASYNC_SCORING_CONTROL_FIELD, AUDIT_METADATA_FIELD, AUDIT_SOURCE_FIELD, type AnyDatasetRecord, BT_CURSOR_HEADER, BT_FOUND_EXISTING_HEADER, BT_IMPERSONATE_USER, BT_PARENT, type BackgroundLogEvent, CREATED_FIELD, type CommentEvent, DEFAULT_IS_LEGACY_DATASET, type DatasetEvent, type DatasetRecord, type ExperimentEvent, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, ExtraFieldsError, ID_FIELD, IS_MERGE_FIELD, type IdField, type InputField, type LogCommentFullArgs, type LogFeedbackFullArgs, type LoggingEvent, MERGE_PATHS_FIELD, OBJECT_DELETE_FIELD, type OtherExperimentLogFields, PARENT_ID_FIELD, type ParentExperimentIds, type ParentPlaygroundLogIds, type ParentProjectLogIds, type PlaygroundLogEvent, SKIP_ASYNC_SCORING_FIELD, type SanitizedExperimentLogPartialArgs, type Score, type Scorer, type ScorerArgs, type Source, SpanComponentsV1, SpanComponentsV2, SpanComponentsV3, type SpanComponentsV3Data, SpanObjectTypeV1, SpanObjectTypeV2, SpanObjectTypeV3, type SpanPurpose, SpanRowIdsV1, SpanRowIdsV2, type SpanType, SpanTypeAttribute, TRANSACTION_ID_FIELD, type TransactionId, VALID_SOURCES, _urljoin, base64ToUint8Array, batchItems, camelToSnakeCase, capitalize, concatUint8Arrays, constructJsonArray, deterministicReplacer, ensureDatasetRecord, ensureLegacyDatasetRecord, ensureNewDatasetRecord, forEachMissingKey, getObjValueByPath, getRecordKeys, isArray, isEmpty, isNumber, isObject, isObjectOrArray, loadPrettyXact, lowercase, mapAt, mapSetDefault, mapSetNotPresent, mergeDicts, mergeDictsWithPaths, mergeGitMetadataSettings, mergeRowBatch, notEmpty, objectNullish, parseNoStrip, parseParent, prettifyXact, recordAt, recordFind, recordSetDefault, resolveParentHeader, snakeToCamelCase, snakeToTitleCase, spanComponentsV3Schema, spanObjectTypeV3EnumSchema, spanObjectTypeV3ToString, spanPurposeAttributeValues, spanTypeAttributeValues, stringToUint8Array, uint8ArrayToBase64, uint8ArrayToString };
+export { ASYNC_SCORING_CONTROL_FIELD, AUDIT_METADATA_FIELD, AUDIT_SOURCE_FIELD, type AnyDatasetRecord, BT_CURSOR_HEADER, BT_FOUND_EXISTING_HEADER, BT_IMPERSONATE_USER, BT_PARENT, type BackgroundLogEvent, CREATED_FIELD, type CommentEvent, DEFAULT_IS_LEGACY_DATASET, type DatasetEvent, type DatasetRecord, type ExperimentEvent, type ExperimentLogFullArgs, type ExperimentLogPartialArgs, ExtraFieldsError, ID_FIELD, IS_MERGE_FIELD, type IdField, type InputField, type LogCommentFullArgs, type LogFeedbackFullArgs, type LoggingEvent, MERGE_PATHS_FIELD, OBJECT_DELETE_FIELD, type OtherExperimentLogFields, PARENT_ID_FIELD, type ParentExperimentIds, type ParentPlaygroundLogIds, type ParentProjectLogIds, type PlaygroundLogEvent, SKIP_ASYNC_SCORING_FIELD, type SanitizedExperimentLogPartialArgs, type Score, type Scorer, type ScorerArgs, type Source, SpanComponentsV1, SpanComponentsV2, SpanComponentsV3, type SpanComponentsV3Data, SpanComponentsV4, type SpanComponentsV4Data, SpanObjectTypeV1, SpanObjectTypeV2, SpanObjectTypeV3, type SpanPurpose, SpanRowIdsV1, SpanRowIdsV2, type SpanType, SpanTypeAttribute, TRANSACTION_ID_FIELD, type TransactionId, VALID_SOURCES, _urljoin, base64ToUint8Array, batchItems, camelToSnakeCase, capitalize, concatUint8Arrays, constructJsonArray, deterministicReplacer, ensureDatasetRecord, ensureLegacyDatasetRecord, ensureNewDatasetRecord, forEachMissingKey, getObjValueByPath, getRecordKeys, isArray, isEmpty, isNumber, isObject, isObjectOrArray, loadPrettyXact, lowercase, mapAt, mapSetDefault, mapSetNotPresent, mergeDicts, mergeDictsWithPaths, mergeGitMetadataSettings, mergeRowBatch, notEmpty, objectNullish, parseNoStrip, parseParent, prettifyXact, recordAt, recordFind, recordSetDefault, resolveParentHeader, snakeToCamelCase, snakeToTitleCase, spanComponentsV3Schema, spanComponentsV4Schema, spanObjectTypeV3EnumSchema, spanObjectTypeV3ToString, spanPurposeAttributeValues, spanTypeAttributeValues, stringToUint8Array, uint8ArrayToBase64, uint8ArrayToString };

package/util/dist/index.js

@@ -609,22 +609,6 @@ var SpanComponentsV3 = class _SpanComponentsV3 {
     return new _SpanComponentsV3(spanComponentsV3Schema.parse(jsonObj));
   }
 };
-function parseParent(parent) {
-  return typeof parent === "string" ? parent : parent ? new SpanComponentsV3({
-    object_type: parent.object_type === "experiment" ? 1 /* EXPERIMENT */ : parent.object_type === "playground_logs" ? 3 /* PLAYGROUND_LOGS */ : 2 /* PROJECT_LOGS */,
-    object_id: parent.object_id,
-    ...parent.row_ids ? {
-      row_id: parent.row_ids.id,
-      span_id: parent.row_ids.span_id,
-      root_span_id: parent.row_ids.root_span_id
-    } : {
-      row_id: void 0,
-      span_id: void 0,
-      root_span_id: void 0
-    },
-    propagated_event: parent.propagated_event
-  }).toStr() : void 0;
-}
 
 // util/http_headers.ts
 var BT_FOUND_EXISTING_HEADER = "x-bt-found-existing";
@@ -1097,6 +1081,232 @@ function camelToSnakeCase(s) {
   return s.replace(/([A-Z])/g, (m) => "_" + m.toLowerCase()).replace(/^_/, "");
 }
 
+// util/span_identifier_v4.ts
+
+var ENCODING_VERSION_NUMBER_V4 = 4;
+function tryMakeHexTraceId(s) {
+  try {
+    if (typeof s === "string" && s.length === 32) {
+      const bytes = new Uint8Array(16);
+      for (let i = 0; i < 16; i++) {
+        const hex = s.substr(i * 2, 2);
+        const byte = parseInt(hex, 16);
+        if (isNaN(byte)) throw new Error();
+        bytes[i] = byte;
+      }
+      return { bytes, isHex: true };
+    }
+  } catch (e4) {
+  }
+  return { bytes: void 0, isHex: false };
+}
+function tryMakeHexSpanId(s) {
+  try {
+    if (typeof s === "string" && s.length === 16) {
+      const bytes = new Uint8Array(8);
+      for (let i = 0; i < 8; i++) {
+        const hex = s.substr(i * 2, 2);
+        const byte = parseInt(hex, 16);
+        if (isNaN(byte)) throw new Error();
+        bytes[i] = byte;
+      }
+      return { bytes, isHex: true };
+    }
+  } catch (e5) {
+  }
+  return { bytes: void 0, isHex: false };
+}
+var INVALID_ENCODING_ERRMSG_V4 = `SpanComponents string is not properly encoded. This library only supports encoding versions up to ${ENCODING_VERSION_NUMBER_V4}. Please make sure the SDK library used to decode the SpanComponents is at least as new as any library used to encode it.`;
+var FIELDS_ID_TO_NAME = {
+  [1 /* OBJECT_ID */]: "object_id",
+  [2 /* ROW_ID */]: "row_id",
+  [3 /* SPAN_ID */]: "span_id",
+  [4 /* ROOT_SPAN_ID */]: "root_span_id"
+};
+var spanComponentsV4Schema = _v3.z.object({
+  object_type: spanObjectTypeV3EnumSchema,
+  propagated_event: _v3.z.record(_v3.z.unknown()).nullish()
+}).and(
+  _v3.z.union([
+    // Must provide one or the other.
+    _v3.z.object({
+      object_id: _v3.z.string().nullish(),
+      compute_object_metadata_args: _v3.z.optional(_v3.z.null())
+    }),
+    _v3.z.object({
+      object_id: _v3.z.optional(_v3.z.null()),
+      compute_object_metadata_args: _v3.z.record(_v3.z.unknown())
+    })
+  ])
+).and(
+  _v3.z.union([
+    // Either all of these must be provided or none.
+    _v3.z.object({
+      row_id: _v3.z.string(),
+      span_id: _v3.z.string(),
+      root_span_id: _v3.z.string()
+    }),
+    _v3.z.object({
+      row_id: _v3.z.optional(_v3.z.null()),
+      span_id: _v3.z.optional(_v3.z.null()),
+      root_span_id: _v3.z.optional(_v3.z.null())
+    })
+  ])
+);
+var SpanComponentsV4 = class _SpanComponentsV4 {
+  constructor(data) {
+    this.data = data;
+  }
+  toStr() {
+    const jsonObj = {
+      compute_object_metadata_args: this.data.compute_object_metadata_args || void 0,
+      propagated_event: this.data.propagated_event || void 0
+    };
+    Object.keys(jsonObj).forEach((key) => {
+      if (jsonObj[key] === void 0) {
+        delete jsonObj[key];
+      }
+    });
+    const allBuffers = [];
+    allBuffers.push(
+      new Uint8Array([ENCODING_VERSION_NUMBER_V4, this.data.object_type])
+    );
+    const hexEntries = [];
+    function addHexField(origVal, fieldId) {
+      let hexResult;
+      if (fieldId === 3 /* SPAN_ID */) {
+        hexResult = tryMakeHexSpanId(origVal);
+      } else if (fieldId === 4 /* ROOT_SPAN_ID */) {
+        hexResult = tryMakeHexTraceId(origVal);
+      } else {
+        hexResult = { bytes: void 0, isHex: false };
+      }
+      if (hexResult.isHex) {
+        hexEntries.push(
+          concatUint8Arrays(new Uint8Array([fieldId]), hexResult.bytes)
+        );
+      } else {
+        jsonObj[FIELDS_ID_TO_NAME[fieldId]] = origVal;
+      }
+    }
+    if (this.data.object_id) {
+      addHexField(this.data.object_id, 1 /* OBJECT_ID */);
+    }
+    if (this.data.row_id) {
+      addHexField(this.data.row_id, 2 /* ROW_ID */);
+    }
+    if (this.data.span_id) {
+      addHexField(this.data.span_id, 3 /* SPAN_ID */);
+    }
+    if (this.data.root_span_id) {
+      addHexField(this.data.root_span_id, 4 /* ROOT_SPAN_ID */);
+    }
+    if (hexEntries.length > 255) {
+      throw new Error("Impossible: too many hex entries to encode");
+    }
+    allBuffers.push(new Uint8Array([hexEntries.length]));
+    allBuffers.push(...hexEntries);
+    if (Object.keys(jsonObj).length > 0) {
+      allBuffers.push(stringToUint8Array(JSON.stringify(jsonObj)));
+    }
+    return uint8ArrayToBase64(concatUint8Arrays(...allBuffers));
+  }
+  static fromStr(s) {
+    try {
+      const rawBytes = base64ToUint8Array(s);
+      const jsonObj = {};
+      if (rawBytes[0] < ENCODING_VERSION_NUMBER_V4) {
+        const v3Components = SpanComponentsV3.fromStr(s);
+        jsonObj["object_type"] = v3Components.data.object_type;
+        jsonObj["object_id"] = v3Components.data.object_id;
+        jsonObj["compute_object_metadata_args"] = v3Components.data.compute_object_metadata_args;
+        jsonObj["row_id"] = v3Components.data.row_id;
+        jsonObj["span_id"] = v3Components.data.span_id;
+        jsonObj["root_span_id"] = v3Components.data.root_span_id;
+        jsonObj["propagated_event"] = v3Components.data.propagated_event;
+      } else {
+        jsonObj["object_type"] = rawBytes[1];
+        const numHexEntries = rawBytes[2];
+        let byteOffset = 3;
+        for (let i = 0; i < numHexEntries; i++) {
+          const fieldId = rawBytes[byteOffset];
+          if (fieldId === 3 /* SPAN_ID */) {
+            const hexBytes = rawBytes.subarray(byteOffset + 1, byteOffset + 9);
+            byteOffset += 9;
+            jsonObj[FIELDS_ID_TO_NAME[fieldId]] = Array.from(
+              hexBytes,
+              (b) => b.toString(16).padStart(2, "0")
+            ).join("");
+          } else if (fieldId === 4 /* ROOT_SPAN_ID */) {
+            const hexBytes = rawBytes.subarray(byteOffset + 1, byteOffset + 17);
+            byteOffset += 17;
+            jsonObj[FIELDS_ID_TO_NAME[fieldId]] = Array.from(
+              hexBytes,
+              (b) => b.toString(16).padStart(2, "0")
+            ).join("");
+          } else {
+            const hexBytes = rawBytes.subarray(byteOffset + 1, byteOffset + 17);
+            byteOffset += 17;
+            jsonObj[FIELDS_ID_TO_NAME[fieldId]] = Array.from(
+              hexBytes,
+              (b) => b.toString(16).padStart(2, "0")
+            ).join("");
+          }
+        }
+        if (byteOffset < rawBytes.length) {
+          const remainingJsonObj = JSON.parse(
+            uint8ArrayToString(rawBytes.subarray(byteOffset))
+          );
+          Object.assign(jsonObj, remainingJsonObj);
+        }
+      }
+      return _SpanComponentsV4.fromJsonObj(jsonObj);
+    } catch (e6) {
+      throw new Error(INVALID_ENCODING_ERRMSG_V4);
+    }
+  }
+  objectIdFields() {
+    if (!this.data.object_id) {
+      throw new Error(
+        "Impossible: cannot invoke `objectIdFields` unless SpanComponentsV4 is initialized with an `object_id`"
+      );
+    }
+    switch (this.data.object_type) {
+      case 1 /* EXPERIMENT */:
+        return { experiment_id: this.data.object_id };
+      case 2 /* PROJECT_LOGS */:
+        return { project_id: this.data.object_id, log_id: "g" };
+      case 3 /* PLAYGROUND_LOGS */:
+        return { prompt_session_id: this.data.object_id, log_id: "x" };
+      default:
+        const _ = this.data.object_type;
+        throw new Error(`Invalid object_type ${this.data.object_type}`);
+    }
+  }
+  async export() {
+    return this.toStr();
+  }
+  static fromJsonObj(jsonObj) {
+    return new _SpanComponentsV4(spanComponentsV4Schema.parse(jsonObj));
+  }
+};
+function parseParent(parent) {
+  return typeof parent === "string" ? parent : parent ? new SpanComponentsV4({
+    object_type: parent.object_type === "experiment" ? 1 /* EXPERIMENT */ : parent.object_type === "playground_logs" ? 3 /* PLAYGROUND_LOGS */ : 2 /* PROJECT_LOGS */,
+    object_id: parent.object_id,
+    ...parent.row_ids ? {
+      row_id: parent.row_ids.id,
+      span_id: parent.row_ids.span_id,
+      root_span_id: parent.row_ids.root_span_id
+    } : {
+      row_id: void 0,
+      span_id: void 0,
+      root_span_id: void 0
+    },
+    propagated_event: parent.propagated_event
+  }).toStr() : void 0;
+}
+
 // util/span_types.ts
 var spanTypeAttributeValues = [
   "llm",
@@ -1261,4 +1471,6 @@ function objectNullish(object) {
 
 
 
-exports.ASYNC_SCORING_CONTROL_FIELD = ASYNC_SCORING_CONTROL_FIELD; exports.AUDIT_METADATA_FIELD = AUDIT_METADATA_FIELD; exports.AUDIT_SOURCE_FIELD = AUDIT_SOURCE_FIELD; exports.BT_CURSOR_HEADER = BT_CURSOR_HEADER; exports.BT_FOUND_EXISTING_HEADER = BT_FOUND_EXISTING_HEADER; exports.BT_IMPERSONATE_USER = BT_IMPERSONATE_USER; exports.BT_PARENT = BT_PARENT; exports.CREATED_FIELD = CREATED_FIELD; exports.DEFAULT_IS_LEGACY_DATASET = DEFAULT_IS_LEGACY_DATASET; exports.ExtraFieldsError = ExtraFieldsError; exports.ID_FIELD = ID_FIELD; exports.IS_MERGE_FIELD = IS_MERGE_FIELD; exports.MERGE_PATHS_FIELD = MERGE_PATHS_FIELD; exports.OBJECT_DELETE_FIELD = OBJECT_DELETE_FIELD; exports.PARENT_ID_FIELD = PARENT_ID_FIELD; exports.SKIP_ASYNC_SCORING_FIELD = SKIP_ASYNC_SCORING_FIELD; exports.SpanComponentsV1 = SpanComponentsV1; exports.SpanComponentsV2 = SpanComponentsV2; exports.SpanComponentsV3 = SpanComponentsV3; exports.SpanObjectTypeV1 = SpanObjectTypeV1; exports.SpanObjectTypeV2 = SpanObjectTypeV2; exports.SpanObjectTypeV3 = SpanObjectTypeV3; exports.SpanRowIdsV1 = SpanRowIdsV1; exports.SpanRowIdsV2 = SpanRowIdsV2; exports.SpanTypeAttribute = SpanTypeAttribute; exports.TRANSACTION_ID_FIELD = TRANSACTION_ID_FIELD; exports.VALID_SOURCES = VALID_SOURCES; exports._urljoin = _urljoin; exports.base64ToUint8Array = base64ToUint8Array; exports.batchItems = batchItems; exports.camelToSnakeCase = camelToSnakeCase; exports.capitalize = capitalize; exports.concatUint8Arrays = concatUint8Arrays; exports.constructJsonArray = constructJsonArray; exports.deterministicReplacer = deterministicReplacer; exports.ensureDatasetRecord = ensureDatasetRecord; exports.ensureLegacyDatasetRecord = ensureLegacyDatasetRecord; exports.ensureNewDatasetRecord = ensureNewDatasetRecord; exports.forEachMissingKey = forEachMissingKey; exports.getObjValueByPath = getObjValueByPath; exports.getRecordKeys = getRecordKeys; exports.isArray = isArray; exports.isEmpty = isEmpty; exports.isNumber = isNumber; exports.isObject = isObject; exports.isObjectOrArray = isObjectOrArray; exports.loadPrettyXact = loadPrettyXact; exports.lowercase = lowercase; exports.mapAt = mapAt; exports.mapSetDefault = mapSetDefault; exports.mapSetNotPresent = mapSetNotPresent; exports.mergeDicts = mergeDicts; exports.mergeDictsWithPaths = mergeDictsWithPaths; exports.mergeGitMetadataSettings = mergeGitMetadataSettings; exports.mergeRowBatch = mergeRowBatch; exports.notEmpty = notEmpty; exports.objectNullish = objectNullish; exports.parseNoStrip = parseNoStrip; exports.parseParent = parseParent; exports.prettifyXact = prettifyXact; exports.recordAt = recordAt; exports.recordFind = recordFind; exports.recordSetDefault = recordSetDefault; exports.resolveParentHeader = resolveParentHeader; exports.snakeToCamelCase = snakeToCamelCase; exports.snakeToTitleCase = snakeToTitleCase; exports.spanComponentsV3Schema = spanComponentsV3Schema; exports.spanObjectTypeV3EnumSchema = spanObjectTypeV3EnumSchema; exports.spanObjectTypeV3ToString = spanObjectTypeV3ToString; exports.spanPurposeAttributeValues = spanPurposeAttributeValues; exports.spanTypeAttributeValues = spanTypeAttributeValues; exports.stringToUint8Array = stringToUint8Array; exports.uint8ArrayToBase64 = uint8ArrayToBase64; exports.uint8ArrayToString = uint8ArrayToString;
+
+
+exports.ASYNC_SCORING_CONTROL_FIELD = ASYNC_SCORING_CONTROL_FIELD; exports.AUDIT_METADATA_FIELD = AUDIT_METADATA_FIELD; exports.AUDIT_SOURCE_FIELD = AUDIT_SOURCE_FIELD; exports.BT_CURSOR_HEADER = BT_CURSOR_HEADER; exports.BT_FOUND_EXISTING_HEADER = BT_FOUND_EXISTING_HEADER; exports.BT_IMPERSONATE_USER = BT_IMPERSONATE_USER; exports.BT_PARENT = BT_PARENT; exports.CREATED_FIELD = CREATED_FIELD; exports.DEFAULT_IS_LEGACY_DATASET = DEFAULT_IS_LEGACY_DATASET; exports.ExtraFieldsError = ExtraFieldsError; exports.ID_FIELD = ID_FIELD; exports.IS_MERGE_FIELD = IS_MERGE_FIELD; exports.MERGE_PATHS_FIELD = MERGE_PATHS_FIELD; exports.OBJECT_DELETE_FIELD = OBJECT_DELETE_FIELD; exports.PARENT_ID_FIELD = PARENT_ID_FIELD; exports.SKIP_ASYNC_SCORING_FIELD = SKIP_ASYNC_SCORING_FIELD; exports.SpanComponentsV1 = SpanComponentsV1; exports.SpanComponentsV2 = SpanComponentsV2; exports.SpanComponentsV3 = SpanComponentsV3; exports.SpanComponentsV4 = SpanComponentsV4; exports.SpanObjectTypeV1 = SpanObjectTypeV1; exports.SpanObjectTypeV2 = SpanObjectTypeV2; exports.SpanObjectTypeV3 = SpanObjectTypeV3; exports.SpanRowIdsV1 = SpanRowIdsV1; exports.SpanRowIdsV2 = SpanRowIdsV2; exports.SpanTypeAttribute = SpanTypeAttribute; exports.TRANSACTION_ID_FIELD = TRANSACTION_ID_FIELD; exports.VALID_SOURCES = VALID_SOURCES; exports._urljoin = _urljoin; exports.base64ToUint8Array = base64ToUint8Array; exports.batchItems = batchItems; exports.camelToSnakeCase = camelToSnakeCase; exports.capitalize = capitalize; exports.concatUint8Arrays = concatUint8Arrays; exports.constructJsonArray = constructJsonArray; exports.deterministicReplacer = deterministicReplacer; exports.ensureDatasetRecord = ensureDatasetRecord; exports.ensureLegacyDatasetRecord = ensureLegacyDatasetRecord; exports.ensureNewDatasetRecord = ensureNewDatasetRecord; exports.forEachMissingKey = forEachMissingKey; exports.getObjValueByPath = getObjValueByPath; exports.getRecordKeys = getRecordKeys; exports.isArray = isArray; exports.isEmpty = isEmpty; exports.isNumber = isNumber; exports.isObject = isObject; exports.isObjectOrArray = isObjectOrArray; exports.loadPrettyXact = loadPrettyXact; exports.lowercase = lowercase; exports.mapAt = mapAt; exports.mapSetDefault = mapSetDefault; exports.mapSetNotPresent = mapSetNotPresent; exports.mergeDicts = mergeDicts; exports.mergeDictsWithPaths = mergeDictsWithPaths; exports.mergeGitMetadataSettings = mergeGitMetadataSettings; exports.mergeRowBatch = mergeRowBatch; exports.notEmpty = notEmpty; exports.objectNullish = objectNullish; exports.parseNoStrip = parseNoStrip; exports.parseParent = parseParent; exports.prettifyXact = prettifyXact; exports.recordAt = recordAt; exports.recordFind = recordFind; exports.recordSetDefault = recordSetDefault; exports.resolveParentHeader = resolveParentHeader; exports.snakeToCamelCase = snakeToCamelCase; exports.snakeToTitleCase = snakeToTitleCase; exports.spanComponentsV3Schema = spanComponentsV3Schema; exports.spanComponentsV4Schema = spanComponentsV4Schema; exports.spanObjectTypeV3EnumSchema = spanObjectTypeV3EnumSchema; exports.spanObjectTypeV3ToString = spanObjectTypeV3ToString; exports.spanPurposeAttributeValues = spanPurposeAttributeValues; exports.spanTypeAttributeValues = spanTypeAttributeValues; exports.stringToUint8Array = stringToUint8Array; exports.uint8ArrayToBase64 = uint8ArrayToBase64; exports.uint8ArrayToString = uint8ArrayToString;