@mastra/core 1.23.1-alpha.0 → 1.24.0-alpha.1

package/dist/chunk-ZPHI6QAA.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var chunkQFGYBEP3_cjs = require('./chunk-QFGYBEP3.cjs');
+var async_hooks = require('async_hooks');
+
+var spanContextStorage = new async_hooks.AsyncLocalStorage();
+function getCurrentSpan() {
+  return spanContextStorage.getStore();
+}
+var initialized = false;
+function initContextStorage() {
+  if (initialized) return;
+  initialized = true;
+  chunkQFGYBEP3_cjs.setCurrentSpanResolver(getCurrentSpan);
+  chunkQFGYBEP3_cjs.setExecuteWithContext(executeWithContext);
+  chunkQFGYBEP3_cjs.setExecuteWithContextSync(executeWithContextSync);
+}
+async function executeWithContext(params) {
+  const { span, fn } = params;
+  const wrappedFn = span ? () => spanContextStorage.run(span, fn) : fn;
+  if (span?.executeInContext) {
+    return span.executeInContext(wrappedFn);
+  }
+  return wrappedFn();
+}
+function executeWithContextSync(params) {
+  const { span, fn } = params;
+  const wrappedFn = span ? () => spanContextStorage.run(span, fn) : fn;
+  if (span?.executeInContextSync) {
+    return span.executeInContextSync(wrappedFn);
+  }
+  return wrappedFn();
+}
+
+exports.executeWithContext = executeWithContext;
+exports.executeWithContextSync = executeWithContextSync;
+exports.getCurrentSpan = getCurrentSpan;
+exports.initContextStorage = initContextStorage;
+//# sourceMappingURL=chunk-ZPHI6QAA.cjs.map
+//# sourceMappingURL=chunk-ZPHI6QAA.cjs.map

package/dist/chunk-ZPHI6QAA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/context-storage.ts"],"names":["AsyncLocalStorage","setCurrentSpanResolver","setExecuteWithContext","setExecuteWithContextSync"],"mappings":";;;;;AAUA,IAAM,kBAAA,GAAqB,IAAIA,6BAAA,EAA2B;AAMnD,SAAS,cAAA,GAAsC;AACpD,EAAA,OAAO,mBAAmB,QAAA,EAAS;AACrC;AAEA,IAAI,WAAA,GAAc,KAAA;AAUX,SAAS,kBAAA,GAA2B;AACzC,EAAA,IAAI,WAAA,EAAa;AACjB,EAAA,WAAA,GAAc,IAAA;AACd,EAAAC,wCAAA,CAAuB,cAAc,CAAA;AACrC,EAAAC,uCAAA,CAAsB,kBAAkB,CAAA;AACxC,EAAAC,2CAAA,CAA0B,sBAAsB,CAAA;AAClD;AAqBA,eAAsB,mBAAsB,MAAA,EAA8D;AACxG,EAAA,MAAM,EAAE,IAAA,EAAM,EAAA,EAAG,GAAI,MAAA;AAGrB,EAAA,MAAM,YAAY,IAAA,GAAO,MAAM,mBAAmB,GAAA,CAAI,IAAA,EAAM,EAAE,CAAA,GAAI,EAAA;AAElE,EAAA,IAAI,MAAM,gBAAA,EAAkB;AAC1B,IAAA,OAAO,IAAA,CAAK,iBAAiB,SAAS,CAAA;AAAA,EACxC;AAEA,EAAA,OAAO,SAAA,EAAU;AACnB;AAqBO,SAAS,uBAA0B,MAAA,EAA4C;AACpF,EAAA,MAAM,EAAE,IAAA,EAAM,EAAA,EAAG,GAAI,MAAA;AAGrB,EAAA,MAAM,YAAY,IAAA,GAAO,MAAM,mBAAmB,GAAA,CAAI,IAAA,EAAM,EAAE,CAAA,GAAI,EAAA;AAElE,EAAA,IAAI,MAAM,oBAAA,EAAsB;AAC9B,IAAA,OAAO,IAAA,CAAK,qBAAqB,SAAS,CAAA;AAAA,EAC5C;AAEA,EAAA,OAAO,SAAA,EAAU;AACnB","file":"chunk-ZPHI6QAA.cjs","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { AnySpan } from './types';\nimport { setCurrentSpanResolver, setExecuteWithContext, setExecuteWithContextSync } from './utils';\n\n/**\n * Ambient storage for the current span. Populated by executeWithContext/executeWithContextSync\n * so that infrastructure code (e.g. DualLogger) can resolve the active span without\n * being passed it explicitly.\n */\nconst spanContextStorage = new AsyncLocalStorage<AnySpan>();\n\n/**\n * Returns the current span from AsyncLocalStorage, if one is active.\n * Used by DualLogger to forward logs to a span-correlated loggerVNext.\n */\nexport function getCurrentSpan(): AnySpan | undefined {\n  return spanContextStorage.getStore();\n}\n\nlet initialized = false;\n\n/**\n * Registers the AsyncLocalStorage-backed context resolvers with the browser-safe\n * utils module. Must be called once at startup (e.g. from the Mastra constructor).\n *\n * This is an explicit initialization function rather than a top-level side-effect\n * because the package declares `\"sideEffects\": false` and tsup's tree-shaking\n * (`preset: 'smallest'`) strips bare side-effect imports.\n */\nexport function initContextStorage(): void {\n  if (initialized) return;\n  initialized = true;\n  setCurrentSpanResolver(getCurrentSpan);\n  setExecuteWithContext(executeWithContext);\n  setExecuteWithContextSync(executeWithContextSync);\n}\n\n/**\n * Execute an async function within the span's tracing context if available.\n * Falls back to direct execution if no span exists.\n *\n * When a bridge is configured, this enables auto-instrumented operations\n * (HTTP requests, database queries, etc.) to be properly nested under the\n * current span in the external tracing system.\n *\n * @param span - The span to use as context (or undefined to execute without context)\n * @param fn - The async function to execute\n * @returns The result of the function execution\n *\n * @example\n * ```typescript\n * const result = await executeWithContext(llmSpan, async () =>\n *   model.generateText(args)\n * );\n * ```\n */\nexport async function executeWithContext<T>(params: { span?: AnySpan; fn: () => Promise<T> }): Promise<T> {\n  const { span, fn } = params;\n\n  // Wrap fn so the span is available via getCurrentSpan() inside the async context.\n  const wrappedFn = span ? () => spanContextStorage.run(span, fn) : fn;\n\n  if (span?.executeInContext) {\n    return span.executeInContext(wrappedFn);\n  }\n\n  return wrappedFn();\n}\n\n/**\n * Execute a synchronous function within the span's tracing context if available.\n * Falls back to direct execution if no span exists.\n *\n * When a bridge is configured, this enables auto-instrumented operations\n * (HTTP requests, database queries, etc.) to be properly nested under the\n * current span in the external tracing system.\n *\n * @param span - The span to use as context (or undefined to execute without context)\n * @param fn - The synchronous function to execute\n * @returns The result of the function execution\n *\n * @example\n * ```typescript\n * const result = executeWithContextSync(llmSpan, () =>\n *   model.streamText(args)\n * );\n * ```\n */\nexport function executeWithContextSync<T>(params: { span?: AnySpan; fn: () => T }): T {\n  const { span, fn } = params;\n\n  // Wrap fn so the span is available via getCurrentSpan() inside the sync context.\n  const wrappedFn = span ? () => spanContextStorage.run(span, fn) : fn;\n\n  if (span?.executeInContextSync) {\n    return span.executeInContextSync(wrappedFn);\n  }\n\n  return wrappedFn();\n}\n"]}

package/dist/datasets/index.cjs

@@ -1,69 +1,69 @@
 'use strict';
 
-var chunkFDSY7ZGW_cjs = require('../chunk-FDSY7ZGW.cjs');
-var chunkWXCT24DY_cjs = require('../chunk-WXCT24DY.cjs');
+var chunkL73KZFX6_cjs = require('../chunk-L73KZFX6.cjs');
+var chunkSRQR5UN6_cjs = require('../chunk-SRQR5UN6.cjs');
 
 
 
 Object.defineProperty(exports, "Dataset", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.Dataset; }
+  get: function () { return chunkL73KZFX6_cjs.Dataset; }
 });
 Object.defineProperty(exports, "DatasetsManager", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.DatasetsManager; }
+  get: function () { return chunkL73KZFX6_cjs.DatasetsManager; }
 });
 Object.defineProperty(exports, "compareExperiments", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.compareExperiments; }
+  get: function () { return chunkL73KZFX6_cjs.compareExperiments; }
 });
 Object.defineProperty(exports, "computeMean", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.computeMean; }
+  get: function () { return chunkL73KZFX6_cjs.computeMean; }
 });
 Object.defineProperty(exports, "computeScorerStats", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.computeScorerStats; }
+  get: function () { return chunkL73KZFX6_cjs.computeScorerStats; }
 });
 Object.defineProperty(exports, "executeTarget", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.executeTarget; }
+  get: function () { return chunkL73KZFX6_cjs.executeTarget; }
 });
 Object.defineProperty(exports, "isRegression", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.isRegression; }
+  get: function () { return chunkL73KZFX6_cjs.isRegression; }
 });
 Object.defineProperty(exports, "resolveScorers", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.resolveScorers; }
+  get: function () { return chunkL73KZFX6_cjs.resolveScorers; }
 });
 Object.defineProperty(exports, "runExperiment", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.runExperiment; }
+  get: function () { return chunkL73KZFX6_cjs.runExperiment; }
 });
 Object.defineProperty(exports, "runScorersForItem", {
   enumerable: true,
-  get: function () { return chunkFDSY7ZGW_cjs.runScorersForItem; }
+  get: function () { return chunkL73KZFX6_cjs.runScorersForItem; }
 });
 Object.defineProperty(exports, "SchemaUpdateValidationError", {
   enumerable: true,
-  get: function () { return chunkWXCT24DY_cjs.SchemaUpdateValidationError; }
+  get: function () { return chunkSRQR5UN6_cjs.SchemaUpdateValidationError; }
 });
 Object.defineProperty(exports, "SchemaValidationError", {
   enumerable: true,
-  get: function () { return chunkWXCT24DY_cjs.SchemaValidationError; }
+  get: function () { return chunkSRQR5UN6_cjs.SchemaValidationError; }
 });
 Object.defineProperty(exports, "SchemaValidator", {
   enumerable: true,
-  get: function () { return chunkWXCT24DY_cjs.SchemaValidator; }
+  get: function () { return chunkSRQR5UN6_cjs.SchemaValidator; }
 });
 Object.defineProperty(exports, "createValidator", {
   enumerable: true,
-  get: function () { return chunkWXCT24DY_cjs.createValidator; }
+  get: function () { return chunkSRQR5UN6_cjs.createValidator; }
 });
 Object.defineProperty(exports, "getSchemaValidator", {
   enumerable: true,
-  get: function () { return chunkWXCT24DY_cjs.getSchemaValidator; }
+  get: function () { return chunkSRQR5UN6_cjs.getSchemaValidator; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/datasets/index.js

@@ -1,4 +1,4 @@
-export { Dataset, DatasetsManager, compareExperiments, computeMean, computeScorerStats, executeTarget, isRegression, resolveScorers, runExperiment, runScorersForItem } from '../chunk-HMVCVSAM.js';
-export { SchemaUpdateValidationError, SchemaValidationError, SchemaValidator, createValidator, getSchemaValidator } from '../chunk-S2546L42.js';
+export { Dataset, DatasetsManager, compareExperiments, computeMean, computeScorerStats, executeTarget, isRegression, resolveScorers, runExperiment, runScorersForItem } from '../chunk-IKUMKFM4.js';
+export { SchemaUpdateValidationError, SchemaValidationError, SchemaValidator, createValidator, getSchemaValidator } from '../chunk-7BBERBXP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-core
 description: Documentation for @mastra/core. Use when working with @mastra/core APIs, configuration, or implementation.
 metadata:
   package: "@mastra/core"
-  version: "1.23.1-alpha.0"
+  version: "1.24.0-alpha.1"
 ---
 
 ## When to use
@@ -211,6 +211,7 @@ Read the individual reference documents for detailed explanations and code examp
 - [Reference: Tracing](references/reference-observability-tracing-instances.md) - Core Tracing classes and methods
 - [Reference: Interfaces](references/reference-observability-tracing-interfaces.md) - Tracing type definitions and interfaces
 - [Reference: SensitiveDataFilter](references/reference-observability-tracing-processors-sensitive-data-filter.md) - API reference for the SensitiveDataFilter processor
+- [Reference: Span filtering](references/reference-observability-tracing-span-filtering.md) - Reference for excludeSpanTypes, spanFilter, and span filtering behavior
 - [Reference: Spans](references/reference-observability-tracing-spans.md) - Span interfaces, methods, and lifecycle events
 - [Reference: BatchPartsProcessor](references/reference-processors-batch-parts-processor.md) - Documentation for the BatchPartsProcessor in Mastra, which batches multiple stream parts together to reduce frequency of emissions.
 - [Reference: LanguageDetector](references/reference-processors-language-detector.md) - Documentation for the LanguageDetector in Mastra, which detects language and can translate content in AI responses.