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

package/dist/gen-ai-semantics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Utilities for converting Mastra Spans to OTel Spans
+ * with Semantic conventions for generative AI systems
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/v1.38.0/docs/gen-ai/README.md
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/v1.38.0/docs/gen-ai/gen-ai-events.md
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/v1.38.0/docs/gen-ai/gen-ai-spans.md
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/v1.38.0/docs/gen-ai/gen-ai-agent-spans.md
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/non-normative/examples-llm-calls/
+ * @see https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/
+ */
+import type { AnyExportedSpan, UsageStats } from '@mastra/core/observability';
+import type { Attributes } from '@opentelemetry/api';
+import { ATTR_GEN_AI_USAGE_INPUT_TOKENS, ATTR_GEN_AI_USAGE_OUTPUT_TOKENS } from '@opentelemetry/semantic-conventions/incubating';
+/**
+ * Token usage attributes following OTel GenAI semantic conventions.
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ */
+export interface OtelUsageMetrics {
+    [ATTR_GEN_AI_USAGE_INPUT_TOKENS]?: number;
+    [ATTR_GEN_AI_USAGE_OUTPUT_TOKENS]?: number;
+    'gen_ai.usage.reasoning_tokens'?: number;
+    'gen_ai.usage.cached_input_tokens'?: number;
+    'gen_ai.usage.cache_write_tokens'?: number;
+    'gen_ai.usage.audio_input_tokens'?: number;
+    'gen_ai.usage.audio_output_tokens'?: number;
+}
+/**
+ * Formats UsageStats to OTel GenAI semantic convention attributes.
+ */
+export declare function formatUsageMetrics(usage?: UsageStats): OtelUsageMetrics;
+/**
+ * Get an OTEL-compliant span name based on span type and attributes
+ */
+export declare function getSpanName(span: AnyExportedSpan): string;
+/**
+ * Gets OpenTelemetry attributes from Mastra Span
+ * Following OTEL Semantic Conventions for GenAI
+ */
+export declare function getAttributes(span: AnyExportedSpan): Attributes;
+//# sourceMappingURL=gen-ai-semantics.d.ts.map

package/dist/gen-ai-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-ai-semantics.d.ts","sourceRoot":"","sources":["../src/gen-ai-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,eAAe,EAIf,UAAU,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAgBL,8BAA8B,EAC9B,+BAA+B,EAYhC,MAAM,gDAAgD,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,8BAA8B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC,+BAA+B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3C,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAqCvE;AAuCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CA+K/D"}