@mastra/core 1.23.0-alpha.8 → 1.23.0

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @mastra/core
 
+## 1.23.0
+
+### Minor Changes
+
+- Added `UpdateObservationalMemoryConfigInput` type, `updateObservationalMemoryConfig()` method stub, and `deepMergeConfig()` utility to the `MemoryStorage` base class. These additions support per-record observational memory config overrides introduced in `@mastra/memory`. ([#15115](https://github.com/mastra-ai/mastra/pull/15115))
+
+- Memory operations now produce observability spans and accept an optional `observabilityContext` parameter. A new `MEMORY_OPERATION` span type, `MEMORY` entity type, and `MemoryOperationAttributes` interface let you identify memory spans in your traces. Agent and network code automatically threads observability context into memory calls. ([#14305](https://github.com/mastra-ai/mastra/pull/14305))
+
+  **New observability identifiers:**
+  - `SpanType.MEMORY_OPERATION` — span type for all memory operations
+  - `EntityType.MEMORY` — entity type for memory spans
+  - `MemoryOperationAttributes` — typed attributes (operationType, messageCount, embeddingTokens, etc.)
+
+  **Updated abstract methods** on `MastraMemory` now accept optional `observabilityContext`:
+
+  ```typescript
+  import type { ObservabilityContext } from '@mastra/core/observability';
+
+  // All four methods accept an optional observabilityContext
+  await memory.recall({
+    threadId: 'thread-1',
+    observabilityContext: { tracingContext: { currentSpan: parentSpan } },
+  });
+
+  await memory.saveMessages({
+    messages,
+    observabilityContext: { tracingContext: { currentSpan: parentSpan } },
+  });
+
+  await memory.deleteMessages(['msg-1'], { tracingContext: { currentSpan: parentSpan } });
+
+  await memory.updateWorkingMemory({
+    threadId: 'thread-1',
+    workingMemory: 'content',
+    observabilityContext: { tracingContext: { currentSpan: parentSpan } },
+  });
+  ```
+
+- Added dynamic function support for workspace tool config. The `enabled`, `requireApproval`, and `requireReadBeforeWrite` options now accept async functions in addition to static booleans, enabling context-aware tool behavior like disabling tools based on user tier or requiring approval only for certain file paths. ([#14528](https://github.com/mastra-ai/mastra/pull/14528))
+
+  **Example**
+
+  ```typescript
+  tools: {
+    [WORKSPACE_TOOLS.FILESYSTEM.WRITE_FILE]: {
+      requireApproval: async ({ args }) => {
+        return (args.path as string).startsWith('/protected')
+      },
+    },
+    [WORKSPACE_TOOLS.SANDBOX.EXECUTE_COMMAND]: {
+      enabled: async ({ requestContext }) => {
+        return requestContext['allowExecution'] === 'true'
+      },
+    },
+  }
+  ```
+
+- Added MASTRA_OFFLINE environment variable to disable network fetches for provider data in offline/air-gapped environments. When set to 'true' or '1', all provider sync and auto-refresh operations are skipped while the static provider registry remains fully functional. ([#15101](https://github.com/mastra-ai/mastra/pull/15101))
+
+- Added `WORKSPACE_ACTION` span type for workspace tracing. All workspace tools (filesystem, sandbox, search, skill, LSP) now create child spans with metadata including category, operation, file paths, commands, exit codes, bytes transferred, and duration. Added `startWorkspaceSpan()` utility for span creation with graceful no-op when tracing is inactive. ([#14554](https://github.com/mastra-ai/mastra/pull/14554))
+
+### Patch Changes
+
+- Update provider registry and model documentation with latest models and providers ([`f32b9e1`](https://github.com/mastra-ai/mastra/commit/f32b9e115a3c754d1c8cfa3f4256fba87b09cfb7))
+
+- Added `setBrowser` method to Agent class for runtime browser configuration ([#15036](https://github.com/mastra-ai/mastra/pull/15036))
+
+- Fixed resourceId being overwritten to NULL during workflow execution of loop, foreach, parallel, and conditional steps. The resourceId set via `createRun()` is now correctly preserved throughout the entire workflow lifecycle. ([#14958](https://github.com/mastra-ai/mastra/pull/14958))
+
+- Fix onScorerRun hook payloads missing threadId and resourceId so hooks now receive correct identifiers ([#13835](https://github.com/mastra-ai/mastra/pull/13835))
+
+- Fixed AGENTS.md reminder persistence and deduplication across turns by storing reminder metadata on injected user messages. ([#15100](https://github.com/mastra-ai/mastra/pull/15100))
+
+- Fixed sub-agent memory isolation so sub-agents no longer inherit parent requestContext keys and write to their own threads when `mastra__threadId` or `mastra__resourceId` are set. ([#15022](https://github.com/mastra-ai/mastra/pull/15022))
+
+- Fully isolate `async_hooks` from shared chunks so importing `@mastra/core` in browser bundles never pulls in the Node-only dependency ([#15074](https://github.com/mastra-ai/mastra/pull/15074))
+
+- Fixed `__setLogger` passing a raw string to `logger.child()`, which caused PinoLogger to serialize each character as a separate log field (e.g. `0: "B", 1: "U", 2: "N"...`). Now passes `{ component }` object instead. ([#15079](https://github.com/mastra-ai/mastra/pull/15079))
+
+- Fixed observational memory buffering so sealed assistant chunks stay split instead of being merged back into one persisted message during long tool runs. ([#14995](https://github.com/mastra-ai/mastra/pull/14995))
+
+- Fixed image attachments from @ai-sdk/react and @ai-sdk/vue clients throwing errors. File parts using the AI SDK v5 UIMessage format ({ type: 'file', url: '...', mediaType: '...' }) are now handled correctly when routed through the ModelMessage code path. ([#14734](https://github.com/mastra-ai/mastra/pull/14734))
+
+- Fixed a browser bundling issue where importing `@mastra/core` could pull in a Node-only dependency. ([#15072](https://github.com/mastra-ai/mastra/pull/15072))
+
+## 1.23.0-alpha.9
+
+### Minor Changes
+
+- Added `UpdateObservationalMemoryConfigInput` type, `updateObservationalMemoryConfig()` method stub, and `deepMergeConfig()` utility to the `MemoryStorage` base class. These additions support per-record observational memory config overrides introduced in `@mastra/memory`. ([#15115](https://github.com/mastra-ai/mastra/pull/15115))
+
 ## 1.23.0-alpha.8
 
 ### Minor Changes

package/README.md

@@ -50,6 +50,9 @@ npm install @mastra/core
 - **Voice** (`/voice`) - Voice interaction capabilities with text-to-speech and speech-to-text integration. Supports multiple voice providers and real-time voice
   communication for agents. [Learn more about Voice](https://mastra.ai/docs/voice/overview)
 
+- **Browser** (`/browser`) - Base classes and utilities for browser automation. Provides the `MastraBrowser` abstract class, thread management, and screencast streaming
+  for building browser providers. Use with `@mastra/agent-browser` or `@mastra/stagehand` for complete browser automation. [Learn more about Browser](https://mastra.ai/docs/browser/overview)
+
 ## Additional Resources
 
 - [Getting Started Guide](https://mastra.ai/docs/getting-started/installation)

package/dist/agent/index.cjs

@@ -1,37 +1,37 @@
 'use strict';
 
-var chunkON4TYQED_cjs = require('../chunk-ON4TYQED.cjs');
+var chunkBWVSCKCI_cjs = require('../chunk-BWVSCKCI.cjs');
 var chunkWAPY5X7M_cjs = require('../chunk-WAPY5X7M.cjs');
 
 
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.Agent; }
+  get: function () { return chunkBWVSCKCI_cjs.Agent; }
 });
 Object.defineProperty(exports, "TripWire", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.TripWire; }
+  get: function () { return chunkBWVSCKCI_cjs.TripWire; }
 });
 Object.defineProperty(exports, "isSupportedLanguageModel", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.isSupportedLanguageModel; }
+  get: function () { return chunkBWVSCKCI_cjs.isSupportedLanguageModel; }
 });
 Object.defineProperty(exports, "resolveThreadIdFromArgs", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.resolveThreadIdFromArgs; }
+  get: function () { return chunkBWVSCKCI_cjs.resolveThreadIdFromArgs; }
 });
 Object.defineProperty(exports, "supportedLanguageModelSpecifications", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.supportedLanguageModelSpecifications; }
+  get: function () { return chunkBWVSCKCI_cjs.supportedLanguageModelSpecifications; }
 });
 Object.defineProperty(exports, "tryGenerateWithJsonFallback", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.tryGenerateWithJsonFallback; }
+  get: function () { return chunkBWVSCKCI_cjs.tryGenerateWithJsonFallback; }
 });
 Object.defineProperty(exports, "tryStreamWithJsonFallback", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.tryStreamWithJsonFallback; }
+  get: function () { return chunkBWVSCKCI_cjs.tryStreamWithJsonFallback; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,

package/dist/agent/index.js

@@ -1,4 +1,4 @@
-export { Agent, TripWire, isSupportedLanguageModel, resolveThreadIdFromArgs, supportedLanguageModelSpecifications, tryGenerateWithJsonFallback, tryStreamWithJsonFallback } from '../chunk-AGEOFSDZ.js';
+export { Agent, TripWire, isSupportedLanguageModel, resolveThreadIdFromArgs, supportedLanguageModelSpecifications, tryGenerateWithJsonFallback, tryStreamWithJsonFallback } from '../chunk-2KZU2SCO.js';
 export { MessageList, TypeDetector, aiV5ModelMessageToV2PromptMessage, convertMessages } from '../chunk-DRKIN7BQ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/browser/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkON4TYQED_cjs = require('../chunk-ON4TYQED.cjs');
+var chunkBWVSCKCI_cjs = require('../chunk-BWVSCKCI.cjs');
 var chunkFCQNDFEW_cjs = require('../chunk-FCQNDFEW.cjs');
 var chunk7GW2TQXP_cjs = require('../chunk-7GW2TQXP.cjs');
 var events = require('events');
@@ -1037,7 +1037,7 @@ To fix this, either:
    */
   getInputProcessors(configuredProcessors = []) {
     const hasProcessor = configuredProcessors.some(
-      (p) => !chunkON4TYQED_cjs.isProcessorWorkflow(p) && "id" in p && p.id === "browser-context"
+      (p) => !chunkBWVSCKCI_cjs.isProcessorWorkflow(p) && "id" in p && p.id === "browser-context"
     );
     if (hasProcessor) return [];
     return [new BrowserContextProcessor()];

package/dist/browser/index.js

@@ -1,4 +1,4 @@
-import { isProcessorWorkflow } from '../chunk-AGEOFSDZ.js';
+import { isProcessorWorkflow } from '../chunk-2KZU2SCO.js';
 import { MastraBase } from '../chunk-WENZPAHS.js';
 import { RegisteredLogger } from '../chunk-DBBWTK24.js';
 import { EventEmitter } from 'events';

package/dist/channels/index.cjs

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkON4TYQED_cjs = require('../chunk-ON4TYQED.cjs');
+var chunkBWVSCKCI_cjs = require('../chunk-BWVSCKCI.cjs');
 
 
 
 Object.defineProperty(exports, "AgentChannels", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.AgentChannels; }
+  get: function () { return chunkBWVSCKCI_cjs.AgentChannels; }
 });
 Object.defineProperty(exports, "ChatChannelProcessor", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.ChatChannelProcessor; }
+  get: function () { return chunkBWVSCKCI_cjs.ChatChannelProcessor; }
 });
 Object.defineProperty(exports, "MastraStateAdapter", {
   enumerable: true,
-  get: function () { return chunkON4TYQED_cjs.MastraStateAdapter; }
+  get: function () { return chunkBWVSCKCI_cjs.MastraStateAdapter; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/channels/index.js

@@ -1,3 +1,3 @@
-export { AgentChannels, ChatChannelProcessor, MastraStateAdapter } from '../chunk-AGEOFSDZ.js';
+export { AgentChannels, ChatChannelProcessor, MastraStateAdapter } from '../chunk-2KZU2SCO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{chunk-AGEOFSDZ.js → chunk-2KZU2SCO.js}

@@ -1,13 +1,13 @@
+import { PUBSUB_SYMBOL, STREAM_FORMAT_SYMBOL } from './chunk-2QXNHEDL.js';
 import { createWorkspaceTools, createSkillTools, getTiktoken, BM25Index } from './chunk-TD7IL7ZC.js';
 import { DefaultVoice } from './chunk-72EQLBZY.js';
-import { PUBSUB_SYMBOL, STREAM_FORMAT_SYMBOL } from './chunk-2QXNHEDL.js';
 import { InMemoryStore } from './chunk-YRGPLKBI.js';
 import { MessageList, coreContentToString, DefaultGeneratedFile, DefaultGeneratedFileWithType, sanitizeToolName } from './chunk-DRKIN7BQ.js';
 import { parsePartialJson, isDeepEqualData, stepCountIs } from './chunk-2PHG443D.js';
 import { generateId, APICallError, tool, asSchema } from './chunk-6PALJNKG.js';
 import { EventEmitterPubSub } from './chunk-X2HAI3OX.js';
 import { executeHook } from './chunk-L54GIUCB.js';
-import { resolveModelConfig, ModelRouterEmbeddingModel, ModelRouterLanguageModel } from './chunk-GYBRTUAA.js';
+import { resolveModelConfig, ModelRouterEmbeddingModel, ModelRouterLanguageModel } from './chunk-WRGRNVJH.js';
 import { MastraLLMV1 } from './chunk-KQIVH5GM.js';
 import { noopLogger } from './chunk-PJ5YCHXB.js';
 import { removeUndefinedValues, safeStringify, ensureToolProperties, makeCoreTool, createMastraProxy, deepMerge, generateEmptyFromSchema, selectFields, ensureSerializable, delay } from './chunk-OLCO53KU.js';
@@ -29239,5 +29239,5 @@ var MockMemory = class extends MastraMemory {
 };
 
 export { Agent, AgentChannels, AgentsMDInjector, BaseProcessor, BatchPartsProcessor, ChatChannelProcessor, ChunkFrom, DefaultExecutionEngine, ExecutionEngine, FilePartSchema, ImagePartSchema, LanguageDetector, MastraAgentNetworkStream, MastraMemory, MastraModelOutput, MastraScorer, MastraStateAdapter, MemoryProcessor, MessageContentSchema, MessageHistory, MessagePartSchema, MockMemory, ModerationProcessor, PIIDetector, ProcessorInputPhaseSchema, ProcessorInputStepPhaseSchema, ProcessorMessageContentSchema, ProcessorMessageSchema, ProcessorOutputResultPhaseSchema, ProcessorOutputStepPhaseSchema, ProcessorOutputStreamPhaseSchema, ProcessorRunner, ProcessorState, ProcessorStepInputSchema, ProcessorStepOutputSchema, ProcessorStepSchema, PromptInjectionDetector, ReasoningPartSchema, Run, SYSTEM_REMINDER_END_TAG, SYSTEM_REMINDER_START_TAG, SemanticRecall, SkillSearchProcessor, SkillsProcessor, SourcePartSchema, StepStartPartSchema, StructuredOutputProcessor, SystemPromptScrubber, TextPartSchema, TokenLimiterProcessor, ToolCallFilter, ToolInvocationPartSchema, ToolSearchProcessor, TripWire, UnicodeNormalizer, WORKING_MEMORY_END_TAG, WORKING_MEMORY_START_TAG, Workflow, WorkflowRunOutput, WorkingMemory, WorkspaceInstructionsProcessor, augmentWithInit, cleanStepResult, cloneStep, cloneWorkflow, convertFullStreamChunkToMastra, convertFullStreamChunkToUIMessageStream, convertMastraChunkToAISDKv5, createDeprecationProxy, createScorer, createStep, createTimeTravelExecutionParams, createWorkflow, extractWorkingMemoryContent, extractWorkingMemoryTags, filterSystemReminderMessages, formatCheckFeedback, formatCompletionFeedback, formatStreamCompletionFeedback, formatValidationFeedback, forwardAgentStreamChunk, generateFinalResult, generateStructuredFinalResult, getResumeLabelsByStepId, getStepIds, getStepResult, getThreadOMMetadata, globalEmbeddingCache, hydrateSerializedStepErrors, isObservationalMemoryEnabled, isProcessor, isProcessorWorkflow, isSupportedLanguageModel, isSystemReminderMessage, loop, mapVariable, memoryDefaultOptions, parseMemoryRequestContext, removeSystemReminderTags, removeWorkingMemoryTags, resolveThreadIdFromArgs, runChecks, runCompletionScorers, runCountDeprecationMessage, runDefaultCompletionCheck, runStreamCompletionScorers, runValidation, setThreadOMMetadata, supportedLanguageModelSpecifications, tryGenerateWithJsonFallback, tryStreamWithJsonFallback, validateStepInput, validateStepRequestContext, validateStepResumeData, validateStepStateData, validateStepSuspendData };
-//# sourceMappingURL=chunk-AGEOFSDZ.js.map
-//# sourceMappingURL=chunk-AGEOFSDZ.js.map
+//# sourceMappingURL=chunk-2KZU2SCO.js.map
+//# sourceMappingURL=chunk-2KZU2SCO.js.map