@mastra/core 1.0.0-beta.0 → 1.0.0-beta.10

package/dist/memory/types.d.ts

@@ -1,10 +1,11 @@
 import type { EmbeddingModelV2 } from '@ai-sdk/provider-v5';
 import type { EmbeddingModel, AssistantContent, CoreMessage, ToolContent, UserContent } from '../ai-sdk.types.d.ts';
 import type { JSONSchema7 } from 'json-schema';
-export type { MastraDBMessage } from '../agent/index.js';
 import type { ZodObject } from 'zod';
+export type { MastraDBMessage } from '../agent/index.js';
 import type { EmbeddingModelId } from '../llm/model/index.js';
-import type { MastraLanguageModel } from '../llm/model/shared.types.js';
+import type { MastraLanguageModel, MastraModelConfig } from '../llm/model/shared.types.js';
+import type { RequestContext } from '../request-context/index.js';
 import type { MastraStorage } from '../storage/index.js';
 import type { DynamicArgument } from '../types/index.js';
 import type { MastraVector } from '../vector/index.js';
@@ -35,6 +36,24 @@ export type StorageThreadType = {
     updatedAt: Date;
     metadata?: Record<string, unknown>;
 };
+/**
+ * Memory-specific context passed via RequestContext under the 'MastraMemory' key
+ * This provides processors with access to memory-related execution context
+ */
+export type MemoryRuntimeContext = {
+    thread?: Partial<StorageThreadType> & {
+        id: string;
+    };
+    resourceId?: string;
+    memoryConfig?: MemoryConfig;
+};
+/**
+ * Parse and validate memory runtime context from RequestContext
+ * @param runtimeContext - The RequestContext to extract memory context from
+ * @returns The validated MemoryRuntimeContext or null if not available
+ * @throws Error if the context exists but is malformed
+ */
+export declare function parseMemoryRuntimeContext(runtimeContext?: RequestContext): MemoryRuntimeContext | null;
 export type MessageResponse<T extends 'raw' | 'core_message'> = {
     raw: MastraMessageV1[];
     core_message: CoreMessage[];
@@ -209,6 +228,26 @@ export type SemanticRecall = {
      * ```
      */
     indexConfig?: VectorIndexConfig;
+    /**
+     * Minimum similarity score threshold (0-1).
+     * Messages below this threshold will be filtered out from semantic search results.
+     *
+     * @example
+     * ```typescript
+     * threshold: 0.7 // Only include messages with 70%+ similarity
+     * ```
+     */
+    threshold?: number;
+    /**
+     * Index name for the vector store.
+     * If not provided, will be auto-generated based on embedder model.
+     *
+     * @example
+     * ```typescript
+     * indexName: 'my-custom-index'
+     * ```
+     */
+    indexName?: string;
 };
 /**
  * Configuration for memory behaviors and retrieval strategies.
@@ -220,6 +259,17 @@ export type SemanticRecall = {
  * @see https://mastra.ai/docs/memory/overview
  */
 export type MemoryConfig = {
+    /**
+     * When true, prevents memory from saving new messages.
+     * Useful for internal agents (like routing agents) that should read memory but not modify it.
+     *
+     * @default false
+     * @example
+     * ```typescript
+     * readOnly: true // Agent can read memory but won't save new messages
+     * ```
+     */
+    readOnly?: boolean;
     /**
      * Number of recent messages from the current thread to include in context.
      * Provides short-term conversational continuity.
@@ -292,8 +342,9 @@ export type MemoryConfig = {
         /**
          * Language model to use for title generation.
          * Can be static or a function that receives request context for dynamic selection.
+         * Accepts both Mastra models and standard AI SDK LanguageModelV1/V2.
          */
-        model: DynamicArgument<MastraLanguageModel>;
+        model: DynamicArgument<MastraModelConfig>;
         /**
          * Custom instructions for title generation.
          * Can be static or a function that receives request context for dynamic customization.
@@ -309,7 +360,7 @@ export type MemoryConfig = {
          * @deprecated Moved to top-level `generateTitle`. Using `threads.generateTitle` will throw an error.
          */
         generateTitle?: boolean | {
-            model: DynamicArgument<MastraLanguageModel>;
+            model: DynamicArgument<MastraModelConfig>;
             instructions?: DynamicArgument<string>;
         };
     };
@@ -370,16 +421,23 @@ export type SharedMemoryConfig = {
      */
     embedder?: EmbeddingModelId | EmbeddingModel<string> | EmbeddingModelV2<string>;
     /**
-     * Memory processors that modify retrieved messages before sending to the LLM.
-     * Useful for managing context size, filtering content, and preventing token limit errors.
-     * Processors execute in order, with TokenLimiter typically placed last.
+     * @deprecated This option is deprecated and will throw an error if used.
+     * Use the new Input/Output processor system instead.
+     *
+     * See: https://mastra.ai/en/docs/memory/processors
      *
      * @example
      * ```typescript
-     * processors: [
-     *   new CustomMemoryProcessor(),
-     *   new TokenLimiter(127000)
-     * ]
+     * // OLD (throws error):
+     * new Memory({
+     *   processors: [new TokenLimiter(100000)]
+     * })
+     *
+     * // NEW (use this):
+     * new Agent({
+     *   memory,
+     *   outputProcessors: [new TokenLimiterProcessor(100000)]
+     * })
      * ```
      */
     processors?: MemoryProcessor[];

package/dist/memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"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"}

package/dist/models-dev-23RN2WHG.js

@@ -0,0 +1,3 @@
+export { ModelsDevGateway } from './chunk-OEIVMCWX.js';
+//# sourceMappingURL=models-dev-23RN2WHG.js.map
+//# sourceMappingURL=models-dev-23RN2WHG.js.map

package/dist/{models-dev-7U4NRMM3.js.map → models-dev-23RN2WHG.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"models-dev-7U4NRMM3.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"models-dev-23RN2WHG.js"}

package/dist/models-dev-EO3SUIY2.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkMRFUISXC_cjs = require('./chunk-MRFUISXC.cjs');
+
+
+
+Object.defineProperty(exports, "ModelsDevGateway", {
+  enumerable: true,
+  get: function () { return chunkMRFUISXC_cjs.ModelsDevGateway; }
+});
+//# sourceMappingURL=models-dev-EO3SUIY2.cjs.map
+//# sourceMappingURL=models-dev-EO3SUIY2.cjs.map

package/dist/{models-dev-VKSAQPRK.cjs.map → models-dev-EO3SUIY2.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"models-dev-VKSAQPRK.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"models-dev-EO3SUIY2.cjs"}

package/dist/netlify-GXJ5D5DD.js

@@ -0,0 +1,3 @@
+export { NetlifyGateway } from './chunk-Z57R5WS4.js';
+//# sourceMappingURL=netlify-GXJ5D5DD.js.map
+//# sourceMappingURL=netlify-GXJ5D5DD.js.map

package/dist/{netlify-42ZNWIDQ.js.map → netlify-GXJ5D5DD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"netlify-42ZNWIDQ.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"netlify-GXJ5D5DD.js"}

package/dist/netlify-KJLY3GFS.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkYWMMBIOM_cjs = require('./chunk-YWMMBIOM.cjs');
+
+
+
+Object.defineProperty(exports, "NetlifyGateway", {
+  enumerable: true,
+  get: function () { return chunkYWMMBIOM_cjs.NetlifyGateway; }
+});
+//# sourceMappingURL=netlify-KJLY3GFS.cjs.map
+//# sourceMappingURL=netlify-KJLY3GFS.cjs.map

package/dist/{netlify-2IDXTNFW.cjs.map → netlify-KJLY3GFS.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"netlify-2IDXTNFW.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"netlify-KJLY3GFS.cjs"}

package/dist/observability/index.cjs

@@ -1,36 +1,44 @@
 'use strict';
 
-var chunkE7K4FTLN_cjs = require('../chunk-E7K4FTLN.cjs');
+var chunk72YCRTEX_cjs = require('../chunk-72YCRTEX.cjs');
 
 
 
 Object.defineProperty(exports, "InternalSpans", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.InternalSpans; }
+  get: function () { return chunk72YCRTEX_cjs.InternalSpans; }
 });
 Object.defineProperty(exports, "NoOpObservability", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.NoOpObservability; }
+  get: function () { return chunk72YCRTEX_cjs.NoOpObservability; }
 });
 Object.defineProperty(exports, "SamplingStrategyType", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.SamplingStrategyType; }
+  get: function () { return chunk72YCRTEX_cjs.SamplingStrategyType; }
 });
 Object.defineProperty(exports, "SpanType", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.SpanType; }
+  get: function () { return chunk72YCRTEX_cjs.SpanType; }
 });
 Object.defineProperty(exports, "TracingEventType", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.TracingEventType; }
+  get: function () { return chunk72YCRTEX_cjs.TracingEventType; }
+});
+Object.defineProperty(exports, "executeWithContext", {
+  enumerable: true,
+  get: function () { return chunk72YCRTEX_cjs.executeWithContext; }
+});
+Object.defineProperty(exports, "executeWithContextSync", {
+  enumerable: true,
+  get: function () { return chunk72YCRTEX_cjs.executeWithContextSync; }
 });
 Object.defineProperty(exports, "getOrCreateSpan", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.getOrCreateSpan; }
+  get: function () { return chunk72YCRTEX_cjs.getOrCreateSpan; }
 });
 Object.defineProperty(exports, "wrapMastra", {
   enumerable: true,
-  get: function () { return chunkE7K4FTLN_cjs.wrapMastra; }
+  get: function () { return chunk72YCRTEX_cjs.wrapMastra; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/observability/index.js

@@ -1,3 +1,3 @@
-export { InternalSpans, NoOpObservability, SamplingStrategyType, SpanType, TracingEventType, getOrCreateSpan, wrapMastra } from '../chunk-KIZIOFZC.js';
+export { InternalSpans, NoOpObservability, SamplingStrategyType, SpanType, TracingEventType, executeWithContext, executeWithContextSync, getOrCreateSpan, wrapMastra } from '../chunk-Y36Y5MTD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/observability/types/tracing.d.ts

@@ -5,6 +5,7 @@ import type { MastraError } from '../../error/index.js';
 import type { IMastraLogger } from '../../logger/index.js';
 import type { Mastra } from '../../mastra/index.js';
 import type { RequestContext } from '../../request-context/index.js';
+import type { LanguageModelUsage, ProviderMetadata } from '../../stream/types.js';
 import type { WorkflowRunStatus, WorkflowStepStatus } from '../../workflows/index.js';
 /**
  * AI-specific span types with their associated metadata
@@ -54,6 +55,10 @@ export interface AIBaseAttributes {
 export interface AgentRunAttributes extends AIBaseAttributes {
     /** Agent identifier */
     agentId: string;
+    /** Human-readable agent name */
+    agentName?: string;
+    /** Conversation/thread/session identifier for multi-turn interactions */
+    conversationId?: string;
     /** Agent Instructions **/
     instructions?: string;
     /** Agent Prompt **/
@@ -63,29 +68,62 @@ export interface AgentRunAttributes extends AIBaseAttributes {
     /** Maximum steps allowed */
     maxSteps?: number;
 }
-/** Token usage statistics - supports both v5 and legacy formats */
+/**
+ * Detailed breakdown of input token usage by type.
+ * Based on OpenInference semantic conventions.
+ */
+export interface InputTokenDetails {
+    /** Regular text tokens (non-cached, non-audio, non-image) */
+    text?: number;
+    /** Tokens served from cache (cache hit/read) */
+    cacheRead?: number;
+    /** Tokens written to cache (cache creation - Anthropic only) */
+    cacheWrite?: number;
+    /** Audio input tokens */
+    audio?: number;
+    /** Image input tokens (includes PDF pages) */
+    image?: number;
+}
+/**
+ * Detailed breakdown of output token usage by type.
+ * Based on OpenInference semantic conventions.
+ */
+export interface OutputTokenDetails {
+    /** Regular text output tokens */
+    text?: number;
+    /** Reasoning/thinking tokens (o1, Claude thinking, Gemini thoughts) */
+    reasoning?: number;
+    /** Audio output tokens */
+    audio?: number;
+    /** Image output tokens (DALL-E, etc.) */
+    image?: number;
+}
+/** Token usage statistics */
 export interface UsageStats {
+    /** Total input tokens (sum of all input details) */
     inputTokens?: number;
+    /** Total output tokens (sum of all output details) */
     outputTokens?: number;
-    promptTokens?: number;
-    completionTokens?: number;
-    totalTokens?: number;
-    reasoningTokens?: number;
-    cachedInputTokens?: number;
-    promptCacheHitTokens?: number;
-    promptCacheMissTokens?: number;
+    /** Detailed breakdown of input token usage */
+    inputDetails?: InputTokenDetails;
+    /** Detailed breakdown of output token usage */
+    outputDetails?: OutputTokenDetails;
 }
 /**
  * Model Generation attributes
  */
 export interface ModelGenerationAttributes extends AIBaseAttributes {
+    /** Agent identifier (when generation is part of an agent run) */
+    agentId?: string;
+    /** Human-readable agent name (when generation is part of an agent run) */
+    agentName?: string;
     /** Model name (e.g., 'gpt-4', 'claude-3') */
     model?: string;
     /** Model provider (e.g., 'openai', 'anthropic') */
     provider?: string;
     /** Type of result/output this LLM call produced */
     resultType?: 'tool_selection' | 'response_generation' | 'reasoning' | 'planning';
-    /** Token usage statistics - supports both v5 and legacy formats */
+    /** Token usage statistics */
     usage?: UsageStats;
     /** Model parameters */
     parameters?: {
@@ -105,6 +143,20 @@ export interface ModelGenerationAttributes extends AIBaseAttributes {
     streaming?: boolean;
     /** Reason the generation finished */
     finishReason?: string;
+    /**
+     * When the first token/chunk of the completion was received.
+     * Used to calculate time-to-first-token (TTFT) metrics.
+     * Only applicable for streaming responses.
+     */
+    completionStartTime?: Date;
+    /** Actual model used in the response (may differ from request model) */
+    responseModel?: string;
+    /** Unique identifier for the response */
+    responseId?: string;
+    /** Server address for the model endpoint */
+    serverAddress?: string;
+    /** Server port for the model endpoint */
+    serverPort?: number;
 }
 /**
  * Model Step attributes - for a single model execution within a generation
@@ -162,6 +214,16 @@ export interface ProcessorRunAttributes extends AIBaseAttributes {
     processorType: 'input' | 'output';
     /** Processor index in the agent */
     processorIndex?: number;
+    /** MessageList mutations performed by this processor */
+    messageListMutations?: Array<{
+        type: 'add' | 'addSystem' | 'removeByIds' | 'clear';
+        source?: string;
+        count?: number;
+        ids?: string[];
+        text?: string;
+        tag?: string;
+        message?: any;
+    }>;
 }
 /**
  * Workflow Run attributes
@@ -288,10 +350,12 @@ interface BaseSpan<TType extends SpanType> {
     startTime: Date;
     /** When span ended */
     endTime?: Date;
-    /** Is an internal span? (spans internal to the operation of mastra) */
+    /** Span-type specific attributes */
     attributes?: SpanTypeMap[TType];
     /** User-defined metadata */
     metadata?: Record<string, any>;
+    /** Labels used to categorize and filter traces. Only valid on root spans. */
+    tags?: string[];
     /** Input passed at the start of the span */
     input?: any;
     /** Output generated at the end of the span */
@@ -342,6 +406,80 @@ export interface Span<TType extends SpanType> extends BaseSpan<TType> {
     exportSpan(includeInternalSpans?: boolean): ExportedSpan<TType> | undefined;
     /** Returns the traceId on span, unless NoOpSpan, then undefined */
     get externalTraceId(): string | undefined;
+    /**
+     * Execute an async function within this span's tracing context.
+     *
+     * When a bridge is configured, this enables auto-instrumented operations
+     * (HTTP requests, database queries, etc.) to be properly nested under this
+     * span in the external tracing system.
+     *
+     * @param fn - The async function to execute within the span context
+     * @returns The result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = await modelSpan.executeInContext(async () => {
+     *   return model.generateText(...);
+     * });
+     * ```
+     */
+    executeInContext<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a synchronous function within this span's tracing context.
+     *
+     * When a bridge is configured, this enables auto-instrumented operations
+     * (HTTP requests, database queries, etc.) to be properly nested under this
+     * span in the external tracing system.
+     *
+     * @param fn - The synchronous function to execute within the span context
+     * @returns The result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = modelSpan.executeInContextSync(() => {
+     *   return model.streamText(...);
+     * });
+     * ```
+     */
+    executeInContextSync<T>(fn: () => T): T;
+}
+export interface BridgeSpanContext {
+    /**
+     * Execute an async function within this span's tracing context.
+     *
+     * When a bridge is configured, this enables auto-instrumented operations
+     * (HTTP requests, database queries, etc.) to be properly nested under this
+     * span in the external tracing system.
+     *
+     * @param fn - The async function to execute within the span context
+     * @returns The result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = await modelSpan.executeInContext(async () => {
+     *   return model.generateText(...);
+     * });
+     * ```
+     */
+    executeInContext<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a synchronous function within this span's tracing context.
+     *
+     * When a bridge is configured, this enables auto-instrumented operations
+     * (HTTP requests, database queries, etc.) to be properly nested under this
+     * span in the external tracing system.
+     *
+     * @param fn - The synchronous function to execute within the span context
+     * @returns The result of the function execution
+     *
+     * @example
+     * ```typescript
+     * const result = modelSpan.executeInContextSync(() => {
+     *   return model.streamText(...);
+     * });
+     * ```
+     */
+    executeInContextSync<T>(fn: () => T): T;
 }
 /**
  * Specialized span interface for MODEL_GENERATION spans
@@ -359,11 +497,25 @@ export interface ExportedSpan<TType extends SpanType> extends BaseSpan<TType> {
     parentSpanId?: string;
     /** `TRUE` if the span is the root span of a trace */
     isRootSpan: boolean;
+    /**
+     * Tags for this trace (only present on root spans).
+     * Tags are string labels used to categorize and filter traces.
+     */
+    tags?: string[];
+}
+/**
+ * Options for ending a model generation span
+ */
+export interface EndGenerationOptions extends EndSpanOptions<SpanType.MODEL_GENERATION> {
+    /** Raw usage data from AI SDK - will be converted to UsageStats with cache token details */
+    usage?: LanguageModelUsage;
+    /** Provider-specific metadata for extracting cache tokens */
+    providerMetadata?: ProviderMetadata;
 }
 export interface IModelSpanTracker {
     getTracingContext(): TracingContext;
     reportGenerationError(options: ErrorSpanOptions<SpanType.MODEL_GENERATION>): void;
-    endGeneration(options?: EndSpanOptions<SpanType.MODEL_GENERATION>): void;
+    endGeneration(options?: EndGenerationOptions): void;
     wrapStream<T extends {
         pipeThrough: Function;
     }>(stream: T): T;
@@ -383,7 +535,7 @@ export interface ObservabilityInstance {
     /**
      * Get current configuration
      */
-    getConfig(): Readonly<Required<ObservabilityInstanceConfig>>;
+    getConfig(): Readonly<ObservabilityInstanceConfig>;
     /**
      * Get all exporters
      */
@@ -396,6 +548,10 @@ export interface ObservabilityInstance {
      * Get the logger instance (for exporters and other components)
      */
     getLogger(): IMastraLogger;
+    /**
+     * Get the bridge instance if configured
+     */
+    getBridge(): ObservabilityBridge | undefined;
     /**
      * Start a new span of a specific SpanType
      */
@@ -431,6 +587,8 @@ export interface CreateSpanOptions<TType extends SpanType> extends CreateBaseOpt
     input?: any;
     /** Output data (for event spans) */
     output?: any;
+    /** Labels used to categorize and filter traces. Only valid on root spans. */
+    tags?: string[];
     /** Parent span */
     parent?: AnySpan;
     /** Is an event span? */
@@ -593,6 +751,17 @@ export interface TracingOptions {
      * If provided, the root span will be created as a child of this span.
      */
     parentSpanId?: string;
+    /**
+     * Tags to apply to this trace.
+     * Tags are string labels that can be used to categorize and filter traces
+     * Note: Tags are only applied to the root span of a trace.
+     */
+    tags?: string[];
+}
+export interface SpanIds {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
 }
 /**
  * Context for tracing that flows through workflow and agent execution
@@ -622,6 +791,8 @@ export interface ObservabilityInstanceConfig {
     exporters?: ObservabilityExporter[];
     /** Custom processors */
     spanOutputProcessors?: SpanOutputProcessor[];
+    /** OpenTelemetry bridge for integration with existing OTEL infrastructure */
+    bridge?: ObservabilityBridge;
     /** Set to `true` if you want to see spans internal to the operation of mastra */
     includeInternalSpans?: boolean;
     /**
@@ -699,6 +870,10 @@ export interface InitExporterOptions {
     mastra?: Mastra;
     config?: ObservabilityInstanceConfig;
 }
+export interface InitBridgeOptions {
+    mastra?: Mastra;
+    config?: ObservabilityInstanceConfig;
+}
 /**
  * Interface for tracing exporters
  */
@@ -707,7 +882,7 @@ export interface ObservabilityExporter {
     name: string;
     /** Initialize exporter with tracing configuration and/or access to Mastra */
     init?(options: InitExporterOptions): void;
-    /** Sets logger instance throughout Observability, including all configured exporters, processors, etc..  */
+    /** Sets logger instance on the exporter.  */
     __setLogger?(logger: IMastraLogger): void;
     /** Export tracing events */
     exportTracingEvent(event: TracingEvent): Promise<void>;
@@ -722,6 +897,54 @@ export interface ObservabilityExporter {
     /** Shutdown exporter */
     shutdown(): Promise<void>;
 }
+/**
+ * Interface for observability bridges
+ */
+export interface ObservabilityBridge {
+    /** Bridge name */
+    name: string;
+    /** Initialize bridge with observability configuration and/or access to Mastra */
+    init?(options: InitBridgeOptions): void;
+    /** Sets logger instance on the bridge  */
+    __setLogger?(logger: IMastraLogger): void;
+    /**
+     * Export Mastra tracing events to OTEL infrastructure
+     * Called for SPAN_STARTED, SPAN_UPDATED, SPAN_ENDED events
+     *
+     * @param event - Tracing event with exported span
+     */
+    exportTracingEvent(event: TracingEvent): Promise<void>;
+    /**
+     * Execute an async function within the tracing context of a Mastra span.
+     * This enables auto-instrumented operations (HTTP, DB) to have correct parent spans
+     * in the external tracing system (e.g., OpenTelemetry, DataDog, etc.).
+     *
+     * @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?<T>(spanId: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a synchronous function within the tracing context of a Mastra span.
+     * This enables auto-instrumented operations (HTTP, DB) to have correct parent spans
+     * in the external tracing system (e.g., OpenTelemetry, DataDog, etc.).
+     *
+     * @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?<T>(spanId: string, fn: () => T): T;
+    /**
+     * 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: CreateSpanOptions<SpanType>): SpanIds | undefined;
+    /** Shutdown bridge and cleanup resources */
+    shutdown(): Promise<void>;
+}
 /**
  * Interface for span processors
  */