@mastra/otel-exporter 0.0.0-safe-stringify-telemetry-20251205024938 → 0.0.0-scorers-logs-20251208101616

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