npm - @mastra/otel-bridge - Versions diffs - 1.0.0-beta.1 → 1.0.0-beta.3 - Mend

@mastra/otel-bridge 1.0.0-beta.1 → 1.0.0-beta.3

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.

Files changed (8) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,52 @@
 # @mastra/otel-bridge
+## 1.0.0-beta.3
+### Patch Changes
+- Updated dependencies [[`72df8ae`](https://github.com/mastra-ai/mastra/commit/72df8ae595584cdd7747d5c39ffaca45e4507227), [`9198899`](https://github.com/mastra-ai/mastra/commit/91988995c427b185c33714b7f3be955367911324), [`653e65a`](https://github.com/mastra-ai/mastra/commit/653e65ae1f9502c2958a32f47a5a2df11e612a92), [`c6fd6fe`](https://github.com/mastra-ai/mastra/commit/c6fd6fedd09e9cf8004b03a80925f5e94826ad7e), [`0bed332`](https://github.com/mastra-ai/mastra/commit/0bed332843f627202c6520eaf671771313cd20f3)]:
+  - @mastra/core@1.0.0-beta.9
+  - @mastra/otel-exporter@1.0.0-beta.4
+## 1.0.0-beta.2
+### Patch Changes
+- Updated OtelExporters, Bridge, and Arize packages to better implement GenAI v1.38.0 Otel Semantic Conventions. See: ([#10591](https://github.com/mastra-ai/mastra/pull/10591))
+  https://github.com/open-telemetry/semantic-conventions/blob/v1.38.0/docs/gen-ai/README.md
+- feat(observability): Add tags support to OtelExporter, OtelBridge, and ArizeExporter ([#10843](https://github.com/mastra-ai/mastra/pull/10843))
+  This change adds support for the `tracingOptions.tags` feature to the OpenTelemetry-based exporters and bridge. Tags are now included as span attributes when present on root spans, following the same pattern as Braintrust and Langfuse exporters.
+  **Changes:**
+  - **OtelExporter**: Tags are now included as `mastra.tags` span attribute for root spans
+  - **OtelBridge**: Tags flow through the SpanConverter and are included in native OTEL spans as `mastra.tags`
+  - **ArizeExporter**: Tags are mapped to the native OpenInference `tag.tags` semantic convention
+  **Implementation Details:**
+  - Tags are only included on root spans (by design)
+  - Tags are stored as JSON-stringified arrays for maximum backend compatibility (many OTEL backends have limited native array support)
+  - Empty or undefined tag arrays are not included in span attributes
+  **Usage:**
+  ```typescript
+  const result = await agent.generate({
+    messages: [{ role: 'user', content: 'Hello' }],
+    tracingOptions: {
+      tags: ['production', 'experiment-v2'],
+    },
+  });
+  ```
+  Fixes #10771
+- Updated dependencies [[`6c59a40`](https://github.com/mastra-ai/mastra/commit/6c59a40e0ad160467bd13d63a8a287028d75b02d), [`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`db500e8`](https://github.com/mastra-ai/mastra/commit/db500e8b8c5b4df9bd3590a7da6e007c08f94945), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`0bada2f`](https://github.com/mastra-ai/mastra/commit/0bada2f2c1234932cf30c1c47a719ffb64b801c5), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`cc60ff6`](https://github.com/mastra-ai/mastra/commit/cc60ff616541a3b0fb531a7e469bf9ae7bb90528), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
+  - @mastra/observability@1.0.0-beta.3
+  - @mastra/core@1.0.0-beta.7
+  - @mastra/otel-exporter@1.0.0-beta.3
 ## 1.0.0-beta.1
 ### Minor Changes

package/dist/bridge.d.ts CHANGED Viewed

@@ -11,7 +11,7 @@
  * nested within OTEL spans from auto-instrumentation, and any OTEL-instrumented
  * operations within Mastra spans maintain the correct hierarchy.
  */
-import type { ObservabilityBridge, TracingEvent, CreateSpanOptions, SpanType, SpanIds } from '@mastra/core/observability';
+import type { ObservabilityBridge, TracingEvent, CreateSpanOptions, SpanType, SpanIds, InitExporterOptions } from '@mastra/core/observability';
 import { BaseExporter } from '@mastra/observability';
 /**
  * Configuration for the OtelBridge
@@ -45,7 +45,7 @@ export declare class OtelBridge extends BaseExporter implements ObservabilityBri
     name: string;
     private otelTracer;
     private otelSpanMap;
-    private spanConverter;
+    private spanConverter?;
     constructor(config?: OtelBridgeConfig);
     /**
      * Handle Mastra tracing events
@@ -56,6 +56,10 @@ export declare class OtelBridge extends BaseExporter implements ObservabilityBri
      * Note: OTEL spans are created when registerSpan is called when the span is first created.
      */
     protected _exportTracingEvent(event: TracingEvent): Promise<void>;
+    /**
+     * Initialize with tracing configuration
+     */
+    init(options: InitExporterOptions): void;
     /**
      * Create a span in the bridge's tracing system.
      * Called during Mastra span construction to get bridge-generated identifiers.

package/dist/bridge.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,OAAO,~~EACR~~,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAK1E;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,EAE9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,SAAQ,YAAa,YAAW,mBAAmB;IACzE,IAAI,SAAU;IACd,OAAO,CAAC,UAAU,CAAuD;IACzE,OAAO,CAAC,WAAW,CAAuE;IAC1F,OAAO,CAAC,aAAa,~~CAAuB~~;~~gBAEhC~~,MAAM,GAAE,gBAAqB;IAIzC;;;;;;;OAOG;cACa,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,SAAS;~~IAoDrE~~;;;;;OAKG;YACW,eAAe;~~IAoD7B~~;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE;;;;;;OAMG;IACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}
1	+ {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAK1E;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,EAE9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,SAAQ,YAAa,YAAW,mBAAmB;IACzE,IAAI,SAAU;IACd,OAAO,CAAC,UAAU,CAAuD;IACzE,OAAO,CAAC,WAAW,CAAuE;IAC1F,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAE1B,MAAM,GAAE,gBAAqB;IAIzC;;;;;;;OAOG;cACa,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,mBAAmB;IAQjC;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,SAAS;IAmDrE;;;;;OAKG;YACW,eAAe;IAwD7B;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE;;;;;;OAMG;IACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/index.cjs CHANGED Viewed

@@ -10,7 +10,7 @@ var OtelBridge = class extends observability.BaseExporter {
   name = "otel";
   otelTracer = api.trace.getTracer("@mastra/otel-bridge", "1.0.0");
   otelSpanMap = /* @__PURE__ */ new Map();
-  spanConverter = new otelExporter.SpanConverter();
+  spanConverter;
   constructor(config = {}) {
     super(config);
   }
@@ -27,6 +27,16 @@ var OtelBridge = class extends observability.BaseExporter {
       await this.handleSpanEnded(event);
     }
   }
+  /**
+   * Initialize with tracing configuration
+   */
+  init(options) {
+    this.spanConverter = new otelExporter.SpanConverter({
+      packageName: "@mastra/otel-bridge",
+      serviceName: options.config?.serviceName,
+      format: "GenAI_v1_38_0"
+    });
+  }
   /**
    * Create a span in the bridge's tracing system.
    * Called during Mastra span construction to get bridge-generated identifiers.
@@ -44,11 +54,10 @@ var OtelBridge = class extends observability.BaseExporter {
           parentOtelContext = parentEntry.otelContext;
         }
       }
-      const isRootSpan = !options.parent;
       const otelSpan = this.otelTracer.startSpan(
         options.name,
         {
-          kind: otelExporter.getSpanKind(options.type, isRootSpan)
+          kind: otelExporter.getSpanKind(options.type)
         },
         parentOtelContext
       );
@@ -83,9 +92,12 @@ var OtelBridge = class extends observability.BaseExporter {
         return;
       }
       this.otelSpanMap.delete(mastraSpan.id);
+      if (!this.spanConverter) {
+        return;
+      }
       const { otelSpan } = entry;
       this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);
-      const readableSpan = this.spanConverter.convertSpan(mastraSpan);
+      const readableSpan = await this.spanConverter.convertSpan(mastraSpan);
       otelSpan.updateName(readableSpan.name);
       for (const [key, value] of Object.entries(readableSpan.attributes)) {
         if (value !== void 0 && value !== null && typeof value !== "object") {

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/bridge.ts"],"names":["BaseExporter","otelTrace","SpanConverter","TracingEventType","otelContext","getExternalParentId","getSpanKind","event"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n OpenTelemetry Bridge for Mastra Observability\n \n This bridge enables bidirectional integration with OpenTelemetry infrastructure:\n * 1. Reads OTEL trace context from active spans (via AsyncLocalStorage)\n * 2. Creates real OTEL spans when Mastra spans are created\n * 3. Maintains span context for proper parent-child relationships\n * 4. Allows OTEL-instrumented code (DB, HTTP clients) in tools/workflows to have correct parents\n \n This creates complete distributed traces where Mastra spans are properly\n * nested within OTEL spans from auto-instrumentation, and any OTEL-instrumented\n * operations within Mastra spans maintain the correct hierarchy.\n /\n\nimport type {\n ObservabilityBridge,\n TracingEvent,\n CreateSpanOptions,\n SpanType,\n SpanIds,\n} from '@mastra/core/observability';\nimport { TracingEventType } from '@mastra/core/observability';\nimport { BaseExporter, getExternalParentId } from '@mastra/observability';\nimport { SpanConverter, getSpanKind } from '@mastra/otel-exporter';\nimport { trace as otelTrace, context as otelContext } from '@opentelemetry/api';\nimport type { Span as OtelSpan, Context as OtelContext } from '@opentelemetry/api';\n\n/\n Configuration for the OtelBridge\n /\n\nexport type OtelBridgeConfig = {\n // Currently no configuration options - placeholder for future options\n};\n\n/\n OpenTelemetry Bridge implementation\n \n Creates real OTEL spans when Mastra spans are created, maintaining proper\n * context propagation for nested instrumentation.\n \n @example\n * ```typescript\n * import { OtelBridge } from '@mastra/otel-bridge';\n * import { Mastra } from '@mastra/core';\n \n const mastra = new Mastra({\n * agents: { myAgent },\n * observability: {\n * configs: {\n * default: {\n * serviceName: 'my-service',\n * bridge: new OtelBridge(),\n * }\n * }\n * }\n * });\n * ```\n /\nexport class OtelBridge extends BaseExporter implements ObservabilityBridge {\n name = 'otel';\n private otelTracer = otelTrace.getTracer('@mastra/otel-bridge', '1.0.0');\n private otelSpanMap = new Map<string, { otelSpan: OtelSpan; otelContext: OtelContext }>();\n private spanConverter = new SpanConverter();\n\n constructor(config: OtelBridgeConfig = {}) {\n super(config);\n }\n\n /\n Handle Mastra tracing events\n \n Ships OTEL spans when Mastra spans end.\n * This maintains proper span hierarchy and allows OTEL-instrumented code within\n * Mastra spans to have correct parent-child relationships.\n * Note: OTEL spans are created when registerSpan is called when the span is first created.\n /\n protected async _exportTracingEvent(event: TracingEvent): Promise<void> {\n if (event.type === TracingEventType.SPAN_ENDED) {\n await this.handleSpanEnded(event);\n }\n }\n\n /\n Create a span in the bridge's tracing system.\n * Called during Mastra span construction to get bridge-generated identifiers.\n \n @param options - Span creation options from Mastra\n * @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails\n /\n createSpan(options: CreateSpanOptions<SpanType>): SpanIds \| undefined {\n try {\n // Determine parent context\n let parentOtelContext = otelContext.active();\n\n // Get external parent ID (walks up chain to find non-internal parent)\n const externalParentId = getExternalParentId(options);\n if (externalParentId) {\n // Look up external parent's OTEL span from map\n const parentEntry = this.otelSpanMap.get(externalParentId);\n if (parentEntry) {\n parentOtelContext = parentEntry.otelContext;\n }\n }\n\n // Create OTEL span with SpanKind (must be set at creation, immutable)\n const isRootSpan = !options.parent;\n const otelSpan = this.otelTracer.startSpan(\n options.name,\n {\n kind: getSpanKind(options.type, isRootSpan),\n },\n parentOtelContext,\n );\n\n // Create context with this span active\n const spanContext = otelTrace.setSpan(parentOtelContext, otelSpan);\n\n // Get OTEL span identifiers\n const otelSpanContext = otelSpan.spanContext();\n const spanId = otelSpanContext.spanId;\n const traceId = otelSpanContext.traceId;\n\n // Store for later retrieval (for executeWithSpanContext and event handling)\n this.otelSpanMap.set(spanId, { otelSpan, otelContext: spanContext });\n\n // Get parentSpanId from parent context if available\n const parentSpan = otelTrace.getSpan(parentOtelContext);\n const parentSpanId = parentSpan?.spanContext().spanId;\n\n this.logger.debug(\n `[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] ` +\n `[parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`,\n );\n\n return { spanId, traceId, parentSpanId };\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to create span:', error);\n return undefined;\n }\n }\n\n /\n Handle SPAN_ENDED event\n \n Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,\n * events, and status, then ends the span. Cleans up the span map entry.\n /\n private async handleSpanEnded(event: TracingEvent): Promise<void> {\n try {\n const mastraSpan = event.exportedSpan;\n const entry = this.otelSpanMap.get(mastraSpan.id);\n\n if (!entry) {\n this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);\n return;\n }\n\n // Remove from map immediately to prevent memory leak\n this.otelSpanMap.delete(mastraSpan.id);\n\n const { otelSpan } = entry;\n\n this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);\n\n // Use SpanConverter to get consistent span formatting with otel-exporter\n const readableSpan = this.spanConverter.convertSpan(mastraSpan);\n\n // Update span name to match the converter's formatting\n otelSpan.updateName(readableSpan.name);\n\n // Set all attributes from the converter (includes OTEL semantic conventions)\n for (const [key, value] of Object.entries(readableSpan.attributes)) {\n if (value !== undefined && value !== null && typeof value !== 'object') {\n otelSpan.setAttribute(key, value);\n }\n }\n\n // Set status from the converter\n otelSpan.setStatus(readableSpan.status);\n\n // Add exception events if present\n for (const event of readableSpan.events) {\n if (event.name === 'exception' && event.attributes) {\n const error = new Error(event.attributes['exception.message'] as string);\n otelSpan.recordException(error);\n }\n }\n\n // End the span with the actual end time\n otelSpan.end(mastraSpan.endTime);\n\n this.logger.debug(\n `[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`,\n );\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to handle SPAN_ENDED:', error);\n }\n }\n\n /\n Execute a function (sync or async) within the OTEL context of a Mastra span.\n * Retrieves the stored OTEL context for the span and executes the function within it.\n \n This is the core implementation used by both executeInContext and executeInContextSync.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The function to execute within the span context\n * @returns The result of the function execution\n /\n private executeWithSpanContext<T>(spanId: string, fn: () => T): T {\n const entry = this.otelSpanMap.get(spanId);\n\n this.logger.debug(\n `[OtelBridge.executeWithSpanContext] spanId=${spanId}, ` +\n `inMap=${!!entry}, ` +\n `storedOtelSpan=${entry?.otelSpan.spanContext().spanId \|\| 'none'}`,\n );\n\n const spanContext = entry?.otelContext;\n if (spanContext) {\n return otelContext.with(spanContext, fn);\n }\n return fn();\n }\n\n /\n Execute an async function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The async function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T> {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Execute a synchronous function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The synchronous function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContextSync<T>(spanId: string, fn: () => T): T {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Shutdown the bridge and clean up resources\n */\n async shutdown(): Promise<void> {\n // End any remaining spans\n for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {\n this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);\n otelSpan.end();\n }\n this.otelSpanMap.clear();\n this.logger.info('[OtelBridge] Shutdown complete');\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/bridge.ts"],"names":["BaseExporter","otelTrace","TracingEventType","SpanConverter","otelContext","getExternalParentId","getSpanKind","event"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n OpenTelemetry Bridge for Mastra Observability\n \n This bridge enables bidirectional integration with OpenTelemetry infrastructure:\n * 1. Reads OTEL trace context from active spans (via AsyncLocalStorage)\n * 2. Creates real OTEL spans when Mastra spans are created\n * 3. Maintains span context for proper parent-child relationships\n * 4. Allows OTEL-instrumented code (DB, HTTP clients) in tools/workflows to have correct parents\n \n This creates complete distributed traces where Mastra spans are properly\n * nested within OTEL spans from auto-instrumentation, and any OTEL-instrumented\n * operations within Mastra spans maintain the correct hierarchy.\n /\n\nimport type {\n ObservabilityBridge,\n TracingEvent,\n CreateSpanOptions,\n SpanType,\n SpanIds,\n InitExporterOptions,\n} from '@mastra/core/observability';\nimport { TracingEventType } from '@mastra/core/observability';\nimport { BaseExporter, getExternalParentId } from '@mastra/observability';\nimport { SpanConverter, getSpanKind } from '@mastra/otel-exporter';\nimport { trace as otelTrace, context as otelContext } from '@opentelemetry/api';\nimport type { Span as OtelSpan, Context as OtelContext } from '@opentelemetry/api';\n\n/\n Configuration for the OtelBridge\n /\n\nexport type OtelBridgeConfig = {\n // Currently no configuration options - placeholder for future options\n};\n\n/\n OpenTelemetry Bridge implementation\n \n Creates real OTEL spans when Mastra spans are created, maintaining proper\n * context propagation for nested instrumentation.\n \n @example\n * ```typescript\n * import { OtelBridge } from '@mastra/otel-bridge';\n * import { Mastra } from '@mastra/core';\n \n const mastra = new Mastra({\n * agents: { myAgent },\n * observability: {\n * configs: {\n * default: {\n * serviceName: 'my-service',\n * bridge: new OtelBridge(),\n * }\n * }\n * }\n * });\n * ```\n /\nexport class OtelBridge extends BaseExporter implements ObservabilityBridge {\n name = 'otel';\n private otelTracer = otelTrace.getTracer('@mastra/otel-bridge', '1.0.0');\n private otelSpanMap = new Map<string, { otelSpan: OtelSpan; otelContext: OtelContext }>();\n private spanConverter?: SpanConverter;\n\n constructor(config: OtelBridgeConfig = {}) {\n super(config);\n }\n\n /\n Handle Mastra tracing events\n \n Ships OTEL spans when Mastra spans end.\n * This maintains proper span hierarchy and allows OTEL-instrumented code within\n * Mastra spans to have correct parent-child relationships.\n * Note: OTEL spans are created when registerSpan is called when the span is first created.\n /\n protected async _exportTracingEvent(event: TracingEvent): Promise<void> {\n if (event.type === TracingEventType.SPAN_ENDED) {\n await this.handleSpanEnded(event);\n }\n }\n\n /\n Initialize with tracing configuration\n /\n init(options: InitExporterOptions) {\n this.spanConverter = new SpanConverter({\n packageName: '@mastra/otel-bridge',\n serviceName: options.config?.serviceName,\n format: 'GenAI_v1_38_0',\n });\n }\n\n /\n Create a span in the bridge's tracing system.\n * Called during Mastra span construction to get bridge-generated identifiers.\n \n @param options - Span creation options from Mastra\n * @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails\n /\n createSpan(options: CreateSpanOptions<SpanType>): SpanIds \| undefined {\n try {\n // Determine parent context\n let parentOtelContext = otelContext.active();\n\n // Get external parent ID (walks up chain to find non-internal parent)\n const externalParentId = getExternalParentId(options);\n if (externalParentId) {\n // Look up external parent's OTEL span from map\n const parentEntry = this.otelSpanMap.get(externalParentId);\n if (parentEntry) {\n parentOtelContext = parentEntry.otelContext;\n }\n }\n\n // Create OTEL span with SpanKind (must be set at creation, immutable)\n const otelSpan = this.otelTracer.startSpan(\n options.name,\n {\n kind: getSpanKind(options.type),\n },\n parentOtelContext,\n );\n\n // Create context with this span active\n const spanContext = otelTrace.setSpan(parentOtelContext, otelSpan);\n\n // Get OTEL span identifiers\n const otelSpanContext = otelSpan.spanContext();\n const spanId = otelSpanContext.spanId;\n const traceId = otelSpanContext.traceId;\n\n // Store for later retrieval (for executeWithSpanContext and event handling)\n this.otelSpanMap.set(spanId, { otelSpan, otelContext: spanContext });\n\n // Get parentSpanId from parent context if available\n const parentSpan = otelTrace.getSpan(parentOtelContext);\n const parentSpanId = parentSpan?.spanContext().spanId;\n\n this.logger.debug(\n `[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] ` +\n `[parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`,\n );\n\n return { spanId, traceId, parentSpanId };\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to create span:', error);\n return undefined;\n }\n }\n\n /\n Handle SPAN_ENDED event\n \n Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,\n * events, and status, then ends the span. Cleans up the span map entry.\n /\n private async handleSpanEnded(event: TracingEvent): Promise<void> {\n try {\n const mastraSpan = event.exportedSpan;\n const entry = this.otelSpanMap.get(mastraSpan.id);\n\n if (!entry) {\n this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);\n return;\n }\n\n // Remove from map immediately to prevent memory leak\n this.otelSpanMap.delete(mastraSpan.id);\n\n if (!this.spanConverter) {\n return;\n }\n\n const { otelSpan } = entry;\n\n this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);\n\n // Use SpanConverter to get consistent span formatting with otel-exporter\n const readableSpan = await this.spanConverter!.convertSpan(mastraSpan);\n\n // Update span name to match the converter's formatting\n otelSpan.updateName(readableSpan.name);\n\n // Set all attributes from the converter (includes OTEL semantic conventions)\n for (const [key, value] of Object.entries(readableSpan.attributes)) {\n if (value !== undefined && value !== null && typeof value !== 'object') {\n otelSpan.setAttribute(key, value);\n }\n }\n\n // Set status from the converter\n otelSpan.setStatus(readableSpan.status);\n\n // Add exception events if present\n for (const event of readableSpan.events) {\n if (event.name === 'exception' && event.attributes) {\n const error = new Error(event.attributes['exception.message'] as string);\n otelSpan.recordException(error);\n }\n }\n\n // End the span with the actual end time\n otelSpan.end(mastraSpan.endTime);\n\n this.logger.debug(\n `[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`,\n );\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to handle SPAN_ENDED:', error);\n }\n }\n\n /\n Execute a function (sync or async) within the OTEL context of a Mastra span.\n * Retrieves the stored OTEL context for the span and executes the function within it.\n \n This is the core implementation used by both executeInContext and executeInContextSync.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The function to execute within the span context\n * @returns The result of the function execution\n /\n private executeWithSpanContext<T>(spanId: string, fn: () => T): T {\n const entry = this.otelSpanMap.get(spanId);\n\n this.logger.debug(\n `[OtelBridge.executeWithSpanContext] spanId=${spanId}, ` +\n `inMap=${!!entry}, ` +\n `storedOtelSpan=${entry?.otelSpan.spanContext().spanId \|\| 'none'}`,\n );\n\n const spanContext = entry?.otelContext;\n if (spanContext) {\n return otelContext.with(spanContext, fn);\n }\n return fn();\n }\n\n /\n Execute an async function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The async function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T> {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Execute a synchronous function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The synchronous function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContextSync<T>(spanId: string, fn: () => T): T {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Shutdown the bridge and clean up resources\n */\n async shutdown(): Promise<void> {\n // End any remaining spans\n for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {\n this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);\n otelSpan.end();\n }\n this.otelSpanMap.clear();\n this.logger.info('[OtelBridge] Shutdown complete');\n }\n}\n"]}

package/dist/index.js CHANGED Viewed

@@ -8,7 +8,7 @@ var OtelBridge = class extends BaseExporter {
   name = "otel";
   otelTracer = trace.getTracer("@mastra/otel-bridge", "1.0.0");
   otelSpanMap = /* @__PURE__ */ new Map();
-  spanConverter = new SpanConverter();
+  spanConverter;
   constructor(config = {}) {
     super(config);
   }
@@ -25,6 +25,16 @@ var OtelBridge = class extends BaseExporter {
       await this.handleSpanEnded(event);
     }
   }
+  /**
+   * Initialize with tracing configuration
+   */
+  init(options) {
+    this.spanConverter = new SpanConverter({
+      packageName: "@mastra/otel-bridge",
+      serviceName: options.config?.serviceName,
+      format: "GenAI_v1_38_0"
+    });
+  }
   /**
    * Create a span in the bridge's tracing system.
    * Called during Mastra span construction to get bridge-generated identifiers.
@@ -42,11 +52,10 @@ var OtelBridge = class extends BaseExporter {
           parentOtelContext = parentEntry.otelContext;
         }
       }
-      const isRootSpan = !options.parent;
       const otelSpan = this.otelTracer.startSpan(
         options.name,
         {
-          kind: getSpanKind(options.type, isRootSpan)
+          kind: getSpanKind(options.type)
         },
         parentOtelContext
       );
@@ -81,9 +90,12 @@ var OtelBridge = class extends BaseExporter {
         return;
       }
       this.otelSpanMap.delete(mastraSpan.id);
+      if (!this.spanConverter) {
+        return;
+      }
       const { otelSpan } = entry;
       this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);
-      const readableSpan = this.spanConverter.convertSpan(mastraSpan);
+      const readableSpan = await this.spanConverter.convertSpan(mastraSpan);
       otelSpan.updateName(readableSpan.name);
       for (const [key, value] of Object.entries(readableSpan.attributes)) {
         if (value !== void 0 && value !== null && typeof value !== "object") {

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/bridge.ts"],"names":["otelTrace","otelContext","event"],"mappings":"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","file":"index.js","sourcesContent":["/*\n OpenTelemetry Bridge for Mastra Observability\n \n This bridge enables bidirectional integration with OpenTelemetry infrastructure:\n * 1. Reads OTEL trace context from active spans (via AsyncLocalStorage)\n * 2. Creates real OTEL spans when Mastra spans are created\n * 3. Maintains span context for proper parent-child relationships\n * 4. Allows OTEL-instrumented code (DB, HTTP clients) in tools/workflows to have correct parents\n \n This creates complete distributed traces where Mastra spans are properly\n * nested within OTEL spans from auto-instrumentation, and any OTEL-instrumented\n * operations within Mastra spans maintain the correct hierarchy.\n /\n\nimport type {\n ObservabilityBridge,\n TracingEvent,\n CreateSpanOptions,\n SpanType,\n SpanIds,\n} from '@mastra/core/observability';\nimport { TracingEventType } from '@mastra/core/observability';\nimport { BaseExporter, getExternalParentId } from '@mastra/observability';\nimport { SpanConverter, getSpanKind } from '@mastra/otel-exporter';\nimport { trace as otelTrace, context as otelContext } from '@opentelemetry/api';\nimport type { Span as OtelSpan, Context as OtelContext } from '@opentelemetry/api';\n\n/\n Configuration for the OtelBridge\n /\n\nexport type OtelBridgeConfig = {\n // Currently no configuration options - placeholder for future options\n};\n\n/\n OpenTelemetry Bridge implementation\n \n Creates real OTEL spans when Mastra spans are created, maintaining proper\n * context propagation for nested instrumentation.\n \n @example\n * ```typescript\n * import { OtelBridge } from '@mastra/otel-bridge';\n * import { Mastra } from '@mastra/core';\n \n const mastra = new Mastra({\n * agents: { myAgent },\n * observability: {\n * configs: {\n * default: {\n * serviceName: 'my-service',\n * bridge: new OtelBridge(),\n * }\n * }\n * }\n * });\n * ```\n /\nexport class OtelBridge extends BaseExporter implements ObservabilityBridge {\n name = 'otel';\n private otelTracer = otelTrace.getTracer('@mastra/otel-bridge', '1.0.0');\n private otelSpanMap = new Map<string, { otelSpan: OtelSpan; otelContext: OtelContext }>();\n private spanConverter = new SpanConverter();\n\n constructor(config: OtelBridgeConfig = {}) {\n super(config);\n }\n\n /\n Handle Mastra tracing events\n \n Ships OTEL spans when Mastra spans end.\n * This maintains proper span hierarchy and allows OTEL-instrumented code within\n * Mastra spans to have correct parent-child relationships.\n * Note: OTEL spans are created when registerSpan is called when the span is first created.\n /\n protected async _exportTracingEvent(event: TracingEvent): Promise<void> {\n if (event.type === TracingEventType.SPAN_ENDED) {\n await this.handleSpanEnded(event);\n }\n }\n\n /\n Create a span in the bridge's tracing system.\n * Called during Mastra span construction to get bridge-generated identifiers.\n \n @param options - Span creation options from Mastra\n * @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails\n /\n createSpan(options: CreateSpanOptions<SpanType>): SpanIds \| undefined {\n try {\n // Determine parent context\n let parentOtelContext = otelContext.active();\n\n // Get external parent ID (walks up chain to find non-internal parent)\n const externalParentId = getExternalParentId(options);\n if (externalParentId) {\n // Look up external parent's OTEL span from map\n const parentEntry = this.otelSpanMap.get(externalParentId);\n if (parentEntry) {\n parentOtelContext = parentEntry.otelContext;\n }\n }\n\n // Create OTEL span with SpanKind (must be set at creation, immutable)\n const isRootSpan = !options.parent;\n const otelSpan = this.otelTracer.startSpan(\n options.name,\n {\n kind: getSpanKind(options.type, isRootSpan),\n },\n parentOtelContext,\n );\n\n // Create context with this span active\n const spanContext = otelTrace.setSpan(parentOtelContext, otelSpan);\n\n // Get OTEL span identifiers\n const otelSpanContext = otelSpan.spanContext();\n const spanId = otelSpanContext.spanId;\n const traceId = otelSpanContext.traceId;\n\n // Store for later retrieval (for executeWithSpanContext and event handling)\n this.otelSpanMap.set(spanId, { otelSpan, otelContext: spanContext });\n\n // Get parentSpanId from parent context if available\n const parentSpan = otelTrace.getSpan(parentOtelContext);\n const parentSpanId = parentSpan?.spanContext().spanId;\n\n this.logger.debug(\n `[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] ` +\n `[parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`,\n );\n\n return { spanId, traceId, parentSpanId };\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to create span:', error);\n return undefined;\n }\n }\n\n /\n Handle SPAN_ENDED event\n \n Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,\n * events, and status, then ends the span. Cleans up the span map entry.\n /\n private async handleSpanEnded(event: TracingEvent): Promise<void> {\n try {\n const mastraSpan = event.exportedSpan;\n const entry = this.otelSpanMap.get(mastraSpan.id);\n\n if (!entry) {\n this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);\n return;\n }\n\n // Remove from map immediately to prevent memory leak\n this.otelSpanMap.delete(mastraSpan.id);\n\n const { otelSpan } = entry;\n\n this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);\n\n // Use SpanConverter to get consistent span formatting with otel-exporter\n const readableSpan = this.spanConverter.convertSpan(mastraSpan);\n\n // Update span name to match the converter's formatting\n otelSpan.updateName(readableSpan.name);\n\n // Set all attributes from the converter (includes OTEL semantic conventions)\n for (const [key, value] of Object.entries(readableSpan.attributes)) {\n if (value !== undefined && value !== null && typeof value !== 'object') {\n otelSpan.setAttribute(key, value);\n }\n }\n\n // Set status from the converter\n otelSpan.setStatus(readableSpan.status);\n\n // Add exception events if present\n for (const event of readableSpan.events) {\n if (event.name === 'exception' && event.attributes) {\n const error = new Error(event.attributes['exception.message'] as string);\n otelSpan.recordException(error);\n }\n }\n\n // End the span with the actual end time\n otelSpan.end(mastraSpan.endTime);\n\n this.logger.debug(\n `[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`,\n );\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to handle SPAN_ENDED:', error);\n }\n }\n\n /\n Execute a function (sync or async) within the OTEL context of a Mastra span.\n * Retrieves the stored OTEL context for the span and executes the function within it.\n \n This is the core implementation used by both executeInContext and executeInContextSync.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The function to execute within the span context\n * @returns The result of the function execution\n /\n private executeWithSpanContext<T>(spanId: string, fn: () => T): T {\n const entry = this.otelSpanMap.get(spanId);\n\n this.logger.debug(\n `[OtelBridge.executeWithSpanContext] spanId=${spanId}, ` +\n `inMap=${!!entry}, ` +\n `storedOtelSpan=${entry?.otelSpan.spanContext().spanId \|\| 'none'}`,\n );\n\n const spanContext = entry?.otelContext;\n if (spanContext) {\n return otelContext.with(spanContext, fn);\n }\n return fn();\n }\n\n /\n Execute an async function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The async function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T> {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Execute a synchronous function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The synchronous function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContextSync<T>(spanId: string, fn: () => T): T {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Shutdown the bridge and clean up resources\n */\n async shutdown(): Promise<void> {\n // End any remaining spans\n for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {\n this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);\n otelSpan.end();\n }\n this.otelSpanMap.clear();\n this.logger.info('[OtelBridge] Shutdown complete');\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/bridge.ts"],"names":["otelTrace","otelContext","event"],"mappings":"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","file":"index.js","sourcesContent":["/*\n OpenTelemetry Bridge for Mastra Observability\n \n This bridge enables bidirectional integration with OpenTelemetry infrastructure:\n * 1. Reads OTEL trace context from active spans (via AsyncLocalStorage)\n * 2. Creates real OTEL spans when Mastra spans are created\n * 3. Maintains span context for proper parent-child relationships\n * 4. Allows OTEL-instrumented code (DB, HTTP clients) in tools/workflows to have correct parents\n \n This creates complete distributed traces where Mastra spans are properly\n * nested within OTEL spans from auto-instrumentation, and any OTEL-instrumented\n * operations within Mastra spans maintain the correct hierarchy.\n /\n\nimport type {\n ObservabilityBridge,\n TracingEvent,\n CreateSpanOptions,\n SpanType,\n SpanIds,\n InitExporterOptions,\n} from '@mastra/core/observability';\nimport { TracingEventType } from '@mastra/core/observability';\nimport { BaseExporter, getExternalParentId } from '@mastra/observability';\nimport { SpanConverter, getSpanKind } from '@mastra/otel-exporter';\nimport { trace as otelTrace, context as otelContext } from '@opentelemetry/api';\nimport type { Span as OtelSpan, Context as OtelContext } from '@opentelemetry/api';\n\n/\n Configuration for the OtelBridge\n /\n\nexport type OtelBridgeConfig = {\n // Currently no configuration options - placeholder for future options\n};\n\n/\n OpenTelemetry Bridge implementation\n \n Creates real OTEL spans when Mastra spans are created, maintaining proper\n * context propagation for nested instrumentation.\n \n @example\n * ```typescript\n * import { OtelBridge } from '@mastra/otel-bridge';\n * import { Mastra } from '@mastra/core';\n \n const mastra = new Mastra({\n * agents: { myAgent },\n * observability: {\n * configs: {\n * default: {\n * serviceName: 'my-service',\n * bridge: new OtelBridge(),\n * }\n * }\n * }\n * });\n * ```\n /\nexport class OtelBridge extends BaseExporter implements ObservabilityBridge {\n name = 'otel';\n private otelTracer = otelTrace.getTracer('@mastra/otel-bridge', '1.0.0');\n private otelSpanMap = new Map<string, { otelSpan: OtelSpan; otelContext: OtelContext }>();\n private spanConverter?: SpanConverter;\n\n constructor(config: OtelBridgeConfig = {}) {\n super(config);\n }\n\n /\n Handle Mastra tracing events\n \n Ships OTEL spans when Mastra spans end.\n * This maintains proper span hierarchy and allows OTEL-instrumented code within\n * Mastra spans to have correct parent-child relationships.\n * Note: OTEL spans are created when registerSpan is called when the span is first created.\n /\n protected async _exportTracingEvent(event: TracingEvent): Promise<void> {\n if (event.type === TracingEventType.SPAN_ENDED) {\n await this.handleSpanEnded(event);\n }\n }\n\n /\n Initialize with tracing configuration\n /\n init(options: InitExporterOptions) {\n this.spanConverter = new SpanConverter({\n packageName: '@mastra/otel-bridge',\n serviceName: options.config?.serviceName,\n format: 'GenAI_v1_38_0',\n });\n }\n\n /\n Create a span in the bridge's tracing system.\n * Called during Mastra span construction to get bridge-generated identifiers.\n \n @param options - Span creation options from Mastra\n * @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails\n /\n createSpan(options: CreateSpanOptions<SpanType>): SpanIds \| undefined {\n try {\n // Determine parent context\n let parentOtelContext = otelContext.active();\n\n // Get external parent ID (walks up chain to find non-internal parent)\n const externalParentId = getExternalParentId(options);\n if (externalParentId) {\n // Look up external parent's OTEL span from map\n const parentEntry = this.otelSpanMap.get(externalParentId);\n if (parentEntry) {\n parentOtelContext = parentEntry.otelContext;\n }\n }\n\n // Create OTEL span with SpanKind (must be set at creation, immutable)\n const otelSpan = this.otelTracer.startSpan(\n options.name,\n {\n kind: getSpanKind(options.type),\n },\n parentOtelContext,\n );\n\n // Create context with this span active\n const spanContext = otelTrace.setSpan(parentOtelContext, otelSpan);\n\n // Get OTEL span identifiers\n const otelSpanContext = otelSpan.spanContext();\n const spanId = otelSpanContext.spanId;\n const traceId = otelSpanContext.traceId;\n\n // Store for later retrieval (for executeWithSpanContext and event handling)\n this.otelSpanMap.set(spanId, { otelSpan, otelContext: spanContext });\n\n // Get parentSpanId from parent context if available\n const parentSpan = otelTrace.getSpan(parentOtelContext);\n const parentSpanId = parentSpan?.spanContext().spanId;\n\n this.logger.debug(\n `[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] ` +\n `[parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`,\n );\n\n return { spanId, traceId, parentSpanId };\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to create span:', error);\n return undefined;\n }\n }\n\n /\n Handle SPAN_ENDED event\n \n Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,\n * events, and status, then ends the span. Cleans up the span map entry.\n /\n private async handleSpanEnded(event: TracingEvent): Promise<void> {\n try {\n const mastraSpan = event.exportedSpan;\n const entry = this.otelSpanMap.get(mastraSpan.id);\n\n if (!entry) {\n this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);\n return;\n }\n\n // Remove from map immediately to prevent memory leak\n this.otelSpanMap.delete(mastraSpan.id);\n\n if (!this.spanConverter) {\n return;\n }\n\n const { otelSpan } = entry;\n\n this.logger.debug(`[OtelBridge] Ending OTEL span [mastraId=${mastraSpan.id}] [name=${mastraSpan.name}]`);\n\n // Use SpanConverter to get consistent span formatting with otel-exporter\n const readableSpan = await this.spanConverter!.convertSpan(mastraSpan);\n\n // Update span name to match the converter's formatting\n otelSpan.updateName(readableSpan.name);\n\n // Set all attributes from the converter (includes OTEL semantic conventions)\n for (const [key, value] of Object.entries(readableSpan.attributes)) {\n if (value !== undefined && value !== null && typeof value !== 'object') {\n otelSpan.setAttribute(key, value);\n }\n }\n\n // Set status from the converter\n otelSpan.setStatus(readableSpan.status);\n\n // Add exception events if present\n for (const event of readableSpan.events) {\n if (event.name === 'exception' && event.attributes) {\n const error = new Error(event.attributes['exception.message'] as string);\n otelSpan.recordException(error);\n }\n }\n\n // End the span with the actual end time\n otelSpan.end(mastraSpan.endTime);\n\n this.logger.debug(\n `[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`,\n );\n } catch (error) {\n this.logger.error('[OtelBridge] Failed to handle SPAN_ENDED:', error);\n }\n }\n\n /\n Execute a function (sync or async) within the OTEL context of a Mastra span.\n * Retrieves the stored OTEL context for the span and executes the function within it.\n \n This is the core implementation used by both executeInContext and executeInContextSync.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The function to execute within the span context\n * @returns The result of the function execution\n /\n private executeWithSpanContext<T>(spanId: string, fn: () => T): T {\n const entry = this.otelSpanMap.get(spanId);\n\n this.logger.debug(\n `[OtelBridge.executeWithSpanContext] spanId=${spanId}, ` +\n `inMap=${!!entry}, ` +\n `storedOtelSpan=${entry?.otelSpan.spanContext().spanId \|\| 'none'}`,\n );\n\n const spanContext = entry?.otelContext;\n if (spanContext) {\n return otelContext.with(spanContext, fn);\n }\n return fn();\n }\n\n /\n Execute an async function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The async function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T> {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Execute a synchronous function within the OTEL context of a Mastra span.\n \n @param spanId - The ID of the Mastra span to use as context\n * @param fn - The synchronous function to execute within the span context\n * @returns The result of the function execution\n /\n executeInContextSync<T>(spanId: string, fn: () => T): T {\n return this.executeWithSpanContext(spanId, fn);\n }\n\n /\n Shutdown the bridge and clean up resources\n */\n async shutdown(): Promise<void> {\n // End any remaining spans\n for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {\n this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);\n otelSpan.end();\n }\n this.otelSpanMap.clear();\n this.logger.info('[OtelBridge] Shutdown complete');\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/otel-bridge",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "description": "OpenTelemetry observability bridge for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -25,8 +25,8 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@mastra/observability": "1.0.0-beta.2",
-    "@mastra/otel-exporter": "1.0.0-beta.2"
+    "@mastra/observability": "1.0.0-beta.3",
+    "@mastra/otel-exporter": "1.0.0-beta.4"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.8",
@@ -36,8 +36,8 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.6",
-    "@internal/types-builder": "0.0.28"
+    "@internal/types-builder": "0.0.28",
+    "@mastra/core": "1.0.0-beta.9"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0",