@mastra/otel-bridge 1.4.3 → 1.4.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/otel-bridge
 
+## 1.4.4
+
+### Patch Changes
+
+- Updated dependencies [[`ce93a3c`](https://github.com/mastra-ai/mastra/commit/ce93a3c114ea1cbfbd576f3db41d7c26c9844f5b), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`a211d09`](https://github.com/mastra-ai/mastra/commit/a211d09185dc65a746534914cf38b67f21ee9bac), [`0dca9d0`](https://github.com/mastra-ai/mastra/commit/0dca9d0b1356024a53b72ea6f040db528b126caa), [`6218217`](https://github.com/mastra-ai/mastra/commit/62182171b6cfca0b099f1c6a77a2e65e7639ab86), [`5807d3a`](https://github.com/mastra-ai/mastra/commit/5807d3ae1d259b8b7d6df7e5bf2b485c694af9c8), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`05db566`](https://github.com/mastra-ai/mastra/commit/05db566fcbdcbf33d0bffca0c72ec30129e2e3ca), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093), [`29c584a`](https://github.com/mastra-ai/mastra/commit/29c584a13a88831e5ed1fdeb0ff8e82eae180433), [`c093146`](https://github.com/mastra-ai/mastra/commit/c0931466404d3c521308ea119cb165bb7e695155), [`8124754`](https://github.com/mastra-ai/mastra/commit/8124754ae89fbc69f8136d1df4a91904d0f84c4e), [`d12b2e4`](https://github.com/mastra-ai/mastra/commit/d12b2e4023fd9e3d3e93a9169f5088bcee2a849c), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093)]:
+  - @mastra/core@1.54.0
+  - @mastra/observability@1.16.3
+  - @mastra/otel-exporter@1.3.6
+
+## 1.4.4-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`ce93a3c`](https://github.com/mastra-ai/mastra/commit/ce93a3c114ea1cbfbd576f3db41d7c26c9844f5b), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`5807d3a`](https://github.com/mastra-ai/mastra/commit/5807d3ae1d259b8b7d6df7e5bf2b485c694af9c8), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093), [`c093146`](https://github.com/mastra-ai/mastra/commit/c0931466404d3c521308ea119cb165bb7e695155), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093)]:
+  - @mastra/core@1.54.0-alpha.1
+  - @mastra/observability@1.16.3-alpha.0
+  - @mastra/otel-exporter@1.3.6-alpha.0
+
 ## 1.4.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -1,273 +1,269 @@
-'use strict';
-
-var observability$1 = require('@mastra/core/observability');
-var observability = require('@mastra/observability');
-var otelExporter = require('@mastra/otel-exporter');
-var api = require('@opentelemetry/api');
-var apiLogs = require('@opentelemetry/api-logs');
-
-// src/bridge.ts
-var OtelBridge = class extends observability.BaseExporter {
-  name = "otel";
-  tracerProvider;
-  loggerProvider;
-  otelTracer;
-  otelLogger;
-  otelSpanMap = /* @__PURE__ */ new Map();
-  spanConverter;
-  constructor(config = {}) {
-    super(config);
-    this.tracerProvider = config.tracerProvider ?? api.trace.getTracerProvider();
-    this.otelTracer = this.tracerProvider.getTracer("@mastra/otel-bridge", "1.0.0");
-    this.loggerProvider = config.loggerProvider ?? apiLogs.logs.getLoggerProvider();
-    this.otelLogger = this.loggerProvider.getLogger("@mastra/otel-bridge", "1.0.0");
-  }
-  /**
-   * Handle Mastra tracing events
-   *
-   * Ships OTEL spans when Mastra spans end.
-   * This maintains proper span hierarchy and allows OTEL-instrumented code within
-   * Mastra spans to have correct parent-child relationships.
-   * Note: OTEL spans are created when registerSpan is called when the span is first created.
-   */
-  async _exportTracingEvent(event) {
-    if (event.type === observability$1.TracingEventType.SPAN_ENDED) {
-      await this.handleSpanEnded(event);
-    }
-  }
-  /**
-   * Forward Mastra log events into the globally-registered OTEL LoggerProvider.
-   *
-   * If the user has not registered a LoggerProvider (e.g. via @opentelemetry/sdk-logs
-   * or NodeSDK's logRecordProcessor option), the API returns a no-op logger and
-   * emit() is a silent no-op — the bridge degrades gracefully.
-   *
-   * Trace correlation:
-   * - If the log carries a spanId we have an OTEL span for, emit under that span's
-   *   stored context so the log nests beneath it in the trace.
-   * - Else if the log carries traceId+spanId, attach a SpanContext built from those
-   *   IDs so backends still correlate by ID.
-   * - Else emit under whatever context is currently active.
-   */
-  async onLogEvent(event) {
-    if (this.isDisabled) return;
-    try {
-      const params = otelExporter.convertLog(event.log);
-      const attributes = { ...params.attributes };
-      if (params.traceId) attributes["mastra.traceId"] = params.traceId;
-      if (params.spanId) attributes["mastra.spanId"] = params.spanId;
-      const logContext = this.resolveLogContext(params.traceId, params.spanId);
-      this.otelLogger.emit({
-        timestamp: params.timestamp,
-        severityNumber: params.severityNumber,
-        severityText: params.severityText,
-        body: params.body,
-        attributes,
-        context: logContext
-      });
-    } catch (error) {
-      this.logger.error("[OtelBridge] Failed to emit log:", error);
-    }
-  }
-  /**
-   * Pick the OTEL Context to emit a log under so trace correlation is correct.
-   */
-  resolveLogContext(traceId, spanId) {
-    if (spanId) {
-      const entry = this.otelSpanMap.get(spanId);
-      if (entry) return entry.otelContext;
-    }
-    if (traceId && spanId) {
-      const candidate = {
-        traceId,
-        spanId,
-        traceFlags: api.TraceFlags.SAMPLED,
-        isRemote: false
-      };
-      if (api.isSpanContextValid(candidate)) {
-        return api.trace.setSpanContext(api.context.active(), candidate);
-      }
-    }
-    return api.context.active();
-  }
-  /**
-   * 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.
-   *
-   * @param options - Span creation options from Mastra
-   * @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails
-   */
-  createSpan(options) {
-    try {
-      let parentOtelContext = api.context.active();
-      const externalParentId = observability.getExternalParentId(options);
-      if (externalParentId) {
-        const parentEntry = this.otelSpanMap.get(externalParentId);
-        if (parentEntry) {
-          parentOtelContext = parentEntry.otelContext;
-        }
-      }
-      const otelSpan = this.otelTracer.startSpan(
-        options.name,
-        {
-          kind: otelExporter.getSpanKind(options.type)
-        },
-        parentOtelContext
-      );
-      const spanContext = api.trace.setSpan(parentOtelContext, otelSpan);
-      const otelSpanContext = otelSpan.spanContext();
-      if (!api.isSpanContextValid(otelSpanContext)) {
-        otelSpan.end();
-        return void 0;
-      }
-      const spanId = otelSpanContext.spanId;
-      const traceId = otelSpanContext.traceId;
-      this.otelSpanMap.set(spanId, { otelSpan, otelContext: spanContext });
-      const parentSpan = api.trace.getSpan(parentOtelContext);
-      const parentSpanContext = parentSpan?.spanContext();
-      const parentSpanId = parentSpanContext && api.isSpanContextValid(parentSpanContext) ? parentSpanContext.spanId : void 0;
-      this.logger.debug(
-        `[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] [parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`
-      );
-      return { spanId, traceId, parentSpanId };
-    } catch (error) {
-      this.logger.error("[OtelBridge] Failed to create span:", error);
-      return void 0;
-    }
-  }
-  /**
-   * Handle SPAN_ENDED event
-   *
-   * Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,
-   * events, and status, then ends the span. Cleans up the span map entry.
-   */
-  async handleSpanEnded(event) {
-    try {
-      const mastraSpan = event.exportedSpan;
-      const entry = this.otelSpanMap.get(mastraSpan.id);
-      if (!entry) {
-        this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);
-        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 = 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") {
-          otelSpan.setAttribute(key, value);
-        }
-      }
-      otelSpan.setStatus(readableSpan.status);
-      for (const event2 of readableSpan.events) {
-        if (event2.name === "exception" && event2.attributes) {
-          const error = new Error(event2.attributes["exception.message"]);
-          otelSpan.recordException(error);
-        }
-      }
-      otelSpan.end(mastraSpan.endTime);
-      this.logger.debug(
-        `[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`
-      );
-    } catch (error) {
-      this.logger.error("[OtelBridge] Failed to handle SPAN_ENDED:", error);
-    }
-  }
-  /**
-   * Execute a function (sync or async) within the OTEL context of a Mastra span.
-   * Retrieves the stored OTEL context for the span and executes the function within it.
-   *
-   * This is the core implementation used by both executeInContext and executeInContextSync.
-   *
-   * @param spanId - The ID of the Mastra span to use as context
-   * @param fn - The function to execute within the span context
-   * @returns The result of the function execution
-   */
-  executeWithSpanContext(spanId, fn) {
-    const entry = this.otelSpanMap.get(spanId);
-    this.logger.debug(
-      `[OtelBridge.executeWithSpanContext] spanId=${spanId}, inMap=${!!entry}, storedOtelSpan=${entry?.otelSpan.spanContext().spanId || "none"}`
-    );
-    const spanContext = entry?.otelContext;
-    if (spanContext) {
-      return api.context.with(spanContext, fn);
-    }
-    return fn();
-  }
-  /**
-   * Execute an async function within the OTEL context of a Mastra span.
-   *
-   * @param spanId - The ID of the Mastra span to use as context
-   * @param fn - The async function to execute within the span context
-   * @returns The result of the function execution
-   */
-  executeInContext(spanId, fn) {
-    return this.executeWithSpanContext(spanId, fn);
-  }
-  /**
-   * Execute a synchronous function within the OTEL context of a Mastra span.
-   *
-   * @param spanId - The ID of the Mastra span to use as context
-   * @param fn - The synchronous function to execute within the span context
-   * @returns The result of the function execution
-   */
-  executeInContextSync(spanId, fn) {
-    return this.executeWithSpanContext(spanId, fn);
-  }
-  /**
-   * Force flush any buffered spans without shutting down the bridge.
-   *
-   * Attempts to flush the underlying OTEL tracer provider if it supports
-   * the forceFlush operation. This is useful in serverless environments
-   * where you need to ensure all spans are exported before the runtime
-   * instance is terminated.
-   */
-  async flush() {
-    await this.flushProvider(this.tracerProvider, "tracer");
-    await this.flushProvider(this.loggerProvider, "logger");
-  }
-  async flushProvider(provider, label) {
-    try {
-      if (provider && typeof provider === "object" && "forceFlush" in provider && typeof provider.forceFlush === "function") {
-        await provider.forceFlush();
-        this.logger.debug(`[OtelBridge] Flushed ${label} provider`);
-      } else {
-        this.logger.debug(
-          `[OtelBridge] ${label === "tracer" ? "Tracer" : "Logger"} provider does not support forceFlush`
-        );
-      }
-    } catch (error) {
-      this.logger.error(`[OtelBridge] Failed to flush ${label} provider:`, error);
-    }
-  }
-  /**
-   * Shutdown the bridge and clean up resources
-   */
-  async shutdown() {
-    await this.flush();
-    for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {
-      this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);
-      otelSpan.end();
-    }
-    this.otelSpanMap.clear();
-    this.logger.info("[OtelBridge] Shutdown complete");
-  }
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _mastra_core_observability = require("@mastra/core/observability");
+let _mastra_observability = require("@mastra/observability");
+let _mastra_otel_exporter = require("@mastra/otel-exporter");
+let _opentelemetry_api = require("@opentelemetry/api");
+let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+//#region src/bridge.ts
+/**
+* OpenTelemetry Bridge implementation
+*
+* Creates real OTEL spans when Mastra spans are created, maintaining proper
+* context propagation for nested instrumentation.
+*
+* @example
+* ```typescript
+* import { OtelBridge } from '@mastra/otel-bridge';
+* import { Mastra } from '@mastra/core';
+*
+* const mastra = new Mastra({
+*   agents: { myAgent },
+*   observability: {
+*     configs: {
+*       default: {
+*         serviceName: 'my-service',
+*         bridge: new OtelBridge(),
+*       }
+*     }
+*   }
+* });
+* ```
+*/
+var OtelBridge = class extends _mastra_observability.BaseExporter {
+	name = "otel";
+	tracerProvider;
+	loggerProvider;
+	otelTracer;
+	otelLogger;
+	otelSpanMap = /* @__PURE__ */ new Map();
+	spanConverter;
+	constructor(config = {}) {
+		super(config);
+		this.tracerProvider = config.tracerProvider ?? _opentelemetry_api.trace.getTracerProvider();
+		this.otelTracer = this.tracerProvider.getTracer("@mastra/otel-bridge", "1.0.0");
+		this.loggerProvider = config.loggerProvider ?? _opentelemetry_api_logs.logs.getLoggerProvider();
+		this.otelLogger = this.loggerProvider.getLogger("@mastra/otel-bridge", "1.0.0");
+	}
+	/**
+	* Handle Mastra tracing events
+	*
+	* Ships OTEL spans when Mastra spans end.
+	* This maintains proper span hierarchy and allows OTEL-instrumented code within
+	* Mastra spans to have correct parent-child relationships.
+	* Note: OTEL spans are created when registerSpan is called when the span is first created.
+	*/
+	async _exportTracingEvent(event) {
+		if (event.type === _mastra_core_observability.TracingEventType.SPAN_ENDED) await this.handleSpanEnded(event);
+	}
+	/**
+	* Forward Mastra log events into the globally-registered OTEL LoggerProvider.
+	*
+	* If the user has not registered a LoggerProvider (e.g. via @opentelemetry/sdk-logs
+	* or NodeSDK's logRecordProcessor option), the API returns a no-op logger and
+	* emit() is a silent no-op — the bridge degrades gracefully.
+	*
+	* Trace correlation:
+	* - If the log carries a spanId we have an OTEL span for, emit under that span's
+	*   stored context so the log nests beneath it in the trace.
+	* - Else if the log carries traceId+spanId, attach a SpanContext built from those
+	*   IDs so backends still correlate by ID.
+	* - Else emit under whatever context is currently active.
+	*/
+	async onLogEvent(event) {
+		if (this.isDisabled) return;
+		try {
+			const params = (0, _mastra_otel_exporter.convertLog)(event.log);
+			const attributes = { ...params.attributes };
+			if (params.traceId) attributes["mastra.traceId"] = params.traceId;
+			if (params.spanId) attributes["mastra.spanId"] = params.spanId;
+			const logContext = this.resolveLogContext(params.traceId, params.spanId);
+			this.otelLogger.emit({
+				timestamp: params.timestamp,
+				severityNumber: params.severityNumber,
+				severityText: params.severityText,
+				body: params.body,
+				attributes,
+				context: logContext
+			});
+		} catch (error) {
+			this.logger.error("[OtelBridge] Failed to emit log:", error);
+		}
+	}
+	/**
+	* Pick the OTEL Context to emit a log under so trace correlation is correct.
+	*/
+	resolveLogContext(traceId, spanId) {
+		if (spanId) {
+			const entry = this.otelSpanMap.get(spanId);
+			if (entry) return entry.otelContext;
+		}
+		if (traceId && spanId) {
+			const candidate = {
+				traceId,
+				spanId,
+				traceFlags: _opentelemetry_api.TraceFlags.SAMPLED,
+				isRemote: false
+			};
+			if ((0, _opentelemetry_api.isSpanContextValid)(candidate)) return _opentelemetry_api.trace.setSpanContext(_opentelemetry_api.context.active(), candidate);
+		}
+		return _opentelemetry_api.context.active();
+	}
+	/**
+	* Initialize with tracing configuration
+	*/
+	init(options) {
+		this.spanConverter = new _mastra_otel_exporter.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.
+	*
+	* @param options - Span creation options from Mastra
+	* @returns Span identifiers (spanId, traceId, parentSpanId) from bridge, or undefined if creation fails
+	*/
+	createSpan(options) {
+		try {
+			let parentOtelContext = _opentelemetry_api.context.active();
+			const externalParentId = (0, _mastra_observability.getExternalParentId)(options);
+			if (externalParentId) {
+				const parentEntry = this.otelSpanMap.get(externalParentId);
+				if (parentEntry) parentOtelContext = parentEntry.otelContext;
+			}
+			const otelSpan = this.otelTracer.startSpan(options.name, { kind: (0, _mastra_otel_exporter.getSpanKind)(options.type) }, parentOtelContext);
+			const spanContext = _opentelemetry_api.trace.setSpan(parentOtelContext, otelSpan);
+			const otelSpanContext = otelSpan.spanContext();
+			if (!(0, _opentelemetry_api.isSpanContextValid)(otelSpanContext)) {
+				otelSpan.end();
+				return;
+			}
+			const spanId = otelSpanContext.spanId;
+			const traceId = otelSpanContext.traceId;
+			this.otelSpanMap.set(spanId, {
+				otelSpan,
+				otelContext: spanContext
+			});
+			const parentSpanContext = _opentelemetry_api.trace.getSpan(parentOtelContext)?.spanContext();
+			const parentSpanId = parentSpanContext && (0, _opentelemetry_api.isSpanContextValid)(parentSpanContext) ? parentSpanContext.spanId : void 0;
+			this.logger.debug(`[OtelBridge.createSpan] Created span [spanId=${spanId}] [traceId=${traceId}] [parentSpanId=${parentSpanId}] [type=${options.type}] [mapSize=${this.otelSpanMap.size}]`);
+			return {
+				spanId,
+				traceId,
+				parentSpanId
+			};
+		} catch (error) {
+			this.logger.error("[OtelBridge] Failed to create span:", error);
+			return;
+		}
+	}
+	/**
+	* Handle SPAN_ENDED event
+	*
+	* Retrieves the OTEL span created at SPAN_STARTED, sets all final attributes,
+	* events, and status, then ends the span. Cleans up the span map entry.
+	*/
+	async handleSpanEnded(event) {
+		try {
+			const mastraSpan = event.exportedSpan;
+			const entry = this.otelSpanMap.get(mastraSpan.id);
+			if (!entry) {
+				this.logger.warn(`[OtelBridge] No OTEL span found for Mastra span [id=${mastraSpan.id}].`);
+				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 = 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") otelSpan.setAttribute(key, value);
+			otelSpan.setStatus(readableSpan.status);
+			for (const event of readableSpan.events) if (event.name === "exception" && event.attributes) {
+				const error = new Error(event.attributes["exception.message"]);
+				otelSpan.recordException(error);
+			}
+			otelSpan.end(mastraSpan.endTime);
+			this.logger.debug(`[OtelBridge] Completed OTEL span [mastraId=${mastraSpan.id}] [traceId=${otelSpan.spanContext().traceId}]`);
+		} catch (error) {
+			this.logger.error("[OtelBridge] Failed to handle SPAN_ENDED:", error);
+		}
+	}
+	/**
+	* Execute a function (sync or async) within the OTEL context of a Mastra span.
+	* Retrieves the stored OTEL context for the span and executes the function within it.
+	*
+	* This is the core implementation used by both executeInContext and executeInContextSync.
+	*
+	* @param spanId - The ID of the Mastra span to use as context
+	* @param fn - The function to execute within the span context
+	* @returns The result of the function execution
+	*/
+	executeWithSpanContext(spanId, fn) {
+		const entry = this.otelSpanMap.get(spanId);
+		this.logger.debug(`[OtelBridge.executeWithSpanContext] spanId=${spanId}, inMap=${!!entry}, storedOtelSpan=${entry?.otelSpan.spanContext().spanId || "none"}`);
+		const spanContext = entry?.otelContext;
+		if (spanContext) return _opentelemetry_api.context.with(spanContext, fn);
+		return fn();
+	}
+	/**
+	* Execute an async function within the OTEL context of a Mastra span.
+	*
+	* @param spanId - The ID of the Mastra span to use as context
+	* @param fn - The async function to execute within the span context
+	* @returns The result of the function execution
+	*/
+	executeInContext(spanId, fn) {
+		return this.executeWithSpanContext(spanId, fn);
+	}
+	/**
+	* Execute a synchronous function within the OTEL context of a Mastra span.
+	*
+	* @param spanId - The ID of the Mastra span to use as context
+	* @param fn - The synchronous function to execute within the span context
+	* @returns The result of the function execution
+	*/
+	executeInContextSync(spanId, fn) {
+		return this.executeWithSpanContext(spanId, fn);
+	}
+	/**
+	* Force flush any buffered spans without shutting down the bridge.
+	*
+	* Attempts to flush the underlying OTEL tracer provider if it supports
+	* the forceFlush operation. This is useful in serverless environments
+	* where you need to ensure all spans are exported before the runtime
+	* instance is terminated.
+	*/
+	async flush() {
+		await this.flushProvider(this.tracerProvider, "tracer");
+		await this.flushProvider(this.loggerProvider, "logger");
+	}
+	async flushProvider(provider, label) {
+		try {
+			if (provider && typeof provider === "object" && "forceFlush" in provider && typeof provider.forceFlush === "function") {
+				await provider.forceFlush();
+				this.logger.debug(`[OtelBridge] Flushed ${label} provider`);
+			} else this.logger.debug(`[OtelBridge] ${label === "tracer" ? "Tracer" : "Logger"} provider does not support forceFlush`);
+		} catch (error) {
+			this.logger.error(`[OtelBridge] Failed to flush ${label} provider:`, error);
+		}
+	}
+	/**
+	* Shutdown the bridge and clean up resources
+	*/
+	async shutdown() {
+		await this.flush();
+		for (const [spanId, { otelSpan }] of this.otelSpanMap.entries()) {
+			this.logger.warn(`[OtelBridge] Force-ending span that was not properly closed [id=${spanId}]`);
+			otelSpan.end();
+		}
+		this.otelSpanMap.clear();
+		this.logger.info("[OtelBridge] Shutdown complete");
+	}
 };
-
+//#endregion
 exports.OtelBridge = OtelBridge;
-//# sourceMappingURL=index.cjs.map
+
 //# sourceMappingURL=index.cjs.map