braintrust 3.23.0 → 3.24.0

package/dist/auto-instrumentations/hook.mjs

@@ -107,6 +107,7 @@ var DefaultChannel = class {
   constructor(name) {
     this.name = name;
   }
+  name;
   hasSubscribers = false;
   subscribe(_subscription) {
   }
@@ -1159,6 +1160,7 @@ var SpanComponentsV3 = class _SpanComponentsV3 {
   constructor(data) {
     this.data = data;
   }
+  data;
   toStr() {
     const jsonObj = {
       compute_object_metadata_args: this.data.compute_object_metadata_args || void 0,
@@ -1576,6 +1578,7 @@ var SpanComponentsV4 = class _SpanComponentsV4 {
   constructor(data) {
     this.data = data;
   }
+  data;
   toStr() {
     const jsonObj = {
       compute_object_metadata_args: this.data.compute_object_metadata_args || void 0,
@@ -4728,6 +4731,97 @@ var SpanCache = class {
   }
 };
 
+// src/span-origin.ts
+var SDK_VERSION = true ? "3.24.0" : "0.0.0";
+function detectSpanOriginEnvironment(explicit) {
+  if (explicit) return explicit;
+  const envType = isomorph_default.getEnv("BRAINTRUST_ENVIRONMENT_TYPE");
+  const envName = isomorph_default.getEnv("BRAINTRUST_ENVIRONMENT_NAME");
+  if (envType || envName) {
+    return {
+      ...envType ? { type: envType } : {},
+      ...envName ? { name: envName } : {}
+    };
+  }
+  const ci = firstPresent([
+    ["GITHUB_ACTIONS", "github_actions"],
+    ["GITLAB_CI", "gitlab_ci"],
+    ["CIRCLECI", "circleci"],
+    ["BUILDKITE", "buildkite"],
+    ["JENKINS_URL", "jenkins"],
+    ["JENKINS_HOME", "jenkins"],
+    ["TF_BUILD", "azure_pipelines"],
+    ["TEAMCITY_VERSION", "teamcity"],
+    ["TRAVIS", "travis"],
+    ["BITBUCKET_BUILD_NUMBER", "bitbucket"]
+  ]);
+  if (ci) return { type: "ci", name: ci };
+  if (isomorph_default.getEnv("CI")) return { type: "ci", name: "ci" };
+  const earlyServer = firstPresent([
+    ["VERCEL", "vercel"],
+    ["NETLIFY", "netlify"]
+  ]);
+  if (earlyServer) return { type: "server", name: earlyServer };
+  if (isomorph_default.getEnv("ECS_CONTAINER_METADATA_URI") || isomorph_default.getEnv("ECS_CONTAINER_METADATA_URI_V4")) {
+    return { type: "server", name: "ecs" };
+  }
+  const awsExecutionEnv = isomorph_default.getEnv("AWS_EXECUTION_ENV");
+  if (awsExecutionEnv?.startsWith("AWS_ECS_")) {
+    return { type: "server", name: "ecs" };
+  }
+  if (awsExecutionEnv?.startsWith("AWS_Lambda_")) {
+    return { type: "server", name: "aws_lambda" };
+  }
+  if (isomorph_default.getEnv("AWS_LAMBDA_FUNCTION_NAME")) {
+    return { type: "server", name: "aws_lambda" };
+  }
+  const server = firstPresent([
+    ["K_SERVICE", "cloud_run"],
+    ["FUNCTION_TARGET", "gcp_functions"],
+    ["KUBERNETES_SERVICE_HOST", "kubernetes"],
+    ["DYNO", "heroku"],
+    ["FLY_APP_NAME", "fly"],
+    ["RAILWAY_ENVIRONMENT", "railway"],
+    ["RENDER_SERVICE_NAME", "render"]
+  ]);
+  if (server) return { type: "server", name: server };
+  return deploymentModeEnvironment("NODE_ENV", isomorph_default.getEnv("NODE_ENV"));
+}
+function makeSpanOrigin(instrumentationName, environment) {
+  return {
+    name: "braintrust.sdk.javascript",
+    version: SDK_VERSION,
+    instrumentation: { name: instrumentationName },
+    ...environment ? { environment } : {}
+  };
+}
+function mergeSpanOriginContext(context, instrumentationName, environment) {
+  const next = { ...context ?? {} };
+  const current = isObject2(next.span_origin) ? { ...next.span_origin } : {};
+  next.span_origin = {
+    ...makeSpanOrigin(instrumentationName, environment),
+    ...current
+  };
+  return next;
+}
+function firstPresent(entries) {
+  return entries.find(([key]) => Boolean(isomorph_default.getEnv(key)))?.[1];
+}
+function deploymentModeEnvironment(_key, value) {
+  if (!value) return void 0;
+  const normalized = value.toLowerCase();
+  if (normalized === "production" || normalized === "staging") {
+    return { type: "server", name: normalized };
+  }
+  if (normalized === "development" || normalized === "local") {
+    return { type: "local", name: normalized };
+  }
+  return { name: value };
+}
+function isObject2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/logger.ts
 var BRAINTRUST_ATTACHMENT = BraintrustAttachmentReference.shape.type.value;
 var EXTERNAL_ATTACHMENT = ExternalAttachmentReference.shape.type.value;
@@ -4776,6 +4870,7 @@ var LoginInvalidOrgError = class extends Error {
     super(message);
     this.message = message;
   }
+  message;
 };
 var REDACTION_FIELDS = [
   "input",
@@ -4791,6 +4886,8 @@ var MaskingError = class {
     this.fieldName = fieldName;
     this.errorType = errorType;
   }
+  fieldName;
+  errorType;
   get errorMsg() {
     return `ERROR: Failed to mask field '${this.fieldName}' - ${this.errorType}`;
   }
@@ -5000,7 +5097,9 @@ var BraintrustState = class _BraintrustState {
       diskCache: parametersDiskCache
     });
     this.spanCache = new SpanCache({ disabled: loginParams.disableSpanCache });
+    this.spanOriginEnvironment = detectSpanOriginEnvironment();
   }
+  loginParams;
   id;
   currentExperiment;
   // Note: the value of IsAsyncFlush doesn't really matter here, since we
@@ -5035,6 +5134,7 @@ var BraintrustState = class _BraintrustState {
   _idGenerator = null;
   _contextManager = null;
   _otelFlushCallback = null;
+  spanOriginEnvironment;
   resetLoginInfo() {
     this.appUrl = null;
     this.appPublicUrl = null;
@@ -7539,6 +7639,11 @@ var ObjectFetcher = class {
     this._internal_btql = _internal_btql;
     this._internalBrainstoreRealtime = _internalBrainstoreRealtime;
   }
+  objectType;
+  pinnedVersion;
+  mutateRecord;
+  _internal_btql;
+  _internalBrainstoreRealtime;
   _fetchedData = void 0;
   get id() {
     throw new Error("ObjectFetcher subclasses must have an 'id' attribute");
@@ -8058,7 +8163,11 @@ var SpanImpl = class _SpanImpl {
       metrics: {
         start: args.startTime ?? getCurrentUnixTimestamp()
       },
-      context: { ...callerLocation },
+      context: mergeSpanOriginContext(
+        { ...callerLocation },
+        "braintrust-js-logger",
+        this._state.spanOriginEnvironment
+      ),
       span_attributes: {
         name,
         type,
@@ -8432,6 +8541,7 @@ var Dataset2 = class extends ObjectFetcher {
     this.pinnedEnvironment = pinState?.pinnedEnvironment;
     this.pinnedSnapshotName = pinState?.pinnedSnapshotName;
   }
+  state;
   lazyMetadata;
   __braintrust_dataset_marker = true;
   newRecords = 0;
@@ -9104,9 +9214,48 @@ var aiSDKChannels = defineChannels("ai", {
     kind: "sync-stream"
   })
 });
+var harnessAgentChannels = defineChannels("@ai-sdk/harness", {
+  generate: channel({
+    channelName: "HarnessAgent.generate",
+    kind: "async"
+  }),
+  stream: channel({
+    channelName: "HarnessAgent.stream",
+    kind: "async"
+  }),
+  continueGenerate: channel({
+    channelName: "HarnessAgent.continueGenerate",
+    kind: "async"
+  }),
+  continueStream: channel({
+    channelName: "HarnessAgent.continueStream",
+    kind: "async"
+  })
+});
 
 // src/auto-instrumentations/configs/ai-sdk.ts
 var aiSDKConfigs = [
+  // HarnessAgent turn methods are published only from the package's ESM
+  // `./agent` entrypoint. The compiled class expression is anonymous, so match
+  // the first async method with each public name instead of a class name.
+  ...[
+    ["generate", harnessAgentChannels.generate.channelName],
+    ["stream", harnessAgentChannels.stream.channelName],
+    ["continueGenerate", harnessAgentChannels.continueGenerate.channelName],
+    ["continueStream", harnessAgentChannels.continueStream.channelName]
+  ].map(([methodName, channelName]) => ({
+    channelName,
+    module: {
+      name: "@ai-sdk/harness",
+      versionRange: ">=1.0.0 <2.0.0",
+      filePath: "dist/agent/index.js"
+    },
+    functionQuery: {
+      methodName,
+      kind: "Async",
+      index: 0
+    }
+  })),
   // generateText - async function
   {
     channelName: aiSDKChannels.generateText.channelName,

package/dist/auto-instrumentations/index.cjs

@@ -61,6 +61,7 @@ var DefaultChannel = class {
   constructor(name) {
     this.name = name;
   }
+  name;
   hasSubscribers = false;
   subscribe(_subscription) {
   }
@@ -722,9 +723,48 @@ var aiSDKChannels = defineChannels("ai", {
     kind: "sync-stream"
   })
 });
+var harnessAgentChannels = defineChannels("@ai-sdk/harness", {
+  generate: channel({
+    channelName: "HarnessAgent.generate",
+    kind: "async"
+  }),
+  stream: channel({
+    channelName: "HarnessAgent.stream",
+    kind: "async"
+  }),
+  continueGenerate: channel({
+    channelName: "HarnessAgent.continueGenerate",
+    kind: "async"
+  }),
+  continueStream: channel({
+    channelName: "HarnessAgent.continueStream",
+    kind: "async"
+  })
+});
 
 // src/auto-instrumentations/configs/ai-sdk.ts
 var aiSDKConfigs = [
+  // HarnessAgent turn methods are published only from the package's ESM
+  // `./agent` entrypoint. The compiled class expression is anonymous, so match
+  // the first async method with each public name instead of a class name.
+  ...[
+    ["generate", harnessAgentChannels.generate.channelName],
+    ["stream", harnessAgentChannels.stream.channelName],
+    ["continueGenerate", harnessAgentChannels.continueGenerate.channelName],
+    ["continueStream", harnessAgentChannels.continueStream.channelName]
+  ].map(([methodName, channelName]) => ({
+    channelName,
+    module: {
+      name: "@ai-sdk/harness",
+      versionRange: ">=1.0.0 <2.0.0",
+      filePath: "dist/agent/index.js"
+    },
+    functionQuery: {
+      methodName,
+      kind: "Async",
+      index: 0
+    }
+  })),
   // generateText - async function
   {
     channelName: aiSDKChannels.generateText.channelName,

package/dist/auto-instrumentations/index.mjs

@@ -20,7 +20,7 @@ import {
   openRouterConfigs,
   openaiConfigs,
   piCodingAgentConfigs
-} from "./chunk-YXLNSAMJ.mjs";
+} from "./chunk-F43DNLPD.mjs";
 export {
   aiSDKConfigs,
   anthropicConfigs,

package/dist/browser.d.mts

@@ -20364,6 +20364,11 @@ type InferParameters<T extends EvalParameters> = {
     [K in keyof T]: InferParameterValue<T[K]>;
 };
 
+type SpanOriginEnvironment = {
+    type?: string;
+    name?: string;
+};
+
 /// <reference lib="dom" />
 
 declare const LOGS3_OVERFLOW_REFERENCE_TYPE = "logs3_overflow";
@@ -20784,6 +20789,7 @@ declare class BraintrustState {
     private _idGenerator;
     private _contextManager;
     private _otelFlushCallback;
+    spanOriginEnvironment: SpanOriginEnvironment | undefined;
     constructor(loginParams: LoginOptions);
     resetLoginInfo(): void;
     resetIdGenState(): void;
@@ -21564,6 +21570,7 @@ type AsyncFlushArg<IsAsyncFlush> = {
 type InitLoggerOptions<IsAsyncFlush> = FullLoginOptions & {
     projectName?: string;
     projectId?: string;
+    environment?: SpanOriginEnvironment;
     setCurrent?: boolean;
     state?: BraintrustState;
     orgProjectMetadata?: OrgProjectMetadata;
@@ -23526,8 +23533,8 @@ type EveJsonObject = {
     readonly [key: string]: EveJsonValue;
 };
 interface EveHookContext {
-    readonly session?: {
-        readonly id?: string;
+    readonly session: {
+        readonly id: string;
         readonly parent?: {
             readonly callId?: string;
             readonly sessionId?: string;
@@ -23628,6 +23635,15 @@ type EveHandleMessageStreamEvent = {
     };
     readonly meta?: EveStreamEventMeta;
     readonly type: "message.completed";
+} | {
+    readonly data: {
+        readonly reasoning: string;
+        readonly sequence: number;
+        readonly stepIndex: number;
+        readonly turnId: string;
+    };
+    readonly meta?: EveStreamEventMeta;
+    readonly type: "reasoning.completed";
 } | {
     readonly data: {
         readonly result: EveJsonValue;
@@ -23761,22 +23777,128 @@ interface EveHookDefinition {
 interface EveInstrumentationSetupContext {
     readonly agentName: string;
 }
+type EveTextPart = {
+    readonly text: string;
+    readonly type: "text";
+};
+type EveImagePart = {
+    readonly image: unknown;
+    readonly mediaType?: string;
+    readonly type: "image";
+};
+type EveFilePart = {
+    readonly data: unknown;
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly type: "file";
+};
+type EveReasoningPart = {
+    readonly text: string;
+    readonly type: "reasoning";
+};
+type EveReasoningFilePart = {
+    readonly data: unknown;
+    readonly mediaType: string;
+    readonly type: "reasoning-file";
+};
+type EveCustomPart = {
+    readonly kind: `${string}.${string}`;
+    readonly type: "custom";
+};
+type EveToolCallPart = {
+    readonly input: unknown;
+    readonly providerExecuted?: boolean;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-call";
+};
+type EveToolResultContentPart = EveTextPart | EveFilePart | {
+    readonly data: string;
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly type: "file-data";
+} | {
+    readonly mediaType?: string;
+    readonly type: "file-url";
+    readonly url: string;
+} | {
+    readonly fileId: string | Readonly<Record<string, string>>;
+    readonly type: "file-id" | "image-file-id";
+} | {
+    readonly providerReference: Readonly<Record<string, string>>;
+    readonly type: "file-reference" | "image-file-reference";
+} | {
+    readonly data: string;
+    readonly mediaType: string;
+    readonly type: "image-data";
+} | {
+    readonly type: "image-url";
+    readonly url: string;
+} | {
+    readonly type: "custom";
+};
+type EveToolResultOutput = {
+    readonly type: "text" | "error-text";
+    readonly value: string;
+} | {
+    readonly type: "json" | "error-json";
+    readonly value: EveJsonValue;
+} | {
+    readonly reason?: string;
+    readonly type: "execution-denied";
+} | {
+    readonly type: "content";
+    readonly value: readonly EveToolResultContentPart[];
+};
+type EveToolResultPart = {
+    readonly output: EveToolResultOutput;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-result";
+};
+type EveToolApprovalRequest = {
+    readonly approvalId: string;
+    readonly isAutomatic?: boolean;
+    readonly signature?: string;
+    readonly toolCallId: string;
+    readonly type: "tool-approval-request";
+};
+type EveToolApprovalResponse = {
+    readonly approvalId: string;
+    readonly approved: boolean;
+    readonly providerExecuted?: boolean;
+    readonly reason?: string;
+    readonly type: "tool-approval-response";
+};
+type EveSystemModelMessage = {
+    readonly content: string;
+    readonly role: "system";
+};
+type EveModelMessage = EveSystemModelMessage | {
+    readonly content: string | readonly (EveTextPart | EveImagePart | EveFilePart)[];
+    readonly role: "user";
+} | {
+    readonly content: string | readonly (EveTextPart | EveCustomPart | EveFilePart | EveReasoningPart | EveReasoningFilePart | EveToolCallPart | EveToolResultPart | EveToolApprovalRequest)[];
+    readonly role: "assistant";
+} | {
+    readonly content: readonly (EveToolResultPart | EveToolApprovalResponse)[];
+    readonly role: "tool";
+};
 interface EveInstrumentationModelInput {
-    readonly instructions?: string | readonly EveJsonObject[];
-    readonly messages: readonly EveJsonObject[];
+    readonly instructions?: string | readonly EveSystemModelMessage[];
+    readonly messages: readonly EveModelMessage[];
 }
 interface EveInstrumentationStepStartedEventInput {
-    readonly channel?: unknown;
     readonly modelInput: EveInstrumentationModelInput;
     readonly session: {
-        readonly id?: string;
+        readonly id: string;
     };
     readonly step: {
-        readonly index?: number;
+        readonly index: number;
     };
     readonly turn: {
-        readonly id?: string;
-        readonly sequence?: number;
+        readonly id: string;
+        readonly sequence: number;
     };
 }
 interface EveInstrumentationDefinition {

package/dist/browser.d.ts

@@ -20364,6 +20364,11 @@ type InferParameters<T extends EvalParameters> = {
     [K in keyof T]: InferParameterValue<T[K]>;
 };
 
+type SpanOriginEnvironment = {
+    type?: string;
+    name?: string;
+};
+
 /// <reference lib="dom" />
 
 declare const LOGS3_OVERFLOW_REFERENCE_TYPE = "logs3_overflow";
@@ -20784,6 +20789,7 @@ declare class BraintrustState {
     private _idGenerator;
     private _contextManager;
     private _otelFlushCallback;
+    spanOriginEnvironment: SpanOriginEnvironment | undefined;
     constructor(loginParams: LoginOptions);
     resetLoginInfo(): void;
     resetIdGenState(): void;
@@ -21564,6 +21570,7 @@ type AsyncFlushArg<IsAsyncFlush> = {
 type InitLoggerOptions<IsAsyncFlush> = FullLoginOptions & {
     projectName?: string;
     projectId?: string;
+    environment?: SpanOriginEnvironment;
     setCurrent?: boolean;
     state?: BraintrustState;
     orgProjectMetadata?: OrgProjectMetadata;
@@ -23526,8 +23533,8 @@ type EveJsonObject = {
     readonly [key: string]: EveJsonValue;
 };
 interface EveHookContext {
-    readonly session?: {
-        readonly id?: string;
+    readonly session: {
+        readonly id: string;
         readonly parent?: {
             readonly callId?: string;
             readonly sessionId?: string;
@@ -23628,6 +23635,15 @@ type EveHandleMessageStreamEvent = {
     };
     readonly meta?: EveStreamEventMeta;
     readonly type: "message.completed";
+} | {
+    readonly data: {
+        readonly reasoning: string;
+        readonly sequence: number;
+        readonly stepIndex: number;
+        readonly turnId: string;
+    };
+    readonly meta?: EveStreamEventMeta;
+    readonly type: "reasoning.completed";
 } | {
     readonly data: {
         readonly result: EveJsonValue;
@@ -23761,22 +23777,128 @@ interface EveHookDefinition {
 interface EveInstrumentationSetupContext {
     readonly agentName: string;
 }
+type EveTextPart = {
+    readonly text: string;
+    readonly type: "text";
+};
+type EveImagePart = {
+    readonly image: unknown;
+    readonly mediaType?: string;
+    readonly type: "image";
+};
+type EveFilePart = {
+    readonly data: unknown;
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly type: "file";
+};
+type EveReasoningPart = {
+    readonly text: string;
+    readonly type: "reasoning";
+};
+type EveReasoningFilePart = {
+    readonly data: unknown;
+    readonly mediaType: string;
+    readonly type: "reasoning-file";
+};
+type EveCustomPart = {
+    readonly kind: `${string}.${string}`;
+    readonly type: "custom";
+};
+type EveToolCallPart = {
+    readonly input: unknown;
+    readonly providerExecuted?: boolean;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-call";
+};
+type EveToolResultContentPart = EveTextPart | EveFilePart | {
+    readonly data: string;
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly type: "file-data";
+} | {
+    readonly mediaType?: string;
+    readonly type: "file-url";
+    readonly url: string;
+} | {
+    readonly fileId: string | Readonly<Record<string, string>>;
+    readonly type: "file-id" | "image-file-id";
+} | {
+    readonly providerReference: Readonly<Record<string, string>>;
+    readonly type: "file-reference" | "image-file-reference";
+} | {
+    readonly data: string;
+    readonly mediaType: string;
+    readonly type: "image-data";
+} | {
+    readonly type: "image-url";
+    readonly url: string;
+} | {
+    readonly type: "custom";
+};
+type EveToolResultOutput = {
+    readonly type: "text" | "error-text";
+    readonly value: string;
+} | {
+    readonly type: "json" | "error-json";
+    readonly value: EveJsonValue;
+} | {
+    readonly reason?: string;
+    readonly type: "execution-denied";
+} | {
+    readonly type: "content";
+    readonly value: readonly EveToolResultContentPart[];
+};
+type EveToolResultPart = {
+    readonly output: EveToolResultOutput;
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly type: "tool-result";
+};
+type EveToolApprovalRequest = {
+    readonly approvalId: string;
+    readonly isAutomatic?: boolean;
+    readonly signature?: string;
+    readonly toolCallId: string;
+    readonly type: "tool-approval-request";
+};
+type EveToolApprovalResponse = {
+    readonly approvalId: string;
+    readonly approved: boolean;
+    readonly providerExecuted?: boolean;
+    readonly reason?: string;
+    readonly type: "tool-approval-response";
+};
+type EveSystemModelMessage = {
+    readonly content: string;
+    readonly role: "system";
+};
+type EveModelMessage = EveSystemModelMessage | {
+    readonly content: string | readonly (EveTextPart | EveImagePart | EveFilePart)[];
+    readonly role: "user";
+} | {
+    readonly content: string | readonly (EveTextPart | EveCustomPart | EveFilePart | EveReasoningPart | EveReasoningFilePart | EveToolCallPart | EveToolResultPart | EveToolApprovalRequest)[];
+    readonly role: "assistant";
+} | {
+    readonly content: readonly (EveToolResultPart | EveToolApprovalResponse)[];
+    readonly role: "tool";
+};
 interface EveInstrumentationModelInput {
-    readonly instructions?: string | readonly EveJsonObject[];
-    readonly messages: readonly EveJsonObject[];
+    readonly instructions?: string | readonly EveSystemModelMessage[];
+    readonly messages: readonly EveModelMessage[];
 }
 interface EveInstrumentationStepStartedEventInput {
-    readonly channel?: unknown;
     readonly modelInput: EveInstrumentationModelInput;
     readonly session: {
-        readonly id?: string;
+        readonly id: string;
     };
     readonly step: {
-        readonly index?: number;
+        readonly index: number;
     };
     readonly turn: {
-        readonly id?: string;
-        readonly sequence?: number;
+        readonly id: string;
+        readonly sequence: number;
     };
 }
 interface EveInstrumentationDefinition {