@mastra/otel-exporter 0.0.0-bundle-recursion-20251030002519 → 0.0.0-bundle-studio-cloud-20251222034739

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/index.cjs CHANGED
@@ -1,12 +1,16 @@
1
1
  'use strict';
2
2
 
3
- var aiTracing = require('@mastra/core/ai-tracing');
3
+ var observability = require('@mastra/core/observability');
4
+ var observability$1 = require('@mastra/observability');
4
5
  var api = require('@opentelemetry/api');
5
- var resources = require('@opentelemetry/resources');
6
6
  var sdkTraceBase = require('@opentelemetry/sdk-trace-base');
7
+ var fs = require('fs');
8
+ var url = require('url');
9
+ var resources = require('@opentelemetry/resources');
7
10
  var semanticConventions = require('@opentelemetry/semantic-conventions');
11
+ var incubating = require('@opentelemetry/semantic-conventions/incubating');
8
12
 
9
- // src/ai-tracing.ts
13
+ // src/tracing.ts
10
14
 
11
15
  // src/loadExporter.ts
12
16
  var OTLPHttpExporter;
@@ -204,399 +208,490 @@ function resolveCustomConfig(config) {
204
208
  protocol: config.protocol || "http/json"
205
209
  };
206
210
  }
207
- var MastraReadableSpan = class {
208
- name;
209
- kind;
210
- spanContext;
211
- parentSpanContext;
212
- parentSpanId;
213
- startTime;
214
- endTime;
215
- status;
216
- attributes;
217
- links;
218
- events;
219
- duration;
220
- ended;
221
- resource;
222
- instrumentationLibrary;
223
- instrumentationScope;
224
- droppedAttributesCount = 0;
225
- droppedEventsCount = 0;
226
- droppedLinksCount = 0;
227
- constructor(aiSpan, attributes, kind, parentSpanId, resource, instrumentationLibrary) {
228
- this.name = aiSpan.name;
229
- this.kind = kind;
230
- this.attributes = attributes;
231
- this.parentSpanId = parentSpanId;
232
- this.links = [];
233
- this.events = [];
234
- this.startTime = this.dateToHrTime(aiSpan.startTime);
235
- this.endTime = aiSpan.endTime ? this.dateToHrTime(aiSpan.endTime) : this.startTime;
236
- this.ended = !!aiSpan.endTime;
237
- if (aiSpan.endTime) {
238
- const durationMs = aiSpan.endTime.getTime() - aiSpan.startTime.getTime();
239
- this.duration = [Math.floor(durationMs / 1e3), durationMs % 1e3 * 1e6];
240
- } else {
241
- this.duration = [0, 0];
211
+
212
+ // src/gen-ai-messages.ts
213
+ var isMastraMessagePart = (p) => {
214
+ return typeof p === "object" && p != null && "type" in p && (p.type === "text" || p.type === "tool-call" || p.type === "tool-result") && (p.type === "text" && "text" in p || p.type === "tool-call" && "toolCallId" in p && "toolName" in p && "input" in p || p.type === "tool-result" && "toolCallId" in p && "toolName" in p && "output" in p);
215
+ };
216
+ var isMastraMessage = (m) => {
217
+ return typeof m === "object" && m != null && "role" in m && "content" in m && (typeof m.content === "string" || Array.isArray(m.content) && m.content.every(isMastraMessagePart));
218
+ };
219
+ var convertMastraMessagesToGenAIMessages = (inputOutputString) => {
220
+ try {
221
+ const parsedIO = JSON.parse(inputOutputString);
222
+ if (typeof parsedIO !== "object" || parsedIO == null || !("messages" in parsedIO) && !("text" in parsedIO)) {
223
+ return inputOutputString;
242
224
  }
243
- if (aiSpan.errorInfo) {
244
- this.status = {
245
- code: api.SpanStatusCode.ERROR,
246
- message: aiSpan.errorInfo.message
247
- };
248
- this.events.push({
249
- name: "exception",
250
- attributes: {
251
- "exception.message": aiSpan.errorInfo.message,
252
- "exception.type": "Error",
253
- ...aiSpan.errorInfo.details?.stack && {
254
- "exception.stacktrace": aiSpan.errorInfo.details.stack
255
- }
256
- },
257
- time: this.startTime,
258
- droppedAttributesCount: 0
259
- });
260
- } else if (aiSpan.endTime) {
261
- this.status = { code: api.SpanStatusCode.OK };
262
- } else {
263
- this.status = { code: api.SpanStatusCode.UNSET };
264
- }
265
- if (aiSpan.isEvent) {
266
- this.events.push({
267
- name: "instant_event",
268
- attributes: {},
269
- time: this.startTime,
270
- droppedAttributesCount: 0
271
- });
225
+ if ("text" in parsedIO) {
226
+ return JSON.stringify([
227
+ {
228
+ role: "assistant",
229
+ parts: [{ type: "text", content: parsedIO.text }]
230
+ }
231
+ ]);
272
232
  }
273
- this.spanContext = () => ({
274
- traceId: aiSpan.traceId,
275
- spanId: aiSpan.id,
276
- traceFlags: api.TraceFlags.SAMPLED,
277
- isRemote: false
278
- });
279
- if (parentSpanId) {
280
- this.parentSpanContext = {
281
- traceId: aiSpan.traceId,
282
- spanId: parentSpanId,
283
- traceFlags: api.TraceFlags.SAMPLED,
284
- isRemote: false
285
- };
233
+ if (Array.isArray(parsedIO.messages)) {
234
+ return JSON.stringify(
235
+ parsedIO.messages.map((m) => {
236
+ if (!isMastraMessage(m)) {
237
+ return m;
238
+ }
239
+ const role = m.role;
240
+ let parts = [];
241
+ if (Array.isArray(m.content)) {
242
+ parts = m.content.map((c) => {
243
+ switch (c.type) {
244
+ case "text":
245
+ return {
246
+ type: "text",
247
+ content: c.text
248
+ };
249
+ case "tool-call":
250
+ return {
251
+ type: "tool_call",
252
+ id: c.toolCallId,
253
+ name: c.toolName,
254
+ arguments: JSON.stringify(c.input)
255
+ };
256
+ case "tool-result":
257
+ return {
258
+ type: "tool_call_response",
259
+ id: c.toolCallId,
260
+ name: c.toolName,
261
+ response: JSON.stringify(c.output.value)
262
+ };
263
+ default:
264
+ return c;
265
+ }
266
+ });
267
+ } else {
268
+ parts = [
269
+ {
270
+ type: "text",
271
+ content: m.content
272
+ }
273
+ ];
274
+ }
275
+ return {
276
+ role,
277
+ parts
278
+ };
279
+ })
280
+ );
286
281
  }
287
- this.resource = resource || {};
288
- this.instrumentationLibrary = instrumentationLibrary || {
289
- name: "@mastra/otel",
290
- version: "1.0.0"
291
- };
292
- this.instrumentationScope = this.instrumentationLibrary;
293
- }
294
- /**
295
- * Convert JavaScript Date to hrtime format
296
- */
297
- dateToHrTime(date) {
298
- const ms = date.getTime();
299
- const seconds = Math.floor(ms / 1e3);
300
- const nanoseconds = ms % 1e3 * 1e6;
301
- return [seconds, nanoseconds];
282
+ return inputOutputString;
283
+ } catch {
284
+ return inputOutputString;
302
285
  }
303
286
  };
304
287
 
305
- // src/span-converter.ts
306
- var SPAN_KIND_MAPPING = {
307
- // Model operations are CLIENT spans (calling external AI services)
308
- [aiTracing.AISpanType.MODEL_GENERATION]: api.SpanKind.CLIENT,
309
- [aiTracing.AISpanType.MODEL_CHUNK]: api.SpanKind.CLIENT,
310
- // MCP tool calls are CLIENT (external service calls)
311
- [aiTracing.AISpanType.MCP_TOOL_CALL]: api.SpanKind.CLIENT,
312
- // Root spans for agent/workflow are SERVER (entry points)
313
- [aiTracing.AISpanType.AGENT_RUN]: api.SpanKind.SERVER,
314
- [aiTracing.AISpanType.WORKFLOW_RUN]: api.SpanKind.SERVER
315
- };
316
- var SpanConverter = class {
317
- resource;
318
- instrumentationLibrary;
319
- constructor(resource) {
320
- this.resource = resource;
321
- this.instrumentationLibrary = {
322
- name: "@mastra/otel",
323
- version: "1.0.0"
324
- };
288
+ // src/gen-ai-semantics.ts
289
+ function formatUsageMetrics(usage) {
290
+ if (!usage) return {};
291
+ const metrics = {};
292
+ if (usage.inputTokens !== void 0) {
293
+ metrics[incubating.ATTR_GEN_AI_USAGE_INPUT_TOKENS] = usage.inputTokens;
325
294
  }
326
- /**
327
- * Convert a Mastra AI span to an OpenTelemetry ReadableSpan
328
- * This preserves Mastra's trace and span IDs
329
- */
330
- convertSpan(aiSpan) {
331
- const spanKind = this.getSpanKind(aiSpan);
332
- const attributes = this.buildAttributes(aiSpan);
333
- const spanName = this.buildSpanName(aiSpan);
334
- const otelSpan = { ...aiSpan, name: spanName };
335
- return new MastraReadableSpan(
336
- otelSpan,
337
- attributes,
338
- spanKind,
339
- aiSpan.parentSpanId,
340
- // Use the parentSpanId from the Mastra span directly
341
- this.resource,
342
- this.instrumentationLibrary
343
- );
295
+ if (usage.outputTokens !== void 0) {
296
+ metrics[incubating.ATTR_GEN_AI_USAGE_OUTPUT_TOKENS] = usage.outputTokens;
344
297
  }
345
- /**
346
- * Get the appropriate SpanKind based on span type and context
347
- */
348
- getSpanKind(aiSpan) {
349
- if (aiSpan.isRootSpan) {
350
- if (aiSpan.type === aiTracing.AISpanType.AGENT_RUN || aiSpan.type === aiTracing.AISpanType.WORKFLOW_RUN) {
351
- return api.SpanKind.SERVER;
352
- }
298
+ if (usage.outputDetails?.reasoning !== void 0) {
299
+ metrics["gen_ai.usage.reasoning_tokens"] = usage.outputDetails.reasoning;
300
+ }
301
+ if (usage.inputDetails?.cacheRead !== void 0) {
302
+ metrics["gen_ai.usage.cached_input_tokens"] = usage.inputDetails.cacheRead;
303
+ }
304
+ if (usage.inputDetails?.cacheWrite !== void 0) {
305
+ metrics["gen_ai.usage.cache_write_tokens"] = usage.inputDetails.cacheWrite;
306
+ }
307
+ if (usage.inputDetails?.audio !== void 0) {
308
+ metrics["gen_ai.usage.audio_input_tokens"] = usage.inputDetails.audio;
309
+ }
310
+ if (usage.outputDetails?.audio !== void 0) {
311
+ metrics["gen_ai.usage.audio_output_tokens"] = usage.outputDetails.audio;
312
+ }
313
+ return metrics;
314
+ }
315
+ function getOperationName(span) {
316
+ switch (span.type) {
317
+ case observability.SpanType.MODEL_GENERATION:
318
+ return "chat";
319
+ case observability.SpanType.TOOL_CALL:
320
+ case observability.SpanType.MCP_TOOL_CALL:
321
+ return "execute_tool";
322
+ case observability.SpanType.AGENT_RUN:
323
+ return "invoke_agent";
324
+ case observability.SpanType.WORKFLOW_RUN:
325
+ return "invoke_workflow";
326
+ default:
327
+ return span.type.toLowerCase();
328
+ }
329
+ }
330
+ function sanitizeSpanName(name) {
331
+ return name.replace(/[^\p{L}\p{N}._ -]/gu, "");
332
+ }
333
+ function getSpanIdentifier(span) {
334
+ switch (span.type) {
335
+ case observability.SpanType.MODEL_GENERATION: {
336
+ const attrs = span.attributes;
337
+ return attrs?.model ?? "unknown";
338
+ }
339
+ case observability.SpanType.TOOL_CALL:
340
+ case observability.SpanType.MCP_TOOL_CALL: {
341
+ const attrs = span.attributes;
342
+ return attrs?.toolId ?? "unknown";
343
+ }
344
+ case observability.SpanType.AGENT_RUN: {
345
+ const attrs = span.attributes;
346
+ return attrs?.agentName ?? attrs?.agentId ?? "unknown";
353
347
  }
354
- return SPAN_KIND_MAPPING[aiSpan.type] || api.SpanKind.INTERNAL;
348
+ case observability.SpanType.WORKFLOW_RUN: {
349
+ const attrs = span.attributes;
350
+ return attrs?.workflowId ?? "unknown";
351
+ }
352
+ default:
353
+ return null;
355
354
  }
356
- /**
357
- * Build OTEL-compliant span name based on span type and attributes
358
- */
359
- buildSpanName(aiSpan) {
360
- switch (aiSpan.type) {
361
- case aiTracing.AISpanType.MODEL_GENERATION: {
362
- const attrs = aiSpan.attributes;
363
- const operation = attrs?.resultType === "tool_selection" ? "tool_selection" : "chat";
364
- const model = attrs?.model || "unknown";
365
- return `${operation} ${model}`;
366
- }
367
- case aiTracing.AISpanType.TOOL_CALL:
368
- case aiTracing.AISpanType.MCP_TOOL_CALL: {
369
- const toolAttrs = aiSpan.attributes;
370
- const toolName = toolAttrs?.toolId || "unknown";
371
- return `tool.execute ${toolName}`;
372
- }
373
- case aiTracing.AISpanType.AGENT_RUN: {
374
- const agentAttrs = aiSpan.attributes;
375
- const agentId = agentAttrs?.agentId || "unknown";
376
- return `agent.${agentId}`;
377
- }
378
- case aiTracing.AISpanType.WORKFLOW_RUN: {
379
- const workflowAttrs = aiSpan.attributes;
380
- const workflowId = workflowAttrs?.workflowId || "unknown";
381
- return `workflow.${workflowId}`;
382
- }
383
- case aiTracing.AISpanType.WORKFLOW_STEP:
384
- return aiSpan.name;
385
- default:
386
- return aiSpan.name;
355
+ }
356
+ function getSpanName(span) {
357
+ const identifier = getSpanIdentifier(span);
358
+ if (identifier) {
359
+ const operation = getOperationName(span);
360
+ return `${operation} ${identifier}`;
361
+ }
362
+ return sanitizeSpanName(span.name);
363
+ }
364
+ function getAttributes(span) {
365
+ const attributes = {};
366
+ const spanType = span.type.toLowerCase();
367
+ attributes[incubating.ATTR_GEN_AI_OPERATION_NAME] = getOperationName(span);
368
+ attributes["mastra.span.type"] = span.type;
369
+ if (span.input !== void 0) {
370
+ const inputStr = typeof span.input === "string" ? span.input : JSON.stringify(span.input);
371
+ if (span.type === observability.SpanType.MODEL_GENERATION) {
372
+ attributes[incubating.ATTR_GEN_AI_INPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(inputStr);
373
+ } else if (span.type === observability.SpanType.TOOL_CALL || span.type === observability.SpanType.MCP_TOOL_CALL) {
374
+ attributes["gen_ai.tool.call.arguments"] = inputStr;
375
+ } else {
376
+ attributes[`mastra.${spanType}.input`] = inputStr;
387
377
  }
388
378
  }
389
- /**
390
- * Build OpenTelemetry attributes from Mastra AI span
391
- * Following OTEL Semantic Conventions for GenAI
392
- */
393
- buildAttributes(aiSpan) {
394
- const attributes = {};
395
- attributes["gen_ai.operation.name"] = this.getOperationName(aiSpan);
396
- attributes["span.kind"] = this.getSpanKindString(aiSpan);
397
- attributes["mastra.span.type"] = aiSpan.type;
398
- attributes["mastra.trace_id"] = aiSpan.traceId;
399
- attributes["mastra.span_id"] = aiSpan.id;
400
- if (aiSpan.parentSpanId) {
401
- attributes["mastra.parent_span_id"] = aiSpan.parentSpanId;
402
- }
403
- if (aiSpan.input !== void 0) {
404
- const inputStr = typeof aiSpan.input === "string" ? aiSpan.input : JSON.stringify(aiSpan.input);
405
- attributes["input"] = inputStr;
406
- if (aiSpan.type === aiTracing.AISpanType.MODEL_GENERATION) {
407
- attributes["gen_ai.prompt"] = inputStr;
408
- } else if (aiSpan.type === aiTracing.AISpanType.TOOL_CALL || aiSpan.type === aiTracing.AISpanType.MCP_TOOL_CALL) {
409
- attributes["gen_ai.tool.input"] = inputStr;
410
- }
379
+ if (span.output !== void 0) {
380
+ const outputStr = typeof span.output === "string" ? span.output : JSON.stringify(span.output);
381
+ if (span.type === observability.SpanType.MODEL_GENERATION) {
382
+ attributes[incubating.ATTR_GEN_AI_OUTPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(outputStr);
383
+ } else if (span.type === observability.SpanType.TOOL_CALL || span.type === observability.SpanType.MCP_TOOL_CALL) {
384
+ attributes["gen_ai.tool.call.result"] = outputStr;
385
+ } else {
386
+ attributes[`mastra.${spanType}.output`] = outputStr;
411
387
  }
412
- if (aiSpan.output !== void 0) {
413
- const outputStr = typeof aiSpan.output === "string" ? aiSpan.output : JSON.stringify(aiSpan.output);
414
- attributes["output"] = outputStr;
415
- if (aiSpan.type === aiTracing.AISpanType.MODEL_GENERATION) {
416
- attributes["gen_ai.completion"] = outputStr;
417
- } else if (aiSpan.type === aiTracing.AISpanType.TOOL_CALL || aiSpan.type === aiTracing.AISpanType.MCP_TOOL_CALL) {
418
- attributes["gen_ai.tool.output"] = outputStr;
419
- }
388
+ }
389
+ if (span.type === observability.SpanType.MODEL_GENERATION && span.attributes) {
390
+ const modelAttrs = span.attributes;
391
+ if (modelAttrs.model) {
392
+ attributes[incubating.ATTR_GEN_AI_REQUEST_MODEL] = modelAttrs.model;
393
+ }
394
+ if (modelAttrs.provider) {
395
+ attributes[incubating.ATTR_GEN_AI_PROVIDER_NAME] = normalizeProvider(modelAttrs.provider);
420
396
  }
421
- if (aiSpan.type === aiTracing.AISpanType.MODEL_GENERATION && aiSpan.attributes) {
422
- const modelAttrs = aiSpan.attributes;
423
- if (modelAttrs.model) {
424
- attributes["gen_ai.request.model"] = modelAttrs.model;
397
+ if (modelAttrs.agentId) {
398
+ attributes[incubating.ATTR_GEN_AI_AGENT_ID] = modelAttrs.agentId;
399
+ }
400
+ if (modelAttrs.agentName) {
401
+ attributes[incubating.ATTR_GEN_AI_AGENT_NAME] = modelAttrs.agentName;
402
+ }
403
+ Object.assign(attributes, formatUsageMetrics(modelAttrs.usage));
404
+ if (modelAttrs.parameters) {
405
+ if (modelAttrs.parameters.temperature !== void 0) {
406
+ attributes[incubating.ATTR_GEN_AI_REQUEST_TEMPERATURE] = modelAttrs.parameters.temperature;
425
407
  }
426
- if (modelAttrs.provider) {
427
- attributes["gen_ai.system"] = modelAttrs.provider;
408
+ if (modelAttrs.parameters.maxOutputTokens !== void 0) {
409
+ attributes[incubating.ATTR_GEN_AI_REQUEST_MAX_TOKENS] = modelAttrs.parameters.maxOutputTokens;
428
410
  }
429
- if (modelAttrs.usage) {
430
- const inputTokens = modelAttrs.usage.inputTokens ?? modelAttrs.usage.promptTokens;
431
- const outputTokens = modelAttrs.usage.outputTokens ?? modelAttrs.usage.completionTokens;
432
- if (inputTokens !== void 0) {
433
- attributes["gen_ai.usage.input_tokens"] = inputTokens;
434
- }
435
- if (outputTokens !== void 0) {
436
- attributes["gen_ai.usage.output_tokens"] = outputTokens;
437
- }
438
- if (modelAttrs.usage.totalTokens !== void 0) {
439
- attributes["gen_ai.usage.total_tokens"] = modelAttrs.usage.totalTokens;
440
- }
441
- if (modelAttrs.usage.reasoningTokens !== void 0) {
442
- attributes["gen_ai.usage.reasoning_tokens"] = modelAttrs.usage.reasoningTokens;
443
- }
444
- if (modelAttrs.usage.cachedInputTokens !== void 0) {
445
- attributes["gen_ai.usage.cached_input_tokens"] = modelAttrs.usage.cachedInputTokens;
446
- }
411
+ if (modelAttrs.parameters.topP !== void 0) {
412
+ attributes[incubating.ATTR_GEN_AI_REQUEST_TOP_P] = modelAttrs.parameters.topP;
447
413
  }
448
- if (modelAttrs.parameters) {
449
- if (modelAttrs.parameters.temperature !== void 0) {
450
- attributes["gen_ai.request.temperature"] = modelAttrs.parameters.temperature;
451
- }
452
- if (modelAttrs.parameters.maxOutputTokens !== void 0) {
453
- attributes["gen_ai.request.max_tokens"] = modelAttrs.parameters.maxOutputTokens;
454
- }
455
- if (modelAttrs.parameters.topP !== void 0) {
456
- attributes["gen_ai.request.top_p"] = modelAttrs.parameters.topP;
457
- }
458
- if (modelAttrs.parameters.topK !== void 0) {
459
- attributes["gen_ai.request.top_k"] = modelAttrs.parameters.topK;
460
- }
461
- if (modelAttrs.parameters.presencePenalty !== void 0) {
462
- attributes["gen_ai.request.presence_penalty"] = modelAttrs.parameters.presencePenalty;
463
- }
464
- if (modelAttrs.parameters.frequencyPenalty !== void 0) {
465
- attributes["gen_ai.request.frequency_penalty"] = modelAttrs.parameters.frequencyPenalty;
466
- }
467
- if (modelAttrs.parameters.stopSequences) {
468
- attributes["gen_ai.request.stop_sequences"] = JSON.stringify(modelAttrs.parameters.stopSequences);
469
- }
414
+ if (modelAttrs.parameters.topK !== void 0) {
415
+ attributes[incubating.ATTR_GEN_AI_REQUEST_TOP_K] = modelAttrs.parameters.topK;
470
416
  }
471
- if (modelAttrs.finishReason) {
472
- attributes["gen_ai.response.finish_reasons"] = modelAttrs.finishReason;
417
+ if (modelAttrs.parameters.presencePenalty !== void 0) {
418
+ attributes[incubating.ATTR_GEN_AI_REQUEST_PRESENCE_PENALTY] = modelAttrs.parameters.presencePenalty;
473
419
  }
474
- }
475
- if ((aiSpan.type === aiTracing.AISpanType.TOOL_CALL || aiSpan.type === aiTracing.AISpanType.MCP_TOOL_CALL) && aiSpan.attributes) {
476
- const toolAttrs = aiSpan.attributes;
477
- if (toolAttrs.toolId) {
478
- attributes["gen_ai.tool.name"] = toolAttrs.toolId;
420
+ if (modelAttrs.parameters.frequencyPenalty !== void 0) {
421
+ attributes[incubating.ATTR_GEN_AI_REQUEST_FREQUENCY_PENALTY] = modelAttrs.parameters.frequencyPenalty;
479
422
  }
480
- if (aiSpan.type === aiTracing.AISpanType.MCP_TOOL_CALL) {
481
- const mcpAttrs = toolAttrs;
482
- if (mcpAttrs.mcpServer) {
483
- attributes["mcp.server"] = mcpAttrs.mcpServer;
484
- }
485
- if (mcpAttrs.serverVersion) {
486
- attributes["mcp.server.version"] = mcpAttrs.serverVersion;
487
- }
488
- } else {
489
- if (toolAttrs.toolDescription) {
490
- attributes["gen_ai.tool.description"] = toolAttrs.toolDescription;
491
- }
423
+ if (modelAttrs.parameters.stopSequences) {
424
+ attributes[incubating.ATTR_GEN_AI_REQUEST_STOP_SEQUENCES] = JSON.stringify(modelAttrs.parameters.stopSequences);
492
425
  }
493
- if (toolAttrs.success !== void 0) {
494
- attributes["gen_ai.tool.success"] = toolAttrs.success;
426
+ if (modelAttrs.parameters.seed) {
427
+ attributes[incubating.ATTR_GEN_AI_REQUEST_SEED] = modelAttrs.parameters.seed;
495
428
  }
496
429
  }
497
- if (aiSpan.type === aiTracing.AISpanType.AGENT_RUN && aiSpan.attributes) {
498
- const agentAttrs = aiSpan.attributes;
499
- if (agentAttrs.agentId) {
500
- attributes["agent.id"] = agentAttrs.agentId;
501
- attributes["gen_ai.agent.id"] = agentAttrs.agentId;
502
- }
503
- if (agentAttrs.maxSteps) {
504
- attributes["agent.max_steps"] = agentAttrs.maxSteps;
505
- }
506
- if (agentAttrs.availableTools) {
507
- attributes["agent.available_tools"] = JSON.stringify(agentAttrs.availableTools);
508
- }
430
+ if (modelAttrs.finishReason) {
431
+ attributes[incubating.ATTR_GEN_AI_RESPONSE_FINISH_REASONS] = JSON.stringify([modelAttrs.finishReason]);
509
432
  }
510
- if (aiSpan.type === aiTracing.AISpanType.WORKFLOW_RUN && aiSpan.attributes) {
511
- const workflowAttrs = aiSpan.attributes;
512
- if (workflowAttrs.workflowId) {
513
- attributes["workflow.id"] = workflowAttrs.workflowId;
514
- }
515
- if (workflowAttrs.status) {
516
- attributes["workflow.status"] = workflowAttrs.status;
517
- }
433
+ if (modelAttrs.responseModel) {
434
+ attributes[incubating.ATTR_GEN_AI_RESPONSE_MODEL] = modelAttrs.responseModel;
435
+ }
436
+ if (modelAttrs.responseId) {
437
+ attributes[incubating.ATTR_GEN_AI_RESPONSE_ID] = modelAttrs.responseId;
438
+ }
439
+ if (modelAttrs.serverAddress) {
440
+ attributes[incubating.ATTR_SERVER_ADDRESS] = modelAttrs.serverAddress;
441
+ }
442
+ if (modelAttrs.serverPort !== void 0) {
443
+ attributes[incubating.ATTR_SERVER_PORT] = modelAttrs.serverPort;
444
+ }
445
+ }
446
+ if ((span.type === observability.SpanType.TOOL_CALL || span.type === observability.SpanType.MCP_TOOL_CALL) && span.attributes) {
447
+ const toolAttrs = span.attributes;
448
+ if (toolAttrs.toolId) {
449
+ attributes[incubating.ATTR_GEN_AI_TOOL_NAME] = toolAttrs.toolId;
518
450
  }
519
- if (aiSpan.errorInfo) {
520
- attributes["error"] = true;
521
- attributes["error.type"] = aiSpan.errorInfo.id || "unknown";
522
- attributes["error.message"] = aiSpan.errorInfo.message;
523
- if (aiSpan.errorInfo.domain) {
524
- attributes["error.domain"] = aiSpan.errorInfo.domain;
451
+ if (span.type === observability.SpanType.MCP_TOOL_CALL) {
452
+ const mcpAttrs = toolAttrs;
453
+ if (mcpAttrs.mcpServer) {
454
+ attributes[incubating.ATTR_SERVER_ADDRESS] = mcpAttrs.mcpServer;
525
455
  }
526
- if (aiSpan.errorInfo.category) {
527
- attributes["error.category"] = aiSpan.errorInfo.category;
456
+ } else {
457
+ if (toolAttrs.toolDescription) {
458
+ attributes[incubating.ATTR_GEN_AI_TOOL_DESCRIPTION] = toolAttrs.toolDescription;
528
459
  }
529
460
  }
530
- if (aiSpan.metadata) {
531
- Object.entries(aiSpan.metadata).forEach(([key, value]) => {
532
- if (!attributes[key]) {
533
- if (value === null || value === void 0) {
534
- return;
535
- }
536
- if (typeof value === "object") {
537
- attributes[key] = JSON.stringify(value);
538
- } else {
539
- attributes[key] = value;
540
- }
541
- }
542
- });
461
+ }
462
+ if (span.type === observability.SpanType.AGENT_RUN && span.attributes) {
463
+ const agentAttrs = span.attributes;
464
+ if (agentAttrs.agentId) {
465
+ attributes[incubating.ATTR_GEN_AI_AGENT_ID] = agentAttrs.agentId;
466
+ }
467
+ if (agentAttrs.agentName) {
468
+ attributes[incubating.ATTR_GEN_AI_AGENT_NAME] = agentAttrs.agentName;
543
469
  }
544
- if (aiSpan.startTime) {
545
- attributes["mastra.start_time"] = aiSpan.startTime.toISOString();
470
+ if (agentAttrs.conversationId) {
471
+ attributes[incubating.ATTR_GEN_AI_CONVERSATION_ID] = agentAttrs.conversationId;
546
472
  }
547
- if (aiSpan.endTime) {
548
- attributes["mastra.end_time"] = aiSpan.endTime.toISOString();
549
- const duration = aiSpan.endTime.getTime() - aiSpan.startTime.getTime();
550
- attributes["mastra.duration_ms"] = duration;
473
+ if (agentAttrs.maxSteps) {
474
+ attributes[`mastra.${spanType}.max_steps`] = agentAttrs.maxSteps;
551
475
  }
552
- return attributes;
476
+ if (agentAttrs.availableTools) {
477
+ attributes[`gen_ai.tool.definitions`] = JSON.stringify(agentAttrs.availableTools);
478
+ }
479
+ attributes[incubating.ATTR_GEN_AI_SYSTEM_INSTRUCTIONS] = agentAttrs.instructions;
553
480
  }
481
+ if (span.errorInfo) {
482
+ attributes[incubating.ATTR_ERROR_TYPE] = span.errorInfo.id || "unknown";
483
+ attributes[incubating.ATTR_ERROR_MESSAGE] = span.errorInfo.message;
484
+ if (span.errorInfo.domain) {
485
+ attributes["error.domain"] = span.errorInfo.domain;
486
+ }
487
+ if (span.errorInfo.category) {
488
+ attributes["error.category"] = span.errorInfo.category;
489
+ }
490
+ }
491
+ return attributes;
492
+ }
493
+ var PROVIDER_ALIASES = {
494
+ anthropic: ["anthropic", "claude"],
495
+ "aws.bedrock": ["awsbedrock", "bedrock", "amazonbedrock"],
496
+ "azure.ai.inference": ["azureaiinference", "azureinference"],
497
+ "azure.ai.openai": ["azureaiopenai", "azureopenai", "msopenai", "microsoftopenai"],
498
+ cohere: ["cohere"],
499
+ deepseek: ["deepseek"],
500
+ "gcp.gemini": ["gcpgemini", "gemini"],
501
+ "gcp.gen_ai": ["gcpgenai", "googlegenai", "googleai"],
502
+ "gcp.vertex_ai": ["gcpvertexai", "vertexai"],
503
+ groq: ["groq"],
504
+ "ibm.watsonx.ai": ["ibmwatsonxai", "watsonx", "watsonxai"],
505
+ mistral_ai: ["mistral", "mistralai"],
506
+ openai: ["openai", "oai"],
507
+ perplexity: ["perplexity", "pplx"],
508
+ x_ai: ["xai", "x-ai", "x_ai", "x.com ai"]
509
+ };
510
+ function normalizeProviderString(input) {
511
+ return input.toLowerCase().replace(/[^a-z0-9]/g, "");
512
+ }
513
+ function normalizeProvider(providerName) {
514
+ const normalized = normalizeProviderString(providerName);
515
+ for (const [canonical, aliases] of Object.entries(PROVIDER_ALIASES)) {
516
+ for (const alias of aliases) {
517
+ if (normalized === alias) {
518
+ return canonical;
519
+ }
520
+ }
521
+ }
522
+ return providerName.toLowerCase();
523
+ }
524
+
525
+ // src/span-converter.ts
526
+ var SpanConverter = class {
527
+ constructor(params) {
528
+ this.params = params;
529
+ this.format = params.format;
530
+ }
531
+ resource;
532
+ scope;
533
+ initPromise;
534
+ format;
554
535
  /**
555
- * Get the operation name based on span type for gen_ai.operation.name
536
+ * Lazily initialize resource & scope on first use.
537
+ * Subsequent calls reuse the same promise (no races).
556
538
  */
557
- getOperationName(aiSpan) {
558
- switch (aiSpan.type) {
559
- case aiTracing.AISpanType.MODEL_GENERATION: {
560
- const attrs = aiSpan.attributes;
561
- return attrs?.resultType === "tool_selection" ? "tool_selection" : "chat";
562
- }
563
- case aiTracing.AISpanType.TOOL_CALL:
564
- case aiTracing.AISpanType.MCP_TOOL_CALL:
565
- return "tool.execute";
566
- case aiTracing.AISpanType.AGENT_RUN:
567
- return "agent.run";
568
- case aiTracing.AISpanType.WORKFLOW_RUN:
569
- return "workflow.run";
570
- default:
571
- return aiSpan.type.replace(/_/g, ".");
539
+ async initIfNeeded() {
540
+ if (this.initPromise) {
541
+ return this.initPromise;
572
542
  }
543
+ this.initPromise = (async () => {
544
+ const packageVersion = await getPackageVersion(this.params.packageName) ?? "unknown";
545
+ const serviceVersion = await getPackageVersion("@mastra/core") ?? "unknown";
546
+ let resource = resources.resourceFromAttributes({
547
+ [semanticConventions.ATTR_SERVICE_NAME]: this.params.serviceName || "mastra-service",
548
+ [semanticConventions.ATTR_SERVICE_VERSION]: serviceVersion,
549
+ [semanticConventions.ATTR_TELEMETRY_SDK_NAME]: this.params.packageName,
550
+ [semanticConventions.ATTR_TELEMETRY_SDK_VERSION]: packageVersion,
551
+ [semanticConventions.ATTR_TELEMETRY_SDK_LANGUAGE]: "nodejs"
552
+ });
553
+ if (this.params.config?.resourceAttributes) {
554
+ resource = resource.merge(
555
+ // Duplicate attributes from config will override defaults above
556
+ resources.resourceFromAttributes(this.params.config.resourceAttributes)
557
+ );
558
+ }
559
+ this.resource = resource;
560
+ this.scope = {
561
+ name: this.params.packageName,
562
+ version: packageVersion
563
+ };
564
+ })();
565
+ return this.initPromise;
573
566
  }
574
567
  /**
575
- * Get span kind as string for attribute
568
+ * Convert a Mastra Span to an OpenTelemetry ReadableSpan
576
569
  */
577
- getSpanKindString(aiSpan) {
578
- const kind = this.getSpanKind(aiSpan);
579
- switch (kind) {
580
- case api.SpanKind.SERVER:
581
- return "server";
582
- case api.SpanKind.CLIENT:
583
- return "client";
584
- case api.SpanKind.INTERNAL:
585
- return "internal";
586
- case api.SpanKind.PRODUCER:
587
- return "producer";
588
- case api.SpanKind.CONSUMER:
589
- return "consumer";
590
- default:
591
- return "internal";
570
+ async convertSpan(span) {
571
+ await this.initIfNeeded();
572
+ if (!this.resource || !this.scope) {
573
+ throw new Error("SpanConverter not initialized correctly");
592
574
  }
575
+ const name = getSpanName(span);
576
+ const kind = getSpanKind(span.type);
577
+ const attributes = getAttributes(span);
578
+ if (span.metadata) {
579
+ for (const [k, v] of Object.entries(span.metadata)) {
580
+ if (v === null || v === void 0) {
581
+ continue;
582
+ }
583
+ attributes[`mastra.metadata.${k}`] = typeof v === "object" ? JSON.stringify(v) : v;
584
+ }
585
+ }
586
+ if (span.isRootSpan && span.tags?.length) {
587
+ attributes["mastra.tags"] = JSON.stringify(span.tags);
588
+ }
589
+ const startTime = dateToHrTime(span.startTime);
590
+ const endTime = span.endTime ? dateToHrTime(span.endTime) : startTime;
591
+ const duration = computeDuration(span.startTime, span.endTime);
592
+ const { status, events } = buildStatusAndEvents(span, startTime);
593
+ const spanContext = {
594
+ traceId: span.traceId,
595
+ spanId: span.id,
596
+ traceFlags: api.TraceFlags.SAMPLED,
597
+ isRemote: false
598
+ };
599
+ const parentSpanContext = span.parentSpanId ? {
600
+ traceId: span.traceId,
601
+ spanId: span.parentSpanId,
602
+ traceFlags: api.TraceFlags.SAMPLED,
603
+ isRemote: false
604
+ } : void 0;
605
+ const links = [];
606
+ const readable = {
607
+ name,
608
+ kind,
609
+ spanContext: () => spanContext,
610
+ parentSpanContext,
611
+ startTime,
612
+ endTime,
613
+ status,
614
+ attributes,
615
+ links,
616
+ events,
617
+ duration,
618
+ ended: !!span.endTime,
619
+ resource: this.resource,
620
+ instrumentationScope: this.scope,
621
+ droppedAttributesCount: 0,
622
+ droppedEventsCount: 0,
623
+ droppedLinksCount: 0
624
+ };
625
+ return readable;
593
626
  }
594
627
  };
628
+ async function getPackageVersion(pkgName) {
629
+ try {
630
+ const manifestUrl = new URL(await undefined(`${pkgName}/package.json`));
631
+ const path = url.fileURLToPath(manifestUrl);
632
+ const pkgJson = JSON.parse(fs.readFileSync(path, "utf8"));
633
+ return pkgJson.version;
634
+ } catch {
635
+ return void 0;
636
+ }
637
+ }
638
+ function getSpanKind(type) {
639
+ switch (type) {
640
+ case observability.SpanType.MODEL_GENERATION:
641
+ case observability.SpanType.MCP_TOOL_CALL:
642
+ return api.SpanKind.CLIENT;
643
+ default:
644
+ return api.SpanKind.INTERNAL;
645
+ }
646
+ }
647
+ function dateToHrTime(date) {
648
+ const ms = date.getTime();
649
+ const seconds = Math.floor(ms / 1e3);
650
+ const nanoseconds = ms % 1e3 * 1e6;
651
+ return [seconds, nanoseconds];
652
+ }
653
+ function computeDuration(start, end) {
654
+ if (!end) return [0, 0];
655
+ const diffMs = end.getTime() - start.getTime();
656
+ return [Math.floor(diffMs / 1e3), diffMs % 1e3 * 1e6];
657
+ }
658
+ function buildStatusAndEvents(span, defaultTime) {
659
+ const events = [];
660
+ if (span.errorInfo) {
661
+ const status = {
662
+ code: api.SpanStatusCode.ERROR,
663
+ message: span.errorInfo.message
664
+ };
665
+ events.push({
666
+ name: "exception",
667
+ attributes: {
668
+ "exception.message": span.errorInfo.message,
669
+ "exception.type": "Error",
670
+ ...span.errorInfo.details?.stack && {
671
+ "exception.stacktrace": span.errorInfo.details.stack
672
+ }
673
+ },
674
+ time: defaultTime,
675
+ droppedAttributesCount: 0
676
+ });
677
+ return { status, events };
678
+ }
679
+ if (span.endTime) {
680
+ return {
681
+ status: { code: api.SpanStatusCode.OK },
682
+ events
683
+ };
684
+ }
685
+ return {
686
+ status: { code: api.SpanStatusCode.UNSET },
687
+ events
688
+ };
689
+ }
595
690
 
596
- // src/ai-tracing.ts
597
- var OtelExporter = class extends aiTracing.BaseExporter {
691
+ // src/tracing.ts
692
+ var OtelExporter = class extends observability$1.BaseExporter {
598
693
  config;
599
- tracingConfig;
694
+ observabilityConfig;
600
695
  spanConverter;
601
696
  processor;
602
697
  exporter;
@@ -605,7 +700,6 @@ var OtelExporter = class extends aiTracing.BaseExporter {
605
700
  constructor(config) {
606
701
  super(config);
607
702
  this.config = config;
608
- this.spanConverter = new SpanConverter();
609
703
  if (config.logLevel === "debug") {
610
704
  api.diag.setLogger(new api.DiagConsoleLogger(), api.DiagLogLevel.DEBUG);
611
705
  }
@@ -613,8 +707,8 @@ var OtelExporter = class extends aiTracing.BaseExporter {
613
707
  /**
614
708
  * Initialize with tracing configuration
615
709
  */
616
- init(config) {
617
- this.tracingConfig = config;
710
+ init(options) {
711
+ this.observabilityConfig = options.config;
618
712
  }
619
713
  async setupExporter() {
620
714
  if (this.isSetup || this.exporter) return;
@@ -692,21 +786,12 @@ var OtelExporter = class extends aiTracing.BaseExporter {
692
786
  }
693
787
  async setupProcessor() {
694
788
  if (this.processor || this.isSetup) return;
695
- let resource = resources.resourceFromAttributes({
696
- [semanticConventions.ATTR_SERVICE_NAME]: this.tracingConfig?.serviceName || "mastra-service",
697
- [semanticConventions.ATTR_SERVICE_VERSION]: "1.0.0",
698
- // Add telemetry SDK information
699
- [semanticConventions.ATTR_TELEMETRY_SDK_NAME]: "@mastra/otel-exporter",
700
- [semanticConventions.ATTR_TELEMETRY_SDK_VERSION]: "1.0.0",
701
- [semanticConventions.ATTR_TELEMETRY_SDK_LANGUAGE]: "nodejs"
789
+ this.spanConverter = new SpanConverter({
790
+ packageName: "@mastra/otel-exporter",
791
+ serviceName: this.observabilityConfig?.serviceName,
792
+ config: this.config,
793
+ format: "GenAI_v1_38_0"
702
794
  });
703
- if (this.config.resourceAttributes) {
704
- resource = resource.merge(
705
- // Duplicate attributes from config will override defaults above
706
- resources.resourceFromAttributes(this.config.resourceAttributes)
707
- );
708
- }
709
- this.spanConverter = new SpanConverter(resource);
710
795
  this.processor = new sdkTraceBase.BatchSpanProcessor(this.exporter, {
711
796
  maxExportBatchSize: this.config.batchSize || 512,
712
797
  // Default batch size
@@ -727,8 +812,8 @@ var OtelExporter = class extends aiTracing.BaseExporter {
727
812
  await this.setupProcessor();
728
813
  this.isSetup = true;
729
814
  }
730
- async _exportEvent(event) {
731
- if (event.type !== aiTracing.AITracingEventType.SPAN_ENDED) {
815
+ async _exportTracingEvent(event) {
816
+ if (event.type !== observability.TracingEventType.SPAN_ENDED) {
732
817
  return;
733
818
  }
734
819
  const span = event.exportedSpan;
@@ -742,9 +827,9 @@ var OtelExporter = class extends aiTracing.BaseExporter {
742
827
  return;
743
828
  }
744
829
  try {
745
- const readableSpan = this.spanConverter.convertSpan(span);
830
+ const otelSpan = await this.spanConverter.convertSpan(span);
746
831
  await new Promise((resolve) => {
747
- this.processor.onEnd(readableSpan);
832
+ this.processor.onEnd(otelSpan);
748
833
  resolve();
749
834
  });
750
835
  this.logger.debug(
@@ -762,5 +847,7 @@ var OtelExporter = class extends aiTracing.BaseExporter {
762
847
  };
763
848
 
764
849
  exports.OtelExporter = OtelExporter;
850
+ exports.SpanConverter = SpanConverter;
851
+ exports.getSpanKind = getSpanKind;
765
852
  //# sourceMappingURL=index.cjs.map
766
853
  //# sourceMappingURL=index.cjs.map