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.js CHANGED
@@ -93,6 +93,8 @@ __export(browser_exports, {
93
93
  addAzureBlobHeaders: () => addAzureBlobHeaders,
94
94
  agentAssertionScorer: () => agentAssertionScorer,
95
95
  braintrustAISDKTelemetry: () => braintrustAISDKTelemetry,
96
+ braintrustEveHook: () => braintrustEveHook,
97
+ braintrustEveInstrumentation: () => braintrustEveInstrumentation,
96
98
  braintrustFlueInstrumentation: () => braintrustFlueInstrumentation,
97
99
  braintrustFlueObserver: () => braintrustFlueObserver,
98
100
  braintrustStreamChunkSchema: () => braintrustStreamChunkSchema,
@@ -2387,19 +2389,30 @@ var CallEvent = import_v36.z.union([
2387
2389
  var ChatCompletionContentPartTextWithTitle = import_v36.z.object({
2388
2390
  text: import_v36.z.string().default(""),
2389
2391
  type: import_v36.z.literal("text"),
2390
- cache_control: import_v36.z.object({ type: import_v36.z.literal("ephemeral") }).optional()
2392
+ cache_control: import_v36.z.object({
2393
+ type: import_v36.z.literal("ephemeral"),
2394
+ ttl: import_v36.z.enum(["5m", "1h"]).optional()
2395
+ }).optional()
2391
2396
  });
2392
2397
  var ChatCompletionContentPartImageWithTitle = import_v36.z.object({
2393
2398
  image_url: import_v36.z.object({
2394
2399
  url: import_v36.z.string(),
2395
2400
  detail: import_v36.z.union([import_v36.z.literal("auto"), import_v36.z.literal("low"), import_v36.z.literal("high")]).optional()
2396
2401
  }),
2397
- type: import_v36.z.literal("image_url")
2402
+ type: import_v36.z.literal("image_url"),
2403
+ cache_control: import_v36.z.object({
2404
+ type: import_v36.z.literal("ephemeral"),
2405
+ ttl: import_v36.z.enum(["5m", "1h"]).optional()
2406
+ }).optional()
2398
2407
  });
2399
2408
  var ChatCompletionContentPartFileFile = import_v36.z.object({ file_data: import_v36.z.string(), filename: import_v36.z.string(), file_id: import_v36.z.string() }).partial();
2400
2409
  var ChatCompletionContentPartFileWithTitle = import_v36.z.object({
2401
2410
  file: ChatCompletionContentPartFileFile,
2402
- type: import_v36.z.literal("file")
2411
+ type: import_v36.z.literal("file"),
2412
+ cache_control: import_v36.z.object({
2413
+ type: import_v36.z.literal("ephemeral"),
2414
+ ttl: import_v36.z.enum(["5m", "1h"]).optional()
2415
+ }).optional()
2403
2416
  });
2404
2417
  var ChatCompletionContentPart = import_v36.z.union([
2405
2418
  ChatCompletionContentPartTextWithTitle,
@@ -2409,7 +2422,10 @@ var ChatCompletionContentPart = import_v36.z.union([
2409
2422
  var ChatCompletionContentPartText = import_v36.z.object({
2410
2423
  text: import_v36.z.string().default(""),
2411
2424
  type: import_v36.z.literal("text"),
2412
- cache_control: import_v36.z.object({ type: import_v36.z.literal("ephemeral") }).optional()
2425
+ cache_control: import_v36.z.object({
2426
+ type: import_v36.z.literal("ephemeral"),
2427
+ ttl: import_v36.z.enum(["5m", "1h"]).optional()
2428
+ }).optional()
2413
2429
  });
2414
2430
  var ChatCompletionMessageToolCall = import_v36.z.object({
2415
2431
  id: import_v36.z.string(),
@@ -4460,13 +4476,23 @@ var LRUCache = class {
4460
4476
  * @returns The cached value if found, undefined otherwise.
4461
4477
  */
4462
4478
  get(key) {
4463
- const value = this.cache.get(key);
4464
- if (value === void 0) {
4479
+ const entry = this.cache.get(key);
4480
+ if (entry === void 0) {
4465
4481
  return void 0;
4466
4482
  }
4467
4483
  this.cache.delete(key);
4468
- this.cache.set(key, value);
4469
- return value;
4484
+ this.cache.set(key, entry);
4485
+ return entry.value;
4486
+ }
4487
+ /**
4488
+ * Checks whether a key exists and marks it as most recently used.
4489
+ */
4490
+ has(key) {
4491
+ if (!this.cache.has(key)) {
4492
+ return false;
4493
+ }
4494
+ this.get(key);
4495
+ return true;
4470
4496
  }
4471
4497
  /**
4472
4498
  * Stores a value in the cache.
@@ -4483,7 +4509,38 @@ var LRUCache = class {
4483
4509
  const first = this.cache.keys().next().value;
4484
4510
  this.cache.delete(first);
4485
4511
  }
4486
- this.cache.set(key, value);
4512
+ this.cache.set(key, { value });
4513
+ }
4514
+ /**
4515
+ * Removes an item from the cache.
4516
+ */
4517
+ delete(key) {
4518
+ return this.cache.delete(key);
4519
+ }
4520
+ /**
4521
+ * Iterates over cache entries from least to most recently used.
4522
+ */
4523
+ *entries() {
4524
+ for (const [key, entry] of this.cache) {
4525
+ yield [key, entry.value];
4526
+ }
4527
+ }
4528
+ /**
4529
+ * Iterates over cache keys from least to most recently used.
4530
+ */
4531
+ keys() {
4532
+ return this.cache.keys();
4533
+ }
4534
+ /**
4535
+ * Iterates over cache values from least to most recently used.
4536
+ */
4537
+ *values() {
4538
+ for (const entry of this.cache.values()) {
4539
+ yield entry.value;
4540
+ }
4541
+ }
4542
+ [Symbol.iterator]() {
4543
+ return this.entries();
4487
4544
  }
4488
4545
  /**
4489
4546
  * Removes all items from the cache.
@@ -5041,6 +5098,9 @@ function applyMaskingToField(maskingFunction, data, fieldName) {
5041
5098
  return `ERROR: Failed to mask field '${fieldName}' - ${errorType}`;
5042
5099
  }
5043
5100
  }
5101
+ var INITIAL_SPAN_WRITE_AS_MERGE = /* @__PURE__ */ Symbol(
5102
+ "braintrust.initial-span-write-as-merge"
5103
+ );
5044
5104
  var BRAINTRUST_CURRENT_SPAN_STORE = /* @__PURE__ */ Symbol.for(
5045
5105
  "braintrust.currentSpanStore"
5046
5106
  );
@@ -8691,6 +8751,12 @@ var traceable = wrapTraced;
8691
8751
  function startSpan(args) {
8692
8752
  return startSpanAndIsLogger(args).span;
8693
8753
  }
8754
+ function _internalStartSpanWithInitialMerge(args) {
8755
+ return startSpanAndIsLogger({
8756
+ ...args,
8757
+ [INITIAL_SPAN_WRITE_AS_MERGE]: true
8758
+ }).span;
8759
+ }
8694
8760
  async function flush(options) {
8695
8761
  const state = options?.state ?? _globalState;
8696
8762
  return await state.bgLogger().flush();
@@ -9601,7 +9667,7 @@ var SpanImpl = class _SpanImpl {
9601
9667
  this._spanId = resolvedIds.spanId;
9602
9668
  this._rootSpanId = resolvedIds.rootSpanId;
9603
9669
  this._spanParents = resolvedIds.spanParents;
9604
- this.isMerge = false;
9670
+ this.isMerge = args[INITIAL_SPAN_WRITE_AS_MERGE] === true;
9605
9671
  this.logInternal({ event, internalData });
9606
9672
  this.isMerge = true;
9607
9673
  }
@@ -31545,6 +31611,8 @@ __export(exports_exports, {
31545
31611
  addAzureBlobHeaders: () => addAzureBlobHeaders,
31546
31612
  agentAssertionScorer: () => agentAssertionScorer,
31547
31613
  braintrustAISDKTelemetry: () => braintrustAISDKTelemetry,
31614
+ braintrustEveHook: () => braintrustEveHook,
31615
+ braintrustEveInstrumentation: () => braintrustEveInstrumentation,
31548
31616
  braintrustFlueInstrumentation: () => braintrustFlueInstrumentation,
31549
31617
  braintrustFlueObserver: () => braintrustFlueObserver,
31550
31618
  braintrustStreamChunkSchema: () => braintrustStreamChunkSchema,
@@ -33045,6 +33113,1469 @@ function BraintrustMiddleware(config = {}) {
33045
33113
  };
33046
33114
  }
33047
33115
 
33116
+ // src/instrumentation/plugins/eve-plugin.ts
33117
+ var EVE_TRACE_STATE_KEY = "braintrust.eve.tracing";
33118
+ var MAX_EVE_CACHE_ENTRIES = 1e4;
33119
+ var MAX_STORED_LLM_INPUTS = 100;
33120
+ var MAX_STORED_SPAN_REFERENCES = 1e4;
33121
+ var MAX_STORED_STEP_STARTS = 1e4;
33122
+ function braintrustEveHook(options) {
33123
+ const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
33124
+ const bridge = new EveBridge(state);
33125
+ return {
33126
+ events: {
33127
+ "*": async (event, ctx) => {
33128
+ await bridge.handle(event, ctx, options.metadata);
33129
+ }
33130
+ }
33131
+ };
33132
+ }
33133
+ function braintrustEveInstrumentation(options) {
33134
+ const state = options.defineState(EVE_TRACE_STATE_KEY, emptyEveTraceState);
33135
+ return {
33136
+ events: {
33137
+ "step.started": (input) => {
33138
+ try {
33139
+ captureEveModelInput(state, input);
33140
+ } catch (error) {
33141
+ debugLogger.warn("Error in Eve LLM input capture:", error);
33142
+ }
33143
+ }
33144
+ },
33145
+ recordInputs: false,
33146
+ recordOutputs: false,
33147
+ setup: options.setup
33148
+ };
33149
+ }
33150
+ function isEveHandleMessageStreamEvent(event) {
33151
+ return isObject(event) && typeof event["type"] === "string";
33152
+ }
33153
+ var ResumedEveSpan = class {
33154
+ constructor(reference) {
33155
+ this.reference = reference;
33156
+ this.endTime = reference.endTime;
33157
+ }
33158
+ endTime;
33159
+ get rootSpanId() {
33160
+ return this.reference.rootSpanId;
33161
+ }
33162
+ get spanId() {
33163
+ return this.reference.spanId;
33164
+ }
33165
+ log(event) {
33166
+ const metrics = {
33167
+ ...this.reference.startEvent?.metrics,
33168
+ ...this.endTime === void 0 ? {} : { end: this.endTime },
33169
+ ...event.metrics
33170
+ };
33171
+ updateSpan({
33172
+ exported: this.reference.exported,
33173
+ ...this.reference.startEvent,
33174
+ ...event,
33175
+ ...Object.keys(metrics).length > 0 ? { metrics } : {}
33176
+ });
33177
+ }
33178
+ end(args) {
33179
+ if (this.endTime === void 0) {
33180
+ this.endTime = args?.endTime ?? getCurrentUnixTimestamp();
33181
+ this.log({ metrics: { end: this.endTime } });
33182
+ }
33183
+ return this.endTime;
33184
+ }
33185
+ };
33186
+ var EveBridge = class {
33187
+ constructor(state) {
33188
+ this.state = state;
33189
+ }
33190
+ eventQueuesBySession = /* @__PURE__ */ new Map();
33191
+ sessionsById = new LRUCache({
33192
+ max: MAX_EVE_CACHE_ENTRIES
33193
+ });
33194
+ completedToolKeys = new LRUCache({
33195
+ max: MAX_EVE_CACHE_ENTRIES
33196
+ });
33197
+ toolsByCallKey = new LRUCache({
33198
+ max: MAX_EVE_CACHE_ENTRIES
33199
+ });
33200
+ turnsByKey = new LRUCache({
33201
+ max: MAX_EVE_CACHE_ENTRIES
33202
+ });
33203
+ async startEveSpan(args) {
33204
+ const rowId = args?.event?.id;
33205
+ const reference = typeof rowId === "string" && readEveTraceState(this.state).spanReferences.find(
33206
+ (candidate) => candidate.rowId === rowId
33207
+ );
33208
+ if (reference) {
33209
+ return new ResumedEveSpan(reference);
33210
+ }
33211
+ const startTime = args?.startTime ?? getCurrentUnixTimestamp();
33212
+ const parentSpanIds = args?.parentSpanIds;
33213
+ const startEvent = {
33214
+ created: (/* @__PURE__ */ new Date()).toISOString(),
33215
+ metrics: { start: startTime },
33216
+ span_attributes: {
33217
+ ...args?.name ? { name: args.name } : {},
33218
+ ...args?.type ? { type: args.type } : {},
33219
+ ...args?.spanAttributes
33220
+ },
33221
+ span_parents: parentSpanIds ? "spanId" in parentSpanIds ? [parentSpanIds.spanId] : parentSpanIds.parentSpanIds : []
33222
+ };
33223
+ const span = withCurrent(
33224
+ NOOP_SPAN,
33225
+ () => _internalStartSpanWithInitialMerge({ ...args, startTime })
33226
+ );
33227
+ if (typeof rowId !== "string") {
33228
+ return span;
33229
+ }
33230
+ try {
33231
+ const exported = await span.export();
33232
+ const reference2 = {
33233
+ exported,
33234
+ rootSpanId: span.rootSpanId,
33235
+ rowId,
33236
+ spanId: span.spanId,
33237
+ startEvent
33238
+ };
33239
+ this.state.update((current) => {
33240
+ const normalized = normalizeEveTraceState(current);
33241
+ return normalized.spanReferences.some(
33242
+ (candidate) => candidate.rowId === rowId
33243
+ ) ? normalized : {
33244
+ ...normalized,
33245
+ spanReferences: [...normalized.spanReferences, reference2].slice(
33246
+ -MAX_STORED_SPAN_REFERENCES
33247
+ )
33248
+ };
33249
+ });
33250
+ } catch (error) {
33251
+ debugLogger.warn("Error exporting Eve span for resumption:", error);
33252
+ }
33253
+ return span;
33254
+ }
33255
+ async startEveChildSpan(parent, args) {
33256
+ return await this.startEveSpan({
33257
+ ...args,
33258
+ parentSpanIds: {
33259
+ rootSpanId: parent.rootSpanId,
33260
+ spanId: parent.spanId
33261
+ }
33262
+ });
33263
+ }
33264
+ stepOrdinal(event) {
33265
+ let ordinal = 0;
33266
+ this.state.update((current) => {
33267
+ const state = normalizeEveTraceState(current);
33268
+ const previous = state.stepStarts.filter(
33269
+ (entry) => entry.turnId === event.data.turnId && entry.stepIndex === event.data.stepIndex
33270
+ ).at(-1);
33271
+ if (previous?.open) {
33272
+ ordinal = previous.ordinal;
33273
+ return state;
33274
+ }
33275
+ ordinal = state.stepStarts.filter(
33276
+ (entry) => entry.turnId === event.data.turnId
33277
+ ).length;
33278
+ return {
33279
+ ...state,
33280
+ stepStarts: [
33281
+ ...state.stepStarts,
33282
+ {
33283
+ open: true,
33284
+ ordinal,
33285
+ stepIndex: event.data.stepIndex,
33286
+ turnId: event.data.turnId
33287
+ }
33288
+ ].slice(-MAX_STORED_STEP_STARTS)
33289
+ };
33290
+ });
33291
+ return ordinal;
33292
+ }
33293
+ markStepEnded(turnId, stepIndex) {
33294
+ this.state.update((current) => {
33295
+ const state = normalizeEveTraceState(current);
33296
+ let index = -1;
33297
+ for (let i = state.stepStarts.length - 1; i >= 0; i--) {
33298
+ const entry = state.stepStarts[i];
33299
+ if (entry?.turnId === turnId && entry.stepIndex === stepIndex) {
33300
+ index = i;
33301
+ break;
33302
+ }
33303
+ }
33304
+ if (index < 0 || !state.stepStarts[index]?.open) {
33305
+ return state;
33306
+ }
33307
+ return {
33308
+ ...state,
33309
+ stepStarts: state.stepStarts.map(
33310
+ (entry, entryIndex) => entryIndex === index ? { ...entry, open: false } : entry
33311
+ )
33312
+ };
33313
+ });
33314
+ }
33315
+ async handle(event, ctx, hookMetadata) {
33316
+ if (!isEveHandleMessageStreamEvent(event)) {
33317
+ return;
33318
+ }
33319
+ const run = async () => {
33320
+ try {
33321
+ if (!await this.handleEvent(event, ctx, hookMetadata)) {
33322
+ return;
33323
+ }
33324
+ if (event.type === "session.failed") {
33325
+ const sessionId2 = event.data.sessionId || sessionIdFromContext(ctx);
33326
+ await this.flushInstrumentation();
33327
+ if (sessionId2) {
33328
+ this.cleanupSession(sessionId2);
33329
+ }
33330
+ } else if (event.type === "session.completed") {
33331
+ const sessionId2 = sessionIdFromContext(ctx);
33332
+ await this.flushInstrumentation();
33333
+ if (sessionId2) {
33334
+ this.cleanupSession(sessionId2);
33335
+ }
33336
+ }
33337
+ } catch (error) {
33338
+ debugLogger.warn("Error in Eve hook instrumentation:", error);
33339
+ }
33340
+ };
33341
+ const sessionId = event.type === "session.failed" ? event.data.sessionId || sessionIdFromContext(ctx) : sessionIdFromContext(ctx);
33342
+ if (!sessionId) {
33343
+ await run();
33344
+ return;
33345
+ }
33346
+ const previous = this.eventQueuesBySession.get(sessionId);
33347
+ const queued = previous ? previous.then(run) : run();
33348
+ this.eventQueuesBySession.set(sessionId, queued);
33349
+ try {
33350
+ await queued;
33351
+ } finally {
33352
+ if (this.eventQueuesBySession.get(sessionId) === queued) {
33353
+ this.eventQueuesBySession.delete(sessionId);
33354
+ }
33355
+ }
33356
+ }
33357
+ async handleEvent(event, ctx, hookMetadata) {
33358
+ switch (event.type) {
33359
+ case "session.started":
33360
+ await this.handleSessionStarted(event, ctx, hookMetadata);
33361
+ return true;
33362
+ case "turn.started":
33363
+ await this.handleTurnStarted(event, ctx, hookMetadata);
33364
+ return true;
33365
+ case "message.received":
33366
+ await this.handleMessageReceived(event, ctx, hookMetadata);
33367
+ return true;
33368
+ case "step.started":
33369
+ await this.handleStepStarted(event, ctx, hookMetadata);
33370
+ return true;
33371
+ case "message.completed":
33372
+ this.handleMessageCompleted(event, ctx);
33373
+ return true;
33374
+ case "result.completed":
33375
+ this.handleResultCompleted(event, ctx);
33376
+ return true;
33377
+ case "actions.requested":
33378
+ await this.handleActionsRequested(event, ctx, hookMetadata);
33379
+ return true;
33380
+ case "action.result":
33381
+ await this.handleActionResult(event, ctx, hookMetadata);
33382
+ return true;
33383
+ case "subagent.called":
33384
+ await this.handleSubagentCalled(event, ctx, hookMetadata);
33385
+ return true;
33386
+ case "subagent.completed":
33387
+ await this.handleSubagentCompleted(event, ctx, hookMetadata);
33388
+ return true;
33389
+ case "step.completed":
33390
+ this.handleStepCompleted(event, ctx);
33391
+ return true;
33392
+ case "step.failed":
33393
+ this.handleStepFailed(event, ctx);
33394
+ return true;
33395
+ case "turn.completed":
33396
+ await this.handleTurnCompleted(event, ctx);
33397
+ return true;
33398
+ case "turn.failed":
33399
+ await this.handleTurnFailed(event, ctx);
33400
+ return true;
33401
+ case "session.failed":
33402
+ await this.handleSessionFailed(event, ctx);
33403
+ return true;
33404
+ case "session.completed":
33405
+ await this.handleSessionCompleted(event, ctx);
33406
+ return true;
33407
+ default:
33408
+ return false;
33409
+ }
33410
+ }
33411
+ async handleSessionStarted(event, ctx, hookMetadata) {
33412
+ const sessionId = sessionIdFromContext(ctx);
33413
+ if (!sessionId) {
33414
+ return;
33415
+ }
33416
+ const metadata = {
33417
+ ...hookMetadata ?? {},
33418
+ ...modelMetadataFromRuntime(event.data.runtime)
33419
+ };
33420
+ this.state.update((current) => {
33421
+ const normalized = normalizeEveTraceState(current);
33422
+ return {
33423
+ ...normalized,
33424
+ metadata: { ...normalized.metadata, ...metadata }
33425
+ };
33426
+ });
33427
+ await this.ensureSession(sessionId, ctx, metadata, eventTime2(event));
33428
+ for (const [key, turn] of this.turnsByKey) {
33429
+ if (!key.startsWith(`${sessionId}:`)) {
33430
+ continue;
33431
+ }
33432
+ turn.metadata = { ...turn.metadata, ...metadata };
33433
+ turn.span.log({ metadata: turn.metadata });
33434
+ for (const step of turn.stepsByIndex.values()) {
33435
+ step.metadata = { ...step.metadata, ...metadata };
33436
+ step.span.log({ metadata: step.metadata });
33437
+ }
33438
+ }
33439
+ }
33440
+ async handleTurnStarted(event, ctx, hookMetadata) {
33441
+ const sessionId = sessionIdFromContext(ctx);
33442
+ if (!sessionId) {
33443
+ return;
33444
+ }
33445
+ const session = await this.ensureSession(
33446
+ sessionId,
33447
+ ctx,
33448
+ hookMetadata ?? {},
33449
+ eventTime2(event)
33450
+ );
33451
+ const key = turnKey2(sessionId, event.data.turnId);
33452
+ const metadata = { ...session.metadata };
33453
+ const existing = this.turnsByKey.get(key);
33454
+ if (existing) {
33455
+ existing.metadata = { ...existing.metadata, ...metadata };
33456
+ existing.span.log({ metadata: existing.metadata });
33457
+ return;
33458
+ }
33459
+ const span = await this.startTurnSpan(session, event, metadata);
33460
+ span.log({ metadata });
33461
+ this.turnsByKey.set(key, {
33462
+ key,
33463
+ metadata,
33464
+ metrics: {},
33465
+ span,
33466
+ stepsByIndex: /* @__PURE__ */ new Map(),
33467
+ turnId: event.data.turnId
33468
+ });
33469
+ }
33470
+ async handleMessageReceived(event, ctx, hookMetadata) {
33471
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33472
+ if (!turn) {
33473
+ return;
33474
+ }
33475
+ const input = [{ content: event.data.message, role: "user" }];
33476
+ turn.span.log({ input });
33477
+ }
33478
+ async handleStepStarted(event, ctx, hookMetadata) {
33479
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33480
+ const sessionId = sessionIdFromContext(ctx);
33481
+ if (!turn || !sessionId) {
33482
+ return;
33483
+ }
33484
+ const existing = turn.stepsByIndex.get(event.data.stepIndex);
33485
+ if (existing) {
33486
+ existing.span.log({
33487
+ ...existing.input !== void 0 ? { input: existing.input } : {},
33488
+ metadata: existing.metadata,
33489
+ metrics: existing.metrics,
33490
+ output: existing.output
33491
+ });
33492
+ const endTime = eventTime2(event);
33493
+ existing.span.end(endTime === void 0 ? void 0 : { endTime });
33494
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33495
+ }
33496
+ const stepOrdinal = this.stepOrdinal(event);
33497
+ const metadata = {
33498
+ ...turn.metadata,
33499
+ ...this.sessionsById.get(sessionId)?.metadata ?? {}
33500
+ };
33501
+ const input = consumeCapturedEveModelInput(
33502
+ this.state,
33503
+ sessionId,
33504
+ event.data.turnId,
33505
+ event.data.stepIndex
33506
+ );
33507
+ const { rowId: eventId, spanId } = await generateEveIds(
33508
+ "step",
33509
+ sessionId,
33510
+ event.data.turnId,
33511
+ String(stepOrdinal)
33512
+ );
33513
+ const span = await this.startEveChildSpan(turn.span, {
33514
+ event: {
33515
+ id: eventId,
33516
+ ...input !== void 0 ? { input } : {},
33517
+ metadata
33518
+ },
33519
+ name: "eve.step",
33520
+ spanAttributes: { type: "llm" /* LLM */ },
33521
+ spanId,
33522
+ startTime: eventTime2(event)
33523
+ });
33524
+ span.log({ ...input !== void 0 ? { input } : {}, metadata });
33525
+ turn.stepsByIndex.set(event.data.stepIndex, {
33526
+ ...input !== void 0 ? { input } : {},
33527
+ metadata,
33528
+ metrics: {},
33529
+ span
33530
+ });
33531
+ }
33532
+ handleMessageCompleted(event, ctx) {
33533
+ const step = this.stepForEvent(event, ctx);
33534
+ if (!step) {
33535
+ return;
33536
+ }
33537
+ const existingMessage = Array.isArray(step.output) && isObject(step.output[0]) ? step.output[0].message : void 0;
33538
+ const existingToolCalls = isObject(existingMessage) ? existingMessage.tool_calls : void 0;
33539
+ step.output = [
33540
+ {
33541
+ finish_reason: normalizedFinishReason(event.data.finishReason),
33542
+ index: 0,
33543
+ message: {
33544
+ content: event.data.message,
33545
+ role: "assistant",
33546
+ ...Array.isArray(existingToolCalls) ? { tool_calls: existingToolCalls } : {}
33547
+ }
33548
+ }
33549
+ ];
33550
+ const turn = this.turnForEvent(event, ctx);
33551
+ if (turn && event.data.finishReason !== "tool-calls") {
33552
+ turn.output = event.data.message;
33553
+ }
33554
+ }
33555
+ handleResultCompleted(event, ctx) {
33556
+ const step = this.stepForEvent(event, ctx);
33557
+ if (step) {
33558
+ step.output = [
33559
+ {
33560
+ finish_reason: "stop",
33561
+ index: 0,
33562
+ message: {
33563
+ content: event.data.result,
33564
+ role: "assistant"
33565
+ }
33566
+ }
33567
+ ];
33568
+ }
33569
+ const turn = this.turnForEvent(event, ctx);
33570
+ if (turn) {
33571
+ turn.output = event.data.result;
33572
+ }
33573
+ }
33574
+ async handleActionsRequested(event, ctx, hookMetadata) {
33575
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33576
+ const sessionId = sessionIdFromContext(ctx);
33577
+ if (!turn || !sessionId) {
33578
+ return;
33579
+ }
33580
+ const traceActions = event.data.actions.filter(isTraceableActionRequest);
33581
+ if (traceActions.length === 0) {
33582
+ return;
33583
+ }
33584
+ for (const action of traceActions) {
33585
+ if (isToolCallAction(action)) {
33586
+ await this.startRequestedTool(event, turn, sessionId, action);
33587
+ } else if (isLocalSubagentCallAction(action)) {
33588
+ await this.startRequestedSubagent(event, turn, sessionId, action);
33589
+ }
33590
+ }
33591
+ const step = turn.stepsByIndex.get(event.data.stepIndex);
33592
+ if (!step) {
33593
+ return;
33594
+ }
33595
+ step.output = [
33596
+ {
33597
+ finish_reason: "tool_calls",
33598
+ index: 0,
33599
+ message: {
33600
+ content: null,
33601
+ role: "assistant",
33602
+ tool_calls: traceActions.map((action) => {
33603
+ const name = action.kind === "tool-call" ? action.toolName : action.subagentName ?? action.name ?? "agent";
33604
+ return {
33605
+ function: {
33606
+ arguments: JSON.stringify(action.input),
33607
+ name
33608
+ },
33609
+ id: action.callId,
33610
+ type: "function"
33611
+ };
33612
+ })
33613
+ }
33614
+ }
33615
+ ];
33616
+ step.span.log({ metadata: step.metadata, output: step.output });
33617
+ }
33618
+ async handleActionResult(event, ctx, hookMetadata) {
33619
+ if (isToolResult(event.data.result)) {
33620
+ await this.handleToolResult(event, ctx, event.data.result, hookMetadata);
33621
+ return;
33622
+ }
33623
+ if (isSubagentResult(event.data.result)) {
33624
+ await this.handleSubagentResult(
33625
+ event,
33626
+ ctx,
33627
+ event.data.result,
33628
+ hookMetadata
33629
+ );
33630
+ }
33631
+ }
33632
+ async handleToolResult(event, ctx, result, hookMetadata) {
33633
+ const sessionId = sessionIdFromContext(ctx);
33634
+ if (!sessionId) {
33635
+ return;
33636
+ }
33637
+ const key = toolKey3(sessionId, result.callId);
33638
+ if (this.completedToolKeys.has(key)) {
33639
+ return;
33640
+ }
33641
+ const tool = this.toolsByCallKey.get(key) ?? await this.startSyntheticTool(event, ctx, result, hookMetadata);
33642
+ if (!tool) {
33643
+ return;
33644
+ }
33645
+ const failed = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
33646
+ tool.span.log({
33647
+ ...failed ? {
33648
+ error: actionResultError(event.data.error, result.output)
33649
+ } : {},
33650
+ metadata: tool.metadata,
33651
+ output: result.output
33652
+ });
33653
+ const endTime = eventTime2(event);
33654
+ tool.span.end(endTime === void 0 ? void 0 : { endTime });
33655
+ this.toolsByCallKey.delete(key);
33656
+ this.completedToolKeys.set(key, true);
33657
+ }
33658
+ async handleSubagentCalled(event, ctx, hookMetadata) {
33659
+ if (event.data.remote?.url) {
33660
+ return;
33661
+ }
33662
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
33663
+ const sessionId = sessionIdFromContext(ctx);
33664
+ if (!turn || !sessionId) {
33665
+ return;
33666
+ }
33667
+ const key = toolKey3(sessionId, event.data.callId);
33668
+ const metadata = toolMetadataFromTurn(turn);
33669
+ const existing = this.toolsByCallKey.get(key);
33670
+ if (existing) {
33671
+ existing.metadata = { ...existing.metadata, ...metadata };
33672
+ existing.span.log({ metadata: existing.metadata });
33673
+ return;
33674
+ }
33675
+ if (this.completedToolKeys.has(key)) {
33676
+ return;
33677
+ }
33678
+ const { rowId: eventId, spanId } = await generateEveIds(
33679
+ "subagent",
33680
+ sessionId,
33681
+ event.data.callId
33682
+ );
33683
+ const pending = this.toolsByCallKey.get(key);
33684
+ if (pending || this.completedToolKeys.has(key)) {
33685
+ if (pending) {
33686
+ pending.metadata = { ...pending.metadata, ...metadata };
33687
+ pending.span.log({ metadata: pending.metadata });
33688
+ }
33689
+ return;
33690
+ }
33691
+ const span = await this.startEveChildSpan(turn.span, {
33692
+ event: {
33693
+ id: eventId,
33694
+ metadata
33695
+ },
33696
+ name: event.data.toolName ?? event.data.name,
33697
+ spanAttributes: { type: "tool" /* TOOL */ },
33698
+ spanId,
33699
+ startTime: eventTime2(event)
33700
+ });
33701
+ span.log({ metadata });
33702
+ this.toolsByCallKey.set(key, {
33703
+ metadata,
33704
+ span,
33705
+ turnKey: turnKey2(sessionId, event.data.turnId)
33706
+ });
33707
+ }
33708
+ async handleSubagentCompleted(event, ctx, hookMetadata) {
33709
+ const sessionId = sessionIdFromContext(ctx);
33710
+ if (!sessionId) {
33711
+ return;
33712
+ }
33713
+ const key = toolKey3(sessionId, event.data.callId);
33714
+ if (this.completedToolKeys.has(key)) {
33715
+ return;
33716
+ }
33717
+ const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagent(event, ctx, hookMetadata);
33718
+ if (!subagent) {
33719
+ return;
33720
+ }
33721
+ subagent.span.log({
33722
+ ...event.data.status === "failed" ? {
33723
+ error: actionResultError(event.data.error, event.data.output)
33724
+ } : {},
33725
+ metadata: subagent.metadata,
33726
+ ...event.data.output !== void 0 ? { output: event.data.output } : {}
33727
+ });
33728
+ const endTime = eventTime2(event);
33729
+ const recordedEndTime = subagent.span.end(
33730
+ endTime === void 0 ? void 0 : { endTime }
33731
+ );
33732
+ this.state.update((current) => {
33733
+ const normalized = normalizeEveTraceState(current);
33734
+ return {
33735
+ ...normalized,
33736
+ spanReferences: normalized.spanReferences.map(
33737
+ (reference) => reference.spanId === subagent.span.spanId ? { ...reference, endTime: recordedEndTime } : reference
33738
+ )
33739
+ };
33740
+ });
33741
+ }
33742
+ async handleSubagentResult(event, ctx, result, hookMetadata) {
33743
+ const sessionId = sessionIdFromContext(ctx);
33744
+ if (!sessionId) {
33745
+ return;
33746
+ }
33747
+ const key = toolKey3(sessionId, result.callId);
33748
+ if (this.completedToolKeys.has(key)) {
33749
+ return;
33750
+ }
33751
+ const subagent = this.toolsByCallKey.get(key) ?? await this.startSyntheticSubagentResult(
33752
+ event,
33753
+ ctx,
33754
+ result,
33755
+ hookMetadata
33756
+ );
33757
+ if (!subagent) {
33758
+ return;
33759
+ }
33760
+ const isError = event.data.status === "failed" || result.isError === true || event.data.error !== void 0;
33761
+ subagent.span.log({
33762
+ ...isError ? {
33763
+ error: actionResultError(event.data.error, result.output)
33764
+ } : {},
33765
+ metadata: subagent.metadata,
33766
+ output: result.output
33767
+ });
33768
+ const endTime = eventTime2(event);
33769
+ subagent.span.end(endTime === void 0 ? void 0 : { endTime });
33770
+ this.toolsByCallKey.delete(key);
33771
+ this.completedToolKeys.set(key, true);
33772
+ }
33773
+ handleStepCompleted(event, ctx) {
33774
+ const step = this.stepForEvent(event, ctx);
33775
+ if (!step) {
33776
+ return;
33777
+ }
33778
+ const usage = event.data.usage;
33779
+ const inputTokens = typeof usage?.inputTokens === "number" && Number.isFinite(usage.inputTokens) && usage.inputTokens >= 0 ? usage.inputTokens : void 0;
33780
+ const outputTokens = typeof usage?.outputTokens === "number" && Number.isFinite(usage.outputTokens) && usage.outputTokens >= 0 ? usage.outputTokens : void 0;
33781
+ const cacheReadTokens = typeof usage?.cacheReadTokens === "number" && Number.isFinite(usage.cacheReadTokens) && usage.cacheReadTokens >= 0 ? usage.cacheReadTokens : void 0;
33782
+ const cacheWriteTokens = typeof usage?.cacheWriteTokens === "number" && Number.isFinite(usage.cacheWriteTokens) && usage.cacheWriteTokens >= 0 ? usage.cacheWriteTokens : void 0;
33783
+ const costUsd = typeof usage?.costUsd === "number" && Number.isFinite(usage.costUsd) && usage.costUsd >= 0 ? usage.costUsd : void 0;
33784
+ const total = inputTokens !== void 0 && outputTokens !== void 0 ? inputTokens + outputTokens : void 0;
33785
+ const metrics = {
33786
+ ...inputTokens !== void 0 ? { prompt_tokens: inputTokens } : {},
33787
+ ...outputTokens !== void 0 ? { completion_tokens: outputTokens } : {},
33788
+ ...total !== void 0 ? { tokens: total } : {},
33789
+ ...cacheReadTokens !== void 0 ? { prompt_cached_tokens: cacheReadTokens } : {},
33790
+ ...cacheWriteTokens !== void 0 ? { prompt_cache_creation_tokens: cacheWriteTokens } : {},
33791
+ ...costUsd !== void 0 ? { estimated_cost: costUsd } : {}
33792
+ };
33793
+ step.metrics = { ...step.metrics, ...metrics };
33794
+ if (Array.isArray(step.output) && isObject(step.output[0])) {
33795
+ const finishReason = step.output[0].finish_reason;
33796
+ if (typeof finishReason !== "string") {
33797
+ step.output[0].finish_reason = normalizedFinishReason(
33798
+ event.data.finishReason
33799
+ );
33800
+ }
33801
+ }
33802
+ step.span.log({
33803
+ ...step.input !== void 0 ? { input: step.input } : {},
33804
+ metadata: step.metadata,
33805
+ metrics,
33806
+ output: step.output
33807
+ });
33808
+ const endTime = eventTime2(event);
33809
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
33810
+ const turn = this.turnForEvent(event, ctx);
33811
+ if (turn) {
33812
+ for (const [key, value] of Object.entries(metrics)) {
33813
+ turn.metrics[key] = (turn.metrics[key] ?? 0) + value;
33814
+ }
33815
+ turn.stepsByIndex.delete(event.data.stepIndex);
33816
+ }
33817
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33818
+ }
33819
+ handleStepFailed(event, ctx) {
33820
+ const step = this.stepForEvent(event, ctx);
33821
+ if (step) {
33822
+ step.span.log({
33823
+ error: errorFromMessage(
33824
+ event.data.message,
33825
+ event.data.code,
33826
+ event.data.details
33827
+ )
33828
+ });
33829
+ const endTime = eventTime2(event);
33830
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
33831
+ }
33832
+ const turn = this.turnForEvent(event, ctx);
33833
+ turn?.stepsByIndex.delete(event.data.stepIndex);
33834
+ this.markStepEnded(event.data.turnId, event.data.stepIndex);
33835
+ }
33836
+ handleTurnCompleted(event, ctx) {
33837
+ const turn = this.turnForEvent(event, ctx);
33838
+ if (!turn) {
33839
+ return;
33840
+ }
33841
+ this.finalizeTurn(turn, {
33842
+ endTime: eventTime2(event)
33843
+ });
33844
+ }
33845
+ handleTurnFailed(event, ctx) {
33846
+ const turn = this.turnForEvent(event, ctx);
33847
+ if (!turn) {
33848
+ return;
33849
+ }
33850
+ this.finalizeTurn(turn, {
33851
+ endTime: eventTime2(event),
33852
+ error: errorFromMessage(
33853
+ event.data.message,
33854
+ event.data.code,
33855
+ event.data.details
33856
+ )
33857
+ });
33858
+ }
33859
+ async handleSessionFailed(event, ctx) {
33860
+ const sessionId = event.data.sessionId || sessionIdFromContext(ctx);
33861
+ if (!sessionId) {
33862
+ return;
33863
+ }
33864
+ const session = await this.ensureSession(
33865
+ sessionId,
33866
+ ctx,
33867
+ {},
33868
+ eventTime2(event)
33869
+ );
33870
+ const error = errorFromMessage(
33871
+ event.data.message,
33872
+ event.data.code,
33873
+ event.data.details
33874
+ );
33875
+ for (const [key, turn] of this.turnsByKey) {
33876
+ if (!key.startsWith(`${sessionId}:`)) {
33877
+ continue;
33878
+ }
33879
+ this.finalizeTurn(turn, {
33880
+ endTime: eventTime2(event),
33881
+ error
33882
+ });
33883
+ }
33884
+ for (const [key, tool] of this.toolsByCallKey) {
33885
+ if (key.startsWith(`${sessionId}:`)) {
33886
+ const endTime2 = eventTime2(event);
33887
+ if (!tool.endedByTurn) {
33888
+ tool.span.log({ metadata: tool.metadata });
33889
+ tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
33890
+ tool.endedByTurn = true;
33891
+ }
33892
+ }
33893
+ }
33894
+ session.span.log({ error });
33895
+ const endTime = eventTime2(event);
33896
+ session.span.end(endTime === void 0 ? void 0 : { endTime });
33897
+ }
33898
+ async handleSessionCompleted(event, ctx) {
33899
+ const sessionId = sessionIdFromContext(ctx);
33900
+ if (!sessionId) {
33901
+ return;
33902
+ }
33903
+ const session = await this.ensureSession(
33904
+ sessionId,
33905
+ ctx,
33906
+ {},
33907
+ eventTime2(event)
33908
+ );
33909
+ for (const [key, turn] of this.turnsByKey) {
33910
+ if (!key.startsWith(`${sessionId}:`)) {
33911
+ continue;
33912
+ }
33913
+ this.finalizeTurn(turn, {
33914
+ endTime: eventTime2(event)
33915
+ });
33916
+ }
33917
+ for (const [key, tool] of this.toolsByCallKey) {
33918
+ if (key.startsWith(`${sessionId}:`) && !tool.endedByTurn) {
33919
+ const endTime2 = eventTime2(event);
33920
+ tool.span.log({ metadata: tool.metadata });
33921
+ tool.span.end(endTime2 === void 0 ? void 0 : { endTime: endTime2 });
33922
+ tool.endedByTurn = true;
33923
+ }
33924
+ }
33925
+ session.span.log({ metadata: session.metadata });
33926
+ const endTime = eventTime2(event);
33927
+ session.span.end(endTime === void 0 ? void 0 : { endTime });
33928
+ }
33929
+ async ensureSession(sessionId, ctx, metadata, startTime) {
33930
+ metadata = {
33931
+ ...readEveTraceState(this.state).metadata,
33932
+ ...metadata
33933
+ };
33934
+ const existing = this.sessionsById.get(sessionId);
33935
+ if (existing) {
33936
+ existing.metadata = { ...existing.metadata, ...metadata };
33937
+ existing.span.log({ metadata: existing.metadata });
33938
+ return existing;
33939
+ }
33940
+ const lineage = parentLineageFromContext(ctx);
33941
+ const parentSubagent = lineage ? this.toolsByCallKey.get(toolKey3(lineage.sessionId, lineage.callId)) : void 0;
33942
+ const activeParent = currentSpan();
33943
+ const [
33944
+ { rowId: eventId, spanId },
33945
+ parentSubagentSpanId,
33946
+ fallbackRootSpanId
33947
+ ] = await Promise.all([
33948
+ generateEveIds("session", sessionId),
33949
+ lineage ? spanIdForSubagent(lineage.sessionId, lineage.callId) : Promise.resolve(void 0),
33950
+ lineage ? rootSpanIdForSession(lineage.rootSessionId) : rootSpanIdForSession(sessionId)
33951
+ ]);
33952
+ const span = await this.startEveSpan({
33953
+ event: {
33954
+ id: eventId,
33955
+ metadata
33956
+ },
33957
+ name: "eve.session",
33958
+ parentSpanIds: lineage && parentSubagentSpanId ? {
33959
+ rootSpanId: parentSubagent?.span.rootSpanId ?? fallbackRootSpanId,
33960
+ spanId: parentSubagentSpanId
33961
+ } : !Object.is(activeParent, NOOP_SPAN) ? {
33962
+ rootSpanId: activeParent.rootSpanId,
33963
+ spanId: activeParent.spanId
33964
+ } : {
33965
+ parentSpanIds: [],
33966
+ rootSpanId: fallbackRootSpanId
33967
+ },
33968
+ spanAttributes: { type: "task" /* TASK */ },
33969
+ spanId,
33970
+ startTime
33971
+ });
33972
+ span.log({ metadata });
33973
+ const session = { metadata, sessionId, span };
33974
+ this.sessionsById.set(sessionId, session);
33975
+ return session;
33976
+ }
33977
+ async ensureTurn(event, ctx, hookMetadata) {
33978
+ const sessionId = sessionIdFromContext(ctx);
33979
+ if (!sessionId) {
33980
+ return void 0;
33981
+ }
33982
+ const session = await this.ensureSession(
33983
+ sessionId,
33984
+ ctx,
33985
+ hookMetadata ?? {},
33986
+ eventTime2(event)
33987
+ );
33988
+ const key = turnKey2(sessionId, event.data.turnId);
33989
+ const existing = this.turnsByKey.get(key);
33990
+ if (existing) {
33991
+ return existing;
33992
+ }
33993
+ const metadata = { ...session.metadata };
33994
+ const span = await this.startTurnSpan(session, event, metadata);
33995
+ span.log({ metadata });
33996
+ const state = {
33997
+ key,
33998
+ metadata,
33999
+ metrics: {},
34000
+ span,
34001
+ stepsByIndex: /* @__PURE__ */ new Map(),
34002
+ turnId: event.data.turnId
34003
+ };
34004
+ this.turnsByKey.set(key, state);
34005
+ return state;
34006
+ }
34007
+ async startRequestedTool(event, turn, sessionId, action) {
34008
+ const key = toolKey3(sessionId, action.callId);
34009
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
34010
+ return;
34011
+ }
34012
+ const metadata = toolMetadataFromTurn(turn);
34013
+ const { rowId: eventId, spanId } = await generateEveIds(
34014
+ "tool",
34015
+ sessionId,
34016
+ event.data.turnId,
34017
+ action.callId
34018
+ );
34019
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
34020
+ return;
34021
+ }
34022
+ const span = await this.startEveChildSpan(turn.span, {
34023
+ event: {
34024
+ id: eventId,
34025
+ input: action.input,
34026
+ metadata
34027
+ },
34028
+ name: action.toolName,
34029
+ spanAttributes: { type: "tool" /* TOOL */ },
34030
+ spanId,
34031
+ startTime: eventTime2(event)
34032
+ });
34033
+ span.log({ input: action.input, metadata });
34034
+ this.toolsByCallKey.set(key, {
34035
+ metadata,
34036
+ span,
34037
+ turnKey: turnKey2(sessionId, event.data.turnId)
34038
+ });
34039
+ }
34040
+ async startRequestedSubagent(event, turn, sessionId, action) {
34041
+ const key = toolKey3(sessionId, action.callId);
34042
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
34043
+ return;
34044
+ }
34045
+ const name = action.subagentName ?? action.name ?? "agent";
34046
+ const metadata = toolMetadataFromTurn(turn);
34047
+ const { rowId: eventId, spanId } = await generateEveIds(
34048
+ "subagent",
34049
+ sessionId,
34050
+ action.callId
34051
+ );
34052
+ if (this.toolsByCallKey.has(key) || this.completedToolKeys.has(key)) {
34053
+ return;
34054
+ }
34055
+ const span = await this.startEveChildSpan(turn.span, {
34056
+ event: {
34057
+ id: eventId,
34058
+ input: action.input,
34059
+ metadata
34060
+ },
34061
+ name,
34062
+ spanAttributes: { type: "tool" /* TOOL */ },
34063
+ spanId,
34064
+ startTime: eventTime2(event)
34065
+ });
34066
+ span.log({ input: action.input, metadata });
34067
+ this.toolsByCallKey.set(key, {
34068
+ metadata,
34069
+ span,
34070
+ turnKey: turnKey2(sessionId, event.data.turnId)
34071
+ });
34072
+ }
34073
+ async startSyntheticTool(event, ctx, result, hookMetadata) {
34074
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
34075
+ const sessionId = sessionIdFromContext(ctx);
34076
+ if (!turn || !sessionId) {
34077
+ return void 0;
34078
+ }
34079
+ const metadata = toolMetadataFromTurn(turn);
34080
+ const { rowId: eventId, spanId } = await generateEveIds(
34081
+ "tool",
34082
+ sessionId,
34083
+ event.data.turnId,
34084
+ result.callId
34085
+ );
34086
+ const existing = this.toolsByCallKey.get(toolKey3(sessionId, result.callId));
34087
+ if (existing) {
34088
+ return existing;
34089
+ }
34090
+ const span = await this.startEveChildSpan(turn.span, {
34091
+ event: {
34092
+ id: eventId,
34093
+ metadata
34094
+ },
34095
+ name: result.toolName,
34096
+ spanAttributes: { type: "tool" /* TOOL */ },
34097
+ spanId,
34098
+ startTime: eventTime2(event)
34099
+ });
34100
+ span.log({ metadata });
34101
+ const state = {
34102
+ metadata,
34103
+ span,
34104
+ turnKey: turnKey2(sessionId, event.data.turnId)
34105
+ };
34106
+ this.toolsByCallKey.set(toolKey3(sessionId, result.callId), state);
34107
+ return state;
34108
+ }
34109
+ async startSyntheticSubagent(event, ctx, hookMetadata) {
34110
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
34111
+ const sessionId = sessionIdFromContext(ctx);
34112
+ if (!turn || !sessionId) {
34113
+ return void 0;
34114
+ }
34115
+ const metadata = toolMetadataFromTurn(turn);
34116
+ const { rowId: eventId, spanId } = await generateEveIds(
34117
+ "subagent",
34118
+ sessionId,
34119
+ event.data.callId
34120
+ );
34121
+ const existing = this.toolsByCallKey.get(
34122
+ toolKey3(sessionId, event.data.callId)
34123
+ );
34124
+ if (existing) {
34125
+ return existing;
34126
+ }
34127
+ const span = await this.startEveChildSpan(turn.span, {
34128
+ event: {
34129
+ id: eventId,
34130
+ metadata
34131
+ },
34132
+ name: event.data.subagentName,
34133
+ spanAttributes: { type: "tool" /* TOOL */ },
34134
+ spanId,
34135
+ startTime: eventTime2(event)
34136
+ });
34137
+ span.log({ metadata });
34138
+ const state = {
34139
+ metadata,
34140
+ span,
34141
+ turnKey: turnKey2(sessionId, event.data.turnId)
34142
+ };
34143
+ this.toolsByCallKey.set(toolKey3(sessionId, event.data.callId), state);
34144
+ return state;
34145
+ }
34146
+ async startSyntheticSubagentResult(event, ctx, result, hookMetadata) {
34147
+ const turn = await this.ensureTurn(event, ctx, hookMetadata);
34148
+ const sessionId = sessionIdFromContext(ctx);
34149
+ if (!turn || !sessionId) {
34150
+ return void 0;
34151
+ }
34152
+ const metadata = toolMetadataFromTurn(turn);
34153
+ const { rowId: eventId, spanId } = await generateEveIds(
34154
+ "subagent",
34155
+ sessionId,
34156
+ result.callId
34157
+ );
34158
+ const existing = this.toolsByCallKey.get(toolKey3(sessionId, result.callId));
34159
+ if (existing) {
34160
+ return existing;
34161
+ }
34162
+ const span = await this.startEveChildSpan(turn.span, {
34163
+ event: {
34164
+ id: eventId,
34165
+ metadata
34166
+ },
34167
+ name: result.subagentName,
34168
+ spanAttributes: { type: "tool" /* TOOL */ },
34169
+ spanId,
34170
+ startTime: eventTime2(event)
34171
+ });
34172
+ span.log({ metadata });
34173
+ const state = {
34174
+ metadata,
34175
+ span,
34176
+ turnKey: turnKey2(sessionId, event.data.turnId)
34177
+ };
34178
+ this.toolsByCallKey.set(toolKey3(sessionId, result.callId), state);
34179
+ return state;
34180
+ }
34181
+ async startTurnSpan(session, event, metadata) {
34182
+ const { rowId: eventId, spanId } = await generateEveIds(
34183
+ "turn",
34184
+ session.sessionId,
34185
+ event.data.turnId
34186
+ );
34187
+ return await this.startEveSpan({
34188
+ event: {
34189
+ id: eventId,
34190
+ metadata
34191
+ },
34192
+ name: "eve.turn",
34193
+ parentSpanIds: {
34194
+ rootSpanId: session.span.rootSpanId,
34195
+ spanId: session.span.spanId
34196
+ },
34197
+ spanAttributes: { type: "task" /* TASK */ },
34198
+ spanId,
34199
+ startTime: eventTime2(event)
34200
+ });
34201
+ }
34202
+ turnForEvent(event, ctx) {
34203
+ const sessionId = sessionIdFromContext(ctx);
34204
+ return sessionId ? this.turnsByKey.get(turnKey2(sessionId, event.data.turnId)) : void 0;
34205
+ }
34206
+ stepForEvent(event, ctx) {
34207
+ return this.turnForEvent(event, ctx)?.stepsByIndex.get(
34208
+ event.data.stepIndex
34209
+ );
34210
+ }
34211
+ finalizeTurn(turn, args) {
34212
+ const { endTime } = args;
34213
+ for (const step of turn.stepsByIndex.values()) {
34214
+ step.span.log({
34215
+ ...step.input !== void 0 ? { input: step.input } : {},
34216
+ metadata: step.metadata,
34217
+ metrics: step.metrics,
34218
+ output: step.output
34219
+ });
34220
+ step.span.end(endTime === void 0 ? void 0 : { endTime });
34221
+ }
34222
+ turn.stepsByIndex.clear();
34223
+ for (const tool of this.toolsByCallKey.values()) {
34224
+ if (tool.turnKey !== turn.key) {
34225
+ continue;
34226
+ }
34227
+ if (tool.endedByTurn) {
34228
+ continue;
34229
+ }
34230
+ tool.span.log({ metadata: tool.metadata });
34231
+ tool.span.end(endTime === void 0 ? void 0 : { endTime });
34232
+ tool.endedByTurn = true;
34233
+ }
34234
+ if (args.error) {
34235
+ turn.span.log({ error: args.error });
34236
+ } else {
34237
+ turn.span.log({
34238
+ metadata: turn.metadata,
34239
+ metrics: turn.metrics,
34240
+ output: turn.output
34241
+ });
34242
+ }
34243
+ turn.span.end(endTime === void 0 ? void 0 : { endTime });
34244
+ this.turnsByKey.delete(turn.key);
34245
+ this.state.update((current) => {
34246
+ const normalized = normalizeEveTraceState(current);
34247
+ return {
34248
+ ...normalized,
34249
+ stepStarts: normalized.stepStarts.filter(
34250
+ (entry) => entry.turnId !== turn.turnId
34251
+ )
34252
+ };
34253
+ });
34254
+ }
34255
+ cleanupSession(sessionId) {
34256
+ const keyPrefix = `${sessionId}:`;
34257
+ this.sessionsById.delete(sessionId);
34258
+ for (const key of this.turnsByKey.keys()) {
34259
+ if (key.startsWith(keyPrefix)) {
34260
+ this.turnsByKey.delete(key);
34261
+ }
34262
+ }
34263
+ for (const key of this.toolsByCallKey.keys()) {
34264
+ if (key.startsWith(keyPrefix)) {
34265
+ this.toolsByCallKey.delete(key);
34266
+ }
34267
+ }
34268
+ for (const key of this.completedToolKeys.keys()) {
34269
+ if (key.startsWith(keyPrefix)) {
34270
+ this.completedToolKeys.delete(key);
34271
+ }
34272
+ }
34273
+ this.state.update(() => emptyEveTraceState());
34274
+ }
34275
+ async flushInstrumentation() {
34276
+ try {
34277
+ await flush();
34278
+ return true;
34279
+ } catch (error) {
34280
+ debugLogger.warn("Error in Eve flush instrumentation:", error);
34281
+ return false;
34282
+ }
34283
+ }
34284
+ };
34285
+ function emptyEveTraceState() {
34286
+ return {
34287
+ llmInputs: [],
34288
+ metadata: {},
34289
+ spanReferences: [],
34290
+ stepStarts: []
34291
+ };
34292
+ }
34293
+ function normalizeEveTraceState(state) {
34294
+ if (!isObject(state)) {
34295
+ return emptyEveTraceState();
34296
+ }
34297
+ const metadata = isObject(state["metadata"]) ? state["metadata"] : {};
34298
+ const spanReferences = Array.isArray(state["spanReferences"]) ? state["spanReferences"].flatMap((entry) => {
34299
+ if (!isObject(entry)) {
34300
+ return [];
34301
+ }
34302
+ const exported = entry["exported"];
34303
+ const endTime = entry["endTime"];
34304
+ const rootSpanId = entry["rootSpanId"];
34305
+ const rowId = entry["rowId"];
34306
+ const spanId = entry["spanId"];
34307
+ const startEvent = entry["startEvent"];
34308
+ const startEventCreated = isObject(startEvent) ? startEvent["created"] : void 0;
34309
+ const startEventMetrics = isObject(startEvent) ? startEvent["metrics"] : void 0;
34310
+ const startEventSpanAttributes = isObject(startEvent) ? startEvent["span_attributes"] : void 0;
34311
+ const startEventSpanParents = isObject(startEvent) ? startEvent["span_parents"] : void 0;
34312
+ const normalizedStartEvent = typeof startEventCreated === "string" && isObject(startEventMetrics) && typeof startEventMetrics["start"] === "number" && Number.isFinite(startEventMetrics["start"]) && isObject(startEventSpanAttributes) && Array.isArray(startEventSpanParents) && startEventSpanParents.every(
34313
+ (parent) => typeof parent === "string"
34314
+ ) ? {
34315
+ created: startEventCreated,
34316
+ metrics: { start: startEventMetrics["start"] },
34317
+ span_attributes: { ...startEventSpanAttributes },
34318
+ span_parents: [...startEventSpanParents]
34319
+ } : void 0;
34320
+ return typeof exported === "string" && typeof rootSpanId === "string" && typeof rowId === "string" && typeof spanId === "string" ? [
34321
+ {
34322
+ ...typeof endTime === "number" && Number.isFinite(endTime) ? { endTime } : {},
34323
+ exported,
34324
+ rootSpanId,
34325
+ rowId,
34326
+ spanId,
34327
+ ...normalizedStartEvent ? { startEvent: normalizedStartEvent } : {}
34328
+ }
34329
+ ] : [];
34330
+ }).slice(-MAX_STORED_SPAN_REFERENCES) : [];
34331
+ const llmInputs = Array.isArray(state["llmInputs"]) ? state["llmInputs"].flatMap((entry) => {
34332
+ if (!isObject(entry)) {
34333
+ return [];
34334
+ }
34335
+ const key = entry["key"];
34336
+ const input = entry["input"];
34337
+ return typeof key === "string" && isCapturedModelInput(input) ? [{ input, key }] : [];
34338
+ }).slice(-MAX_STORED_LLM_INPUTS) : [];
34339
+ const stepStarts = Array.isArray(state["stepStarts"]) ? state["stepStarts"].flatMap((entry) => {
34340
+ if (!isObject(entry)) {
34341
+ return [];
34342
+ }
34343
+ const ordinal = entry["ordinal"];
34344
+ const open = entry["open"];
34345
+ const stepIndex = entry["stepIndex"];
34346
+ const turnId = entry["turnId"];
34347
+ 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 }] : [];
34348
+ }).slice(-MAX_STORED_STEP_STARTS) : [];
34349
+ return { llmInputs, metadata: { ...metadata }, spanReferences, stepStarts };
34350
+ }
34351
+ function readEveTraceState(state) {
34352
+ try {
34353
+ return normalizeEveTraceState(state.get());
34354
+ } catch {
34355
+ return emptyEveTraceState();
34356
+ }
34357
+ }
34358
+ function captureEveModelInput(state, input) {
34359
+ if (!isObject(input)) {
34360
+ return;
34361
+ }
34362
+ const session = input["session"];
34363
+ const turn = input["turn"];
34364
+ const step = input["step"];
34365
+ if (!isObject(session) || !isObject(turn) || !isObject(step)) {
34366
+ return;
34367
+ }
34368
+ const sessionId = session["id"];
34369
+ const turnId = turn["id"];
34370
+ const stepIndex = step["index"];
34371
+ if (typeof sessionId !== "string" || typeof turnId !== "string" || typeof stepIndex !== "number" || !Number.isInteger(stepIndex)) {
34372
+ return;
34373
+ }
34374
+ const captured = capturedModelInput(input["modelInput"]);
34375
+ if (!captured) {
34376
+ return;
34377
+ }
34378
+ const key = llmInputKey(sessionId, turnId, stepIndex);
34379
+ state.update((current) => {
34380
+ const normalized = normalizeEveTraceState(current);
34381
+ const llmInputs = [...normalized.llmInputs, { input: captured, key }];
34382
+ return {
34383
+ ...normalized,
34384
+ llmInputs: llmInputs.slice(-MAX_STORED_LLM_INPUTS)
34385
+ };
34386
+ });
34387
+ }
34388
+ function consumeCapturedEveModelInput(state, sessionId, turnId, stepIndex) {
34389
+ try {
34390
+ const key = llmInputKey(sessionId, turnId, stepIndex);
34391
+ let input;
34392
+ state.update((current) => {
34393
+ const normalized = normalizeEveTraceState(current);
34394
+ const index = normalized.llmInputs.findIndex(
34395
+ (candidate) => candidate.key === key
34396
+ );
34397
+ if (index < 0) {
34398
+ return normalized;
34399
+ }
34400
+ input = normalized.llmInputs[index]?.input;
34401
+ return {
34402
+ ...normalized,
34403
+ llmInputs: normalized.llmInputs.filter(
34404
+ (_, candidateIndex) => candidateIndex !== index
34405
+ )
34406
+ };
34407
+ });
34408
+ return input;
34409
+ } catch (error) {
34410
+ debugLogger.warn("Error in Eve LLM input consumption:", error);
34411
+ return void 0;
34412
+ }
34413
+ }
34414
+ function capturedModelInput(modelInput) {
34415
+ if (!isObject(modelInput)) {
34416
+ return void 0;
34417
+ }
34418
+ const messages = modelInput["messages"];
34419
+ if (!Array.isArray(messages)) {
34420
+ return void 0;
34421
+ }
34422
+ const instructions = modelInput["instructions"];
34423
+ const value = [
34424
+ ...instructions !== void 0 ? [{ content: instructions, role: "system" }] : [],
34425
+ ...messages
34426
+ ];
34427
+ try {
34428
+ const cloned = JSON.parse(JSON.stringify(value));
34429
+ if (!Array.isArray(cloned)) {
34430
+ return void 0;
34431
+ }
34432
+ return cloned;
34433
+ } catch {
34434
+ return void 0;
34435
+ }
34436
+ }
34437
+ function isCapturedModelInput(input) {
34438
+ return Array.isArray(input);
34439
+ }
34440
+ function llmInputKey(sessionId, turnId, stepIndex) {
34441
+ return `${sessionId}\0${turnId}\0${stepIndex}`;
34442
+ }
34443
+ function modelMetadataFromRuntime(runtime) {
34444
+ if (!isObject(runtime)) {
34445
+ return {};
34446
+ }
34447
+ const modelId = runtime["modelId"];
34448
+ return typeof modelId === "string" ? modelMetadataFromModelId(modelId) : {};
34449
+ }
34450
+ function modelMetadataFromModelId(modelId) {
34451
+ const normalized = modelId.trim();
34452
+ if (!normalized) {
34453
+ return {};
34454
+ }
34455
+ const slashIndex = normalized.indexOf("/");
34456
+ if (slashIndex > 0 && slashIndex < normalized.length - 1) {
34457
+ return {
34458
+ model: normalized.slice(slashIndex + 1),
34459
+ provider: normalized.slice(0, slashIndex)
34460
+ };
34461
+ }
34462
+ return {
34463
+ model: normalized
34464
+ };
34465
+ }
34466
+ function sessionIdFromContext(ctx) {
34467
+ if (!isObject(ctx)) {
34468
+ return void 0;
34469
+ }
34470
+ const session = ctx["session"];
34471
+ if (!isObject(session)) {
34472
+ return void 0;
34473
+ }
34474
+ const id = session["id"];
34475
+ return typeof id === "string" ? id : void 0;
34476
+ }
34477
+ function toolMetadataFromTurn(turn) {
34478
+ const { model: _model, provider: _provider, ...metadata } = turn.metadata;
34479
+ return metadata;
34480
+ }
34481
+ function parentLineageFromContext(ctx) {
34482
+ if (!isObject(ctx)) {
34483
+ return void 0;
34484
+ }
34485
+ const session = ctx.session;
34486
+ if (!isObject(session)) {
34487
+ return void 0;
34488
+ }
34489
+ const parent = session["parent"];
34490
+ if (!isObject(parent)) {
34491
+ return void 0;
34492
+ }
34493
+ const callId = parent["callId"];
34494
+ const rootSessionId = parent["rootSessionId"];
34495
+ const sessionId = parent["sessionId"];
34496
+ if (typeof callId !== "string" || typeof rootSessionId !== "string" || typeof sessionId !== "string") {
34497
+ return void 0;
34498
+ }
34499
+ return { callId, rootSessionId, sessionId };
34500
+ }
34501
+ function isToolCallAction(action) {
34502
+ return isObject(action) && action["kind"] === "tool-call" && typeof action["callId"] === "string" && typeof action["toolName"] === "string" && isObject(action["input"]);
34503
+ }
34504
+ function isLocalSubagentCallAction(action) {
34505
+ return isObject(action) && action["kind"] === "subagent-call" && typeof action["callId"] === "string" && isObject(action["input"]);
34506
+ }
34507
+ function isTraceableActionRequest(action) {
34508
+ return isToolCallAction(action) || isLocalSubagentCallAction(action);
34509
+ }
34510
+ function isToolResult(result) {
34511
+ return isObject(result) && result["kind"] === "tool-result" && typeof result["callId"] === "string" && typeof result["toolName"] === "string";
34512
+ }
34513
+ function isSubagentResult(result) {
34514
+ return isObject(result) && result["kind"] === "subagent-result" && typeof result["callId"] === "string" && typeof result["subagentName"] === "string";
34515
+ }
34516
+ function normalizedFinishReason(finishReason) {
34517
+ switch (finishReason) {
34518
+ case "content-filter":
34519
+ return "content_filter";
34520
+ case "tool-calls":
34521
+ return "tool_calls";
34522
+ default:
34523
+ return finishReason;
34524
+ }
34525
+ }
34526
+ function errorFromMessage(message, code, details) {
34527
+ const error = new Error(`${code}: ${message}`);
34528
+ if (details !== void 0) {
34529
+ error.cause = details;
34530
+ }
34531
+ return error;
34532
+ }
34533
+ function actionResultError(error, output) {
34534
+ if (error) {
34535
+ return errorFromMessage(error.message, error.code);
34536
+ }
34537
+ const result = new Error("Eve action failed");
34538
+ if (output !== void 0) {
34539
+ result.cause = output;
34540
+ }
34541
+ return result;
34542
+ }
34543
+ function eventTime2(event) {
34544
+ if (!event.meta?.at) {
34545
+ return void 0;
34546
+ }
34547
+ const timestamp = Date.parse(event.meta.at);
34548
+ return Number.isFinite(timestamp) ? timestamp / 1e3 : void 0;
34549
+ }
34550
+ function turnKey2(sessionId, turnId) {
34551
+ return `${sessionId}:${turnId}`;
34552
+ }
34553
+ function toolKey3(sessionId, callId) {
34554
+ return `${sessionId}:${callId}`;
34555
+ }
34556
+ async function rootSpanIdForSession(sessionId) {
34557
+ return deterministicEveId("eve:root", sessionId);
34558
+ }
34559
+ async function generateEveIds(kind, ...parts) {
34560
+ const [rowId, spanId] = await Promise.all([
34561
+ deterministicEveId(`eve:row:${kind}`, ...parts),
34562
+ deterministicEveId(`eve:${kind}`, ...parts)
34563
+ ]);
34564
+ return { rowId, spanId };
34565
+ }
34566
+ async function spanIdForSubagent(sessionId, callId) {
34567
+ return deterministicEveId("eve:subagent", sessionId, callId);
34568
+ }
34569
+ async function deterministicEveId(...parts) {
34570
+ const data = new TextEncoder().encode(
34571
+ parts.map((part) => `${part.length}:${part}`).join("\0")
34572
+ );
34573
+ const digest = await globalThis.crypto.subtle.digest("SHA-256", data);
34574
+ const bytes = Array.from(new Uint8Array(digest, 0, 16));
34575
+ const hex = bytes.map((byte) => byte.toString(16).padStart(2, "0")).join("");
34576
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
34577
+ }
34578
+
33048
34579
  // src/typed-instrumentation-helpers.ts
33049
34580
  var TypedApplyProxy = Proxy;
33050
34581
 
@@ -33276,7 +34807,13 @@ var BraintrustObservabilityExporter = class {
33276
34807
  const args = {
33277
34808
  name: exported.name,
33278
34809
  spanAttributes: { type: spanTypeFor(exported.type) },
33279
- startTime: epochSeconds(exported.startTime)
34810
+ startTime: epochSeconds(exported.startTime),
34811
+ // Use the Mastra span id as the Braintrust row id so that
34812
+ // `logFeedback({ id: <mastra span id> })` (and Mastra's score events)
34813
+ // attach to the right row. Without this, `SpanImpl` auto-generates a
34814
+ // row id (`this._id = eventId ?? idGenerator.getSpanId()`) that no
34815
+ // external caller could know.
34816
+ event: { id: exported.id }
33280
34817
  };
33281
34818
  const parentRecord = exported.parentSpanId ? this.spans.get(exported.parentSpanId) : void 0;
33282
34819
  if (!this.capturedParent) {