braintrust 3.21.0 → 3.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/browser.mjs CHANGED
@@ -2194,19 +2194,30 @@ var CallEvent = z6.union([
2194
2194
  var ChatCompletionContentPartTextWithTitle = z6.object({
2195
2195
  text: z6.string().default(""),
2196
2196
  type: z6.literal("text"),
2197
- cache_control: z6.object({ type: z6.literal("ephemeral") }).optional()
2197
+ cache_control: z6.object({
2198
+ type: z6.literal("ephemeral"),
2199
+ ttl: z6.enum(["5m", "1h"]).optional()
2200
+ }).optional()
2198
2201
  });
2199
2202
  var ChatCompletionContentPartImageWithTitle = z6.object({
2200
2203
  image_url: z6.object({
2201
2204
  url: z6.string(),
2202
2205
  detail: z6.union([z6.literal("auto"), z6.literal("low"), z6.literal("high")]).optional()
2203
2206
  }),
2204
- type: z6.literal("image_url")
2207
+ type: z6.literal("image_url"),
2208
+ cache_control: z6.object({
2209
+ type: z6.literal("ephemeral"),
2210
+ ttl: z6.enum(["5m", "1h"]).optional()
2211
+ }).optional()
2205
2212
  });
2206
2213
  var ChatCompletionContentPartFileFile = z6.object({ file_data: z6.string(), filename: z6.string(), file_id: z6.string() }).partial();
2207
2214
  var ChatCompletionContentPartFileWithTitle = z6.object({
2208
2215
  file: ChatCompletionContentPartFileFile,
2209
- type: z6.literal("file")
2216
+ type: z6.literal("file"),
2217
+ cache_control: z6.object({
2218
+ type: z6.literal("ephemeral"),
2219
+ ttl: z6.enum(["5m", "1h"]).optional()
2220
+ }).optional()
2210
2221
  });
2211
2222
  var ChatCompletionContentPart = z6.union([
2212
2223
  ChatCompletionContentPartTextWithTitle,
@@ -2216,7 +2227,10 @@ var ChatCompletionContentPart = z6.union([
2216
2227
  var ChatCompletionContentPartText = z6.object({
2217
2228
  text: z6.string().default(""),
2218
2229
  type: z6.literal("text"),
2219
- cache_control: z6.object({ type: z6.literal("ephemeral") }).optional()
2230
+ cache_control: z6.object({
2231
+ type: z6.literal("ephemeral"),
2232
+ ttl: z6.enum(["5m", "1h"]).optional()
2233
+ }).optional()
2220
2234
  });
2221
2235
  var ChatCompletionMessageToolCall = z6.object({
2222
2236
  id: z6.string(),
@@ -4269,13 +4283,23 @@ var LRUCache = class {
4269
4283
  * @returns The cached value if found, undefined otherwise.
4270
4284
  */
4271
4285
  get(key) {
4272
- const value = this.cache.get(key);
4273
- if (value === void 0) {
4286
+ const entry = this.cache.get(key);
4287
+ if (entry === void 0) {
4274
4288
  return void 0;
4275
4289
  }
4276
4290
  this.cache.delete(key);
4277
- this.cache.set(key, value);
4278
- return value;
4291
+ this.cache.set(key, entry);
4292
+ return entry.value;
4293
+ }
4294
+ /**
4295
+ * Checks whether a key exists and marks it as most recently used.
4296
+ */
4297
+ has(key) {
4298
+ if (!this.cache.has(key)) {
4299
+ return false;
4300
+ }
4301
+ this.get(key);
4302
+ return true;
4279
4303
  }
4280
4304
  /**
4281
4305
  * Stores a value in the cache.
@@ -4292,7 +4316,38 @@ var LRUCache = class {
4292
4316
  const first = this.cache.keys().next().value;
4293
4317
  this.cache.delete(first);
4294
4318
  }
4295
- this.cache.set(key, value);
4319
+ this.cache.set(key, { value });
4320
+ }
4321
+ /**
4322
+ * Removes an item from the cache.
4323
+ */
4324
+ delete(key) {
4325
+ return this.cache.delete(key);
4326
+ }
4327
+ /**
4328
+ * Iterates over cache entries from least to most recently used.
4329
+ */
4330
+ *entries() {
4331
+ for (const [key, entry] of this.cache) {
4332
+ yield [key, entry.value];
4333
+ }
4334
+ }
4335
+ /**
4336
+ * Iterates over cache keys from least to most recently used.
4337
+ */
4338
+ keys() {
4339
+ return this.cache.keys();
4340
+ }
4341
+ /**
4342
+ * Iterates over cache values from least to most recently used.
4343
+ */
4344
+ *values() {
4345
+ for (const entry of this.cache.values()) {
4346
+ yield entry.value;
4347
+ }
4348
+ }
4349
+ [Symbol.iterator]() {
4350
+ return this.entries();
4296
4351
  }
4297
4352
  /**
4298
4353
  * Removes all items from the cache.
@@ -4850,6 +4905,9 @@ function applyMaskingToField(maskingFunction, data, fieldName) {
4850
4905
  return `ERROR: Failed to mask field '${fieldName}' - ${errorType}`;
4851
4906
  }
4852
4907
  }
4908
+ var INITIAL_SPAN_WRITE_AS_MERGE = /* @__PURE__ */ Symbol(
4909
+ "braintrust.initial-span-write-as-merge"
4910
+ );
4853
4911
  var BRAINTRUST_CURRENT_SPAN_STORE = /* @__PURE__ */ Symbol.for(
4854
4912
  "braintrust.currentSpanStore"
4855
4913
  );
@@ -8500,6 +8558,12 @@ var traceable = wrapTraced;
8500
8558
  function startSpan(args) {
8501
8559
  return startSpanAndIsLogger(args).span;
8502
8560
  }
8561
+ function _internalStartSpanWithInitialMerge(args) {
8562
+ return startSpanAndIsLogger({
8563
+ ...args,
8564
+ [INITIAL_SPAN_WRITE_AS_MERGE]: true
8565
+ }).span;
8566
+ }
8503
8567
  async function flush(options) {
8504
8568
  const state = options?.state ?? _globalState;
8505
8569
  return await state.bgLogger().flush();
@@ -9410,7 +9474,7 @@ var SpanImpl = class _SpanImpl {
9410
9474
  this._spanId = resolvedIds.spanId;
9411
9475
  this._rootSpanId = resolvedIds.rootSpanId;
9412
9476
  this._spanParents = resolvedIds.spanParents;
9413
- this.isMerge = false;
9477
+ this.isMerge = args[INITIAL_SPAN_WRITE_AS_MERGE] === true;
9414
9478
  this.logInternal({ event, internalData });
9415
9479
  this.isMerge = true;
9416
9480
  }
@@ -31354,6 +31418,8 @@ __export(exports_exports, {
31354
31418
  addAzureBlobHeaders: () => addAzureBlobHeaders,
31355
31419
  agentAssertionScorer: () => agentAssertionScorer,
31356
31420
  braintrustAISDKTelemetry: () => braintrustAISDKTelemetry,
31421
+ braintrustEveHook: () => braintrustEveHook,
31422
+ braintrustEveInstrumentation: () => braintrustEveInstrumentation,
31357
31423
  braintrustFlueInstrumentation: () => braintrustFlueInstrumentation,
31358
31424
  braintrustFlueObserver: () => braintrustFlueObserver,
31359
31425
  braintrustStreamChunkSchema: () => braintrustStreamChunkSchema,
@@ -32854,6 +32920,1469 @@ function BraintrustMiddleware(config = {}) {
32854
32920
  };
32855
32921
  }
32856
32922
 
32923
+ // src/instrumentation/plugins/eve-plugin.ts
32924
+ var EVE_TRACE_STATE_KEY = "braintrust.eve.tracing";
32925
+ var MAX_EVE_CACHE_ENTRIES = 1e4;
32926
+ var MAX_STORED_LLM_INPUTS = 100;
32927
+ var MAX_STORED_SPAN_REFERENCES = 1e4;
32928
+ var MAX_STORED_STEP_STARTS = 1e4;
32929
+ function braintrustEveHook(options) {
32930
+ const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
32931
+ const bridge = new EveBridge(state);
32932
+ return {
32933
+ events: {
32934
+ "*": async (event, ctx) => {
32935
+ await bridge.handle(event, ctx, options.metadata);
32936
+ }
32937
+ }
32938
+ };
32939
+ }
32940
+ function braintrustEveInstrumentation(options) {
32941
+ const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
32942
+ return {
32943
+ events: {
32944
+ "step.started": (input) => {
32945
+ try {
32946
+ captureEveModelInput(state, input);
32947
+ } catch (error) {
32948
+ debugLogger.warn("Error in Eve LLM input capture:", error);
32949
+ }
32950
+ }
32951
+ },
32952
+ recordInputs: false,
32953
+ recordOutputs: false,
32954
+ setup: options.setup
32955
+ };
32956
+ }
32957
+ function isEveHandleMessageStreamEvent(event) {
32958
+ return isObject(event) && typeof event["type"] === "string";
32959
+ }
32960
+ var ResumedEveSpan = class {
32961
+ constructor(reference) {
32962
+ this.reference = reference;
32963
+ this.endTime = reference.endTime;
32964
+ }
32965
+ endTime;
32966
+ get rootSpanId() {
32967
+ return this.reference.rootSpanId;
32968
+ }
32969
+ get spanId() {
32970
+ return this.reference.spanId;
32971
+ }
32972
+ log(event) {
32973
+ const metrics = {
32974
+ ...this.reference.startEvent?.metrics,
32975
+ ...this.endTime === void 0 ? {} : { end: this.endTime },
32976
+ ...event.metrics
32977
+ };
32978
+ updateSpan({
32979
+ exported: this.reference.exported,
32980
+ ...this.reference.startEvent,
32981
+ ...event,
32982
+ ...Object.keys(metrics).length > 0 ? { metrics } : {}
32983
+ });
32984
+ }
32985
+ end(args) {
32986
+ if (this.endTime === void 0) {
32987
+ this.endTime = args?.endTime ?? getCurrentUnixTimestamp();
32988
+ this.log({ metrics: { end: this.endTime } });
32989
+ }
32990
+ return this.endTime;
32991
+ }
32992
+ };
32993
+ var EveBridge = class {
32994
+ constructor(state) {
32995
+ this.state = state;
32996
+ }
32997
+ eventQueuesBySession = /* @__PURE__ */ new Map();
32998
+ sessionsById = new LRUCache({
32999
+ max: MAX_EVE_CACHE_ENTRIES
33000
+ });
33001
+ completedToolKeys = new LRUCache({
33002
+ max: MAX_EVE_CACHE_ENTRIES
33003
+ });
33004
+ toolsByCallKey = new LRUCache({
33005
+ max: MAX_EVE_CACHE_ENTRIES
33006
+ });
33007
+ turnsByKey = new LRUCache({
33008
+ max: MAX_EVE_CACHE_ENTRIES
33009
+ });
33010
+ async startEveSpan(args) {
33011
+ const rowId = args?.event?.id;
33012
+ const reference = typeof rowId === "string" && readEveTraceState(this.state).spanReferences.find(
33013
+ (candidate) => candidate.rowId === rowId
33014
+ );
33015
+ if (reference) {
33016
+ return new ResumedEveSpan(reference);
33017
+ }
33018
+ const startTime = args?.startTime ?? getCurrentUnixTimestamp();
33019
+ const parentSpanIds = args?.parentSpanIds;
33020
+ const startEvent = {
33021
+ created: (/* @__PURE__ */ new Date()).toISOString(),
33022
+ metrics: { start: startTime },
33023
+ span_attributes: {
33024
+ ...args?.name ? { name: args.name } : {},
33025
+ ...args?.type ? { type: args.type } : {},
33026
+ ...args?.spanAttributes
33027
+ },
33028
+ span_parents: parentSpanIds ? "spanId" in parentSpanIds ? [parentSpanIds.spanId] : parentSpanIds.parentSpanIds : []
33029
+ };
33030
+ const span = withCurrent(
33031
+ NOOP_SPAN,
33032
+ () => _internalStartSpanWithInitialMerge({ ...args, startTime })
33033
+ );
33034
+ if (typeof rowId !== "string") {
33035
+ return span;
33036
+ }
33037
+ try {
33038
+ const exported = await span.export();
33039
+ const reference2 = {
33040
+ exported,
33041
+ rootSpanId: span.rootSpanId,
33042
+ rowId,
33043
+ spanId: span.spanId,
33044
+ startEvent
33045
+ };
33046
+ this.state.update((current) => {
33047
+ const normalized = normalizeEveTraceState(current);
33048
+ return normalized.spanReferences.some(
33049
+ (candidate) => candidate.rowId === rowId
33050
+ ) ? normalized : {
33051
+ ...normalized,
33052
+ spanReferences: [...normalized.spanReferences, reference2].slice(
33053
+ -MAX_STORED_SPAN_REFERENCES
33054
+ )
33055
+ };
33056
+ });
33057
+ } catch (error) {
33058
+ debugLogger.warn("Error exporting Eve span for resumption:", error);
33059
+ }
33060
+ return span;
33061
+ }
33062
+ async startEveChildSpan(parent, args) {
33063
+ return await this.startEveSpan({
33064
+ ...args,
33065
+ parentSpanIds: {
33066
+ rootSpanId: parent.rootSpanId,
33067
+ spanId: parent.spanId
33068
+ }
33069
+ });
33070
+ }
33071
+ stepOrdinal(event) {
33072
+ let ordinal = 0;
33073
+ this.state.update((current) => {
33074
+ const state = normalizeEveTraceState(current);
33075
+ const previous = state.stepStarts.filter(
33076
+ (entry) => entry.turnId === event.data.turnId && entry.stepIndex === event.data.stepIndex
33077
+ ).at(-1);
33078
+ if (previous?.open) {
33079
+ ordinal = previous.ordinal;
33080
+ return state;
33081
+ }
33082
+ ordinal = state.stepStarts.filter(
33083
+ (entry) => entry.turnId === event.data.turnId
33084
+ ).length;
33085
+ return {
33086
+ ...state,
33087
+ stepStarts: [
33088
+ ...state.stepStarts,
33089
+ {
33090
+ open: true,
33091
+ ordinal,
33092
+ stepIndex: event.data.stepIndex,
33093
+ turnId: event.data.turnId
33094
+ }
33095
+ ].slice(-MAX_STORED_STEP_STARTS)
33096
+ };
33097
+ });
33098
+ return ordinal;
33099
+ }
33100
+ markStepEnded(turnId, stepIndex) {
33101
+ this.state.update((current) => {
33102
+ const state = normalizeEveTraceState(current);
33103
+ let index = -1;
33104
+ for (let i = state.stepStarts.length - 1; i >= 0; i--) {
33105
+ const entry = state.stepStarts[i];
33106
+ if (entry?.turnId === turnId && entry.stepIndex === stepIndex) {
33107
+ index = i;
33108
+ break;
33109
+ }
33110
+ }
33111
+ if (index < 0 || !state.stepStarts[index]?.open) {
33112
+ return state;
33113
+ }
33114
+ return {
33115
+ ...state,
33116
+ stepStarts: state.stepStarts.map(
33117
+ (entry, entryIndex) => entryIndex === index ? { ...entry, open: false } : entry
33118
+ )
33119
+ };
33120
+ });
33121
+ }
33122
+ async handle(event, ctx, hookMetadata) {
33123
+ if (!isEveHandleMessageStreamEvent(event)) {
33124
+ return;
33125
+ }
33126
+ const run = async () => {
33127
+ try {
33128
+ if (!await this.handleEvent(event, ctx, hookMetadata)) {
33129
+ return;
33130
+ }
33131
+ if (event.type === "session.failed") {
33132
+ const sessionId2 = event.data.sessionId || sessionIdFromContext(ctx);
33133
+ await this.flushInstrumentation();
33134
+ if (sessionId2) {
33135
+ this.cleanupSession(sessionId2);
33136
+ }
33137
+ } else if (event.type === "session.completed") {
33138
+ const sessionId2 = sessionIdFromContext(ctx);
33139
+ await this.flushInstrumentation();
33140
+ if (sessionId2) {
33141
+ this.cleanupSession(sessionId2);
33142
+ }
33143
+ }
33144
+ } catch (error) {
33145
+ debugLogger.warn("Error in Eve hook instrumentation:", error);
33146
+ }
33147
+ };
33148
+ const sessionId = event.type === "session.failed" ? event.data.sessionId || sessionIdFromContext(ctx) : sessionIdFromContext(ctx);
33149
+ if (!sessionId) {
33150
+ await run();
33151
+ return;
33152
+ }
33153
+ const previous = this.eventQueuesBySession.get(sessionId);
33154
+ const queued = previous ? previous.then(run) : run();
33155
+ this.eventQueuesBySession.set(sessionId, queued);
33156
+ try {
33157
+ await queued;
33158
+ } finally {
33159
+ if (this.eventQueuesBySession.get(sessionId) === queued) {
33160
+ this.eventQueuesBySession.delete(sessionId);
33161
+ }
33162
+ }
33163
+ }
33164
+ async handleEvent(event, ctx, hookMetadata) {
33165
+ switch (event.type) {
33166
+ case "session.started":
33167
+ await this.handleSessionStarted(event, ctx, hookMetadata);
33168
+ return true;
33169
+ case "turn.started":
33170
+ await this.handleTurnStarted(event, ctx, hookMetadata);
33171
+ return true;
33172
+ case "message.received":
33173
+ await this.handleMessageReceived(event, ctx, hookMetadata);
33174
+ return true;
33175
+ case "step.started":
33176
+ await this.handleStepStarted(event, ctx, hookMetadata);
33177
+ return true;
33178
+ case "message.completed":
33179
+ this.handleMessageCompleted(event, ctx);
33180
+ return true;
33181
+ case "result.completed":
33182
+ this.handleResultCompleted(event, ctx);
33183
+ return true;
33184
+ case "actions.requested":
33185
+ await this.handleActionsRequested(event, ctx, hookMetadata);
33186
+ return true;
33187
+ case "action.result":
33188
+ await this.handleActionResult(event, ctx, hookMetadata);
33189
+ return true;
33190
+ case "subagent.called":
33191
+ await this.handleSubagentCalled(event, ctx, hookMetadata);
33192
+ return true;
33193
+ case "subagent.completed":
33194
+ await this.handleSubagentCompleted(event, ctx, hookMetadata);
33195
+ return true;
33196
+ case "step.completed":
33197
+ this.handleStepCompleted(event, ctx);
33198
+ return true;
33199
+ case "step.failed":
33200
+ this.handleStepFailed(event, ctx);
33201
+ return true;
33202
+ case "turn.completed":
33203
+ await this.handleTurnCompleted(event, ctx);
33204
+ return true;
33205
+ case "turn.failed":
33206
+ await this.handleTurnFailed(event, ctx);
33207
+ return true;
33208
+ case "session.failed":
33209
+ await this.handleSessionFailed(event, ctx);
33210
+ return true;
33211
+ case "session.completed":
33212
+ await this.handleSessionCompleted(event, ctx);
33213
+ return true;
33214
+ default:
33215
+ return false;
33216
+ }
33217
+ }
33218
+ async handleSessionStarted(event, ctx, hookMetadata) {
33219
+ const sessionId = sessionIdFromContext(ctx);
33220
+ if (!sessionId) {
33221
+ return;
33222
+ }
33223
+ const metadata = {
33224
+ ...hookMetadata ?? {},
33225
+ ...modelMetadataFromRuntime(event.data.runtime)
33226
+ };
33227
+ this.state.update((current) => {
33228
+ const normalized = normalizeEveTraceState(current);
33229
+ return {
33230
+ ...normalized,
33231
+ metadata: { ...normalized.metadata, ...metadata }
33232
+ };
33233
+ });
33234
+ await this.ensureSession(sessionId, ctx, metadata, eventTime2(event));
33235
+ for (const [key, turn] of this.turnsByKey) {
33236
+ if (!key.startsWith(`${sessionId}:`)) {
33237
+ continue;
33238
+ }
33239
+ turn.metadata = { ...turn.metadata, ...metadata };
33240
+ turn.span.log({ metadata: turn.metadata });
33241
+ for (const step of turn.stepsByIndex.values()) {
33242
+ step.metadata = { ...step.metadata, ...metadata };
33243
+ step.span.log({ metadata: step.metadata });
33244
+ }
33245
+ }
33246
+ }
33247
+ async handleTurnStarted(event, ctx, hookMetadata) {
33248
+ const sessionId = sessionIdFromContext(ctx);
33249
+ if (!sessionId) {
33250
+ return;
33251
+ }
33252
+ const session = await this.ensureSession(
33253
+ sessionId,
33254
+ ctx,
33255
+ hookMetadata ?? {},
33256
+ eventTime2(event)
33257
+ );
33258
+ const key = turnKey2(sessionId, event.data.turnId);
33259
+ const metadata = { ...session.metadata };
33260
+ const existing = this.turnsByKey.get(key);
33261
+ if (existing) {
33262
+ existing.metadata = { ...existing.metadata, ...metadata };
33263
+ existing.span.log({ metadata: existing.metadata });
33264
+ return;
33265
+ }
33266
+ const span = await this.startTurnSpan(session, event, metadata);
33267
+ span.log({ metadata });
33268
+ this.turnsByKey.set(key, {
33269
+ key,
33270
+ metadata,
33271
+ metrics: {},
33272
+ span,
33273
+ stepsByIndex: /* @__PURE__ */ new Map(),
33274
+ turnId: event.data.turnId
33275
+ });
33276
+ }
33277
+ async handleMessageReceived(event, ctx, hookMetadata) {
33278
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33279
+ if (!turn) {
33280
+ return;
33281
+ }
33282
+ const input = [{ content: event.data.message, role: "user" }];
33283
+ turn.span.log({ input });
33284
+ }
33285
+ async handleStepStarted(event, ctx, hookMetadata) {
33286
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33287
+ const sessionId = sessionIdFromContext(ctx);
33288
+ if (!turn || !sessionId) {
33289
+ return;
33290
+ }
33291
+ const existing = turn.stepsByIndex.get(event.data.stepIndex);
33292
+ if (existing) {
33293
+ existing.span.log({
33294
+ ...existing.input !== void 0 ? { input: existing.input } : {},
33295
+ metadata: existing.metadata,
33296
+ metrics: existing.metrics,
33297
+ output: existing.output
33298
+ });
33299
+ const endTime = eventTime2(event);
33300
+ existing.span.end(endTime === void 0 ? void 0 : { endTime });
33301
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33302
+ }
33303
+ const stepOrdinal = this.stepOrdinal(event);
33304
+ const metadata = {
33305
+ ...turn.metadata,
33306
+ ...this.sessionsById.get(sessionId)?.metadata ?? {}
33307
+ };
33308
+ const input = consumeCapturedEveModelInput(
33309
+ this.state,
33310
+ sessionId,
33311
+ event.data.turnId,
33312
+ event.data.stepIndex
33313
+ );
33314
+ const { rowId: eventId, spanId } = await generateEveIds(
33315
+ "step",
33316
+ sessionId,
33317
+ event.data.turnId,
33318
+ String(stepOrdinal)
33319
+ );
33320
+ const span = await this.startEveChildSpan(turn.span, {
33321
+ event: {
33322
+ id: eventId,
33323
+ ...input !== void 0 ? { input } : {},
33324
+ metadata
33325
+ },
33326
+ name: "eve.step",
33327
+ spanAttributes: { type: "llm" /* LLM */ },
33328
+ spanId,
33329
+ startTime: eventTime2(event)
33330
+ });
33331
+ span.log({ ...input !== void 0 ? { input } : {}, metadata });
33332
+ turn.stepsByIndex.set(event.data.stepIndex, {
33333
+ ...input !== void 0 ? { input } : {},
33334
+ metadata,
33335
+ metrics: {},
33336
+ span
33337
+ });
33338
+ }
33339
+ handleMessageCompleted(event, ctx) {
33340
+ const step = this.stepForEvent(event, ctx);
33341
+ if (!step) {
33342
+ return;
33343
+ }
33344
+ const existingMessage = Array.isArray(step.output) && isObject(step.output[0]) ? step.output[0].message : void 0;
33345
+ const existingToolCalls = isObject(existingMessage) ? existingMessage.tool_calls : void 0;
33346
+ step.output = [
33347
+ {
33348
+ finish_reason: normalizedFinishReason(event.data.finishReason),
33349
+ index: 0,
33350
+ message: {
33351
+ content: event.data.message,
33352
+ role: "assistant",
33353
+ ...Array.isArray(existingToolCalls) ? { tool_calls: existingToolCalls } : {}
33354
+ }
33355
+ }
33356
+ ];
33357
+ const turn = this.turnForEvent(event, ctx);
33358
+ if (turn && event.data.finishReason !== "tool-calls") {
33359
+ turn.output = event.data.message;
33360
+ }
33361
+ }
33362
+ handleResultCompleted(event, ctx) {
33363
+ const step = this.stepForEvent(event, ctx);
33364
+ if (step) {
33365
+ step.output = [
33366
+ {
33367
+ finish_reason: "stop",
33368
+ index: 0,
33369
+ message: {
33370
+ content: event.data.result,
33371
+ role: "assistant"
33372
+ }
33373
+ }
33374
+ ];
33375
+ }
33376
+ const turn = this.turnForEvent(event, ctx);
33377
+ if (turn) {
33378
+ turn.output = event.data.result;
33379
+ }
33380
+ }
33381
+ async handleActionsRequested(event, ctx, hookMetadata) {
33382
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33383
+ const sessionId = sessionIdFromContext(ctx);
33384
+ if (!turn || !sessionId) {
33385
+ return;
33386
+ }
33387
+ const traceActions = event.data.actions.filter(isTraceableActionRequest);
33388
+ if (traceActions.length === 0) {
33389
+ return;
33390
+ }
33391
+ for (const action of traceActions) {
33392
+ if (isToolCallAction(action)) {
33393
+ await this.startRequestedTool(event, turn, sessionId, action);
33394
+ } else if (isLocalSubagentCallAction(action)) {
33395
+ await this.startRequestedSubagent(event, turn, sessionId, action);
33396
+ }
33397
+ }
33398
+ const step = turn.stepsByIndex.get(event.data.stepIndex);
33399
+ if (!step) {
33400
+ return;
33401
+ }
33402
+ step.output = [
33403
+ {
33404
+ finish_reason: "tool_calls",
33405
+ index: 0,
33406
+ message: {
33407
+ content: null,
33408
+ role: "assistant",
33409
+ tool_calls: traceActions.map((action) => {
33410
+ const name = action.kind === "tool-call" ? action.toolName : action.subagentName ?? action.name ?? "agent";
33411
+ return {
33412
+ function: {
33413
+ arguments: JSON.stringify(action.input),
33414
+ name
33415
+ },
33416
+ id: action.callId,
33417
+ type: "function"
33418
+ };
33419
+ })
33420
+ }
33421
+ }
33422
+ ];
33423
+ step.span.log({ metadata: step.metadata, output: step.output });
33424
+ }
33425
+ async handleActionResult(event, ctx, hookMetadata) {
33426
+ if (isToolResult(event.data.result)) {
33427
+ await this.handleToolResult(event, ctx, event.data.result, hookMetadata);
33428
+ return;
33429
+ }
33430
+ if (isSubagentResult(event.data.result)) {
33431
+ await this.handleSubagentResult(
33432
+ event,
33433
+ ctx,
33434
+ event.data.result,
33435
+ hookMetadata
33436
+ );
33437
+ }
33438
+ }
33439
+ async handleToolResult(event, ctx, result, hookMetadata) {
33440
+ const sessionId = sessionIdFromContext(ctx);
33441
+ if (!sessionId) {
33442
+ return;
33443
+ }
33444
+ const key = toolKey3(sessionId, result.callId);
33445
+ if (this.completedToolKeys.has(key)) {
33446
+ return;
33447
+ }
33448
+ const tool = this.toolsByCallKey.get(key) ?? await this.startSyntheticTool(event, ctx, result, hookMetadata);
33449
+ if (!tool) {
33450
+ return;
33451
+ }
33452
+ const failed = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
33453
+ tool.span.log({
33454
+ ...failed ? {
33455
+ error: actionResultError(event.data.error, result.output)
33456
+ } : {},
33457
+ metadata: tool.metadata,
33458
+ output: result.output
33459
+ });
33460
+ const endTime = eventTime2(event);
33461
+ tool.span.end(endTime === void 0 ? void 0 : { endTime });
33462
+ this.toolsByCallKey.delete(key);
33463
+ this.completedToolKeys.set(key, true);
33464
+ }
33465
+ async handleSubagentCalled(event, ctx, hookMetadata) {
33466
+ if (event.data.remote?.url) {
33467
+ return;
33468
+ }
33469
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33470
+ const sessionId = sessionIdFromContext(ctx);
33471
+ if (!turn || !sessionId) {
33472
+ return;
33473
+ }
33474
+ const key = toolKey3(sessionId, event.data.callId);
33475
+ const metadata = toolMetadataFromTurn(turn);
33476
+ const existing = this.toolsByCallKey.get(key);
33477
+ if (existing) {
33478
+ existing.metadata = { ...existing.metadata, ...metadata };
33479
+ existing.span.log({ metadata: existing.metadata });
33480
+ return;
33481
+ }
33482
+ if (this.completedToolKeys.has(key)) {
33483
+ return;
33484
+ }
33485
+ const { rowId: eventId, spanId } = await generateEveIds(
33486
+ "subagent",
33487
+ sessionId,
33488
+ event.data.callId
33489
+ );
33490
+ const pending = this.toolsByCallKey.get(key);
33491
+ if (pending || this.completedToolKeys.has(key)) {
33492
+ if (pending) {
33493
+ pending.metadata = { ...pending.metadata, ...metadata };
33494
+ pending.span.log({ metadata: pending.metadata });
33495
+ }
33496
+ return;
33497
+ }
33498
+ const span = await this.startEveChildSpan(turn.span, {
33499
+ event: {
33500
+ id: eventId,
33501
+ metadata
33502
+ },
33503
+ name: event.data.toolName ?? event.data.name,
33504
+ spanAttributes: { type: "tool" /* TOOL */ },
33505
+ spanId,
33506
+ startTime: eventTime2(event)
33507
+ });
33508
+ span.log({ metadata });
33509
+ this.toolsByCallKey.set(key, {
33510
+ metadata,
33511
+ span,
33512
+ turnKey: turnKey2(sessionId, event.data.turnId)
33513
+ });
33514
+ }
33515
+ async handleSubagentCompleted(event, ctx, hookMetadata) {
33516
+ const sessionId = sessionIdFromContext(ctx);
33517
+ if (!sessionId) {
33518
+ return;
33519
+ }
33520
+ const key = toolKey3(sessionId, event.data.callId);
33521
+ if (this.completedToolKeys.has(key)) {
33522
+ return;
33523
+ }
33524
+ const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagent(event, ctx, hookMetadata);
33525
+ if (!subagent) {
33526
+ return;
33527
+ }
33528
+ subagent.span.log({
33529
+ ...event.data.status === "failed" ? {
33530
+ error: actionResultError(event.data.error, event.data.output)
33531
+ } : {},
33532
+ metadata: subagent.metadata,
33533
+ ...event.data.output !== void 0 ? { output: event.data.output } : {}
33534
+ });
33535
+ const endTime = eventTime2(event);
33536
+ const recordedEndTime = subagent.span.end(
33537
+ endTime === void 0 ? void 0 : { endTime }
33538
+ );
33539
+ this.state.update((current) => {
33540
+ const normalized = normalizeEveTraceState(current);
33541
+ return {
33542
+ ...normalized,
33543
+ spanReferences: normalized.spanReferences.map(
33544
+ (reference) => reference.spanId === subagent.span.spanId ? { ...reference, endTime: recordedEndTime } : reference
33545
+ )
33546
+ };
33547
+ });
33548
+ }
33549
+ async handleSubagentResult(event, ctx, result, hookMetadata) {
33550
+ const sessionId = sessionIdFromContext(ctx);
33551
+ if (!sessionId) {
33552
+ return;
33553
+ }
33554
+ const key = toolKey3(sessionId, result.callId);
33555
+ if (this.completedToolKeys.has(key)) {
33556
+ return;
33557
+ }
33558
+ const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagentResult(
33559
+ event,
33560
+ ctx,
33561
+ result,
33562
+ hookMetadata
33563
+ );
33564
+ if (!subagent) {
33565
+ return;
33566
+ }
33567
+ const isError = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
33568
+ subagent.span.log({
33569
+ ...isError ? {
33570
+ error: actionResultError(event.data.error, result.output)
33571
+ } : {},
33572
+ metadata: subagent.metadata,
33573
+ output: result.output
33574
+ });
33575
+ const endTime = eventTime2(event);
33576
+ subagent.span.end(endTime === void 0 ? void 0 : { endTime });
33577
+ this.toolsByCallKey.delete(key);
33578
+ this.completedToolKeys.set(key, true);
33579
+ }
33580
+ handleStepCompleted(event, ctx) {
33581
+ const step = this.stepForEvent(event, ctx);
33582
+ if (!step) {
33583
+ return;
33584
+ }
33585
+ const usage = event.data.usage;
33586
+ const inputTokens = typeof usage?.inputTokens === "number" && Number.isFinite(usage.inputTokens) && usage.inputTokens >= 0 ? usage.inputTokens : void 0;
33587
+ const outputTokens = typeof usage?.outputTokens === "number" && Number.isFinite(usage.outputTokens) && usage.outputTokens >= 0 ? usage.outputTokens : void 0;
33588
+ const cacheReadTokens = typeof usage?.cacheReadTokens === "number" && Number.isFinite(usage.cacheReadTokens) && usage.cacheReadTokens >= 0 ? usage.cacheReadTokens : void 0;
33589
+ const cacheWriteTokens = typeof usage?.cacheWriteTokens === "number" && Number.isFinite(usage.cacheWriteTokens) && usage.cacheWriteTokens >= 0 ? usage.cacheWriteTokens : void 0;
33590
+ const costUsd = typeof usage?.costUsd === "number" && Number.isFinite(usage.costUsd) && usage.costUsd >= 0 ? usage.costUsd : void 0;
33591
+ const total = inputTokens !== void 0 && outputTokens !== void 0 ? inputTokens + outputTokens : void 0;
33592
+ const metrics = {
33593
+ ...inputTokens !== void 0 ? { prompt_tokens: inputTokens } : {},
33594
+ ...outputTokens !== void 0 ? { completion_tokens: outputTokens } : {},
33595
+ ...total !== void 0 ? { tokens: total } : {},
33596
+ ...cacheReadTokens !== void 0 ? { prompt_cached_tokens: cacheReadTokens } : {},
33597
+ ...cacheWriteTokens !== void 0 ? { prompt_cache_creation_tokens: cacheWriteTokens } : {},
33598
+ ...costUsd !== void 0 ? { estimated_cost: costUsd } : {}
33599
+ };
33600
+ step.metrics = { ...step.metrics, ...metrics };
33601
+ if (Array.isArray(step.output) && isObject(step.output[0])) {
33602
+ const finishReason = step.output[0].finish_reason;
33603
+ if (typeof finishReason !== "string") {
33604
+ step.output[0].finish_reason = normalizedFinishReason(
33605
+ event.data.finishReason
33606
+ );
33607
+ }
33608
+ }
33609
+ step.span.log({
33610
+ ...step.input !== void 0 ? { input: step.input } : {},
33611
+ metadata: step.metadata,
33612
+ metrics,
33613
+ output: step.output
33614
+ });
33615
+ const endTime = eventTime2(event);
33616
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
33617
+ const turn = this.turnForEvent(event, ctx);
33618
+ if (turn) {
33619
+ for (const [key, value] of Object.entries(metrics)) {
33620
+ turn.metrics[key] = (turn.metrics[key] ?? 0) + value;
33621
+ }
33622
+ turn.stepsByIndex.delete(event.data.stepIndex);
33623
+ }
33624
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33625
+ }
33626
+ handleStepFailed(event, ctx) {
33627
+ const step = this.stepForEvent(event, ctx);
33628
+ if (step) {
33629
+ step.span.log({
33630
+ error: errorFromMessage(
33631
+ event.data.message,
33632
+ event.data.code,
33633
+ event.data.details
33634
+ )
33635
+ });
33636
+ const endTime = eventTime2(event);
33637
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
33638
+ }
33639
+ const turn = this.turnForEvent(event, ctx);
33640
+ turn?.stepsByIndex.delete(event.data.stepIndex);
33641
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33642
+ }
33643
+ handleTurnCompleted(event, ctx) {
33644
+ const turn = this.turnForEvent(event, ctx);
33645
+ if (!turn) {
33646
+ return;
33647
+ }
33648
+ this.finalizeTurn(turn, {
33649
+ endTime: eventTime2(event)
33650
+ });
33651
+ }
33652
+ handleTurnFailed(event, ctx) {
33653
+ const turn = this.turnForEvent(event, ctx);
33654
+ if (!turn) {
33655
+ return;
33656
+ }
33657
+ this.finalizeTurn(turn, {
33658
+ endTime: eventTime2(event),
33659
+ error: errorFromMessage(
33660
+ event.data.message,
33661
+ event.data.code,
33662
+ event.data.details
33663
+ )
33664
+ });
33665
+ }
33666
+ async handleSessionFailed(event, ctx) {
33667
+ const sessionId = event.data.sessionId || sessionIdFromContext(ctx);
33668
+ if (!sessionId) {
33669
+ return;
33670
+ }
33671
+ const session = await this.ensureSession(
33672
+ sessionId,
33673
+ ctx,
33674
+ {},
33675
+ eventTime2(event)
33676
+ );
33677
+ const error = errorFromMessage(
33678
+ event.data.message,
33679
+ event.data.code,
33680
+ event.data.details
33681
+ );
33682
+ for (const [key, turn] of this.turnsByKey) {
33683
+ if (!key.startsWith(`${sessionId}:`)) {
33684
+ continue;
33685
+ }
33686
+ this.finalizeTurn(turn, {
33687
+ endTime: eventTime2(event),
33688
+ error
33689
+ });
33690
+ }
33691
+ for (const [key, tool] of this.toolsByCallKey) {
33692
+ if (key.startsWith(`${sessionId}:`)) {
33693
+ const endTime2 = eventTime2(event);
33694
+ if (!tool.endedByTurn) {
33695
+ tool.span.log({ metadata: tool.metadata });
33696
+ tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
33697
+ tool.endedByTurn = true;
33698
+ }
33699
+ }
33700
+ }
33701
+ session.span.log({ error });
33702
+ const endTime = eventTime2(event);
33703
+ session.span.end(endTime === void 0 ? void 0 : { endTime });
33704
+ }
33705
+ async handleSessionCompleted(event, ctx) {
33706
+ const sessionId = sessionIdFromContext(ctx);
33707
+ if (!sessionId) {
33708
+ return;
33709
+ }
33710
+ const session = await this.ensureSession(
33711
+ sessionId,
33712
+ ctx,
33713
+ {},
33714
+ eventTime2(event)
33715
+ );
33716
+ for (const [key, turn] of this.turnsByKey) {
33717
+ if (!key.startsWith(`${sessionId}:`)) {
33718
+ continue;
33719
+ }
33720
+ this.finalizeTurn(turn, {
33721
+ endTime: eventTime2(event)
33722
+ });
33723
+ }
33724
+ for (const [key, tool] of this.toolsByCallKey) {
33725
+ if (key.startsWith(`${sessionId}:`) && !tool.endedByTurn) {
33726
+ const endTime2 = eventTime2(event);
33727
+ tool.span.log({ metadata: tool.metadata });
33728
+ tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
33729
+ tool.endedByTurn = true;
33730
+ }
33731
+ }
33732
+ session.span.log({ metadata: session.metadata });
33733
+ const endTime = eventTime2(event);
33734
+ session.span.end(endTime === void 0 ? void 0 : { endTime });
33735
+ }
33736
+ async ensureSession(sessionId, ctx, metadata, startTime) {
33737
+ metadata = {
33738
+ ...readEveTraceState(this.state).metadata,
33739
+ ...metadata
33740
+ };
33741
+ const existing = this.sessionsById.get(sessionId);
33742
+ if (existing) {
33743
+ existing.metadata = { ...existing.metadata, ...metadata };
33744
+ existing.span.log({ metadata: existing.metadata });
33745
+ return existing;
33746
+ }
33747
+ const lineage = parentLineageFromContext(ctx);
33748
+ const parentSubagent = lineage ? this.toolsByCallKey.get(toolKey3(lineage.sessionId, lineage.callId)) : void 0;
33749
+ const activeParent = currentSpan();
33750
+ const [
33751
+ { rowId: eventId, spanId },
33752
+ parentSubagentSpanId,
33753
+ fallbackRootSpanId
33754
+ ] = await Promise.all([
33755
+ generateEveIds("session", sessionId),
33756
+ lineage ? spanIdForSubagent(lineage.sessionId, lineage.callId) : Promise.resolve(void 0),
33757
+ lineage ? rootSpanIdForSession(lineage.rootSessionId) : rootSpanIdForSession(sessionId)
33758
+ ]);
33759
+ const span = await this.startEveSpan({
33760
+ event: {
33761
+ id: eventId,
33762
+ metadata
33763
+ },
33764
+ name: "eve.session",
33765
+ parentSpanIds: lineage && parentSubagentSpanId ? {
33766
+ rootSpanId: parentSubagent?.span.rootSpanId ?? fallbackRootSpanId,
33767
+ spanId: parentSubagentSpanId
33768
+ } : !Object.is(activeParent, NOOP_SPAN) ? {
33769
+ rootSpanId: activeParent.rootSpanId,
33770
+ spanId: activeParent.spanId
33771
+ } : {
33772
+ parentSpanIds: [],
33773
+ rootSpanId: fallbackRootSpanId
33774
+ },
33775
+ spanAttributes: { type: "task" /* TASK */ },
33776
+ spanId,
33777
+ startTime
33778
+ });
33779
+ span.log({ metadata });
33780
+ const session = { metadata, sessionId, span };
33781
+ this.sessionsById.set(sessionId, session);
33782
+ return session;
33783
+ }
33784
+ async ensureTurn(event, ctx, hookMetadata) {
33785
+ const sessionId = sessionIdFromContext(ctx);
33786
+ if (!sessionId) {
33787
+ return void 0;
33788
+ }
33789
+ const session = await this.ensureSession(
33790
+ sessionId,
33791
+ ctx,
33792
+ hookMetadata ?? {},
33793
+ eventTime2(event)
33794
+ );
33795
+ const key = turnKey2(sessionId, event.data.turnId);
33796
+ const existing = this.turnsByKey.get(key);
33797
+ if (existing) {
33798
+ return existing;
33799
+ }
33800
+ const metadata = { ...session.metadata };
33801
+ const span = await this.startTurnSpan(session, event, metadata);
33802
+ span.log({ metadata });
33803
+ const state = {
33804
+ key,
33805
+ metadata,
33806
+ metrics: {},
33807
+ span,
33808
+ stepsByIndex: /* @__PURE__ */ new Map(),
33809
+ turnId: event.data.turnId
33810
+ };
33811
+ this.turnsByKey.set(key, state);
33812
+ return state;
33813
+ }
33814
+ async startRequestedTool(event, turn, sessionId, action) {
33815
+ const key = toolKey3(sessionId, action.callId);
33816
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
33817
+ return;
33818
+ }
33819
+ const metadata = toolMetadataFromTurn(turn);
33820
+ const { rowId: eventId, spanId } = await generateEveIds(
33821
+ "tool",
33822
+ sessionId,
33823
+ event.data.turnId,
33824
+ action.callId
33825
+ );
33826
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
33827
+ return;
33828
+ }
33829
+ const span = await this.startEveChildSpan(turn.span, {
33830
+ event: {
33831
+ id: eventId,
33832
+ input: action.input,
33833
+ metadata
33834
+ },
33835
+ name: action.toolName,
33836
+ spanAttributes: { type: "tool" /* TOOL */ },
33837
+ spanId,
33838
+ startTime: eventTime2(event)
33839
+ });
33840
+ span.log({ input: action.input, metadata });
33841
+ this.toolsByCallKey.set(key, {
33842
+ metadata,
33843
+ span,
33844
+ turnKey: turnKey2(sessionId, event.data.turnId)
33845
+ });
33846
+ }
33847
+ async startRequestedSubagent(event, turn, sessionId, action) {
33848
+ const key = toolKey3(sessionId, action.callId);
33849
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
33850
+ return;
33851
+ }
33852
+ const name = action.subagentName ?? action.name ?? "agent";
33853
+ const metadata = toolMetadataFromTurn(turn);
33854
+ const { rowId: eventId, spanId } = await generateEveIds(
33855
+ "subagent",
33856
+ sessionId,
33857
+ action.callId
33858
+ );
33859
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
33860
+ return;
33861
+ }
33862
+ const span = await this.startEveChildSpan(turn.span, {
33863
+ event: {
33864
+ id: eventId,
33865
+ input: action.input,
33866
+ metadata
33867
+ },
33868
+ name,
33869
+ spanAttributes: { type: "tool" /* TOOL */ },
33870
+ spanId,
33871
+ startTime: eventTime2(event)
33872
+ });
33873
+ span.log({ input: action.input, metadata });
33874
+ this.toolsByCallKey.set(key, {
33875
+ metadata,
33876
+ span,
33877
+ turnKey: turnKey2(sessionId, event.data.turnId)
33878
+ });
33879
+ }
33880
+ async startSyntheticTool(event, ctx, result, hookMetadata) {
33881
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33882
+ const sessionId = sessionIdFromContext(ctx);
33883
+ if (!turn || !sessionId) {
33884
+ return void 0;
33885
+ }
33886
+ const metadata = toolMetadataFromTurn(turn);
33887
+ const { rowId: eventId, spanId } = await generateEveIds(
33888
+ "tool",
33889
+ sessionId,
33890
+ event.data.turnId,
33891
+ result.callId
33892
+ );
33893
+ const existing = this.toolsByCallKey.get(toolKey3(sessionId, result.callId));
33894
+ if (existing) {
33895
+ return existing;
33896
+ }
33897
+ const span = await this.startEveChildSpan(turn.span, {
33898
+ event: {
33899
+ id: eventId,
33900
+ metadata
33901
+ },
33902
+ name: result.toolName,
33903
+ spanAttributes: { type: "tool" /* TOOL */ },
33904
+ spanId,
33905
+ startTime: eventTime2(event)
33906
+ });
33907
+ span.log({ metadata });
33908
+ const state = {
33909
+ metadata,
33910
+ span,
33911
+ turnKey: turnKey2(sessionId, event.data.turnId)
33912
+ };
33913
+ this.toolsByCallKey.set(toolKey3(sessionId, result.callId), state);
33914
+ return state;
33915
+ }
33916
+ async startSyntheticSubagent(event, ctx, hookMetadata) {
33917
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33918
+ const sessionId = sessionIdFromContext(ctx);
33919
+ if (!turn || !sessionId) {
33920
+ return void 0;
33921
+ }
33922
+ const metadata = toolMetadataFromTurn(turn);
33923
+ const { rowId: eventId, spanId } = await generateEveIds(
33924
+ "subagent",
33925
+ sessionId,
33926
+ event.data.callId
33927
+ );
33928
+ const existing = this.toolsByCallKey.get(
33929
+ toolKey3(sessionId, event.data.callId)
33930
+ );
33931
+ if (existing) {
33932
+ return existing;
33933
+ }
33934
+ const span = await this.startEveChildSpan(turn.span, {
33935
+ event: {
33936
+ id: eventId,
33937
+ metadata
33938
+ },
33939
+ name: event.data.subagentName,
33940
+ spanAttributes: { type: "tool" /* TOOL */ },
33941
+ spanId,
33942
+ startTime: eventTime2(event)
33943
+ });
33944
+ span.log({ metadata });
33945
+ const state = {
33946
+ metadata,
33947
+ span,
33948
+ turnKey: turnKey2(sessionId, event.data.turnId)
33949
+ };
33950
+ this.toolsByCallKey.set(toolKey3(sessionId, event.data.callId), state);
33951
+ return state;
33952
+ }
33953
+ async startSyntheticSubagentResult(event, ctx, result, hookMetadata) {
33954
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33955
+ const sessionId = sessionIdFromContext(ctx);
33956
+ if (!turn || !sessionId) {
33957
+ return void 0;
33958
+ }
33959
+ const metadata = toolMetadataFromTurn(turn);
33960
+ const { rowId: eventId, spanId } = await generateEveIds(
33961
+ "subagent",
33962
+ sessionId,
33963
+ result.callId
33964
+ );
33965
+ const existing = this.toolsByCallKey.get(toolKey3(sessionId, result.callId));
33966
+ if (existing) {
33967
+ return existing;
33968
+ }
33969
+ const span = await this.startEveChildSpan(turn.span, {
33970
+ event: {
33971
+ id: eventId,
33972
+ metadata
33973
+ },
33974
+ name: result.subagentName,
33975
+ spanAttributes: { type: "tool" /* TOOL */ },
33976
+ spanId,
33977
+ startTime: eventTime2(event)
33978
+ });
33979
+ span.log({ metadata });
33980
+ const state = {
33981
+ metadata,
33982
+ span,
33983
+ turnKey: turnKey2(sessionId, event.data.turnId)
33984
+ };
33985
+ this.toolsByCallKey.set(toolKey3(sessionId, result.callId), state);
33986
+ return state;
33987
+ }
33988
+ async startTurnSpan(session, event, metadata) {
33989
+ const { rowId: eventId, spanId } = await generateEveIds(
33990
+ "turn",
33991
+ session.sessionId,
33992
+ event.data.turnId
33993
+ );
33994
+ return await this.startEveSpan({
33995
+ event: {
33996
+ id: eventId,
33997
+ metadata
33998
+ },
33999
+ name: "eve.turn",
34000
+ parentSpanIds: {
34001
+ rootSpanId: session.span.rootSpanId,
34002
+ spanId: session.span.spanId
34003
+ },
34004
+ spanAttributes: { type: "task" /* TASK */ },
34005
+ spanId,
34006
+ startTime: eventTime2(event)
34007
+ });
34008
+ }
34009
+ turnForEvent(event, ctx) {
34010
+ const sessionId = sessionIdFromContext(ctx);
34011
+ return sessionId ? this.turnsByKey.get(turnKey2(sessionId, event.data.turnId)) : void 0;
34012
+ }
34013
+ stepForEvent(event, ctx) {
34014
+ return this.turnForEvent(event, ctx)?.stepsByIndex.get(
34015
+ event.data.stepIndex
34016
+ );
34017
+ }
34018
+ finalizeTurn(turn, args) {
34019
+ const { endTime } = args;
34020
+ for (const step of turn.stepsByIndex.values()) {
34021
+ step.span.log({
34022
+ ...step.input !== void 0 ? { input: step.input } : {},
34023
+ metadata: step.metadata,
34024
+ metrics: step.metrics,
34025
+ output: step.output
34026
+ });
34027
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
34028
+ }
34029
+ turn.stepsByIndex.clear();
34030
+ for (const tool of this.toolsByCallKey.values()) {
34031
+ if (tool.turnKey !== turn.key) {
34032
+ continue;
34033
+ }
34034
+ if (tool.endedByTurn) {
34035
+ continue;
34036
+ }
34037
+ tool.span.log({ metadata: tool.metadata });
34038
+ tool.span.end(endTime === void 0 ? void 0 : { endTime });
34039
+ tool.endedByTurn = true;
34040
+ }
34041
+ if (args.error) {
34042
+ turn.span.log({ error: args.error });
34043
+ } else {
34044
+ turn.span.log({
34045
+ metadata: turn.metadata,
34046
+ metrics: turn.metrics,
34047
+ output: turn.output
34048
+ });
34049
+ }
34050
+ turn.span.end(endTime === void 0 ? void 0 : { endTime });
34051
+ this.turnsByKey.delete(turn.key);
34052
+ this.state.update((current) => {
34053
+ const normalized = normalizeEveTraceState(current);
34054
+ return {
34055
+ ...normalized,
34056
+ stepStarts: normalized.stepStarts.filter(
34057
+ (entry) => entry.turnId !== turn.turnId
34058
+ )
34059
+ };
34060
+ });
34061
+ }
34062
+ cleanupSession(sessionId) {
34063
+ const keyPrefix = `${sessionId}:`;
34064
+ this.sessionsById.delete(sessionId);
34065
+ for (const key of this.turnsByKey.keys()) {
34066
+ if (key.startsWith(keyPrefix)) {
34067
+ this.turnsByKey.delete(key);
34068
+ }
34069
+ }
34070
+ for (const key of this.toolsByCallKey.keys()) {
34071
+ if (key.startsWith(keyPrefix)) {
34072
+ this.toolsByCallKey.delete(key);
34073
+ }
34074
+ }
34075
+ for (const key of this.completedToolKeys.keys()) {
34076
+ if (key.startsWith(keyPrefix)) {
34077
+ this.completedToolKeys.delete(key);
34078
+ }
34079
+ }
34080
+ this.state.update(() => emptyEveTraceState());
34081
+ }
34082
+ async flushInstrumentation() {
34083
+ try {
34084
+ await flush();
34085
+ return true;
34086
+ } catch (error) {
34087
+ debugLogger.warn("Error in Eve flush instrumentation:", error);
34088
+ return false;
34089
+ }
34090
+ }
34091
+ };
34092
+ function emptyEveTraceState() {
34093
+ return {
34094
+ llmInputs: [],
34095
+ metadata: {},
34096
+ spanReferences: [],
34097
+ stepStarts: []
34098
+ };
34099
+ }
34100
+ function normalizeEveTraceState(state) {
34101
+ if (!isObject(state)) {
34102
+ return emptyEveTraceState();
34103
+ }
34104
+ const metadata = isObject(state["metadata"]) ? state["metadata"] : {};
34105
+ const spanReferences = Array.isArray(state["spanReferences"]) ? state["spanReferences"].flatMap((entry) => {
34106
+ if (!isObject(entry)) {
34107
+ return [];
34108
+ }
34109
+ const exported = entry["exported"];
34110
+ const endTime = entry["endTime"];
34111
+ const rootSpanId = entry["rootSpanId"];
34112
+ const rowId = entry["rowId"];
34113
+ const spanId = entry["spanId"];
34114
+ const startEvent = entry["startEvent"];
34115
+ const startEventCreated = isObject(startEvent) ? startEvent["created"] : void 0;
34116
+ const startEventMetrics = isObject(startEvent) ? startEvent["metrics"] : void 0;
34117
+ const startEventSpanAttributes = isObject(startEvent) ? startEvent["span_attributes"] : void 0;
34118
+ const startEventSpanParents = isObject(startEvent) ? startEvent["span_parents"] : void 0;
34119
+ const normalizedStartEvent = typeof startEventCreated === "string" && isObject(startEventMetrics) && typeof startEventMetrics["start"] === "number" && Number.isFinite(startEventMetrics["start"]) && isObject(startEventSpanAttributes) && Array.isArray(startEventSpanParents) && startEventSpanParents.every(
34120
+ (parent) => typeof parent === "string"
34121
+ ) ? {
34122
+ created: startEventCreated,
34123
+ metrics: { start: startEventMetrics["start"] },
34124
+ span_attributes: { ...startEventSpanAttributes },
34125
+ span_parents: [...startEventSpanParents]
34126
+ } : void 0;
34127
+ return typeof exported === "string" && typeof rootSpanId === "string" && typeof rowId === "string" && typeof spanId === "string" ? [
34128
+ {
34129
+ ...typeof endTime === "number" && Number.isFinite(endTime) ? { endTime } : {},
34130
+ exported,
34131
+ rootSpanId,
34132
+ rowId,
34133
+ spanId,
34134
+ ...normalizedStartEvent ? { startEvent: normalizedStartEvent } : {}
34135
+ }
34136
+ ] : [];
34137
+ }).slice(-MAX_STORED_SPAN_REFERENCES) : [];
34138
+ const llmInputs = Array.isArray(state["llmInputs"]) ? state["llmInputs"].flatMap((entry) => {
34139
+ if (!isObject(entry)) {
34140
+ return [];
34141
+ }
34142
+ const key = entry["key"];
34143
+ const input = entry["input"];
34144
+ return typeof key === "string" && isCapturedModelInput(input) ? [{ input, key }] : [];
34145
+ }).slice(-MAX_STORED_LLM_INPUTS) : [];
34146
+ const stepStarts = Array.isArray(state["stepStarts"]) ? state["stepStarts"].flatMap((entry) => {
34147
+ if (!isObject(entry)) {
34148
+ return [];
34149
+ }
34150
+ const ordinal = entry["ordinal"];
34151
+ const open = entry["open"];
34152
+ const stepIndex = entry["stepIndex"];
34153
+ const turnId = entry["turnId"];
34154
+ 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 }] : [];
34155
+ }).slice(-MAX_STORED_STEP_STARTS) : [];
34156
+ return { llmInputs, metadata: { ...metadata }, spanReferences, stepStarts };
34157
+ }
34158
+ function readEveTraceState(state) {
34159
+ try {
34160
+ return normalizeEveTraceState(state.get());
34161
+ } catch {
34162
+ return emptyEveTraceState();
34163
+ }
34164
+ }
34165
+ function captureEveModelInput(state, input) {
34166
+ if (!isObject(input)) {
34167
+ return;
34168
+ }
34169
+ const session = input["session"];
34170
+ const turn = input["turn"];
34171
+ const step = input["step"];
34172
+ if (!isObject(session) || !isObject(turn) || !isObject(step)) {
34173
+ return;
34174
+ }
34175
+ const sessionId = session["id"];
34176
+ const turnId = turn["id"];
34177
+ const stepIndex = step["index"];
34178
+ if (typeof sessionId !== "string" || typeof turnId !== "string" || typeof stepIndex !== "number" || !Number.isInteger(stepIndex)) {
34179
+ return;
34180
+ }
34181
+ const captured = capturedModelInput(input["modelInput"]);
34182
+ if (!captured) {
34183
+ return;
34184
+ }
34185
+ const key = llmInputKey(sessionId, turnId, stepIndex);
34186
+ state.update((current) => {
34187
+ const normalized = normalizeEveTraceState(current);
34188
+ const llmInputs = [...normalized.llmInputs, { input: captured, key }];
34189
+ return {
34190
+ ...normalized,
34191
+ llmInputs: llmInputs.slice(-MAX_STORED_LLM_INPUTS)
34192
+ };
34193
+ });
34194
+ }
34195
+ function consumeCapturedEveModelInput(state, sessionId, turnId, stepIndex) {
34196
+ try {
34197
+ const key = llmInputKey(sessionId, turnId, stepIndex);
34198
+ let input;
34199
+ state.update((current) => {
34200
+ const normalized = normalizeEveTraceState(current);
34201
+ const index = normalized.llmInputs.findIndex(
34202
+ (candidate) => candidate.key === key
34203
+ );
34204
+ if (index < 0) {
34205
+ return normalized;
34206
+ }
34207
+ input = normalized.llmInputs[index]?.input;
34208
+ return {
34209
+ ...normalized,
34210
+ llmInputs: normalized.llmInputs.filter(
34211
+ (_, candidateIndex) => candidateIndex !== index
34212
+ )
34213
+ };
34214
+ });
34215
+ return input;
34216
+ } catch (error) {
34217
+ debugLogger.warn("Error in Eve LLM input consumption:", error);
34218
+ return void 0;
34219
+ }
34220
+ }
34221
+ function capturedModelInput(modelInput) {
34222
+ if (!isObject(modelInput)) {
34223
+ return void 0;
34224
+ }
34225
+ const messages = modelInput["messages"];
34226
+ if (!Array.isArray(messages)) {
34227
+ return void 0;
34228
+ }
34229
+ const instructions = modelInput["instructions"];
34230
+ const value = [
34231
+ ...instructions !== void 0 ? [{ content: instructions, role: "system" }] : [],
34232
+ ...messages
34233
+ ];
34234
+ try {
34235
+ const cloned = JSON.parse(JSON.stringify(value));
34236
+ if (!Array.isArray(cloned)) {
34237
+ return void 0;
34238
+ }
34239
+ return cloned;
34240
+ } catch {
34241
+ return void 0;
34242
+ }
34243
+ }
34244
+ function isCapturedModelInput(input) {
34245
+ return Array.isArray(input);
34246
+ }
34247
+ function llmInputKey(sessionId, turnId, stepIndex) {
34248
+ return `${sessionId}\0${turnId}\0${stepIndex}`;
34249
+ }
34250
+ function modelMetadataFromRuntime(runtime) {
34251
+ if (!isObject(runtime)) {
34252
+ return {};
34253
+ }
34254
+ const modelId = runtime["modelId"];
34255
+ return typeof modelId === "string" ? modelMetadataFromModelId(modelId) : {};
34256
+ }
34257
+ function modelMetadataFromModelId(modelId) {
34258
+ const normalized = modelId.trim();
34259
+ if (!normalized) {
34260
+ return {};
34261
+ }
34262
+ const slashIndex = normalized.indexOf("/");
34263
+ if (slashIndex > 0 && slashIndex < normalized.length - 1) {
34264
+ return {
34265
+ model: normalized.slice(slashIndex + 1),
34266
+ provider: normalized.slice(0, slashIndex)
34267
+ };
34268
+ }
34269
+ return {
34270
+ model: normalized
34271
+ };
34272
+ }
34273
+ function sessionIdFromContext(ctx) {
34274
+ if (!isObject(ctx)) {
34275
+ return void 0;
34276
+ }
34277
+ const session = ctx["session"];
34278
+ if (!isObject(session)) {
34279
+ return void 0;
34280
+ }
34281
+ const id = session["id"];
34282
+ return typeof id === "string" ? id : void 0;
34283
+ }
34284
+ function toolMetadataFromTurn(turn) {
34285
+ const { model: _model, provider: _provider, ...metadata } = turn.metadata;
34286
+ return metadata;
34287
+ }
34288
+ function parentLineageFromContext(ctx) {
34289
+ if (!isObject(ctx)) {
34290
+ return void 0;
34291
+ }
34292
+ const session = ctx.session;
34293
+ if (!isObject(session)) {
34294
+ return void 0;
34295
+ }
34296
+ const parent = session["parent"];
34297
+ if (!isObject(parent)) {
34298
+ return void 0;
34299
+ }
34300
+ const callId = parent["callId"];
34301
+ const rootSessionId = parent["rootSessionId"];
34302
+ const sessionId = parent["sessionId"];
34303
+ if (typeof callId !== "string" || typeof rootSessionId !== "string" || typeof sessionId !== "string") {
34304
+ return void 0;
34305
+ }
34306
+ return { callId, rootSessionId, sessionId };
34307
+ }
34308
+ function isToolCallAction(action) {
34309
+ return isObject(action) && action["kind"] === "tool-call" && typeof action["callId"] === "string" && typeof action["toolName"] === "string" && isObject(action["input"]);
34310
+ }
34311
+ function isLocalSubagentCallAction(action) {
34312
+ return isObject(action) && action["kind"] === "subagent-call" && typeof action["callId"] === "string" && isObject(action["input"]);
34313
+ }
34314
+ function isTraceableActionRequest(action) {
34315
+ return isToolCallAction(action) || isLocalSubagentCallAction(action);
34316
+ }
34317
+ function isToolResult(result) {
34318
+ return isObject(result) && result["kind"] === "tool-result" && typeof result["callId"] === "string" && typeof result["toolName"] === "string";
34319
+ }
34320
+ function isSubagentResult(result) {
34321
+ return isObject(result) && result["kind"] === "subagent-result" && typeof result["callId"] === "string" && typeof result["subagentName"] === "string";
34322
+ }
34323
+ function normalizedFinishReason(finishReason) {
34324
+ switch (finishReason) {
34325
+ case "content-filter":
34326
+ return "content_filter";
34327
+ case "tool-calls":
34328
+ return "tool_calls";
34329
+ default:
34330
+ return finishReason;
34331
+ }
34332
+ }
34333
+ function errorFromMessage(message, code, details) {
34334
+ const error = new Error(`${code}: ${message}`);
34335
+ if (details !== void 0) {
34336
+ error.cause = details;
34337
+ }
34338
+ return error;
34339
+ }
34340
+ function actionResultError(error, output) {
34341
+ if (error) {
34342
+ return errorFromMessage(error.message, error.code);
34343
+ }
34344
+ const result = new Error("Eve action failed");
34345
+ if (output !== void 0) {
34346
+ result.cause = output;
34347
+ }
34348
+ return result;
34349
+ }
34350
+ function eventTime2(event) {
34351
+ if (!event.meta?.at) {
34352
+ return void 0;
34353
+ }
34354
+ const timestamp = Date.parse(event.meta.at);
34355
+ return Number.isFinite(timestamp) ? timestamp / 1e3 : void 0;
34356
+ }
34357
+ function turnKey2(sessionId, turnId) {
34358
+ return `${sessionId}:${turnId}`;
34359
+ }
34360
+ function toolKey3(sessionId, callId) {
34361
+ return `${sessionId}:${callId}`;
34362
+ }
34363
+ async function rootSpanIdForSession(sessionId) {
34364
+ return deterministicEveId("eve:root", sessionId);
34365
+ }
34366
+ async function generateEveIds(kind, ...parts) {
34367
+ const [rowId, spanId] = await Promise.all([
34368
+ deterministicEveId(`eve:row:${kind}`, ...parts),
34369
+ deterministicEveId(`eve:${kind}`, ...parts)
34370
+ ]);
34371
+ return { rowId, spanId };
34372
+ }
34373
+ async function spanIdForSubagent(sessionId, callId) {
34374
+ return deterministicEveId("eve:subagent", sessionId, callId);
34375
+ }
34376
+ async function deterministicEveId(...parts) {
34377
+ const data = new TextEncoder().encode(
34378
+ parts.map((part) => `${part.length}:${part}`).join("\0")
34379
+ );
34380
+ const digest = await globalThis.crypto.subtle.digest("SHA-256", data);
34381
+ const bytes = Array.from(new Uint8Array(digest, 0, 16));
34382
+ const hex = bytes.map((byte) => byte.toString(16).padStart(2, "0")).join("");
34383
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
34384
+ }
34385
+
32857
34386
  // src/typed-instrumentation-helpers.ts
32858
34387
  var TypedApplyProxy = Proxy;
32859
34388
 
@@ -33085,7 +34614,13 @@ var BraintrustObservabilityExporter = class {
33085
34614
  const args = {
33086
34615
  name: exported.name,
33087
34616
  spanAttributes: { type: spanTypeFor(exported.type) },
33088
- startTime: epochSeconds(exported.startTime)
34617
+ startTime: epochSeconds(exported.startTime),
34618
+ // Use the Mastra span id as the Braintrust row id so that
34619
+ // `logFeedback({ id: <mastra span id> })` (and Mastra's score events)
34620
+ // attach to the right row. Without this, `SpanImpl` auto-generates a
34621
+ // row id (`this._id = eventId ?? idGenerator.getSpanId()`) that no
34622
+ // external caller could know.
34623
+ event: { id: exported.id }
33089
34624
  };
33090
34625
  const parentRecord = exported.parentSpanId ? this.spans.get(exported.parentSpanId) : void 0;
33091
34626
  if (!this.capturedParent) {
@@ -39420,6 +40955,8 @@ export {
39420
40955
  addAzureBlobHeaders,
39421
40956
  agentAssertionScorer,
39422
40957
  braintrustAISDKTelemetry,
40958
+ braintrustEveHook,
40959
+ braintrustEveInstrumentation,
39423
40960
  braintrustFlueInstrumentation,
39424
40961
  braintrustFlueObserver,
39425
40962
  braintrustStreamChunkSchema,