@mastra/otel-exporter 0.0.0-feat-improve-processors-20251205191721 → 0.0.0-feat-mcp-embedded-docs-tools-clean-20260102135536

package/dist/index.js

@@ -1,9 +1,12 @@
 import { SpanType, TracingEventType } from '@mastra/core/observability';
 import { BaseExporter } from '@mastra/observability';
-import { SpanStatusCode, TraceFlags, SpanKind, diag, DiagConsoleLogger, DiagLogLevel } from '@opentelemetry/api';
-import { resourceFromAttributes } from '@opentelemetry/resources';
+import { TraceFlags, SpanKind, SpanStatusCode, diag, DiagConsoleLogger, DiagLogLevel } from '@opentelemetry/api';
 import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { resourceFromAttributes } from '@opentelemetry/resources';
 import { ATTR_TELEMETRY_SDK_LANGUAGE, ATTR_TELEMETRY_SDK_VERSION, ATTR_TELEMETRY_SDK_NAME, ATTR_SERVICE_VERSION, ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+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_AGENT_ID, ATTR_GEN_AI_AGENT_NAME, 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_CONVERSATION_ID, ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, ATTR_ERROR_TYPE, ATTR_ERROR_MESSAGE, ATTR_GEN_AI_USAGE_INPUT_TOKENS, ATTR_GEN_AI_USAGE_OUTPUT_TOKENS } from '@opentelemetry/semantic-conventions/incubating';
 
 // src/tracing.ts
 
@@ -203,396 +206,478 @@ function resolveCustomConfig(config) {
     protocol: config.protocol || "http/json"
   };
 }
-var MastraReadableSpan = class {
-  name;
-  kind;
-  spanContext;
-  parentSpanContext;
-  parentSpanId;
-  startTime;
-  endTime;
-  status;
-  attributes;
-  links;
-  events;
-  duration;
-  ended;
-  resource;
-  instrumentationLibrary;
-  instrumentationScope;
-  droppedAttributesCount = 0;
-  droppedEventsCount = 0;
-  droppedLinksCount = 0;
-  constructor(span, attributes, kind, parentSpanId, resource, instrumentationLibrary) {
-    this.name = span.name;
-    this.kind = kind;
-    this.attributes = attributes;
-    this.parentSpanId = parentSpanId;
-    this.links = [];
-    this.events = [];
-    this.startTime = this.dateToHrTime(span.startTime);
-    this.endTime = span.endTime ? this.dateToHrTime(span.endTime) : this.startTime;
-    this.ended = !!span.endTime;
-    if (span.endTime) {
-      const durationMs = span.endTime.getTime() - span.startTime.getTime();
-      this.duration = [Math.floor(durationMs / 1e3), durationMs % 1e3 * 1e6];
-    } else {
-      this.duration = [0, 0];
+
+// src/gen-ai-messages.ts
+var isMastraMessagePart = (p) => {
+  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);
+};
+var isMastraMessage = (m) => {
+  return typeof m === "object" && m != null && "role" in m && "content" in m && (typeof m.content === "string" || Array.isArray(m.content) && m.content.every(isMastraMessagePart));
+};
+var convertMastraMessagesToGenAIMessages = (inputOutputString) => {
+  try {
+    const parsedIO = JSON.parse(inputOutputString);
+    if (typeof parsedIO !== "object" || parsedIO == null || !("messages" in parsedIO) && !("text" in parsedIO)) {
+      return inputOutputString;
     }
-    if (span.errorInfo) {
-      this.status = {
-        code: SpanStatusCode.ERROR,
-        message: span.errorInfo.message
-      };
-      this.events.push({
-        name: "exception",
-        attributes: {
-          "exception.message": span.errorInfo.message,
-          "exception.type": "Error",
-          ...span.errorInfo.details?.stack && {
-            "exception.stacktrace": span.errorInfo.details.stack
-          }
-        },
-        time: this.startTime,
-        droppedAttributesCount: 0
-      });
-    } else if (span.endTime) {
-      this.status = { code: SpanStatusCode.OK };
-    } else {
-      this.status = { code: SpanStatusCode.UNSET };
-    }
-    if (span.isEvent) {
-      this.events.push({
-        name: "instant_event",
-        attributes: {},
-        time: this.startTime,
-        droppedAttributesCount: 0
-      });
+    if ("text" in parsedIO) {
+      return JSON.stringify([
+        {
+          role: "assistant",
+          parts: [{ type: "text", content: parsedIO.text }]
+        }
+      ]);
     }
-    this.spanContext = () => ({
-      traceId: span.traceId,
-      spanId: span.id,
-      traceFlags: TraceFlags.SAMPLED,
-      isRemote: false
-    });
-    if (parentSpanId) {
-      this.parentSpanContext = {
-        traceId: span.traceId,
-        spanId: parentSpanId,
-        traceFlags: TraceFlags.SAMPLED,
-        isRemote: false
-      };
+    if (Array.isArray(parsedIO.messages)) {
+      return JSON.stringify(
+        parsedIO.messages.map((m) => {
+          if (!isMastraMessage(m)) {
+            return m;
+          }
+          const role = m.role;
+          let parts = [];
+          if (Array.isArray(m.content)) {
+            parts = m.content.map((c) => {
+              switch (c.type) {
+                case "text":
+                  return {
+                    type: "text",
+                    content: c.text
+                  };
+                case "tool-call":
+                  return {
+                    type: "tool_call",
+                    id: c.toolCallId,
+                    name: c.toolName,
+                    arguments: JSON.stringify(c.input)
+                  };
+                case "tool-result":
+                  return {
+                    type: "tool_call_response",
+                    id: c.toolCallId,
+                    name: c.toolName,
+                    response: JSON.stringify(c.output.value)
+                  };
+                default:
+                  return c;
+              }
+            });
+          } else {
+            parts = [
+              {
+                type: "text",
+                content: m.content
+              }
+            ];
+          }
+          return {
+            role,
+            parts
+          };
+        })
+      );
     }
-    this.resource = resource || {};
-    this.instrumentationLibrary = instrumentationLibrary || {
-      name: "@mastra/otel",
-      version: "1.0.0"
-    };
-    this.instrumentationScope = this.instrumentationLibrary;
-  }
-  /**
-   * Convert JavaScript Date to hrtime format
-   */
-  dateToHrTime(date) {
-    const ms = date.getTime();
-    const seconds = Math.floor(ms / 1e3);
-    const nanoseconds = ms % 1e3 * 1e6;
-    return [seconds, nanoseconds];
+    return inputOutputString;
+  } catch {
+    return inputOutputString;
   }
 };
 
-// src/span-converter.ts
-var SPAN_KIND_MAPPING = {
-  // Model operations are CLIENT spans (calling external AI services)
-  [SpanType.MODEL_GENERATION]: SpanKind.CLIENT,
-  [SpanType.MODEL_CHUNK]: SpanKind.CLIENT,
-  // MCP tool calls are CLIENT (external service calls)
-  [SpanType.MCP_TOOL_CALL]: SpanKind.CLIENT,
-  // Root spans for agent/workflow are SERVER (entry points)
-  [SpanType.AGENT_RUN]: SpanKind.SERVER,
-  [SpanType.WORKFLOW_RUN]: SpanKind.SERVER
-};
-function getSpanKind(type, isRootSpan) {
-  if (isRootSpan) {
-    if (type === SpanType.AGENT_RUN || type === SpanType.WORKFLOW_RUN) {
-      return SpanKind.SERVER;
+// src/gen-ai-semantics.ts
+function formatUsageMetrics(usage) {
+  if (!usage) return {};
+  const metrics = {};
+  if (usage.inputTokens !== void 0) {
+    metrics[ATTR_GEN_AI_USAGE_INPUT_TOKENS] = usage.inputTokens;
+  }
+  if (usage.outputTokens !== void 0) {
+    metrics[ATTR_GEN_AI_USAGE_OUTPUT_TOKENS] = usage.outputTokens;
+  }
+  if (usage.outputDetails?.reasoning !== void 0) {
+    metrics["gen_ai.usage.reasoning_tokens"] = usage.outputDetails.reasoning;
+  }
+  if (usage.inputDetails?.cacheRead !== void 0) {
+    metrics["gen_ai.usage.cached_input_tokens"] = usage.inputDetails.cacheRead;
+  }
+  if (usage.inputDetails?.cacheWrite !== void 0) {
+    metrics["gen_ai.usage.cache_write_tokens"] = usage.inputDetails.cacheWrite;
+  }
+  if (usage.inputDetails?.audio !== void 0) {
+    metrics["gen_ai.usage.audio_input_tokens"] = usage.inputDetails.audio;
+  }
+  if (usage.outputDetails?.audio !== void 0) {
+    metrics["gen_ai.usage.audio_output_tokens"] = usage.outputDetails.audio;
+  }
+  return metrics;
+}
+function getOperationName(span) {
+  switch (span.type) {
+    case SpanType.MODEL_GENERATION:
+      return "chat";
+    case SpanType.TOOL_CALL:
+    case SpanType.MCP_TOOL_CALL:
+      return "execute_tool";
+    case SpanType.AGENT_RUN:
+      return "invoke_agent";
+    case SpanType.WORKFLOW_RUN:
+      return "invoke_workflow";
+    default:
+      return span.type.toLowerCase();
+  }
+}
+function sanitizeSpanName(name) {
+  return name.replace(/[^\p{L}\p{N}._ -]/gu, "");
+}
+function getSpanIdentifier(span) {
+  switch (span.type) {
+    case SpanType.MODEL_GENERATION: {
+      const attrs = span.attributes;
+      return attrs?.model ?? "unknown";
     }
+    default:
+      return span.entityName ?? span.entityId ?? "unknown";
   }
-  return SPAN_KIND_MAPPING[type] || SpanKind.INTERNAL;
 }
-var SpanConverter = class {
-  resource;
-  instrumentationLibrary;
-  constructor(resource) {
-    this.resource = resource;
-    this.instrumentationLibrary = {
-      name: "@mastra/otel-exporter",
-      version: "1.0.0"
-    };
+function getSpanName(span) {
+  const identifier = getSpanIdentifier(span);
+  if (identifier) {
+    const operation = getOperationName(span);
+    return `${operation} ${identifier}`;
   }
-  /**
-   * Convert a Mastra Span to an OpenTelemetry ReadableSpan
-   * This preserves Mastra's trace and span IDs
-   */
-  convertSpan(span) {
-    const spanKind = getSpanKind(span.type, span.isRootSpan);
-    const attributes = this.buildAttributes(span);
-    const spanName = this.buildSpanName(span);
-    const otelSpan = { ...span, name: spanName };
-    return new MastraReadableSpan(
-      otelSpan,
-      attributes,
-      spanKind,
-      span.parentSpanId,
-      // Use the parentSpanId from the Mastra span directly
-      this.resource,
-      this.instrumentationLibrary
-    );
+  return sanitizeSpanName(span.name);
+}
+function getAttributes(span) {
+  const attributes = {};
+  const spanType = span.type.toLowerCase();
+  attributes[ATTR_GEN_AI_OPERATION_NAME] = getOperationName(span);
+  attributes["mastra.span.type"] = span.type;
+  if (span.input !== void 0) {
+    const inputStr = typeof span.input === "string" ? span.input : JSON.stringify(span.input);
+    if (span.type === SpanType.MODEL_GENERATION) {
+      attributes[ATTR_GEN_AI_INPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(inputStr);
+    } else if (span.type === SpanType.TOOL_CALL || span.type === SpanType.MCP_TOOL_CALL) {
+      attributes["gen_ai.tool.call.arguments"] = inputStr;
+    } else {
+      attributes[`mastra.${spanType}.input`] = inputStr;
+    }
   }
-  /**
-   * Build OTEL-compliant span name based on span type and attributes
-   */
-  buildSpanName(Span) {
-    switch (Span.type) {
-      case SpanType.MODEL_GENERATION: {
-        const attrs = Span.attributes;
-        const operation = attrs?.resultType === "tool_selection" ? "tool_selection" : "chat";
-        const model = attrs?.model || "unknown";
-        return `${operation} ${model}`;
-      }
-      case SpanType.TOOL_CALL:
-      case SpanType.MCP_TOOL_CALL: {
-        const toolAttrs = Span.attributes;
-        const toolName = toolAttrs?.toolId || "unknown";
-        return `tool.execute ${toolName}`;
-      }
-      case SpanType.AGENT_RUN: {
-        const agentAttrs = Span.attributes;
-        const agentId = agentAttrs?.agentId || "unknown";
-        return `agent.${agentId}`;
-      }
-      case SpanType.WORKFLOW_RUN: {
-        const workflowAttrs = Span.attributes;
-        const workflowId = workflowAttrs?.workflowId || "unknown";
-        return `workflow.${workflowId}`;
-      }
-      case SpanType.WORKFLOW_STEP:
-        return Span.name;
-      default:
-        return Span.name;
+  if (span.output !== void 0) {
+    const outputStr = typeof span.output === "string" ? span.output : JSON.stringify(span.output);
+    if (span.type === SpanType.MODEL_GENERATION) {
+      attributes[ATTR_GEN_AI_OUTPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(outputStr);
+    } else if (span.type === SpanType.TOOL_CALL || span.type === SpanType.MCP_TOOL_CALL) {
+      attributes["gen_ai.tool.call.result"] = outputStr;
+    } else {
+      attributes[`mastra.${spanType}.output`] = outputStr;
     }
   }
-  /**
-   * Build OpenTelemetry attributes from Mastra Span
-   * Following OTEL Semantic Conventions for GenAI
-   */
-  buildAttributes(Span) {
-    const attributes = {};
-    attributes["gen_ai.operation.name"] = this.getOperationName(Span);
-    attributes["span.kind"] = this.getSpanKindString(Span);
-    attributes["mastra.span.type"] = Span.type;
-    attributes["mastra.trace_id"] = Span.traceId;
-    attributes["mastra.span_id"] = Span.id;
-    if (Span.parentSpanId) {
-      attributes["mastra.parent_span_id"] = Span.parentSpanId;
-    }
-    if (Span.input !== void 0) {
-      const inputStr = typeof Span.input === "string" ? Span.input : JSON.stringify(Span.input);
-      attributes["input"] = inputStr;
-      if (Span.type === SpanType.MODEL_GENERATION) {
-        attributes["gen_ai.prompt"] = inputStr;
-      } else if (Span.type === SpanType.TOOL_CALL || Span.type === SpanType.MCP_TOOL_CALL) {
-        attributes["gen_ai.tool.input"] = inputStr;
-      }
+  if (span.type === SpanType.MODEL_GENERATION && span.attributes) {
+    const modelAttrs = span.attributes;
+    if (modelAttrs.model) {
+      attributes[ATTR_GEN_AI_REQUEST_MODEL] = modelAttrs.model;
     }
-    if (Span.output !== void 0) {
-      const outputStr = typeof Span.output === "string" ? Span.output : JSON.stringify(Span.output);
-      attributes["output"] = outputStr;
-      if (Span.type === SpanType.MODEL_GENERATION) {
-        attributes["gen_ai.completion"] = outputStr;
-      } else if (Span.type === SpanType.TOOL_CALL || Span.type === SpanType.MCP_TOOL_CALL) {
-        attributes["gen_ai.tool.output"] = outputStr;
-      }
+    if (modelAttrs.provider) {
+      attributes[ATTR_GEN_AI_PROVIDER_NAME] = normalizeProvider(modelAttrs.provider);
+    }
+    if (span.entityId) {
+      attributes[ATTR_GEN_AI_AGENT_ID] = span.entityId;
     }
-    if (Span.type === SpanType.MODEL_GENERATION && Span.attributes) {
-      const modelAttrs = Span.attributes;
-      if (modelAttrs.model) {
-        attributes["gen_ai.request.model"] = modelAttrs.model;
+    if (span.entityName) {
+      attributes[ATTR_GEN_AI_AGENT_NAME] = span.entityName;
+    }
+    Object.assign(attributes, formatUsageMetrics(modelAttrs.usage));
+    if (modelAttrs.parameters) {
+      if (modelAttrs.parameters.temperature !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_TEMPERATURE] = modelAttrs.parameters.temperature;
       }
-      if (modelAttrs.provider) {
-        attributes["gen_ai.system"] = modelAttrs.provider;
+      if (modelAttrs.parameters.maxOutputTokens !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_MAX_TOKENS] = modelAttrs.parameters.maxOutputTokens;
       }
-      if (modelAttrs.usage) {
-        const inputTokens = modelAttrs.usage.inputTokens ?? modelAttrs.usage.promptTokens;
-        const outputTokens = modelAttrs.usage.outputTokens ?? modelAttrs.usage.completionTokens;
-        if (inputTokens !== void 0) {
-          attributes["gen_ai.usage.input_tokens"] = inputTokens;
-        }
-        if (outputTokens !== void 0) {
-          attributes["gen_ai.usage.output_tokens"] = outputTokens;
-        }
-        if (modelAttrs.usage.totalTokens !== void 0) {
-          attributes["gen_ai.usage.total_tokens"] = modelAttrs.usage.totalTokens;
-        }
-        if (modelAttrs.usage.reasoningTokens !== void 0) {
-          attributes["gen_ai.usage.reasoning_tokens"] = modelAttrs.usage.reasoningTokens;
-        }
-        if (modelAttrs.usage.cachedInputTokens !== void 0) {
-          attributes["gen_ai.usage.cached_input_tokens"] = modelAttrs.usage.cachedInputTokens;
-        }
+      if (modelAttrs.parameters.topP !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_TOP_P] = modelAttrs.parameters.topP;
       }
-      if (modelAttrs.parameters) {
-        if (modelAttrs.parameters.temperature !== void 0) {
-          attributes["gen_ai.request.temperature"] = modelAttrs.parameters.temperature;
-        }
-        if (modelAttrs.parameters.maxOutputTokens !== void 0) {
-          attributes["gen_ai.request.max_tokens"] = modelAttrs.parameters.maxOutputTokens;
-        }
-        if (modelAttrs.parameters.topP !== void 0) {
-          attributes["gen_ai.request.top_p"] = modelAttrs.parameters.topP;
-        }
-        if (modelAttrs.parameters.topK !== void 0) {
-          attributes["gen_ai.request.top_k"] = modelAttrs.parameters.topK;
-        }
-        if (modelAttrs.parameters.presencePenalty !== void 0) {
-          attributes["gen_ai.request.presence_penalty"] = modelAttrs.parameters.presencePenalty;
-        }
-        if (modelAttrs.parameters.frequencyPenalty !== void 0) {
-          attributes["gen_ai.request.frequency_penalty"] = modelAttrs.parameters.frequencyPenalty;
-        }
-        if (modelAttrs.parameters.stopSequences) {
-          attributes["gen_ai.request.stop_sequences"] = JSON.stringify(modelAttrs.parameters.stopSequences);
-        }
+      if (modelAttrs.parameters.topK !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_TOP_K] = modelAttrs.parameters.topK;
       }
-      if (modelAttrs.finishReason) {
-        attributes["gen_ai.response.finish_reasons"] = modelAttrs.finishReason;
+      if (modelAttrs.parameters.presencePenalty !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_PRESENCE_PENALTY] = modelAttrs.parameters.presencePenalty;
       }
-    }
-    if ((Span.type === SpanType.TOOL_CALL || Span.type === SpanType.MCP_TOOL_CALL) && Span.attributes) {
-      const toolAttrs = Span.attributes;
-      if (toolAttrs.toolId) {
-        attributes["gen_ai.tool.name"] = toolAttrs.toolId;
+      if (modelAttrs.parameters.frequencyPenalty !== void 0) {
+        attributes[ATTR_GEN_AI_REQUEST_FREQUENCY_PENALTY] = modelAttrs.parameters.frequencyPenalty;
       }
-      if (Span.type === SpanType.MCP_TOOL_CALL) {
-        const mcpAttrs = toolAttrs;
-        if (mcpAttrs.mcpServer) {
-          attributes["mcp.server"] = mcpAttrs.mcpServer;
-        }
-        if (mcpAttrs.serverVersion) {
-          attributes["mcp.server.version"] = mcpAttrs.serverVersion;
-        }
-      } else {
-        if (toolAttrs.toolDescription) {
-          attributes["gen_ai.tool.description"] = toolAttrs.toolDescription;
-        }
+      if (modelAttrs.parameters.stopSequences) {
+        attributes[ATTR_GEN_AI_REQUEST_STOP_SEQUENCES] = JSON.stringify(modelAttrs.parameters.stopSequences);
       }
-      if (toolAttrs.success !== void 0) {
-        attributes["gen_ai.tool.success"] = toolAttrs.success;
+      if (modelAttrs.parameters.seed) {
+        attributes[ATTR_GEN_AI_REQUEST_SEED] = modelAttrs.parameters.seed;
       }
     }
-    if (Span.type === SpanType.AGENT_RUN && Span.attributes) {
-      const agentAttrs = Span.attributes;
-      if (agentAttrs.agentId) {
-        attributes["agent.id"] = agentAttrs.agentId;
-        attributes["gen_ai.agent.id"] = agentAttrs.agentId;
+    if (modelAttrs.finishReason) {
+      attributes[ATTR_GEN_AI_RESPONSE_FINISH_REASONS] = JSON.stringify([modelAttrs.finishReason]);
+    }
+    if (modelAttrs.responseModel) {
+      attributes[ATTR_GEN_AI_RESPONSE_MODEL] = modelAttrs.responseModel;
+    }
+    if (modelAttrs.responseId) {
+      attributes[ATTR_GEN_AI_RESPONSE_ID] = modelAttrs.responseId;
+    }
+    if (modelAttrs.serverAddress) {
+      attributes[ATTR_SERVER_ADDRESS] = modelAttrs.serverAddress;
+    }
+    if (modelAttrs.serverPort !== void 0) {
+      attributes[ATTR_SERVER_PORT] = modelAttrs.serverPort;
+    }
+  }
+  if ((span.type === SpanType.TOOL_CALL || span.type === SpanType.MCP_TOOL_CALL) && span.attributes) {
+    attributes[ATTR_GEN_AI_TOOL_NAME] = span.entityName ?? span.entityId;
+    if (span.type === SpanType.MCP_TOOL_CALL) {
+      const mcpAttrs = span.attributes;
+      if (mcpAttrs.mcpServer) {
+        attributes[ATTR_SERVER_ADDRESS] = mcpAttrs.mcpServer;
       }
-      if (agentAttrs.maxSteps) {
-        attributes["agent.max_steps"] = agentAttrs.maxSteps;
+    } else {
+      const toolAttrs = span.attributes;
+      if (toolAttrs.toolDescription) {
+        attributes[ATTR_GEN_AI_TOOL_DESCRIPTION] = toolAttrs.toolDescription;
       }
-      if (agentAttrs.availableTools) {
-        attributes["agent.available_tools"] = JSON.stringify(agentAttrs.availableTools);
+      if (toolAttrs.toolType) {
+        attributes["gen_ai.tool.type"] = toolAttrs.toolType;
       }
     }
-    if (Span.type === SpanType.WORKFLOW_RUN && Span.attributes) {
-      const workflowAttrs = Span.attributes;
-      if (workflowAttrs.workflowId) {
-        attributes["workflow.id"] = workflowAttrs.workflowId;
-      }
-      if (workflowAttrs.status) {
-        attributes["workflow.status"] = workflowAttrs.status;
-      }
+  }
+  if (span.type === SpanType.AGENT_RUN && span.attributes) {
+    const agentAttrs = span.attributes;
+    if (span.entityId) {
+      attributes[ATTR_GEN_AI_AGENT_ID] = span.entityId;
     }
-    if (Span.errorInfo) {
-      attributes["error"] = true;
-      attributes["error.type"] = Span.errorInfo.id || "unknown";
-      attributes["error.message"] = Span.errorInfo.message;
-      if (Span.errorInfo.domain) {
-        attributes["error.domain"] = Span.errorInfo.domain;
-      }
-      if (Span.errorInfo.category) {
-        attributes["error.category"] = Span.errorInfo.category;
-      }
+    if (span.entityName) {
+      attributes[ATTR_GEN_AI_AGENT_NAME] = span.entityName;
     }
-    if (Span.metadata) {
-      Object.entries(Span.metadata).forEach(([key, value]) => {
-        if (!attributes[key]) {
-          if (value === null || value === void 0) {
-            return;
-          }
-          if (typeof value === "object") {
-            attributes[key] = JSON.stringify(value);
-          } else {
-            attributes[key] = value;
-          }
-        }
-      });
+    if (agentAttrs.conversationId) {
+      attributes[ATTR_GEN_AI_CONVERSATION_ID] = agentAttrs.conversationId;
     }
-    if (Span.startTime) {
-      attributes["mastra.start_time"] = Span.startTime.toISOString();
+    if (agentAttrs.maxSteps) {
+      attributes[`mastra.${spanType}.max_steps`] = agentAttrs.maxSteps;
     }
-    if (Span.endTime) {
-      attributes["mastra.end_time"] = Span.endTime.toISOString();
-      const duration = Span.endTime.getTime() - Span.startTime.getTime();
-      attributes["mastra.duration_ms"] = duration;
+    if (agentAttrs.availableTools) {
+      attributes[`gen_ai.tool.definitions`] = JSON.stringify(agentAttrs.availableTools);
     }
-    return attributes;
+    attributes[ATTR_GEN_AI_SYSTEM_INSTRUCTIONS] = agentAttrs.instructions;
+  }
+  if (span.errorInfo) {
+    attributes[ATTR_ERROR_TYPE] = span.errorInfo.id || "unknown";
+    attributes[ATTR_ERROR_MESSAGE] = span.errorInfo.message;
+    if (span.errorInfo.domain) {
+      attributes["error.domain"] = span.errorInfo.domain;
+    }
+    if (span.errorInfo.category) {
+      attributes["error.category"] = span.errorInfo.category;
+    }
+  }
+  return attributes;
+}
+var PROVIDER_ALIASES = {
+  anthropic: ["anthropic", "claude"],
+  "aws.bedrock": ["awsbedrock", "bedrock", "amazonbedrock"],
+  "azure.ai.inference": ["azureaiinference", "azureinference"],
+  "azure.ai.openai": ["azureaiopenai", "azureopenai", "msopenai", "microsoftopenai"],
+  cohere: ["cohere"],
+  deepseek: ["deepseek"],
+  "gcp.gemini": ["gcpgemini", "gemini"],
+  "gcp.gen_ai": ["gcpgenai", "googlegenai", "googleai"],
+  "gcp.vertex_ai": ["gcpvertexai", "vertexai"],
+  groq: ["groq"],
+  "ibm.watsonx.ai": ["ibmwatsonxai", "watsonx", "watsonxai"],
+  mistral_ai: ["mistral", "mistralai"],
+  openai: ["openai", "oai"],
+  perplexity: ["perplexity", "pplx"],
+  x_ai: ["xai", "x-ai", "x_ai", "x.com ai"]
+};
+function normalizeProviderString(input) {
+  return input.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function normalizeProvider(providerName) {
+  const normalized = normalizeProviderString(providerName);
+  for (const [canonical, aliases] of Object.entries(PROVIDER_ALIASES)) {
+    for (const alias of aliases) {
+      if (normalized === alias) {
+        return canonical;
+      }
+    }
+  }
+  return providerName.toLowerCase();
+}
+
+// src/span-converter.ts
+var SpanConverter = class {
+  constructor(params) {
+    this.params = params;
+    this.format = params.format;
   }
+  resource;
+  scope;
+  initPromise;
+  format;
   /**
-   * Get the operation name based on span type for gen_ai.operation.name
+   * Lazily initialize resource & scope on first use.
+   * Subsequent calls reuse the same promise (no races).
    */
-  getOperationName(Span) {
-    switch (Span.type) {
-      case SpanType.MODEL_GENERATION: {
-        const attrs = Span.attributes;
-        return attrs?.resultType === "tool_selection" ? "tool_selection" : "chat";
-      }
-      case SpanType.TOOL_CALL:
-      case SpanType.MCP_TOOL_CALL:
-        return "tool.execute";
-      case SpanType.AGENT_RUN:
-        return "agent.run";
-      case SpanType.WORKFLOW_RUN:
-        return "workflow.run";
-      default:
-        return Span.type.replace(/_/g, ".");
+  async initIfNeeded() {
+    if (this.initPromise) {
+      return this.initPromise;
     }
+    this.initPromise = (async () => {
+      const packageVersion = await getPackageVersion(this.params.packageName) ?? "unknown";
+      const serviceVersion = await getPackageVersion("@mastra/core") ?? "unknown";
+      let resource = resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: this.params.serviceName || "mastra-service",
+        [ATTR_SERVICE_VERSION]: serviceVersion,
+        [ATTR_TELEMETRY_SDK_NAME]: this.params.packageName,
+        [ATTR_TELEMETRY_SDK_VERSION]: packageVersion,
+        [ATTR_TELEMETRY_SDK_LANGUAGE]: "nodejs"
+      });
+      if (this.params.config?.resourceAttributes) {
+        resource = resource.merge(
+          // Duplicate attributes from config will override defaults above
+          resourceFromAttributes(this.params.config.resourceAttributes)
+        );
+      }
+      this.resource = resource;
+      this.scope = {
+        name: this.params.packageName,
+        version: packageVersion
+      };
+    })();
+    return this.initPromise;
   }
   /**
-   * Get span kind as string for attribute
+   * Convert a Mastra Span to an OpenTelemetry ReadableSpan
    */
-  getSpanKindString(Span) {
-    const kind = getSpanKind(Span.type, Span.isRootSpan);
-    switch (kind) {
-      case SpanKind.SERVER:
-        return "server";
-      case SpanKind.CLIENT:
-        return "client";
-      case SpanKind.INTERNAL:
-        return "internal";
-      case SpanKind.PRODUCER:
-        return "producer";
-      case SpanKind.CONSUMER:
-        return "consumer";
-      default:
-        return "internal";
+  async convertSpan(span) {
+    await this.initIfNeeded();
+    if (!this.resource || !this.scope) {
+      throw new Error("SpanConverter not initialized correctly");
+    }
+    const name = getSpanName(span);
+    const kind = getSpanKind(span.type);
+    const attributes = getAttributes(span);
+    if (span.metadata) {
+      for (const [k, v] of Object.entries(span.metadata)) {
+        if (v === null || v === void 0) {
+          continue;
+        }
+        attributes[`mastra.metadata.${k}`] = typeof v === "object" ? JSON.stringify(v) : v;
+      }
+    }
+    if (span.isRootSpan && span.tags?.length) {
+      attributes["mastra.tags"] = JSON.stringify(span.tags);
     }
+    const startTime = dateToHrTime(span.startTime);
+    const endTime = span.endTime ? dateToHrTime(span.endTime) : startTime;
+    const duration = computeDuration(span.startTime, span.endTime);
+    const { status, events } = buildStatusAndEvents(span, startTime);
+    const spanContext = {
+      traceId: span.traceId,
+      spanId: span.id,
+      traceFlags: TraceFlags.SAMPLED,
+      isRemote: false
+    };
+    const parentSpanContext = span.parentSpanId ? {
+      traceId: span.traceId,
+      spanId: span.parentSpanId,
+      traceFlags: TraceFlags.SAMPLED,
+      isRemote: false
+    } : void 0;
+    const links = [];
+    const readable = {
+      name,
+      kind,
+      spanContext: () => spanContext,
+      parentSpanContext,
+      startTime,
+      endTime,
+      status,
+      attributes,
+      links,
+      events,
+      duration,
+      ended: !!span.endTime,
+      resource: this.resource,
+      instrumentationScope: this.scope,
+      droppedAttributesCount: 0,
+      droppedEventsCount: 0,
+      droppedLinksCount: 0
+    };
+    return readable;
   }
 };
+async function getPackageVersion(pkgName) {
+  try {
+    const manifestUrl = new URL(await import.meta.resolve(`${pkgName}/package.json`));
+    const path = fileURLToPath(manifestUrl);
+    const pkgJson = JSON.parse(readFileSync(path, "utf8"));
+    return pkgJson.version;
+  } catch {
+    return void 0;
+  }
+}
+function getSpanKind(type) {
+  switch (type) {
+    case SpanType.MODEL_GENERATION:
+    case SpanType.MCP_TOOL_CALL:
+      return SpanKind.CLIENT;
+    default:
+      return SpanKind.INTERNAL;
+  }
+}
+function dateToHrTime(date) {
+  const ms = date.getTime();
+  const seconds = Math.floor(ms / 1e3);
+  const nanoseconds = ms % 1e3 * 1e6;
+  return [seconds, nanoseconds];
+}
+function computeDuration(start, end) {
+  if (!end) return [0, 0];
+  const diffMs = end.getTime() - start.getTime();
+  return [Math.floor(diffMs / 1e3), diffMs % 1e3 * 1e6];
+}
+function buildStatusAndEvents(span, defaultTime) {
+  const events = [];
+  if (span.errorInfo) {
+    const status = {
+      code: SpanStatusCode.ERROR,
+      message: span.errorInfo.message
+    };
+    events.push({
+      name: "exception",
+      attributes: {
+        "exception.message": span.errorInfo.message,
+        "exception.type": "Error",
+        ...span.errorInfo.details?.stack && {
+          "exception.stacktrace": span.errorInfo.details.stack
+        }
+      },
+      time: defaultTime,
+      droppedAttributesCount: 0
+    });
+    return { status, events };
+  }
+  if (span.endTime) {
+    return {
+      status: { code: SpanStatusCode.OK },
+      events
+    };
+  }
+  return {
+    status: { code: SpanStatusCode.UNSET },
+    events
+  };
+}
 
 // src/tracing.ts
 var OtelExporter = class extends BaseExporter {
   config;
-  tracingConfig;
+  observabilityConfig;
   spanConverter;
   processor;
   exporter;
@@ -601,7 +686,6 @@ var OtelExporter = class extends BaseExporter {
   constructor(config) {
     super(config);
     this.config = config;
-    this.spanConverter = new SpanConverter();
     if (config.logLevel === "debug") {
       diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);
     }
@@ -610,7 +694,7 @@ var OtelExporter = class extends BaseExporter {
    * Initialize with tracing configuration
    */
   init(options) {
-    this.tracingConfig = options.config;
+    this.observabilityConfig = options.config;
   }
   async setupExporter() {
     if (this.isSetup || this.exporter) return;
@@ -688,21 +772,12 @@ var OtelExporter = class extends BaseExporter {
   }
   async setupProcessor() {
     if (this.processor || this.isSetup) return;
-    let resource = resourceFromAttributes({
-      [ATTR_SERVICE_NAME]: this.tracingConfig?.serviceName || "mastra-service",
-      [ATTR_SERVICE_VERSION]: "1.0.0",
-      // Add telemetry SDK information
-      [ATTR_TELEMETRY_SDK_NAME]: "@mastra/otel-exporter",
-      [ATTR_TELEMETRY_SDK_VERSION]: "1.0.0",
-      [ATTR_TELEMETRY_SDK_LANGUAGE]: "nodejs"
+    this.spanConverter = new SpanConverter({
+      packageName: "@mastra/otel-exporter",
+      serviceName: this.observabilityConfig?.serviceName,
+      config: this.config,
+      format: "GenAI_v1_38_0"
     });
-    if (this.config.resourceAttributes) {
-      resource = resource.merge(
-        // Duplicate attributes from config will override defaults above
-        resourceFromAttributes(this.config.resourceAttributes)
-      );
-    }
-    this.spanConverter = new SpanConverter(resource);
     this.processor = new BatchSpanProcessor(this.exporter, {
       maxExportBatchSize: this.config.batchSize || 512,
       // Default batch size
@@ -738,9 +813,9 @@ var OtelExporter = class extends BaseExporter {
       return;
     }
     try {
-      const readableSpan = this.spanConverter.convertSpan(span);
+      const otelSpan = await this.spanConverter.convertSpan(span);
       await new Promise((resolve) => {
-        this.processor.onEnd(readableSpan);
+        this.processor.onEnd(otelSpan);
         resolve();
       });
       this.logger.debug(
@@ -757,6 +832,6 @@ var OtelExporter = class extends BaseExporter {
   }
 };
 
-export { MastraReadableSpan, OtelExporter, SpanConverter, getSpanKind };
+export { OtelExporter, SpanConverter, getSpanKind };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map