@mastra/memory 0.3.5-alpha.0 → 0.4.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,29 +1,29 @@
 
-> @mastra/memory@0.3.5-alpha.0 build /home/runner/work/mastra/mastra/packages/memory
+> @mastra/memory@0.4.0-alpha.1 build /home/runner/work/mastra/mastra/packages/memory
 > pnpm run check && tsup src/index.ts src/processors/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 
-> @mastra/memory@0.3.5-alpha.0 check /home/runner/work/mastra/mastra/packages/memory
+> @mastra/memory@0.4.0-alpha.1 check /home/runner/work/mastra/mastra/packages/memory
 > tsc --noEmit
 
 CLI Building entry: src/index.ts, src/processors/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 9856ms
+TSC ⚡️ Build success in 9760ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/memory/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/memory/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 11835ms
+DTS ⚡️ Build success in 11637ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs            18.85 KB
+CJS dist/index.cjs            19.00 KB
 CJS dist/processors/index.cjs 5.59 KB
-CJS ⚡️ Build success in 740ms
-ESM dist/index.js            18.68 KB
+CJS ⚡️ Build success in 995ms
+ESM dist/index.js            18.81 KB
 ESM dist/processors/index.js 5.38 KB
-ESM ⚡️ Build success in 740ms
+ESM ⚡️ Build success in 995ms

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @mastra/memory
 
+## 0.4.0-alpha.1
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+- 0dcb9f0: Memory breaking changes: storage, vector, and embedder are now required. Working memory text streaming has been removed, only tool calling is supported for working memory updates now. Default settings have changed (lastMessages: 40->10, semanticRecall: true->false, threads.generateTitle: true->false)
+
+### Patch Changes
+
+- Updated dependencies [b3a3d63]
+- Updated dependencies [344f453]
+- Updated dependencies [0a3ae6d]
+- Updated dependencies [95911be]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+  - @mastra/core@0.10.0-alpha.1
+
 ## 0.3.5-alpha.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -82,6 +82,8 @@ function reorderToolCallsAndResults(messages) {
 
 // src/index.ts
 var CHARS_PER_TOKEN = 4;
+var DEFAULT_MESSAGE_RANGE = { before: 2, after: 2 };
+var DEFAULT_TOP_K = 2;
 var Memory = class extends memory.MastraMemory {
   constructor(config = {}) {
     super({ name: "Memory", ...config });
@@ -97,6 +99,7 @@ var Memory = class extends memory.MastraMemory {
     this.threadConfig = mergedConfig;
   }
   async validateThreadIsOwnedByResource(threadId, resourceId) {
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) {
       throw new Error(`No thread found with id ${threadId}`);
@@ -121,8 +124,8 @@ var Memory = class extends memory.MastraMemory {
       threadConfig
     });
     const config = this.getMergedThreadConfig(threadConfig || {});
-    const defaultRange = core.memoryDefaultOptions.semanticRecall.messageRange;
-    const defaultTopK = core.memoryDefaultOptions.semanticRecall.topK;
+    const defaultRange = DEFAULT_MESSAGE_RANGE;
+    const defaultTopK = DEFAULT_TOP_K;
     const vectorConfig = typeof config?.semanticRecall === `boolean` ? {
       topK: defaultTopK,
       messageRange: defaultRange
@@ -153,6 +156,7 @@ var Memory = class extends memory.MastraMemory {
         })
       );
     }
+    await this.storage.init();
     const rawMessages = await this.storage.getMessages({
       threadId,
       selectBy: {
@@ -204,15 +208,18 @@ var Memory = class extends memory.MastraMemory {
     };
   }
   async getThreadById({ threadId }) {
+    await this.storage.init();
     return this.storage.getThreadById({ threadId });
   }
   async getThreadsByResourceId({ resourceId }) {
+    await this.storage.init();
     return this.storage.getThreadsByResourceId({ resourceId });
   }
   async saveThread({
     thread,
     memoryConfig
   }) {
+    await this.storage.init();
     const config = this.getMergedThreadConfig(memoryConfig || {});
     if (config.workingMemory?.enabled && !thread?.metadata?.workingMemory) {
       return this.storage.saveThread({
@@ -230,6 +237,7 @@ var Memory = class extends memory.MastraMemory {
     title,
     metadata
   }) {
+    await this.storage.init();
     return this.storage.updateThread({
       id,
       title,
@@ -237,6 +245,7 @@ var Memory = class extends memory.MastraMemory {
     });
   }
   async deleteThread(threadId) {
+    await this.storage.init();
     await this.storage.deleteThread({ threadId });
   }
   chunkText(text, tokenSize = 4096) {
@@ -293,6 +302,7 @@ var Memory = class extends memory.MastraMemory {
     messages,
     memoryConfig
   }) {
+    await this.storage.init();
     await this.saveWorkingMemory(messages);
     const updatedMessages = this.updateMessagesToHideWorkingMemory(messages);
     const config = this.getMergedThreadConfig(memoryConfig);
@@ -376,6 +386,7 @@ var Memory = class extends memory.MastraMemory {
   }
   async getWorkingMemory({ threadId }) {
     if (!this.threadConfig.workingMemory?.enabled) return null;
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return this.threadConfig?.workingMemory?.template || this.defaultWorkingMemoryTemplate;
     const memory = thread.metadata?.workingMemory || this.threadConfig.workingMemory.template || this.defaultWorkingMemoryTemplate;
@@ -395,6 +406,7 @@ var Memory = class extends memory.MastraMemory {
     if (!newMemory) {
       return;
     }
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return;
     await this.storage.updateThread({
@@ -418,10 +430,7 @@ var Memory = class extends memory.MastraMemory {
     if (!workingMemory) {
       return null;
     }
-    if (config.workingMemory.use === "tool-call") {
-      return this.getWorkingMemoryToolInstruction(workingMemory);
-    }
-    return this.getWorkingMemoryWithInstruction(workingMemory);
+    return this.getWorkingMemoryToolInstruction(workingMemory);
   }
   defaultWorkingMemoryTemplate = `
 # User Information
@@ -482,7 +491,7 @@ Notes:
   }
   getTools(config) {
     const mergedConfig = this.getMergedThreadConfig(config);
-    if (mergedConfig.workingMemory?.enabled && mergedConfig.workingMemory.use === "tool-call") {
+    if (mergedConfig.workingMemory?.enabled) {
       return {
         updateWorkingMemory: updateWorkingMemoryTool
       };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { memoryDefaultOptions, deepMerge } from '@mastra/core';
+import { deepMerge } from '@mastra/core';
 import { MastraMemory } from '@mastra/core/memory';
 import { embedMany } from 'ai';
 import xxhash from 'xxhash-wasm';
@@ -76,6 +76,8 @@ function reorderToolCallsAndResults(messages) {
 
 // src/index.ts
 var CHARS_PER_TOKEN = 4;
+var DEFAULT_MESSAGE_RANGE = { before: 2, after: 2 };
+var DEFAULT_TOP_K = 2;
 var Memory = class extends MastraMemory {
   constructor(config = {}) {
     super({ name: "Memory", ...config });
@@ -91,6 +93,7 @@ var Memory = class extends MastraMemory {
     this.threadConfig = mergedConfig;
   }
   async validateThreadIsOwnedByResource(threadId, resourceId) {
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) {
       throw new Error(`No thread found with id ${threadId}`);
@@ -115,8 +118,8 @@ var Memory = class extends MastraMemory {
       threadConfig
     });
     const config = this.getMergedThreadConfig(threadConfig || {});
-    const defaultRange = memoryDefaultOptions.semanticRecall.messageRange;
-    const defaultTopK = memoryDefaultOptions.semanticRecall.topK;
+    const defaultRange = DEFAULT_MESSAGE_RANGE;
+    const defaultTopK = DEFAULT_TOP_K;
     const vectorConfig = typeof config?.semanticRecall === `boolean` ? {
       topK: defaultTopK,
       messageRange: defaultRange
@@ -147,6 +150,7 @@ var Memory = class extends MastraMemory {
         })
       );
     }
+    await this.storage.init();
     const rawMessages = await this.storage.getMessages({
       threadId,
       selectBy: {
@@ -198,15 +202,18 @@ var Memory = class extends MastraMemory {
     };
   }
   async getThreadById({ threadId }) {
+    await this.storage.init();
     return this.storage.getThreadById({ threadId });
   }
   async getThreadsByResourceId({ resourceId }) {
+    await this.storage.init();
     return this.storage.getThreadsByResourceId({ resourceId });
   }
   async saveThread({
     thread,
     memoryConfig
   }) {
+    await this.storage.init();
     const config = this.getMergedThreadConfig(memoryConfig || {});
     if (config.workingMemory?.enabled && !thread?.metadata?.workingMemory) {
       return this.storage.saveThread({
@@ -224,6 +231,7 @@ var Memory = class extends MastraMemory {
     title,
     metadata
   }) {
+    await this.storage.init();
     return this.storage.updateThread({
       id,
       title,
@@ -231,6 +239,7 @@ var Memory = class extends MastraMemory {
     });
   }
   async deleteThread(threadId) {
+    await this.storage.init();
     await this.storage.deleteThread({ threadId });
   }
   chunkText(text, tokenSize = 4096) {
@@ -287,6 +296,7 @@ var Memory = class extends MastraMemory {
     messages,
     memoryConfig
   }) {
+    await this.storage.init();
     await this.saveWorkingMemory(messages);
     const updatedMessages = this.updateMessagesToHideWorkingMemory(messages);
     const config = this.getMergedThreadConfig(memoryConfig);
@@ -370,6 +380,7 @@ var Memory = class extends MastraMemory {
   }
   async getWorkingMemory({ threadId }) {
     if (!this.threadConfig.workingMemory?.enabled) return null;
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return this.threadConfig?.workingMemory?.template || this.defaultWorkingMemoryTemplate;
     const memory = thread.metadata?.workingMemory || this.threadConfig.workingMemory.template || this.defaultWorkingMemoryTemplate;
@@ -389,6 +400,7 @@ var Memory = class extends MastraMemory {
     if (!newMemory) {
       return;
     }
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return;
     await this.storage.updateThread({
@@ -412,10 +424,7 @@ var Memory = class extends MastraMemory {
     if (!workingMemory) {
       return null;
     }
-    if (config.workingMemory.use === "tool-call") {
-      return this.getWorkingMemoryToolInstruction(workingMemory);
-    }
-    return this.getWorkingMemoryWithInstruction(workingMemory);
+    return this.getWorkingMemoryToolInstruction(workingMemory);
   }
   defaultWorkingMemoryTemplate = `
 # User Information
@@ -476,7 +485,7 @@ Notes:
   }
   getTools(config) {
     const mergedConfig = this.getMergedThreadConfig(config);
-    if (mergedConfig.workingMemory?.enabled && mergedConfig.workingMemory.use === "tool-call") {
+    if (mergedConfig.workingMemory?.enabled) {
       return {
         updateWorkingMemory: updateWorkingMemoryTool
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/memory",
-  "version": "0.3.5-alpha.0",
+  "version": "0.4.0-alpha.1",
   "description": "",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,8 +40,7 @@
     "postgres": "^3.4.5",
     "redis": "^4.7.0",
     "xxhash-wasm": "^1.1.0",
-    "zod": "^3.24.3",
-    "@mastra/core": "^0.9.5-alpha.0"
+    "zod": "^3.24.3"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^1.3.3",
@@ -53,8 +52,12 @@
     "typescript": "^5.8.2",
     "typescript-eslint": "^8.26.1",
     "vitest": "^3.1.2",
+    "@mastra/core": "0.10.0-alpha.1",
     "@internal/lint": "0.0.5"
   },
+  "peerDependencies": {
+    "@mastra/core": "^0.9.4"
+  },
   "scripts": {
     "check": "tsc --noEmit",
     "build": "pnpm run check && tsup src/index.ts src/processors/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/index.ts

@@ -1,4 +1,4 @@
-import { deepMerge, memoryDefaultOptions } from '@mastra/core';
+import { deepMerge } from '@mastra/core';
 import type { AiMessageType, CoreMessage, CoreTool } from '@mastra/core';
 import { MastraMemory } from '@mastra/core/memory';
 import type { MessageType, MemoryConfig, SharedMemoryConfig, StorageThreadType } from '@mastra/core/memory';
@@ -13,6 +13,9 @@ import { reorderToolCallsAndResults } from './utils';
 // Average characters per token based on OpenAI's tokenization
 const CHARS_PER_TOKEN = 4;
 
+const DEFAULT_MESSAGE_RANGE = { before: 2, after: 2 } as const;
+const DEFAULT_TOP_K = 2;
+
 /**
  * Concrete implementation of MastraMemory that adds support for thread configuration
  * and message injection.
@@ -34,6 +37,7 @@ export class Memory extends MastraMemory {
   }
 
   private async validateThreadIsOwnedByResource(threadId: string, resourceId: string) {
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) {
       throw new Error(`No thread found with id ${threadId}`);
@@ -70,8 +74,8 @@ export class Memory extends MastraMemory {
 
     const config = this.getMergedThreadConfig(threadConfig || {});
 
-    const defaultRange = memoryDefaultOptions.semanticRecall.messageRange;
-    const defaultTopK = memoryDefaultOptions.semanticRecall.topK;
+    const defaultRange = DEFAULT_MESSAGE_RANGE;
+    const defaultTopK = DEFAULT_TOP_K;
 
     const vectorConfig =
       typeof config?.semanticRecall === `boolean`
@@ -110,6 +114,7 @@ export class Memory extends MastraMemory {
       );
     }
 
+    await this.storage.init();
     // Get raw messages from storage
     const rawMessages = await this.storage.getMessages({
       threadId,
@@ -190,10 +195,12 @@ export class Memory extends MastraMemory {
   }
 
   async getThreadById({ threadId }: { threadId: string }): Promise<StorageThreadType | null> {
+    await this.storage.init();
     return this.storage.getThreadById({ threadId });
   }
 
   async getThreadsByResourceId({ resourceId }: { resourceId: string }): Promise<StorageThreadType[]> {
+    await this.storage.init();
     return this.storage.getThreadsByResourceId({ resourceId });
   }
 
@@ -204,6 +211,7 @@ export class Memory extends MastraMemory {
     thread: StorageThreadType;
     memoryConfig?: MemoryConfig;
   }): Promise<StorageThreadType> {
+    await this.storage.init();
     const config = this.getMergedThreadConfig(memoryConfig || {});
 
     if (config.workingMemory?.enabled && !thread?.metadata?.workingMemory) {
@@ -229,6 +237,7 @@ export class Memory extends MastraMemory {
     title: string;
     metadata: Record<string, unknown>;
   }): Promise<StorageThreadType> {
+    await this.storage.init();
     return this.storage.updateThread({
       id,
       title,
@@ -237,6 +246,7 @@ export class Memory extends MastraMemory {
   }
 
   async deleteThread(threadId: string): Promise<void> {
+    await this.storage.init();
     await this.storage.deleteThread({ threadId });
   }
 
@@ -324,6 +334,7 @@ export class Memory extends MastraMemory {
     messages: MessageType[];
     memoryConfig?: MemoryConfig;
   }): Promise<MessageType[]> {
+    await this.storage.init();
     // First save working memory from any messages
     await this.saveWorkingMemory(messages);
 
@@ -441,6 +452,7 @@ export class Memory extends MastraMemory {
   public async getWorkingMemory({ threadId }: { threadId: string }): Promise<string | null> {
     if (!this.threadConfig.workingMemory?.enabled) return null;
 
+    await this.storage.init();
     // Get thread from storage
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return this.threadConfig?.workingMemory?.template || this.defaultWorkingMemoryTemplate;
@@ -480,6 +492,7 @@ export class Memory extends MastraMemory {
       return;
     }
 
+    await this.storage.init();
     const thread = await this.storage.getThreadById({ threadId });
     if (!thread) return;
 
@@ -511,11 +524,7 @@ export class Memory extends MastraMemory {
       return null;
     }
 
-    if (config.workingMemory.use === 'tool-call') {
-      return this.getWorkingMemoryToolInstruction(workingMemory);
-    }
-
-    return this.getWorkingMemoryWithInstruction(workingMemory);
+    return this.getWorkingMemoryToolInstruction(workingMemory);
   }
 
   public defaultWorkingMemoryTemplate = `
@@ -580,7 +589,7 @@ Notes:
 
   public getTools(config?: MemoryConfig): Record<string, CoreTool> {
     const mergedConfig = this.getMergedThreadConfig(config);
-    if (mergedConfig.workingMemory?.enabled && mergedConfig.workingMemory.use === 'tool-call') {
+    if (mergedConfig.workingMemory?.enabled) {
       return {
         updateWorkingMemory: updateWorkingMemoryTool,
       };