braintrust 3.20.0 → 3.22.0

package/dist/index.mjs

@@ -1,8 +1,10 @@
 import {
   Attachment,
   AttachmentReference,
+  BAGGAGE_HEADER,
   BRAINTRUST_CURRENT_SPAN_STORE,
   BRAINTRUST_LANGCHAIN_CALLBACK_HANDLER_NAME,
+  BRAINTRUST_PARENT_KEY,
   BaseAttachment,
   BraintrustLangChainCallbackHandler,
   BraintrustObservabilityExporter,
@@ -25,6 +27,7 @@ import {
   JSONAttachment,
   LEGACY_CACHED_HEADER,
   LOGS3_OVERFLOW_REFERENCE_TYPE,
+  LRUCache,
   LazyValue,
   Logger,
   LoginInvalidOrgError,
@@ -32,6 +35,7 @@ import {
   NOOP_SPAN,
   NOOP_SPAN_PERMALINK,
   NoopSpan,
+  OTELIDGenerator,
   ObjectFetcher,
   ObjectReference,
   Project,
@@ -41,8 +45,10 @@ import {
   ReadonlyExperiment,
   RemoteEvalParameters,
   RunEval,
-  SpanComponentsV3,
+  SpanComponentsV4,
   SpanImpl,
+  TRACEPARENT_HEADER,
+  TRACESTATE_HEADER,
   TestBackgroundLogger,
   ToolFunctionDefinition,
   UUIDGenerator,
@@ -50,6 +56,7 @@ import {
   _exportsForTestingOnly,
   _internalGetGlobalState,
   _internalSetInitialState,
+  _internalStartSpanWithInitialMerge,
   addAzureBlobHeaders,
   braintrustAISDKTelemetry,
   braintrustFlueInstrumentation,
@@ -63,11 +70,13 @@ import {
   currentExperiment,
   currentLogger,
   currentSpan,
+  currentWorkflowAgentWrapperSpan,
   debugLogger,
   deepCopyEvent,
   deserializePlainStringAsJSON,
   devNullWritableStream,
   extractAnthropicCacheTokens,
+  extractTraceContextFromHeaders,
   finalizeAnthropicTokens,
   flush,
   getBedrockRuntimeOperation,
@@ -81,6 +90,7 @@ import {
   initDataset,
   initExperiment,
   initLogger,
+  injectTraceContext,
   isEmpty,
   isObject,
   isTemplateFormat,
@@ -129,7 +139,7 @@ import {
   wrapMastraAgent,
   wrapTraced,
   zodToJsonSchema
-} from "./chunk-F73OMF66.mjs";
+} from "./chunk-ZG2O3XVF.mjs";
 import {
   __export,
   aiSDKChannels,
@@ -152,15 +162,17 @@ import {
   openRouterChannels,
   piCodingAgentChannels,
   strandsAgentSDKChannels
-} from "./chunk-Y7W7WP6H.mjs";
+} from "./chunk-KMGUTPB7.mjs";
 
 // src/exports.ts
 var exports_exports = {};
 __export(exports_exports, {
   Attachment: () => Attachment,
   AttachmentReference: () => AttachmentReference,
+  BAGGAGE_HEADER: () => BAGGAGE_HEADER,
   BRAINTRUST_CURRENT_SPAN_STORE: () => BRAINTRUST_CURRENT_SPAN_STORE,
   BRAINTRUST_LANGCHAIN_CALLBACK_HANDLER_NAME: () => BRAINTRUST_LANGCHAIN_CALLBACK_HANDLER_NAME,
+  BRAINTRUST_PARENT_KEY: () => BRAINTRUST_PARENT_KEY,
   BaseAttachment: () => BaseAttachment,
   BaseExperiment: () => BaseExperiment,
   BraintrustLangChainCallbackHandler: () => BraintrustLangChainCallbackHandler,
@@ -193,6 +205,7 @@ __export(exports_exports, {
   NOOP_SPAN: () => NOOP_SPAN,
   NOOP_SPAN_PERMALINK: () => NOOP_SPAN_PERMALINK,
   NoopSpan: () => NoopSpan,
+  OTELIDGenerator: () => OTELIDGenerator,
   ObjectFetcher: () => ObjectFetcher,
   Project: () => Project2,
   ProjectNameIdMap: () => ProjectNameIdMap,
@@ -204,6 +217,8 @@ __export(exports_exports, {
   ScorerBuilder: () => ScorerBuilder,
   SpanFetcher: () => SpanFetcher,
   SpanImpl: () => SpanImpl,
+  TRACEPARENT_HEADER: () => TRACEPARENT_HEADER,
+  TRACESTATE_HEADER: () => TRACESTATE_HEADER,
   TestBackgroundLogger: () => TestBackgroundLogger,
   ToolBuilder: () => ToolBuilder,
   UUIDGenerator: () => UUIDGenerator,
@@ -213,7 +228,10 @@ __export(exports_exports, {
   _internalIso: () => isomorph_default,
   _internalSetInitialState: () => _internalSetInitialState,
   addAzureBlobHeaders: () => addAzureBlobHeaders,
+  agentAssertionScorer: () => agentAssertionScorer,
   braintrustAISDKTelemetry: () => braintrustAISDKTelemetry,
+  braintrustEveHook: () => braintrustEveHook,
+  braintrustEveInstrumentation: () => braintrustEveInstrumentation,
   braintrustFlueInstrumentation: () => braintrustFlueInstrumentation,
   braintrustFlueObserver: () => braintrustFlueObserver,
   braintrustStreamChunkSchema: () => braintrustStreamChunkSchema,
@@ -230,6 +248,7 @@ __export(exports_exports, {
   devNullWritableStream: () => devNullWritableStream,
   evaluatorDefinitionSchema: () => evaluatorDefinitionSchema,
   evaluatorDefinitionsSchema: () => evaluatorDefinitionsSchema,
+  extractTraceContextFromHeaders: () => extractTraceContextFromHeaders,
   flush: () => flush,
   getContextManager: () => getContextManager,
   getIdGenerator: () => getIdGenerator,
@@ -243,6 +262,7 @@ __export(exports_exports, {
   initFunction: () => initFunction,
   initLogger: () => initLogger,
   initNodeTestSuite: () => initNodeTestSuite,
+  injectTraceContext: () => injectTraceContext,
   invoke: () => invoke,
   isTemplateFormat: () => isTemplateFormat,
   loadParameters: () => loadParameters,
@@ -874,6 +894,7 @@ function wrapAISDK(aiSDK, options = {}) {
         case "Agent":
         case "Experimental_Agent":
         case "ToolLoopAgent":
+        case "WorkflowAgent":
           return original ? wrapAgentClass(original, options) : original;
       }
       return original;
@@ -892,10 +913,10 @@ var wrapAgentClass = (AgentClass, options = {}) => {
       return new Proxy(instance, {
         get(instanceTarget, prop, instanceReceiver) {
           const original = Reflect.get(instanceTarget, prop, instanceTarget);
-          if (prop === "generate") {
+          if (prop === "generate" && typeof original === "function" && instanceTarget.constructor.name !== "WorkflowAgent") {
             return wrapAgentGenerate(original, instanceTarget, options);
           }
-          if (prop === "stream") {
+          if (prop === "stream" && typeof original === "function") {
             return wrapAgentStream(original, instanceTarget, options);
           }
           if (typeof original === "function") {
@@ -910,7 +931,7 @@ var wrapAgentClass = (AgentClass, options = {}) => {
 var wrapAgentGenerate = (generate, instance, options = {}) => {
   const defaultName = `${instance.constructor.name}.generate`;
   return async (params) => makeGenerateTextWrapper(
-    aiSDKChannels.generateText,
+    generateChannelForAgent(instance.constructor.name),
     defaultName,
     generate.bind(instance),
     {
@@ -920,19 +941,42 @@ var wrapAgentGenerate = (generate, instance, options = {}) => {
     options
   )({ ...instance.settings, ...params });
 };
+function generateChannelForAgent(agentName) {
+  if (agentName === "ToolLoopAgent") {
+    return aiSDKChannels.toolLoopAgentGenerate;
+  }
+  return aiSDKChannels.agentGenerate;
+}
 var wrapAgentStream = (stream, instance, options = {}) => {
   const defaultName = `${instance.constructor.name}.stream`;
-  return (params) => makeStreamWrapper(
-    aiSDKChannels.agentStream,
-    defaultName,
-    stream.bind(instance),
-    {
-      self: instance,
-      spanType: "function" /* FUNCTION */
-    },
-    options
-  )({ ...instance.settings, ...params });
+  return (params) => {
+    const workflowAgent = instance.constructor.name === "WorkflowAgent";
+    if (workflowAgent && currentWorkflowAgentWrapperSpan()) {
+      const { span_info: _spanInfo, ...cleanParams } = params;
+      return stream.call(instance, { ...instance.settings, ...cleanParams });
+    }
+    const trace = () => makeStreamWrapper(
+      streamChannelForAgent(instance.constructor.name),
+      defaultName,
+      stream.bind(instance),
+      {
+        self: instance,
+        spanType: "function" /* FUNCTION */
+      },
+      options
+    )({ ...instance.settings, ...params });
+    return trace();
+  };
 };
+function streamChannelForAgent(agentName) {
+  if (agentName === "ToolLoopAgent") {
+    return aiSDKChannels.toolLoopAgentStream;
+  }
+  if (agentName === "WorkflowAgent") {
+    return aiSDKChannels.workflowAgentStream;
+  }
+  return aiSDKChannels.agentStream;
+}
 var makeGenerateTextWrapper = (channel, name, generateText, contextOptions = {}, options = {}) => {
   const wrapper = async function(allParams) {
     const { span_info, ...params } = allParams;
@@ -1194,7 +1238,7 @@ var BraintrustLanguageModelWrapper = class {
       let time_to_first_token = void 0;
       let usage = void 0;
       let fullText = void 0;
-      const toolCalls = {};
+      const toolCalls2 = {};
       let finishReason = void 0;
       return {
         ...ret,
@@ -1213,7 +1257,7 @@ var BraintrustLanguageModelWrapper = class {
                   fullText += chunk.textDelta;
                   break;
                 case "tool-call":
-                  toolCalls[chunk.toolCallId] = {
+                  toolCalls2[chunk.toolCallId] = {
                     toolCallType: chunk.toolCallType,
                     toolCallId: chunk.toolCallId,
                     toolName: chunk.toolName,
@@ -1221,15 +1265,15 @@ var BraintrustLanguageModelWrapper = class {
                   };
                   break;
                 case "tool-call-delta":
-                  if (toolCalls[chunk.toolCallId] === void 0) {
-                    toolCalls[chunk.toolCallId] = {
+                  if (toolCalls2[chunk.toolCallId] === void 0) {
+                    toolCalls2[chunk.toolCallId] = {
                       toolCallType: chunk.toolCallType,
                       toolCallId: chunk.toolCallId,
                       toolName: chunk.toolName,
                       args: ""
                     };
                   }
-                  toolCalls[chunk.toolCallId].args += chunk.argsTextDelta;
+                  toolCalls2[chunk.toolCallId].args += chunk.argsTextDelta;
                   break;
                 case "finish":
                   usage = chunk.usage;
@@ -1242,7 +1286,7 @@ var BraintrustLanguageModelWrapper = class {
               span.log({
                 output: postProcessOutput(
                   fullText,
-                  Object.keys(toolCalls).length > 0 ? Object.values(toolCalls) : void 0,
+                  Object.keys(toolCalls2).length > 0 ? Object.values(toolCalls2) : void 0,
                   finishReason
                 ),
                 metrics: {
@@ -1343,15 +1387,15 @@ function postProcessPrompt(prompt) {
     }
   });
 }
-function postProcessOutput(text, toolCalls, finishReason) {
+function postProcessOutput(text, toolCalls2, finishReason) {
   return [
     {
       index: 0,
       message: {
         role: "assistant",
         content: text ?? "",
-        ...toolCalls && toolCalls.length > 0 ? {
-          tool_calls: toolCalls.map((toolCall) => ({
+        ...toolCalls2 && toolCalls2.length > 0 ? {
+          tool_calls: toolCalls2.map((toolCall) => ({
             id: toolCall.toolCallId,
             function: {
               name: toolCall.toolName,
@@ -1450,29 +1494,29 @@ function normalizeFinishReason(reason) {
   if (typeof reason !== "string") return void 0;
   return reason.replace(/-/g, "_");
 }
-function buildAssistantOutputWithToolCalls(result, toolCalls) {
+function buildAssistantOutputWithToolCalls(result, toolCalls2) {
   return [
     {
       index: 0,
       logprobs: null,
-      finish_reason: normalizeFinishReason(result?.finishReason) ?? (toolCalls.length ? "tool_calls" : void 0),
+      finish_reason: normalizeFinishReason(result?.finishReason) ?? (toolCalls2.length ? "tool_calls" : void 0),
       message: {
         role: "assistant",
-        tool_calls: toolCalls.length > 0 ? toolCalls : void 0
+        tool_calls: toolCalls2.length > 0 ? toolCalls2 : void 0
       }
     }
   ];
 }
 function extractToolCallsFromSteps(steps) {
-  const toolCalls = [];
-  if (!Array.isArray(steps)) return toolCalls;
+  const toolCalls2 = [];
+  if (!Array.isArray(steps)) return toolCalls2;
   let idx = 0;
   for (const step of steps) {
     const blocks = step?.content;
     if (!Array.isArray(blocks)) continue;
     for (const block of blocks) {
       if (block && typeof block === "object" && block.type === "tool-call") {
-        toolCalls.push({
+        toolCalls2.push({
           id: block.toolCallId,
           type: "function",
           index: idx++,
@@ -1484,7 +1528,7 @@ function extractToolCallsFromSteps(steps) {
       }
     }
   }
-  return toolCalls;
+  return toolCalls2;
 }
 function extractToolCallsFromBlocks(blocks) {
   if (!Array.isArray(blocks)) return [];
@@ -1550,12 +1594,12 @@ function BraintrustMiddleware(config = {}) {
             metadata.model = modelId;
           }
         }
-        let toolCalls = extractToolCallsFromSteps(result?.steps);
-        if (!toolCalls || toolCalls.length === 0) {
-          toolCalls = extractToolCallsFromBlocks(result?.content);
+        let toolCalls2 = extractToolCallsFromSteps(result?.steps);
+        if (!toolCalls2 || toolCalls2.length === 0) {
+          toolCalls2 = extractToolCallsFromBlocks(result?.content);
         }
         span.log({
-          output: toolCalls.length > 0 ? buildAssistantOutputWithToolCalls(result, toolCalls) : result?.content,
+          output: toolCalls2.length > 0 ? buildAssistantOutputWithToolCalls(result, toolCalls2) : result?.content,
           metadata,
           metrics: normalizeUsageMetrics(
             result.usage,
@@ -1644,13 +1688,13 @@ function BraintrustMiddleware(config = {}) {
                 metadata.model = model;
               }
               if (toolBlocks.length > 0) {
-                const toolCalls = extractToolCallsFromSteps([
+                const toolCalls2 = extractToolCallsFromSteps([
                   { content: toolBlocks }
                 ]);
-                if (toolCalls.length > 0) {
+                if (toolCalls2.length > 0) {
                   output = buildAssistantOutputWithToolCalls(
                     resultForDetection,
-                    toolCalls
+                    toolCalls2
                   );
                 }
               }
@@ -1688,6 +1732,1469 @@ function BraintrustMiddleware(config = {}) {
   };
 }
 
+// src/instrumentation/plugins/eve-plugin.ts
+var EVE_TRACE_STATE_KEY = "braintrust.eve.tracing";
+var MAX_EVE_CACHE_ENTRIES = 1e4;
+var MAX_STORED_LLM_INPUTS = 100;
+var MAX_STORED_SPAN_REFERENCES = 1e4;
+var MAX_STORED_STEP_STARTS = 1e4;
+function braintrustEveHook(options) {
+  const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
+  const bridge = new EveBridge(state);
+  return {
+    events: {
+      "*": async (event, ctx) => {
+        await bridge.handle(event, ctx, options.metadata);
+      }
+    }
+  };
+}
+function braintrustEveInstrumentation(options) {
+  const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
+  return {
+    events: {
+      "step.started": (input) => {
+        try {
+          captureEveModelInput(state, input);
+        } catch (error) {
+          debugLogger.warn("Error in Eve LLM input capture:", error);
+        }
+      }
+    },
+    recordInputs: false,
+    recordOutputs: false,
+    setup: options.setup
+  };
+}
+function isEveHandleMessageStreamEvent(event) {
+  return isObject(event) && typeof event["type"] === "string";
+}
+var ResumedEveSpan = class {
+  constructor(reference) {
+    this.reference = reference;
+    this.endTime = reference.endTime;
+  }
+  endTime;
+  get rootSpanId() {
+    return this.reference.rootSpanId;
+  }
+  get spanId() {
+    return this.reference.spanId;
+  }
+  log(event) {
+    const metrics = {
+      ...this.reference.startEvent?.metrics,
+      ...this.endTime === void 0 ? {} : { end: this.endTime },
+      ...event.metrics
+    };
+    updateSpan({
+      exported: this.reference.exported,
+      ...this.reference.startEvent,
+      ...event,
+      ...Object.keys(metrics).length > 0 ? { metrics } : {}
+    });
+  }
+  end(args) {
+    if (this.endTime === void 0) {
+      this.endTime = args?.endTime ?? getCurrentUnixTimestamp();
+      this.log({ metrics: { end: this.endTime } });
+    }
+    return this.endTime;
+  }
+};
+var EveBridge = class {
+  constructor(state) {
+    this.state = state;
+  }
+  eventQueuesBySession = /* @__PURE__ */ new Map();
+  sessionsById = new LRUCache({
+    max: MAX_EVE_CACHE_ENTRIES
+  });
+  completedToolKeys = new LRUCache({
+    max: MAX_EVE_CACHE_ENTRIES
+  });
+  toolsByCallKey = new LRUCache({
+    max: MAX_EVE_CACHE_ENTRIES
+  });
+  turnsByKey = new LRUCache({
+    max: MAX_EVE_CACHE_ENTRIES
+  });
+  async startEveSpan(args) {
+    const rowId = args?.event?.id;
+    const reference = typeof rowId === "string" && readEveTraceState(this.state).spanReferences.find(
+      (candidate) => candidate.rowId === rowId
+    );
+    if (reference) {
+      return new ResumedEveSpan(reference);
+    }
+    const startTime = args?.startTime ?? getCurrentUnixTimestamp();
+    const parentSpanIds = args?.parentSpanIds;
+    const startEvent = {
+      created: (/* @__PURE__ */ new Date()).toISOString(),
+      metrics: { start: startTime },
+      span_attributes: {
+        ...args?.name ? { name: args.name } : {},
+        ...args?.type ? { type: args.type } : {},
+        ...args?.spanAttributes
+      },
+      span_parents: parentSpanIds ? "spanId" in parentSpanIds ? [parentSpanIds.spanId] : parentSpanIds.parentSpanIds : []
+    };
+    const span = withCurrent(
+      NOOP_SPAN,
+      () => _internalStartSpanWithInitialMerge({ ...args, startTime })
+    );
+    if (typeof rowId !== "string") {
+      return span;
+    }
+    try {
+      const exported = await span.export();
+      const reference2 = {
+        exported,
+        rootSpanId: span.rootSpanId,
+        rowId,
+        spanId: span.spanId,
+        startEvent
+      };
+      this.state.update((current) => {
+        const normalized = normalizeEveTraceState(current);
+        return normalized.spanReferences.some(
+          (candidate) => candidate.rowId === rowId
+        ) ? normalized : {
+          ...normalized,
+          spanReferences: [...normalized.spanReferences, reference2].slice(
+            -MAX_STORED_SPAN_REFERENCES
+          )
+        };
+      });
+    } catch (error) {
+      debugLogger.warn("Error exporting Eve span for resumption:", error);
+    }
+    return span;
+  }
+  async startEveChildSpan(parent, args) {
+    return await this.startEveSpan({
+      ...args,
+      parentSpanIds: {
+        rootSpanId: parent.rootSpanId,
+        spanId: parent.spanId
+      }
+    });
+  }
+  stepOrdinal(event) {
+    let ordinal = 0;
+    this.state.update((current) => {
+      const state = normalizeEveTraceState(current);
+      const previous = state.stepStarts.filter(
+        (entry) => entry.turnId === event.data.turnId && entry.stepIndex === event.data.stepIndex
+      ).at(-1);
+      if (previous?.open) {
+        ordinal = previous.ordinal;
+        return state;
+      }
+      ordinal = state.stepStarts.filter(
+        (entry) => entry.turnId === event.data.turnId
+      ).length;
+      return {
+        ...state,
+        stepStarts: [
+          ...state.stepStarts,
+          {
+            open: true,
+            ordinal,
+            stepIndex: event.data.stepIndex,
+            turnId: event.data.turnId
+          }
+        ].slice(-MAX_STORED_STEP_STARTS)
+      };
+    });
+    return ordinal;
+  }
+  markStepEnded(turnId, stepIndex) {
+    this.state.update((current) => {
+      const state = normalizeEveTraceState(current);
+      let index = -1;
+      for (let i = state.stepStarts.length - 1; i >= 0; i--) {
+        const entry = state.stepStarts[i];
+        if (entry?.turnId === turnId && entry.stepIndex === stepIndex) {
+          index = i;
+          break;
+        }
+      }
+      if (index < 0 || !state.stepStarts[index]?.open) {
+        return state;
+      }
+      return {
+        ...state,
+        stepStarts: state.stepStarts.map(
+          (entry, entryIndex) => entryIndex === index ? { ...entry, open: false } : entry
+        )
+      };
+    });
+  }
+  async handle(event, ctx, hookMetadata) {
+    if (!isEveHandleMessageStreamEvent(event)) {
+      return;
+    }
+    const run = async () => {
+      try {
+        if (!await this.handleEvent(event, ctx, hookMetadata)) {
+          return;
+        }
+        if (event.type === "session.failed") {
+          const sessionId2 = event.data.sessionId || sessionIdFromContext(ctx);
+          await this.flushInstrumentation();
+          if (sessionId2) {
+            this.cleanupSession(sessionId2);
+          }
+        } else if (event.type === "session.completed") {
+          const sessionId2 = sessionIdFromContext(ctx);
+          await this.flushInstrumentation();
+          if (sessionId2) {
+            this.cleanupSession(sessionId2);
+          }
+        }
+      } catch (error) {
+        debugLogger.warn("Error in Eve hook instrumentation:", error);
+      }
+    };
+    const sessionId = event.type === "session.failed" ? event.data.sessionId || sessionIdFromContext(ctx) : sessionIdFromContext(ctx);
+    if (!sessionId) {
+      await run();
+      return;
+    }
+    const previous = this.eventQueuesBySession.get(sessionId);
+    const queued = previous ? previous.then(run) : run();
+    this.eventQueuesBySession.set(sessionId, queued);
+    try {
+      await queued;
+    } finally {
+      if (this.eventQueuesBySession.get(sessionId) === queued) {
+        this.eventQueuesBySession.delete(sessionId);
+      }
+    }
+  }
+  async handleEvent(event, ctx, hookMetadata) {
+    switch (event.type) {
+      case "session.started":
+        await this.handleSessionStarted(event, ctx, hookMetadata);
+        return true;
+      case "turn.started":
+        await this.handleTurnStarted(event, ctx, hookMetadata);
+        return true;
+      case "message.received":
+        await this.handleMessageReceived(event, ctx, hookMetadata);
+        return true;
+      case "step.started":
+        await this.handleStepStarted(event, ctx, hookMetadata);
+        return true;
+      case "message.completed":
+        this.handleMessageCompleted(event, ctx);
+        return true;
+      case "result.completed":
+        this.handleResultCompleted(event, ctx);
+        return true;
+      case "actions.requested":
+        await this.handleActionsRequested(event, ctx, hookMetadata);
+        return true;
+      case "action.result":
+        await this.handleActionResult(event, ctx, hookMetadata);
+        return true;
+      case "subagent.called":
+        await this.handleSubagentCalled(event, ctx, hookMetadata);
+        return true;
+      case "subagent.completed":
+        await this.handleSubagentCompleted(event, ctx, hookMetadata);
+        return true;
+      case "step.completed":
+        this.handleStepCompleted(event, ctx);
+        return true;
+      case "step.failed":
+        this.handleStepFailed(event, ctx);
+        return true;
+      case "turn.completed":
+        await this.handleTurnCompleted(event, ctx);
+        return true;
+      case "turn.failed":
+        await this.handleTurnFailed(event, ctx);
+        return true;
+      case "session.failed":
+        await this.handleSessionFailed(event, ctx);
+        return true;
+      case "session.completed":
+        await this.handleSessionCompleted(event, ctx);
+        return true;
+      default:
+        return false;
+    }
+  }
+  async handleSessionStarted(event, ctx, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const metadata = {
+      ...hookMetadata ?? {},
+      ...modelMetadataFromRuntime(event.data.runtime)
+    };
+    this.state.update((current) => {
+      const normalized = normalizeEveTraceState(current);
+      return {
+        ...normalized,
+        metadata: { ...normalized.metadata, ...metadata }
+      };
+    });
+    await this.ensureSession(sessionId, ctx, metadata, eventTime(event));
+    for (const [key, turn] of this.turnsByKey) {
+      if (!key.startsWith(`${sessionId}:`)) {
+        continue;
+      }
+      turn.metadata = { ...turn.metadata, ...metadata };
+      turn.span.log({ metadata: turn.metadata });
+      for (const step of turn.stepsByIndex.values()) {
+        step.metadata = { ...step.metadata, ...metadata };
+        step.span.log({ metadata: step.metadata });
+      }
+    }
+  }
+  async handleTurnStarted(event, ctx, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const session = await this.ensureSession(
+      sessionId,
+      ctx,
+      hookMetadata ?? {},
+      eventTime(event)
+    );
+    const key = turnKey(sessionId, event.data.turnId);
+    const metadata = { ...session.metadata };
+    const existing = this.turnsByKey.get(key);
+    if (existing) {
+      existing.metadata = { ...existing.metadata, ...metadata };
+      existing.span.log({ metadata: existing.metadata });
+      return;
+    }
+    const span = await this.startTurnSpan(session, event, metadata);
+    span.log({ metadata });
+    this.turnsByKey.set(key, {
+      key,
+      metadata,
+      metrics: {},
+      span,
+      stepsByIndex: /* @__PURE__ */ new Map(),
+      turnId: event.data.turnId
+    });
+  }
+  async handleMessageReceived(event, ctx, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    if (!turn) {
+      return;
+    }
+    const input = [{ content: event.data.message, role: "user" }];
+    turn.span.log({ input });
+  }
+  async handleStepStarted(event, ctx, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return;
+    }
+    const existing = turn.stepsByIndex.get(event.data.stepIndex);
+    if (existing) {
+      existing.span.log({
+        ...existing.input !== void 0 ? { input: existing.input } : {},
+        metadata: existing.metadata,
+        metrics: existing.metrics,
+        output: existing.output
+      });
+      const endTime = eventTime(event);
+      existing.span.end(endTime === void 0 ? void 0 : { endTime });
+      this.markStepEnded(event.data.turnId, event.data.stepIndex);
+    }
+    const stepOrdinal = this.stepOrdinal(event);
+    const metadata = {
+      ...turn.metadata,
+      ...this.sessionsById.get(sessionId)?.metadata ?? {}
+    };
+    const input = consumeCapturedEveModelInput(
+      this.state,
+      sessionId,
+      event.data.turnId,
+      event.data.stepIndex
+    );
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "step",
+      sessionId,
+      event.data.turnId,
+      String(stepOrdinal)
+    );
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        ...input !== void 0 ? { input } : {},
+        metadata
+      },
+      name: "eve.step",
+      spanAttributes: { type: "llm" /* LLM */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ ...input !== void 0 ? { input } : {}, metadata });
+    turn.stepsByIndex.set(event.data.stepIndex, {
+      ...input !== void 0 ? { input } : {},
+      metadata,
+      metrics: {},
+      span
+    });
+  }
+  handleMessageCompleted(event, ctx) {
+    const step = this.stepForEvent(event, ctx);
+    if (!step) {
+      return;
+    }
+    const existingMessage = Array.isArray(step.output) && isObject(step.output[0]) ? step.output[0].message : void 0;
+    const existingToolCalls = isObject(existingMessage) ? existingMessage.tool_calls : void 0;
+    step.output = [
+      {
+        finish_reason: normalizedFinishReason(event.data.finishReason),
+        index: 0,
+        message: {
+          content: event.data.message,
+          role: "assistant",
+          ...Array.isArray(existingToolCalls) ? { tool_calls: existingToolCalls } : {}
+        }
+      }
+    ];
+    const turn = this.turnForEvent(event, ctx);
+    if (turn && event.data.finishReason !== "tool-calls") {
+      turn.output = event.data.message;
+    }
+  }
+  handleResultCompleted(event, ctx) {
+    const step = this.stepForEvent(event, ctx);
+    if (step) {
+      step.output = [
+        {
+          finish_reason: "stop",
+          index: 0,
+          message: {
+            content: event.data.result,
+            role: "assistant"
+          }
+        }
+      ];
+    }
+    const turn = this.turnForEvent(event, ctx);
+    if (turn) {
+      turn.output = event.data.result;
+    }
+  }
+  async handleActionsRequested(event, ctx, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return;
+    }
+    const traceActions = event.data.actions.filter(isTraceableActionRequest);
+    if (traceActions.length === 0) {
+      return;
+    }
+    for (const action of traceActions) {
+      if (isToolCallAction(action)) {
+        await this.startRequestedTool(event, turn, sessionId, action);
+      } else if (isLocalSubagentCallAction(action)) {
+        await this.startRequestedSubagent(event, turn, sessionId, action);
+      }
+    }
+    const step = turn.stepsByIndex.get(event.data.stepIndex);
+    if (!step) {
+      return;
+    }
+    step.output = [
+      {
+        finish_reason: "tool_calls",
+        index: 0,
+        message: {
+          content: null,
+          role: "assistant",
+          tool_calls: traceActions.map((action) => {
+            const name = action.kind === "tool-call" ? action.toolName : action.subagentName ?? action.name ?? "agent";
+            return {
+              function: {
+                arguments: JSON.stringify(action.input),
+                name
+              },
+              id: action.callId,
+              type: "function"
+            };
+          })
+        }
+      }
+    ];
+    step.span.log({ metadata: step.metadata, output: step.output });
+  }
+  async handleActionResult(event, ctx, hookMetadata) {
+    if (isToolResult(event.data.result)) {
+      await this.handleToolResult(event, ctx, event.data.result, hookMetadata);
+      return;
+    }
+    if (isSubagentResult(event.data.result)) {
+      await this.handleSubagentResult(
+        event,
+        ctx,
+        event.data.result,
+        hookMetadata
+      );
+    }
+  }
+  async handleToolResult(event, ctx, result, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const key = toolKey(sessionId, result.callId);
+    if (this.completedToolKeys.has(key)) {
+      return;
+    }
+    const tool = this.toolsByCallKey.get(key) ?? await this.startSyntheticTool(event, ctx, result, hookMetadata);
+    if (!tool) {
+      return;
+    }
+    const failed = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
+    tool.span.log({
+      ...failed ? {
+        error: actionResultError(event.data.error, result.output)
+      } : {},
+      metadata: tool.metadata,
+      output: result.output
+    });
+    const endTime = eventTime(event);
+    tool.span.end(endTime === void 0 ? void 0 : { endTime });
+    this.toolsByCallKey.delete(key);
+    this.completedToolKeys.set(key, true);
+  }
+  async handleSubagentCalled(event, ctx, hookMetadata) {
+    if (event.data.remote?.url) {
+      return;
+    }
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return;
+    }
+    const key = toolKey(sessionId, event.data.callId);
+    const metadata = toolMetadataFromTurn(turn);
+    const existing = this.toolsByCallKey.get(key);
+    if (existing) {
+      existing.metadata = { ...existing.metadata, ...metadata };
+      existing.span.log({ metadata: existing.metadata });
+      return;
+    }
+    if (this.completedToolKeys.has(key)) {
+      return;
+    }
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "subagent",
+      sessionId,
+      event.data.callId
+    );
+    const pending = this.toolsByCallKey.get(key);
+    if (pending || this.completedToolKeys.has(key)) {
+      if (pending) {
+        pending.metadata = { ...pending.metadata, ...metadata };
+        pending.span.log({ metadata: pending.metadata });
+      }
+      return;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: event.data.toolName ?? event.data.name,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ metadata });
+    this.toolsByCallKey.set(key, {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    });
+  }
+  async handleSubagentCompleted(event, ctx, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const key = toolKey(sessionId, event.data.callId);
+    if (this.completedToolKeys.has(key)) {
+      return;
+    }
+    const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagent(event, ctx, hookMetadata);
+    if (!subagent) {
+      return;
+    }
+    subagent.span.log({
+      ...event.data.status === "failed" ? {
+        error: actionResultError(event.data.error, event.data.output)
+      } : {},
+      metadata: subagent.metadata,
+      ...event.data.output !== void 0 ? { output: event.data.output } : {}
+    });
+    const endTime = eventTime(event);
+    const recordedEndTime = subagent.span.end(
+      endTime === void 0 ? void 0 : { endTime }
+    );
+    this.state.update((current) => {
+      const normalized = normalizeEveTraceState(current);
+      return {
+        ...normalized,
+        spanReferences: normalized.spanReferences.map(
+          (reference) => reference.spanId === subagent.span.spanId ? { ...reference, endTime: recordedEndTime } : reference
+        )
+      };
+    });
+  }
+  async handleSubagentResult(event, ctx, result, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const key = toolKey(sessionId, result.callId);
+    if (this.completedToolKeys.has(key)) {
+      return;
+    }
+    const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagentResult(
+      event,
+      ctx,
+      result,
+      hookMetadata
+    );
+    if (!subagent) {
+      return;
+    }
+    const isError = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
+    subagent.span.log({
+      ...isError ? {
+        error: actionResultError(event.data.error, result.output)
+      } : {},
+      metadata: subagent.metadata,
+      output: result.output
+    });
+    const endTime = eventTime(event);
+    subagent.span.end(endTime === void 0 ? void 0 : { endTime });
+    this.toolsByCallKey.delete(key);
+    this.completedToolKeys.set(key, true);
+  }
+  handleStepCompleted(event, ctx) {
+    const step = this.stepForEvent(event, ctx);
+    if (!step) {
+      return;
+    }
+    const usage = event.data.usage;
+    const inputTokens = typeof usage?.inputTokens === "number" && Number.isFinite(usage.inputTokens) && usage.inputTokens >= 0 ? usage.inputTokens : void 0;
+    const outputTokens = typeof usage?.outputTokens === "number" && Number.isFinite(usage.outputTokens) && usage.outputTokens >= 0 ? usage.outputTokens : void 0;
+    const cacheReadTokens = typeof usage?.cacheReadTokens === "number" && Number.isFinite(usage.cacheReadTokens) && usage.cacheReadTokens >= 0 ? usage.cacheReadTokens : void 0;
+    const cacheWriteTokens = typeof usage?.cacheWriteTokens === "number" && Number.isFinite(usage.cacheWriteTokens) && usage.cacheWriteTokens >= 0 ? usage.cacheWriteTokens : void 0;
+    const costUsd = typeof usage?.costUsd === "number" && Number.isFinite(usage.costUsd) && usage.costUsd >= 0 ? usage.costUsd : void 0;
+    const total = inputTokens !== void 0 && outputTokens !== void 0 ? inputTokens + outputTokens : void 0;
+    const metrics = {
+      ...inputTokens !== void 0 ? { prompt_tokens: inputTokens } : {},
+      ...outputTokens !== void 0 ? { completion_tokens: outputTokens } : {},
+      ...total !== void 0 ? { tokens: total } : {},
+      ...cacheReadTokens !== void 0 ? { prompt_cached_tokens: cacheReadTokens } : {},
+      ...cacheWriteTokens !== void 0 ? { prompt_cache_creation_tokens: cacheWriteTokens } : {},
+      ...costUsd !== void 0 ? { estimated_cost: costUsd } : {}
+    };
+    step.metrics = { ...step.metrics, ...metrics };
+    if (Array.isArray(step.output) && isObject(step.output[0])) {
+      const finishReason = step.output[0].finish_reason;
+      if (typeof finishReason !== "string") {
+        step.output[0].finish_reason = normalizedFinishReason(
+          event.data.finishReason
+        );
+      }
+    }
+    step.span.log({
+      ...step.input !== void 0 ? { input: step.input } : {},
+      metadata: step.metadata,
+      metrics,
+      output: step.output
+    });
+    const endTime = eventTime(event);
+    step.span.end(endTime === void 0 ? void 0 : { endTime });
+    const turn = this.turnForEvent(event, ctx);
+    if (turn) {
+      for (const [key, value] of Object.entries(metrics)) {
+        turn.metrics[key] = (turn.metrics[key] ?? 0) + value;
+      }
+      turn.stepsByIndex.delete(event.data.stepIndex);
+    }
+    this.markStepEnded(event.data.turnId, event.data.stepIndex);
+  }
+  handleStepFailed(event, ctx) {
+    const step = this.stepForEvent(event, ctx);
+    if (step) {
+      step.span.log({
+        error: errorFromMessage(
+          event.data.message,
+          event.data.code,
+          event.data.details
+        )
+      });
+      const endTime = eventTime(event);
+      step.span.end(endTime === void 0 ? void 0 : { endTime });
+    }
+    const turn = this.turnForEvent(event, ctx);
+    turn?.stepsByIndex.delete(event.data.stepIndex);
+    this.markStepEnded(event.data.turnId, event.data.stepIndex);
+  }
+  handleTurnCompleted(event, ctx) {
+    const turn = this.turnForEvent(event, ctx);
+    if (!turn) {
+      return;
+    }
+    this.finalizeTurn(turn, {
+      endTime: eventTime(event)
+    });
+  }
+  handleTurnFailed(event, ctx) {
+    const turn = this.turnForEvent(event, ctx);
+    if (!turn) {
+      return;
+    }
+    this.finalizeTurn(turn, {
+      endTime: eventTime(event),
+      error: errorFromMessage(
+        event.data.message,
+        event.data.code,
+        event.data.details
+      )
+    });
+  }
+  async handleSessionFailed(event, ctx) {
+    const sessionId = event.data.sessionId || sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const session = await this.ensureSession(
+      sessionId,
+      ctx,
+      {},
+      eventTime(event)
+    );
+    const error = errorFromMessage(
+      event.data.message,
+      event.data.code,
+      event.data.details
+    );
+    for (const [key, turn] of this.turnsByKey) {
+      if (!key.startsWith(`${sessionId}:`)) {
+        continue;
+      }
+      this.finalizeTurn(turn, {
+        endTime: eventTime(event),
+        error
+      });
+    }
+    for (const [key, tool] of this.toolsByCallKey) {
+      if (key.startsWith(`${sessionId}:`)) {
+        const endTime2 = eventTime(event);
+        if (!tool.endedByTurn) {
+          tool.span.log({ metadata: tool.metadata });
+          tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
+          tool.endedByTurn = true;
+        }
+      }
+    }
+    session.span.log({ error });
+    const endTime = eventTime(event);
+    session.span.end(endTime === void 0 ? void 0 : { endTime });
+  }
+  async handleSessionCompleted(event, ctx) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return;
+    }
+    const session = await this.ensureSession(
+      sessionId,
+      ctx,
+      {},
+      eventTime(event)
+    );
+    for (const [key, turn] of this.turnsByKey) {
+      if (!key.startsWith(`${sessionId}:`)) {
+        continue;
+      }
+      this.finalizeTurn(turn, {
+        endTime: eventTime(event)
+      });
+    }
+    for (const [key, tool] of this.toolsByCallKey) {
+      if (key.startsWith(`${sessionId}:`) && !tool.endedByTurn) {
+        const endTime2 = eventTime(event);
+        tool.span.log({ metadata: tool.metadata });
+        tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
+        tool.endedByTurn = true;
+      }
+    }
+    session.span.log({ metadata: session.metadata });
+    const endTime = eventTime(event);
+    session.span.end(endTime === void 0 ? void 0 : { endTime });
+  }
+  async ensureSession(sessionId, ctx, metadata, startTime) {
+    metadata = {
+      ...readEveTraceState(this.state).metadata,
+      ...metadata
+    };
+    const existing = this.sessionsById.get(sessionId);
+    if (existing) {
+      existing.metadata = { ...existing.metadata, ...metadata };
+      existing.span.log({ metadata: existing.metadata });
+      return existing;
+    }
+    const lineage = parentLineageFromContext(ctx);
+    const parentSubagent = lineage ? this.toolsByCallKey.get(toolKey(lineage.sessionId, lineage.callId)) : void 0;
+    const activeParent = currentSpan();
+    const [
+      { rowId: eventId, spanId },
+      parentSubagentSpanId,
+      fallbackRootSpanId
+    ] = await Promise.all([
+      generateEveIds("session", sessionId),
+      lineage ? spanIdForSubagent(lineage.sessionId, lineage.callId) : Promise.resolve(void 0),
+      lineage ? rootSpanIdForSession(lineage.rootSessionId) : rootSpanIdForSession(sessionId)
+    ]);
+    const span = await this.startEveSpan({
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: "eve.session",
+      parentSpanIds: lineage && parentSubagentSpanId ? {
+        rootSpanId: parentSubagent?.span.rootSpanId ?? fallbackRootSpanId,
+        spanId: parentSubagentSpanId
+      } : !Object.is(activeParent, NOOP_SPAN) ? {
+        rootSpanId: activeParent.rootSpanId,
+        spanId: activeParent.spanId
+      } : {
+        parentSpanIds: [],
+        rootSpanId: fallbackRootSpanId
+      },
+      spanAttributes: { type: "task" /* TASK */ },
+      spanId,
+      startTime
+    });
+    span.log({ metadata });
+    const session = { metadata, sessionId, span };
+    this.sessionsById.set(sessionId, session);
+    return session;
+  }
+  async ensureTurn(event, ctx, hookMetadata) {
+    const sessionId = sessionIdFromContext(ctx);
+    if (!sessionId) {
+      return void 0;
+    }
+    const session = await this.ensureSession(
+      sessionId,
+      ctx,
+      hookMetadata ?? {},
+      eventTime(event)
+    );
+    const key = turnKey(sessionId, event.data.turnId);
+    const existing = this.turnsByKey.get(key);
+    if (existing) {
+      return existing;
+    }
+    const metadata = { ...session.metadata };
+    const span = await this.startTurnSpan(session, event, metadata);
+    span.log({ metadata });
+    const state = {
+      key,
+      metadata,
+      metrics: {},
+      span,
+      stepsByIndex: /* @__PURE__ */ new Map(),
+      turnId: event.data.turnId
+    };
+    this.turnsByKey.set(key, state);
+    return state;
+  }
+  async startRequestedTool(event, turn, sessionId, action) {
+    const key = toolKey(sessionId, action.callId);
+    if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
+      return;
+    }
+    const metadata = toolMetadataFromTurn(turn);
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "tool",
+      sessionId,
+      event.data.turnId,
+      action.callId
+    );
+    if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
+      return;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        input: action.input,
+        metadata
+      },
+      name: action.toolName,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ input: action.input, metadata });
+    this.toolsByCallKey.set(key, {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    });
+  }
+  async startRequestedSubagent(event, turn, sessionId, action) {
+    const key = toolKey(sessionId, action.callId);
+    if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
+      return;
+    }
+    const name = action.subagentName ?? action.name ?? "agent";
+    const metadata = toolMetadataFromTurn(turn);
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "subagent",
+      sessionId,
+      action.callId
+    );
+    if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
+      return;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        input: action.input,
+        metadata
+      },
+      name,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ input: action.input, metadata });
+    this.toolsByCallKey.set(key, {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    });
+  }
+  async startSyntheticTool(event, ctx, result, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return void 0;
+    }
+    const metadata = toolMetadataFromTurn(turn);
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "tool",
+      sessionId,
+      event.data.turnId,
+      result.callId
+    );
+    const existing = this.toolsByCallKey.get(toolKey(sessionId, result.callId));
+    if (existing) {
+      return existing;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: result.toolName,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ metadata });
+    const state = {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    };
+    this.toolsByCallKey.set(toolKey(sessionId, result.callId), state);
+    return state;
+  }
+  async startSyntheticSubagent(event, ctx, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return void 0;
+    }
+    const metadata = toolMetadataFromTurn(turn);
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "subagent",
+      sessionId,
+      event.data.callId
+    );
+    const existing = this.toolsByCallKey.get(
+      toolKey(sessionId, event.data.callId)
+    );
+    if (existing) {
+      return existing;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: event.data.subagentName,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ metadata });
+    const state = {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    };
+    this.toolsByCallKey.set(toolKey(sessionId, event.data.callId), state);
+    return state;
+  }
+  async startSyntheticSubagentResult(event, ctx, result, hookMetadata) {
+    const turn = await this.ensureTurn(event, ctx, hookMetadata);
+    const sessionId = sessionIdFromContext(ctx);
+    if (!turn || !sessionId) {
+      return void 0;
+    }
+    const metadata = toolMetadataFromTurn(turn);
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "subagent",
+      sessionId,
+      result.callId
+    );
+    const existing = this.toolsByCallKey.get(toolKey(sessionId, result.callId));
+    if (existing) {
+      return existing;
+    }
+    const span = await this.startEveChildSpan(turn.span, {
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: result.subagentName,
+      spanAttributes: { type: "tool" /* TOOL */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+    span.log({ metadata });
+    const state = {
+      metadata,
+      span,
+      turnKey: turnKey(sessionId, event.data.turnId)
+    };
+    this.toolsByCallKey.set(toolKey(sessionId, result.callId), state);
+    return state;
+  }
+  async startTurnSpan(session, event, metadata) {
+    const { rowId: eventId, spanId } = await generateEveIds(
+      "turn",
+      session.sessionId,
+      event.data.turnId
+    );
+    return await this.startEveSpan({
+      event: {
+        id: eventId,
+        metadata
+      },
+      name: "eve.turn",
+      parentSpanIds: {
+        rootSpanId: session.span.rootSpanId,
+        spanId: session.span.spanId
+      },
+      spanAttributes: { type: "task" /* TASK */ },
+      spanId,
+      startTime: eventTime(event)
+    });
+  }
+  turnForEvent(event, ctx) {
+    const sessionId = sessionIdFromContext(ctx);
+    return sessionId ? this.turnsByKey.get(turnKey(sessionId, event.data.turnId)) : void 0;
+  }
+  stepForEvent(event, ctx) {
+    return this.turnForEvent(event, ctx)?.stepsByIndex.get(
+      event.data.stepIndex
+    );
+  }
+  finalizeTurn(turn, args) {
+    const { endTime } = args;
+    for (const step of turn.stepsByIndex.values()) {
+      step.span.log({
+        ...step.input !== void 0 ? { input: step.input } : {},
+        metadata: step.metadata,
+        metrics: step.metrics,
+        output: step.output
+      });
+      step.span.end(endTime === void 0 ? void 0 : { endTime });
+    }
+    turn.stepsByIndex.clear();
+    for (const tool of this.toolsByCallKey.values()) {
+      if (tool.turnKey !== turn.key) {
+        continue;
+      }
+      if (tool.endedByTurn) {
+        continue;
+      }
+      tool.span.log({ metadata: tool.metadata });
+      tool.span.end(endTime === void 0 ? void 0 : { endTime });
+      tool.endedByTurn = true;
+    }
+    if (args.error) {
+      turn.span.log({ error: args.error });
+    } else {
+      turn.span.log({
+        metadata: turn.metadata,
+        metrics: turn.metrics,
+        output: turn.output
+      });
+    }
+    turn.span.end(endTime === void 0 ? void 0 : { endTime });
+    this.turnsByKey.delete(turn.key);
+    this.state.update((current) => {
+      const normalized = normalizeEveTraceState(current);
+      return {
+        ...normalized,
+        stepStarts: normalized.stepStarts.filter(
+          (entry) => entry.turnId !== turn.turnId
+        )
+      };
+    });
+  }
+  cleanupSession(sessionId) {
+    const keyPrefix = `${sessionId}:`;
+    this.sessionsById.delete(sessionId);
+    for (const key of this.turnsByKey.keys()) {
+      if (key.startsWith(keyPrefix)) {
+        this.turnsByKey.delete(key);
+      }
+    }
+    for (const key of this.toolsByCallKey.keys()) {
+      if (key.startsWith(keyPrefix)) {
+        this.toolsByCallKey.delete(key);
+      }
+    }
+    for (const key of this.completedToolKeys.keys()) {
+      if (key.startsWith(keyPrefix)) {
+        this.completedToolKeys.delete(key);
+      }
+    }
+    this.state.update(() => emptyEveTraceState());
+  }
+  async flushInstrumentation() {
+    try {
+      await flush();
+      return true;
+    } catch (error) {
+      debugLogger.warn("Error in Eve flush instrumentation:", error);
+      return false;
+    }
+  }
+};
+function emptyEveTraceState() {
+  return {
+    llmInputs: [],
+    metadata: {},
+    spanReferences: [],
+    stepStarts: []
+  };
+}
+function normalizeEveTraceState(state) {
+  if (!isObject(state)) {
+    return emptyEveTraceState();
+  }
+  const metadata = isObject(state["metadata"]) ? state["metadata"] : {};
+  const spanReferences = Array.isArray(state["spanReferences"]) ? state["spanReferences"].flatMap((entry) => {
+    if (!isObject(entry)) {
+      return [];
+    }
+    const exported = entry["exported"];
+    const endTime = entry["endTime"];
+    const rootSpanId = entry["rootSpanId"];
+    const rowId = entry["rowId"];
+    const spanId = entry["spanId"];
+    const startEvent = entry["startEvent"];
+    const startEventCreated = isObject(startEvent) ? startEvent["created"] : void 0;
+    const startEventMetrics = isObject(startEvent) ? startEvent["metrics"] : void 0;
+    const startEventSpanAttributes = isObject(startEvent) ? startEvent["span_attributes"] : void 0;
+    const startEventSpanParents = isObject(startEvent) ? startEvent["span_parents"] : void 0;
+    const normalizedStartEvent = typeof startEventCreated === "string" && isObject(startEventMetrics) && typeof startEventMetrics["start"] === "number" && Number.isFinite(startEventMetrics["start"]) && isObject(startEventSpanAttributes) && Array.isArray(startEventSpanParents) && startEventSpanParents.every(
+      (parent) => typeof parent === "string"
+    ) ? {
+      created: startEventCreated,
+      metrics: { start: startEventMetrics["start"] },
+      span_attributes: { ...startEventSpanAttributes },
+      span_parents: [...startEventSpanParents]
+    } : void 0;
+    return typeof exported === "string" && typeof rootSpanId === "string" && typeof rowId === "string" && typeof spanId === "string" ? [
+      {
+        ...typeof endTime === "number" && Number.isFinite(endTime) ? { endTime } : {},
+        exported,
+        rootSpanId,
+        rowId,
+        spanId,
+        ...normalizedStartEvent ? { startEvent: normalizedStartEvent } : {}
+      }
+    ] : [];
+  }).slice(-MAX_STORED_SPAN_REFERENCES) : [];
+  const llmInputs = Array.isArray(state["llmInputs"]) ? state["llmInputs"].flatMap((entry) => {
+    if (!isObject(entry)) {
+      return [];
+    }
+    const key = entry["key"];
+    const input = entry["input"];
+    return typeof key === "string" && isCapturedModelInput(input) ? [{ input, key }] : [];
+  }).slice(-MAX_STORED_LLM_INPUTS) : [];
+  const stepStarts = Array.isArray(state["stepStarts"]) ? state["stepStarts"].flatMap((entry) => {
+    if (!isObject(entry)) {
+      return [];
+    }
+    const ordinal = entry["ordinal"];
+    const open = entry["open"];
+    const stepIndex = entry["stepIndex"];
+    const turnId = entry["turnId"];
+    return typeof ordinal === "number" && Number.isInteger(ordinal) && ordinal >= 0 && typeof open === "boolean" && typeof stepIndex === "number" && Number.isInteger(stepIndex) && typeof turnId === "string" ? [{ open, ordinal, stepIndex, turnId }] : [];
+  }).slice(-MAX_STORED_STEP_STARTS) : [];
+  return { llmInputs, metadata: { ...metadata }, spanReferences, stepStarts };
+}
+function readEveTraceState(state) {
+  try {
+    return normalizeEveTraceState(state.get());
+  } catch {
+    return emptyEveTraceState();
+  }
+}
+function captureEveModelInput(state, input) {
+  if (!isObject(input)) {
+    return;
+  }
+  const session = input["session"];
+  const turn = input["turn"];
+  const step = input["step"];
+  if (!isObject(session) || !isObject(turn) || !isObject(step)) {
+    return;
+  }
+  const sessionId = session["id"];
+  const turnId = turn["id"];
+  const stepIndex = step["index"];
+  if (typeof sessionId !== "string" || typeof turnId !== "string" || typeof stepIndex !== "number" || !Number.isInteger(stepIndex)) {
+    return;
+  }
+  const captured = capturedModelInput(input["modelInput"]);
+  if (!captured) {
+    return;
+  }
+  const key = llmInputKey(sessionId, turnId, stepIndex);
+  state.update((current) => {
+    const normalized = normalizeEveTraceState(current);
+    const llmInputs = [...normalized.llmInputs, { input: captured, key }];
+    return {
+      ...normalized,
+      llmInputs: llmInputs.slice(-MAX_STORED_LLM_INPUTS)
+    };
+  });
+}
+function consumeCapturedEveModelInput(state, sessionId, turnId, stepIndex) {
+  try {
+    const key = llmInputKey(sessionId, turnId, stepIndex);
+    let input;
+    state.update((current) => {
+      const normalized = normalizeEveTraceState(current);
+      const index = normalized.llmInputs.findIndex(
+        (candidate) => candidate.key === key
+      );
+      if (index < 0) {
+        return normalized;
+      }
+      input = normalized.llmInputs[index]?.input;
+      return {
+        ...normalized,
+        llmInputs: normalized.llmInputs.filter(
+          (_, candidateIndex) => candidateIndex !== index
+        )
+      };
+    });
+    return input;
+  } catch (error) {
+    debugLogger.warn("Error in Eve LLM input consumption:", error);
+    return void 0;
+  }
+}
+function capturedModelInput(modelInput) {
+  if (!isObject(modelInput)) {
+    return void 0;
+  }
+  const messages = modelInput["messages"];
+  if (!Array.isArray(messages)) {
+    return void 0;
+  }
+  const instructions = modelInput["instructions"];
+  const value = [
+    ...instructions !== void 0 ? [{ content: instructions, role: "system" }] : [],
+    ...messages
+  ];
+  try {
+    const cloned = JSON.parse(JSON.stringify(value));
+    if (!Array.isArray(cloned)) {
+      return void 0;
+    }
+    return cloned;
+  } catch {
+    return void 0;
+  }
+}
+function isCapturedModelInput(input) {
+  return Array.isArray(input);
+}
+function llmInputKey(sessionId, turnId, stepIndex) {
+  return `${sessionId}\0${turnId}\0${stepIndex}`;
+}
+function modelMetadataFromRuntime(runtime) {
+  if (!isObject(runtime)) {
+    return {};
+  }
+  const modelId = runtime["modelId"];
+  return typeof modelId === "string" ? modelMetadataFromModelId(modelId) : {};
+}
+function modelMetadataFromModelId(modelId) {
+  const normalized = modelId.trim();
+  if (!normalized) {
+    return {};
+  }
+  const slashIndex = normalized.indexOf("/");
+  if (slashIndex > 0 && slashIndex < normalized.length - 1) {
+    return {
+      model: normalized.slice(slashIndex + 1),
+      provider: normalized.slice(0, slashIndex)
+    };
+  }
+  return {
+    model: normalized
+  };
+}
+function sessionIdFromContext(ctx) {
+  if (!isObject(ctx)) {
+    return void 0;
+  }
+  const session = ctx["session"];
+  if (!isObject(session)) {
+    return void 0;
+  }
+  const id = session["id"];
+  return typeof id === "string" ? id : void 0;
+}
+function toolMetadataFromTurn(turn) {
+  const { model: _model, provider: _provider, ...metadata } = turn.metadata;
+  return metadata;
+}
+function parentLineageFromContext(ctx) {
+  if (!isObject(ctx)) {
+    return void 0;
+  }
+  const session = ctx.session;
+  if (!isObject(session)) {
+    return void 0;
+  }
+  const parent = session["parent"];
+  if (!isObject(parent)) {
+    return void 0;
+  }
+  const callId = parent["callId"];
+  const rootSessionId = parent["rootSessionId"];
+  const sessionId = parent["sessionId"];
+  if (typeof callId !== "string" || typeof rootSessionId !== "string" || typeof sessionId !== "string") {
+    return void 0;
+  }
+  return { callId, rootSessionId, sessionId };
+}
+function isToolCallAction(action) {
+  return isObject(action) && action["kind"] === "tool-call" && typeof action["callId"] === "string" && typeof action["toolName"] === "string" && isObject(action["input"]);
+}
+function isLocalSubagentCallAction(action) {
+  return isObject(action) && action["kind"] === "subagent-call" && typeof action["callId"] === "string" && isObject(action["input"]);
+}
+function isTraceableActionRequest(action) {
+  return isToolCallAction(action) || isLocalSubagentCallAction(action);
+}
+function isToolResult(result) {
+  return isObject(result) && result["kind"] === "tool-result" && typeof result["callId"] === "string" && typeof result["toolName"] === "string";
+}
+function isSubagentResult(result) {
+  return isObject(result) && result["kind"] === "subagent-result" && typeof result["callId"] === "string" && typeof result["subagentName"] === "string";
+}
+function normalizedFinishReason(finishReason) {
+  switch (finishReason) {
+    case "content-filter":
+      return "content_filter";
+    case "tool-calls":
+      return "tool_calls";
+    default:
+      return finishReason;
+  }
+}
+function errorFromMessage(message, code, details) {
+  const error = new Error(`${code}: ${message}`);
+  if (details !== void 0) {
+    error.cause = details;
+  }
+  return error;
+}
+function actionResultError(error, output) {
+  if (error) {
+    return errorFromMessage(error.message, error.code);
+  }
+  const result = new Error("Eve action failed");
+  if (output !== void 0) {
+    result.cause = output;
+  }
+  return result;
+}
+function eventTime(event) {
+  if (!event.meta?.at) {
+    return void 0;
+  }
+  const timestamp = Date.parse(event.meta.at);
+  return Number.isFinite(timestamp) ? timestamp / 1e3 : void 0;
+}
+function turnKey(sessionId, turnId) {
+  return `${sessionId}:${turnId}`;
+}
+function toolKey(sessionId, callId) {
+  return `${sessionId}:${callId}`;
+}
+async function rootSpanIdForSession(sessionId) {
+  return deterministicEveId("eve:root", sessionId);
+}
+async function generateEveIds(kind, ...parts) {
+  const [rowId, spanId] = await Promise.all([
+    deterministicEveId(`eve:row:${kind}`, ...parts),
+    deterministicEveId(`eve:${kind}`, ...parts)
+  ]);
+  return { rowId, spanId };
+}
+async function spanIdForSubagent(sessionId, callId) {
+  return deterministicEveId("eve:subagent", sessionId, callId);
+}
+async function deterministicEveId(...parts) {
+  const data = new TextEncoder().encode(
+    parts.map((part) => `${part.length}:${part}`).join("\0")
+  );
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", data);
+  const bytes = Array.from(new Uint8Array(digest, 0, 16));
+  const hex = bytes.map((byte) => byte.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
 // src/typed-instrumentation-helpers.ts
 var TypedApplyProxy = Proxy;
 
@@ -5599,15 +7106,21 @@ var waterfall$1 = awaitify(waterfall);
 
 // src/trace.ts
 var SpanFetcher = class _SpanFetcher extends ObjectFetcher {
-  constructor(objectType, _objectId, rootSpanId, _state, spanTypeFilter, includeScorers = false) {
+  constructor(objectType, _objectId, rootSpanId, _state, spanTypeFilter, includeScorers = false, brainstoreRealtime = true) {
     const filterExpr = _SpanFetcher.buildFilter(
       rootSpanId,
       spanTypeFilter,
       includeScorers
     );
-    super(objectType, void 0, void 0, {
-      filter: filterExpr
-    });
+    super(
+      objectType,
+      void 0,
+      void 0,
+      {
+        filter: filterExpr
+      },
+      brainstoreRealtime
+    );
     this._objectId = _objectId;
     this.rootSpanId = rootSpanId;
     this._state = _state;
@@ -5661,7 +7174,7 @@ var CachedSpanFetcher = class {
   spanCache = /* @__PURE__ */ new Map();
   allFetched = false;
   fetchFn;
-  constructor(objectTypeOrFetchFn, objectId, rootSpanId, getState) {
+  constructor(objectTypeOrFetchFn, objectId, rootSpanId, getState, brainstoreRealtime = true) {
     if (typeof objectTypeOrFetchFn === "function") {
       this.fetchFn = (spanType) => objectTypeOrFetchFn(spanType);
     } else {
@@ -5674,7 +7187,8 @@ var CachedSpanFetcher = class {
           rootSpanId,
           state,
           spanType,
-          includeScorers
+          includeScorers,
+          brainstoreRealtime
         );
         const rows = await fetcher.fetchedData();
         return rows.map((row) => ({
@@ -6504,7 +8018,7 @@ async function runEvaluatorInternal(experiment, evaluator, progressReporter, fil
             }
           };
           const parentStr = state.currentParent.getStore();
-          const parentComponents = parentStr ? SpanComponentsV3.fromStr(parentStr) : null;
+          const parentComponents = typeof parentStr === "string" ? SpanComponentsV4.fromStr(parentStr) : null;
           const trace = state ? new LocalTrace({
             objectType: parentComponents ? spanObjectTypeV3ToTypedString(
               parentComponents.data.object_type
@@ -7030,6 +8544,350 @@ var defaultReporter = {
   }
 };
 
+// src/agent-assertions.ts
+function agentAssertionScorer(callback, options = {}) {
+  return async (args) => {
+    const { trace: _trace, ...callbackArgs } = args;
+    const callbackMetadata = callbackArgs.metadata ?? {};
+    const assertions = await callback({
+      ...callbackArgs,
+      metadata: callbackMetadata,
+      assert: agentAssertionHelpers
+    });
+    const resources = {};
+    if (assertions.some((assertion) => assertion.requiresTrace)) {
+      resources.spans = await args.trace?.getSpans({ spanType: ["tool"] });
+    }
+    const results = await Promise.all(
+      assertions.map(async (assertion) => {
+        const result = await assertion.evaluate(resources);
+        return {
+          name: assertion.name,
+          passed: result.passed,
+          failure: result.failure
+        };
+      })
+    );
+    const passed = results.filter((result) => result.passed).length;
+    const total = results.length;
+    const failed = results.filter((result) => !result.passed).map(
+      (result) => `${result.name}: ${result.failure ?? "assertion did not pass"}`
+    );
+    return {
+      name: options.name ?? "assertions",
+      score: total === 0 ? 1 : passed / total,
+      metadata: {
+        assertions: results.map(({ name, passed: passed2 }) => ({ name, passed: passed2 })),
+        failed
+      }
+    };
+  };
+}
+var agentAssertionHelpers = {
+  equals: (actual, expected, name = "equals") => ({
+    name,
+    evaluate: () => {
+      const passed = deepEqual(actual, expected);
+      return {
+        passed,
+        failure: passed ? void 0 : `expected ${formatValue(actual)} to equal ${formatValue(expected)}`
+      };
+    }
+  }),
+  notEquals: (actual, expected, name = "not equals") => ({
+    name,
+    evaluate: () => {
+      const passed = !deepEqual(actual, expected);
+      return {
+        passed,
+        failure: passed ? void 0 : `expected ${formatValue(actual)} not to equal ${formatValue(expected)}`
+      };
+    }
+  }),
+  contains: (value, expected, name = "contains") => ({
+    name,
+    evaluate: () => {
+      const searchedValue = typeof value === "string" ? value : formatValue(value);
+      const passed = expected instanceof RegExp ? testRegex(expected, value) : searchedValue.includes(expected);
+      return {
+        passed,
+        failure: passed ? void 0 : `expected ${formatValue(value)} to contain ${formatValue(expected)}`
+      };
+    }
+  }),
+  matches: (value, schema, name = "matches schema") => ({
+    name,
+    evaluate: async () => {
+      const result = await validateSchema(schema, value);
+      return {
+        passed: result.passed,
+        failure: result.passed ? void 0 : `expected value to match schema: ${result.message}`
+      };
+    }
+  }),
+  calledTool: (toolName, options = {}, name = `called tool ${toolName}`) => ({
+    name,
+    requiresTrace: true,
+    evaluate: ({ spans }) => {
+      const calls = matchingToolCalls(spans ?? [], toolName, options);
+      const passed = options.times === void 0 ? calls.length > 0 : calls.length === options.times;
+      return {
+        passed,
+        failure: passed ? void 0 : options.times === void 0 ? `expected tool "${toolName}" to be called; found ${calls.length} matching call${calls.length === 1 ? "" : "s"}` : `expected tool "${toolName}" to be called ${options.times} time${options.times === 1 ? "" : "s"}; found ${calls.length} matching call${calls.length === 1 ? "" : "s"}`
+      };
+    }
+  }),
+  notCalledTool: (toolName, name = `did not call tool ${toolName}`) => ({
+    name,
+    requiresTrace: true,
+    evaluate: ({ spans }) => {
+      const calls = toolCalls(spans ?? []).filter(
+        (span) => getToolName(span) === toolName
+      );
+      const passed = calls.length === 0;
+      return {
+        passed,
+        failure: passed ? void 0 : `expected tool "${toolName}" not to be called; found ${calls.length} call${calls.length === 1 ? "" : "s"}`
+      };
+    }
+  }),
+  toolOrder: (toolNames, name = "tool order") => ({
+    name,
+    requiresTrace: true,
+    evaluate: ({ spans }) => {
+      const observed = toolCalls(spans ?? []).map(getToolName).filter((toolName) => toolName !== void 0);
+      let fromIndex = 0;
+      const passed = toolNames.every((toolName) => {
+        const index = observed.indexOf(toolName, fromIndex);
+        if (index === -1) return false;
+        fromIndex = index + 1;
+        return true;
+      });
+      return {
+        passed,
+        failure: passed ? void 0 : `expected tool order ${toolNames.join(" -> ")}; observed ${observed.join(" -> ") || "no tools"}`
+      };
+    }
+  }),
+  usedNoTools: (name = "used no tools") => ({
+    name,
+    requiresTrace: true,
+    evaluate: ({ spans }) => {
+      const calls = toolCalls(spans ?? []);
+      const passed = calls.length === 0;
+      return {
+        passed,
+        failure: passed ? void 0 : `expected no tool calls; found ${calls.length}`
+      };
+    }
+  }),
+  maxToolCalls: (max, name = `at most ${max} tool calls`) => ({
+    name,
+    requiresTrace: true,
+    evaluate: ({ spans }) => {
+      const calls = toolCalls(spans ?? []);
+      const passed = calls.length <= max;
+      return {
+        passed,
+        failure: passed ? void 0 : `expected at most ${max} tool call${max === 1 ? "" : "s"}; found ${calls.length}`
+      };
+    }
+  })
+};
+async function validateSchema(schema, value) {
+  try {
+    if ("safeParse" in schema) {
+      const result2 = schema.safeParse(value);
+      return result2.success ? { passed: true, message: "" } : { passed: false, message: formatSchemaError(result2.error) };
+    }
+    if ("parse" in schema) {
+      schema.parse(value);
+      return { passed: true, message: "" };
+    }
+    const result = await schema["~standard"].validate(value);
+    if (typeof result === "object" && result !== null && "issues" in result && Array.isArray(result.issues) && result.issues.length > 0) {
+      return { passed: false, message: formatValue(result.issues) };
+    }
+    return { passed: true, message: "" };
+  } catch (e) {
+    return { passed: false, message: formatSchemaError(e) };
+  }
+}
+function toolCalls(spans) {
+  return spans.filter((span) => span.span_attributes?.type === "tool");
+}
+function matchingToolCalls(spans, toolName, options) {
+  return toolCalls(spans).filter((span) => {
+    if (getToolName(span) !== toolName) return false;
+    if (Object.prototype.hasOwnProperty.call(options, "input") && !matchesValue(span.input, options.input)) {
+      return false;
+    }
+    if (Object.prototype.hasOwnProperty.call(options, "output") && !matchesValue(span.output, options.output)) {
+      return false;
+    }
+    if (options.isError !== void 0 && Boolean(span.error) !== options.isError) {
+      return false;
+    }
+    return true;
+  });
+}
+function getToolName(span) {
+  const spanName = [span.span_attributes?.name, span.name].map(normalizeToolName).find((value) => value !== void 0);
+  if (spanName?.includes("/")) {
+    return spanName;
+  }
+  const metadataName = [
+    span.metadata?.tool_name,
+    span.metadata?.["gen_ai.tool.name"]
+  ].map(normalizeToolName).find((value) => value !== void 0);
+  const mcpServer = [
+    span.metadata?.["mcp.server"],
+    span.metadata?.["openai_codex.mcp.server"]
+  ].find((value) => typeof value === "string" && value !== "");
+  if (metadataName && mcpServer) {
+    return `${mcpServer}/${metadataName}`;
+  }
+  return metadataName ?? spanName;
+}
+function normalizeToolName(value) {
+  if (typeof value !== "string" || value === "") {
+    return void 0;
+  }
+  return value.startsWith("tool:") ? value.slice("tool:".length).trim() : value;
+}
+function matchesValue(actual, matcher) {
+  if (matcher instanceof RegExp) {
+    return testRegex(matcher, actual);
+  }
+  if (typeof matcher === "function") {
+    return matcher(actual);
+  }
+  if (Array.isArray(matcher)) {
+    return Array.isArray(actual) && actual.length === matcher.length && matcher.every((value, index) => matchesValue(actual[index], value));
+  }
+  if (isPlainObject(matcher) && isPlainObject(actual)) {
+    return Object.entries(matcher).every(
+      ([key, value]) => Object.prototype.hasOwnProperty.call(actual, key) && matchesValue(actual[key], value)
+    );
+  }
+  return deepEqual(actual, matcher);
+}
+function testRegex(matcher, value) {
+  matcher.lastIndex = 0;
+  return matcher.test(typeof value === "string" ? value : formatValue(value));
+}
+function deepEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  if (Array.isArray(left) && Array.isArray(right)) {
+    return left.length === right.length && left.every((item, index) => deepEqual(item, right[index]));
+  }
+  if (isPlainObject(left) && isPlainObject(right)) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    return leftKeys.length === rightKeys.length && leftKeys.every(
+      (key) => Object.prototype.hasOwnProperty.call(right, key) && deepEqual(left[key], right[key])
+    );
+  }
+  return false;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+function formatSchemaError(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return formatValue(error);
+}
+function formatValue(value) {
+  if (value instanceof RegExp) {
+    return value.toString();
+  }
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  try {
+    const serialized = JSON.stringify(value);
+    if (serialized !== void 0 && !hasUndefinedJsonValue(value)) {
+      return serialized;
+    }
+    return formatValueWithUndefined(value, /* @__PURE__ */ new Set());
+  } catch {
+    return String(value);
+  }
+}
+function hasUndefinedJsonValue(value, seen = /* @__PURE__ */ new Set()) {
+  if (value === void 0) {
+    return true;
+  }
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  if (seen.has(value)) {
+    return false;
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return Array.from({ length: value.length }).some(
+      (_, index) => hasUndefinedJsonValue(value[index], seen)
+    );
+  }
+  return Object.keys(value).some(
+    (key) => hasUndefinedJsonValue(value[key], seen)
+  );
+}
+function formatValueWithUndefined(value, seen) {
+  if (value === void 0) {
+    return "undefined";
+  }
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return JSON.stringify(value);
+  }
+  if (typeof value === "bigint" || typeof value === "function") {
+    return String(value);
+  }
+  if (typeof value === "symbol") {
+    return String(value);
+  }
+  if (value instanceof RegExp) {
+    return value.toString();
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  if (seen.has(value)) {
+    return '"[Circular]"';
+  }
+  seen.add(value);
+  if (typeof value.toJSON === "function") {
+    const jsonValue = value.toJSON();
+    seen.delete(value);
+    return formatValueWithUndefined(jsonValue, seen);
+  }
+  if (Array.isArray(value)) {
+    const formatted2 = Array.from(
+      { length: value.length },
+      (_, index) => formatValueWithUndefined(value[index], seen)
+    );
+    seen.delete(value);
+    return `[${formatted2.join(",")}]`;
+  }
+  const formatted = Object.keys(value).map(
+    (key) => `${JSON.stringify(key)}:${formatValueWithUndefined(
+      value[key],
+      seen
+    )}`
+  );
+  seen.delete(value);
+  return `{${formatted.join(",")}}`;
+}
+
 // src/dataset-pipeline.ts
 function DatasetPipeline(definition) {
   if (!globalThis.__braintrust_dataset_pipelines) {
@@ -7606,8 +9464,10 @@ configureNode();
 export {
   Attachment,
   AttachmentReference,
+  BAGGAGE_HEADER,
   BRAINTRUST_CURRENT_SPAN_STORE,
   BRAINTRUST_LANGCHAIN_CALLBACK_HANDLER_NAME,
+  BRAINTRUST_PARENT_KEY,
   BaseAttachment,
   BaseExperiment,
   BraintrustLangChainCallbackHandler,
@@ -7640,6 +9500,7 @@ export {
   NOOP_SPAN,
   NOOP_SPAN_PERMALINK,
   NoopSpan,
+  OTELIDGenerator,
   ObjectFetcher,
   Project2 as Project,
   ProjectNameIdMap,
@@ -7651,6 +9512,8 @@ export {
   ScorerBuilder,
   SpanFetcher,
   SpanImpl,
+  TRACEPARENT_HEADER,
+  TRACESTATE_HEADER,
   TestBackgroundLogger,
   ToolBuilder,
   UUIDGenerator,
@@ -7660,7 +9523,10 @@ export {
   isomorph_default as _internalIso,
   _internalSetInitialState,
   addAzureBlobHeaders,
+  agentAssertionScorer,
   braintrustAISDKTelemetry,
+  braintrustEveHook,
+  braintrustEveInstrumentation,
   braintrustFlueInstrumentation,
   braintrustFlueObserver,
   braintrustStreamChunkSchema,
@@ -7678,6 +9544,7 @@ export {
   devNullWritableStream,
   evaluatorDefinitionSchema,
   evaluatorDefinitionsSchema,
+  extractTraceContextFromHeaders,
   flush,
   getContextManager,
   getIdGenerator,
@@ -7691,6 +9558,7 @@ export {
   initFunction,
   initLogger,
   initNodeTestSuite,
+  injectTraceContext,
   invoke,
   isTemplateFormat,
   loadParameters,