@mastra/memory 1.26.1-alpha.4 → 1.26.1-alpha.7

package/dist/docs/references/reference-migrations-upgrade-to-v1-memory.md

@@ -0,0 +1,288 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Memory
+
+Memory configuration now requires explicit parameters, and default settings have been updated for better performance and predictability.
+
+## Changed
+
+### Default settings for semantic recall and last messages
+
+Default settings have changed to more reasonable values based on usage patterns. The `lastMessages` default decreased from 40 to 10, `semanticRecall` is now disabled by default, and thread title generation is disabled by default. These changes improve performance and reduce unexpected LLM API calls.
+
+To migrate, if you were relying on the old defaults, explicitly configure these settings.
+
+```diff
+const memory = new Memory({
+    storage,
+    vector,
+    embedder,
++   options: {
++     lastMessages: 40, // Was default before
++     semanticRecall: {
++       topK: 2,
++       messageRange: 2,
++       scope: 'thread',
++     }, // Was enabled by default before
++     generateTitle: true, // Was enabled by default before
++   },
+  });
+```
+
+### Default memory scope from `thread` to `resource`
+
+The default scope for both working memory and semantic recall has changed from `'thread'` to `'resource'`. This change aligns with common use cases where applications want to remember user information across conversations. When semantic recall is enabled, it now defaults to searching across all user conversations rather than the current thread.
+
+To migrate, if you want to maintain the old behavior where memory is isolated per conversation thread, explicitly set `scope: 'thread'`.
+
+```diff
+const memory = new Memory({
+    storage,
+    vector,
+    embedder,
+    options: {
+      workingMemory: {
+        enabled: true,
++       scope: 'thread', // Explicitly set to thread-scoped
+        template: `# User Profile...`,
+      },
+      semanticRecall: {
+        topK: 3,
++       scope: 'thread', // Explicitly set to thread-scoped
+      },
+    },
+  });
+```
+
+### Thread title generation location
+
+The `generateTitle` option has been moved from `threads.generateTitle` to the top-level of memory options. This change simplifies the API by moving the option to where it logically belongs.
+
+To migrate, move `generateTitle` from the `threads` config to the top level of options.
+
+```diff
+const memory = new Memory({
+    storage,
+    vector,
+    embedder,
+    options: {
+-     threads: {
+-       generateTitle: true,
+-     },
++     generateTitle: true,
+    },
+  });
+```
+
+### Semantic recall default settings optimization
+
+The default settings for semantic recall have been optimized based on RAG research. The `topK` increased from 2 to 4, and `messageRange` changed from `{ before: 2, after: 2 }` to `{ before: 1, after: 1 }`. These changes provide better accuracy while only slightly increasing message count.
+
+To migrate, if you were relying on the previous defaults, explicitly set these values.
+
+```diff
+const memory = new Memory({
+    storage,
+    vector,
+    embedder,
+    options: {
+      semanticRecall: {
++       topK: 2, // Was default before
++       messageRange: { before: 2, after: 2 }, // Was default before
+      },
+    },
+  });
+```
+
+### `memory.readOnly` moved to `memory.options.readOnly`
+
+The `readOnly` property has been moved from the top-level of the memory option to inside `options`. This change aligns `readOnly` with other memory configuration options like `lastMessages` and `semanticRecall`.
+
+To migrate, move `readOnly` from the top level to inside `options`.
+
+```diff
+agent.stream('Hello', {
+    memory: {
+      thread: threadId,
+      resource: resourceId,
+-     readOnly: true,
++     options: {
++       readOnly: true,
++     },
+    },
+  });
+```
+
+> **Codemod:** You can use Mastra's codemod CLI to update your code automatically:
+>
+> ```bash
+> npx @mastra/codemod@latest v1/memory-readonly-to-options .
+> ```
+
+### `Memory.query()` renamed to `Memory.recall()`
+
+The `Memory.query()` method has been renamed to `Memory.recall()`. The new method returns a simpler format with `{ messages: MastraDBMessage[] }` instead of multiple format variations. This change better describes the action of retrieving messages from memory and simplifies the API.
+
+To migrate, rename `query()` to `recall()` and update code that expects the old return format.
+
+```diff
+- const result = await memory.query({ threadId: 'thread-123' });
++ const result = await memory.recall({ threadId: 'thread-123' });
+- // result: { messages: CoreMessage[], uiMessages: UIMessageWithMetadata[], messagesV2: MastraMessageV2[] }
++ // result: { messages: MastraDBMessage[] }
++ const messages = result.messages;
+```
+
+> **Codemod:** You can use Mastra's codemod CLI to update your code automatically:
+>
+> ```bash
+> npx @mastra/codemod@latest v1/memory-query-to-recall .
+> ```
+
+### `Memory.recall()` parameter changes
+
+The `Memory.recall()` method now uses `StorageListMessagesInput` format with pagination, and the `vectorMessageSearch` parameter has been renamed to `vectorSearchString`. These changes align the memory API with the storage pagination API and provide more consistent naming.
+
+To migrate, update method name, query parameters, and the vector search parameter.
+
+```diff
+- memory.query({
++ memory.recall({
+    threadId: 'thread-123',
+-   vectorMessageSearch: 'What did we discuss?',
+-   selectBy: { ... },
++   vectorSearchString: 'What did we discuss?',
++   page: 0,
++   perPage: 20,
++   orderBy: 'createdAt',
++   filter: { ... },
++   threadConfig: { semanticRecall: true },
+  });
+```
+
+> **Codemod:** You can use Mastra's codemod CLI to update your code automatically:
+>
+> ```bash
+> npx @mastra/codemod@latest v1/memory-vector-search-param .
+> ```
+
+### `MastraMessageV2` type renamed to `MastraDBMessage`
+
+The `MastraMessageV2` type has been renamed to `MastraDBMessage` for clarity. This change better describes the purpose of this type as the database message format.
+
+To migrate, replace all instances of `MastraMessageV2` with `MastraDBMessage`.
+
+```diff
+- import { MastraMessageV2 } from '@mastra/core';
+- function yourCustomFunction(input: MastraMessageV2) {}
++ import { MastraDBMessage } from '@mastra/core';
++ function yourCustomFunction(input: MastraDBMessage) {}
+```
+
+> **Codemod:** You can use Mastra's codemod CLI to update your code automatically:
+>
+> ```bash
+> npx @mastra/codemod@latest v1/memory-message-v2-type .
+> ```
+
+## Removed
+
+### Working memory `text-stream` mode
+
+Working memory `use: "text-stream"` option has been removed. Only `tool-call` mode is supported. This change simplifies the working memory API by removing the less reliable streaming mode.
+
+To migrate, remove the `use: "text-stream"` option. Working memory will default to tool-call mode.
+
+```diff
+const memory = new Memory({
+    storage,
+    vector,
+    embedder,
+    options: {
+      workingMemory: {
+        enabled: true,
+-       use: 'text-stream',
+        template: '...',
+      },
+    },
+  });
+```
+
+### `Memory.rememberMessages()` method
+
+The `Memory.rememberMessages()` method has been removed. This method performed the same function as `query()` (now `recall()`), and consolidating to one method simplifies the API.
+
+To migrate, replace `rememberMessages()` calls with `recall()`.
+
+```diff
+- const { messages } = await memory.rememberMessages({
++ const { messages } = await memory.recall({
+    threadId,
+    resourceId,
+  });
+```
+
+### `format` parameter from memory methods
+
+The `format` parameter has been removed from all memory get methods. `MastraDBMessage` is now the default return format everywhere. AI SDK format conversion has moved to dedicated utility functions in `@mastra/ai-sdk/ui`. This change improves tree-shaking by moving UI-specific conversion code to a separate package.
+
+To migrate, remove the `format` parameter and use conversion functions for AI SDK formats.
+
+```diff
+- const messages = await memory.getMessages({ threadId, format: 'v2' });
+- const uiMessages = await memory.getMessages({ threadId, format: 'ui' });
+
++ const result = await memory.recall({ threadId });
++ const messages = result.messages; // Always MastraDBMessage[]
++
++ // Use conversion functions for AI SDK formats
++ import { toAISdkV5Messages } from '@mastra/ai-sdk/ui';
++ const uiMessages = toAISdkV5Messages(messages);
+```
+
+### `MastraMessageV3` type
+
+The `MastraMessageV3` type and related conversion methods have been removed. Messages now convert directly between `MastraMessageV2` (now `MastraDBMessage`) and AI SDK v5 formats. This change simplifies the architecture by removing an intermediary format.
+
+To migrate, use `MastraDBMessage` for storage or AI SDK v5 message formats directly.
+
+```diff
+- import type { MastraMessageV3 } from '@mastra/core/agent';
+- const v3Messages = messageList.get.all.v3();
+
++ // For storage
++ const v2Messages = messageList.get.all.v2();
++
++ // For AI SDK v5
++ const uiMessages = messageList.get.all.aiV5.ui();
++ const modelMessages = messageList.get.all.aiV5.model();
+```
+
+### `processors` config from Memory constructor
+
+The `processors` config option in the Memory constructor is no longer supported and throws an error. Configure processors at the Agent level, where processor behavior is scoped to agent execution.
+
+To migrate, move processor configuration from Memory to Agent using `inputProcessors` and/or `outputProcessors`.
+
+```diff
++ import { TokenLimiter } from '@mastra/core/processors';
++
+  const memory = new Memory({
+    storage,
+    vector,
+    embedder,
+-   processors: [/* ... */],
+  });
+
+  const agent = new Agent({
+    id: 'agent',
+    memory,
++   inputProcessors: [
++     new TokenLimiter({ limit: 4000 }), // Limits historical messages to fit context window
++   ],
+  });
+```
+
+Additionally, the `@mastra/memory/processors` import path has been removed. Import processors from `@mastra/core/processors` instead. See the [processors migration guide](https://mastra.ai/reference/migrations/upgrade-to-v1/processors) for details.
+
+For more information on using processors with agents, see the [Processors docs](https://mastra.ai/docs/agents/processors). For a complete example with memory, see the [TokenLimiter reference](https://mastra.ai/reference/processors/token-limiter-processor).

package/dist/docs/references/reference-vectors-oracledb.md

@@ -342,6 +342,6 @@ export const oracleAgent = new Agent({
 
 ## Related
 
-- [OracleDB storage](https://mastra.ai/reference/storage/oracledb)
+- [OracleDB storage](https://mastra.ai/integrations/databases/oracledb)
 - [Metadata Filters](https://mastra.ai/reference/rag/metadata-filters)
-- [Vector databases](https://mastra.ai/guides/rag/vector-databases)
+- [Vector databases](https://mastra.ai/reference/rag/vector-databases)

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-kjoZv97r.cjs");
+const require_src = require("./src-CTwoCwmY.cjs");
 let _mastra_core_processors = require("@mastra/core/processors");
 exports.Extractor = require_src.Extractor;
 exports.Memory = require_src.Memory;

package/dist/index.js

@@ -1,2 +1,2 @@
-import { C as WorkingMemoryExtractor, R as Extractor, S as deepMergeWorkingMemory, T as summarizeConversation, a as extractWorkingMemoryContent, c as WORKING_MEMORY_STATE_ID, d as getObservationsAsOf, i as WorkingMemory, l as WORKING_MEMORY_STATE_PROCESSOR_ID, n as MessageHistory, o as extractWorkingMemoryTags, r as SemanticRecall, s as removeWorkingMemoryTags, t as Memory, u as WorkingMemoryStateProcessor, w as SUMMARIZE_THREAD_DEFAULTS, x as ModelByInputTokens } from "./src-hv0DMVM-.js";
+import { C as WorkingMemoryExtractor, R as Extractor, S as deepMergeWorkingMemory, T as summarizeConversation, a as extractWorkingMemoryContent, c as WORKING_MEMORY_STATE_ID, d as getObservationsAsOf, i as WorkingMemory, l as WORKING_MEMORY_STATE_PROCESSOR_ID, n as MessageHistory, o as extractWorkingMemoryTags, r as SemanticRecall, s as removeWorkingMemoryTags, t as Memory, u as WorkingMemoryStateProcessor, w as SUMMARIZE_THREAD_DEFAULTS, x as ModelByInputTokens } from "./src-DGdlH4fo.js";
 export { Extractor, Memory, MessageHistory, ModelByInputTokens, SUMMARIZE_THREAD_DEFAULTS, SemanticRecall, WORKING_MEMORY_STATE_ID, WORKING_MEMORY_STATE_PROCESSOR_ID, WorkingMemory, WorkingMemoryExtractor, WorkingMemoryStateProcessor, deepMergeWorkingMemory, extractWorkingMemoryContent, extractWorkingMemoryTags, getObservationsAsOf, removeWorkingMemoryTags, summarizeConversation };

package/dist/processors/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("../src-kjoZv97r.cjs");
+const require_src = require("../src-CTwoCwmY.cjs");
 exports.Extractor = require_src.Extractor;
 exports.ModelByInputTokens = require_src.ModelByInputTokens;
 exports.OBSERVATIONAL_MEMORY_DEFAULTS = require_src.OBSERVATIONAL_MEMORY_DEFAULTS;

package/dist/processors/index.js

@@ -1,2 +1,2 @@
-import { A as extractCurrentTask, B as OBSERVATION_CONTEXT_INSTRUCTIONS, C as WorkingMemoryExtractor, D as OBSERVER_SYSTEM_PROMPT, E as TokenCounter, F as injectAnchorIds, H as OBSERVATION_CONTINUATION_HINT, I as parseAnchorId, L as stripEphemeralAnchorIds, M as hasCurrentTaskSection, N as optimizeObservationsForContext, O as buildObserverPrompt, P as parseObserverOutput, R as Extractor, T as summarizeConversation, V as OBSERVATION_CONTEXT_PROMPT, _ as reconcileObservationGroupsFromReflection, b as wrapInObservationGroup, d as getObservationsAsOf, f as ObservationalMemoryProcessor, g as parseObservationGroups, h as deriveObservationGroupProvenance, j as formatMessagesForObserver, k as buildObserverSystemPrompt, m as combineObservationGroupRanges, p as ObservationalMemory, v as renderObservationGroupsForReflection, x as ModelByInputTokens, y as stripObservationGroups, z as OBSERVATIONAL_MEMORY_DEFAULTS } from "../src-hv0DMVM-.js";
+import { A as extractCurrentTask, B as OBSERVATION_CONTEXT_INSTRUCTIONS, C as WorkingMemoryExtractor, D as OBSERVER_SYSTEM_PROMPT, E as TokenCounter, F as injectAnchorIds, H as OBSERVATION_CONTINUATION_HINT, I as parseAnchorId, L as stripEphemeralAnchorIds, M as hasCurrentTaskSection, N as optimizeObservationsForContext, O as buildObserverPrompt, P as parseObserverOutput, R as Extractor, T as summarizeConversation, V as OBSERVATION_CONTEXT_PROMPT, _ as reconcileObservationGroupsFromReflection, b as wrapInObservationGroup, d as getObservationsAsOf, f as ObservationalMemoryProcessor, g as parseObservationGroups, h as deriveObservationGroupProvenance, j as formatMessagesForObserver, k as buildObserverSystemPrompt, m as combineObservationGroupRanges, p as ObservationalMemory, v as renderObservationGroupsForReflection, x as ModelByInputTokens, y as stripObservationGroups, z as OBSERVATIONAL_MEMORY_DEFAULTS } from "../src-DGdlH4fo.js";
 export { Extractor, ModelByInputTokens, OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, ObservationalMemoryProcessor, TokenCounter, WorkingMemoryExtractor, buildObserverPrompt, buildObserverSystemPrompt, combineObservationGroupRanges, deriveObservationGroupProvenance, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, injectAnchorIds, optimizeObservationsForContext, parseAnchorId, parseObservationGroups, parseObserverOutput, reconcileObservationGroupsFromReflection, renderObservationGroupsForReflection, stripEphemeralAnchorIds, stripObservationGroups, summarizeConversation, wrapInObservationGroup };

package/dist/processors/observational-memory/measure-image-buffer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Synchronous image dimension lookup for in-memory image buffers.
+ *
+ * Uses `probe-image-size`'s sync parsers rather than `image-size`, which has unfixed
+ * denial-of-service advisories (GHSA-w3rx-r6r6-pgpr / CVE-2025-71330 and
+ * GHSA-5p2g-fcmc-qvqq) affecting every published version, on an archived repository
+ * with no fixed release coming. A malformed 32-byte ICNS buffer was enough to hang the
+ * parse loop and exhaust the heap, and image bytes reaching agent memory are untrusted.
+ *
+ * `probe-image-size` covers the formats models actually accept (PNG, JPEG, WebP, GIF,
+ * AVIF, BMP, ICO, PSD, SVG, TIFF). Anything else returns `undefined`, which callers
+ * already handle as "dimensions unknown".
+ */
+/**
+ * Read the pixel dimensions of an image buffer.
+ *
+ * @returns The dimensions, or `undefined` if the buffer isn't a recognized image.
+ */
+export declare function measureImageBuffer(buffer: Uint8Array): {
+    width: number;
+    height: number;
+} | undefined;
+//# sourceMappingURL=measure-image-buffer.d.ts.map

package/dist/processors/observational-memory/measure-image-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-image-buffer.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/measure-image-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmBpG"}

package/dist/processors/observational-memory/observation-strategies/async-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-buffer.d.ts","sourceRoot":"","sources":["../../../../src/processors/observational-memory/observation-strategies/async-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAc1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExF,qBAAa,8BAA+B,SAAQ,mBAAmB;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAC,CAA0B;gBAE3C,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB;IAMxD,IAAI,SAAS,YAEZ;IACD,IAAI,eAAe,YAElB;IACD,IAAI,gBAAgB,YAEnB;cAEkB,eAAe,IAAI,MAAM;IAItC,OAAO;;;;IAQP,gBAAgB,CAAC,QAAQ,EAAE,MAAM;IAIjC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE;;;;;;;;;uBAqJrD,CAAC;wBAAsB,CAAC;uBAAqB,CAAC;;;;IApH1D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6C7F,OAAO,CAAC,SAAS,EAAE,oBAAoB;IAkEvC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB;IA6BhE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAkBzD"}
+{"version":3,"file":"async-buffer.d.ts","sourceRoot":"","sources":["../../../../src/processors/observational-memory/observation-strategies/async-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAc1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExF,qBAAa,8BAA+B,SAAQ,mBAAmB;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAC,CAA0B;gBAE3C,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB;IAMxD,IAAI,SAAS,YAEZ;IACD,IAAI,eAAe,YAElB;IACD,IAAI,gBAAgB,YAEnB;cAEkB,eAAe,IAAI,MAAM;IAItC,OAAO;;;;IAQP,gBAAgB,CAAC,QAAQ,EAAE,MAAM;IAIjC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE;;;;;;;;;uBAqJpD,CAAC;wBAAsB,CAAC;uBAAqB,CAAC;;;;IApH3D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6C7F,OAAO,CAAC,SAAS,EAAE,oBAAoB;IAkEvC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB;IA6BhE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAkBzD"}

package/dist/{src-kjoZv97r.cjs → src-CTwoCwmY.cjs}

@@ -51,8 +51,8 @@ let tokenx = require("tokenx");
 let crypto$1 = require("crypto");
 let _mastra_core_storage = require("@mastra/core/storage");
 let async_hooks = require("async_hooks");
-let image_size = require("image-size");
-image_size = __toESM$1(image_size, 1);
+let probe_image_size_sync_js = require("probe-image-size/sync.js");
+probe_image_size_sync_js = __toESM$1(probe_image_size_sync_js, 1);
 let _mastra_core_tools = require("@mastra/core/tools");
 let _mastra_core_schema = require("@mastra/core/schema");
 let _mastra_core_error = require("@mastra/core/error");
@@ -17366,6 +17366,42 @@ var ObserverRunner = class {
 	}
 };
 //#endregion
+//#region src/processors/observational-memory/measure-image-buffer.ts
+/**
+* Synchronous image dimension lookup for in-memory image buffers.
+*
+* Uses `probe-image-size`'s sync parsers rather than `image-size`, which has unfixed
+* denial-of-service advisories (GHSA-w3rx-r6r6-pgpr / CVE-2025-71330 and
+* GHSA-5p2g-fcmc-qvqq) affecting every published version, on an archived repository
+* with no fixed release coming. A malformed 32-byte ICNS buffer was enough to hang the
+* parse loop and exhaust the heap, and image bytes reaching agent memory are untrusted.
+*
+* `probe-image-size` covers the formats models actually accept (PNG, JPEG, WebP, GIF,
+* AVIF, BMP, ICO, PSD, SVG, TIFF). Anything else returns `undefined`, which callers
+* already handle as "dimensions unknown".
+*/
+const probeBuffer = probe_image_size_sync_js.default;
+/**
+* Read the pixel dimensions of an image buffer.
+*
+* @returns The dimensions, or `undefined` if the buffer isn't a recognized image.
+*/
+function measureImageBuffer(buffer) {
+	let probed;
+	try {
+		probed = probeBuffer(buffer);
+	} catch {
+		return;
+	}
+	if (!probed) return;
+	const { width, height } = probed;
+	if (typeof width !== "number" || !Number.isFinite(width) || typeof height !== "number" || !Number.isFinite(height)) return;
+	return {
+		width,
+		height
+	};
+}
+//#endregion
 //#region src/processors/observational-memory/token-counter.ts
 const IMAGE_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
 	"png",
@@ -17672,26 +17708,23 @@ function resolveImageDimensions(part) {
 		width,
 		height
 	};
-	try {
-		const measured = (0, image_size.default)(buffer);
-		const measuredWidth = getFiniteNumber(measured.width);
-		const measuredHeight = getFiniteNumber(measured.height);
-		if (!measuredWidth || !measuredHeight) return {
-			width,
-			height
-		};
-		const resolved = {
-			width: width ?? measuredWidth,
-			height: height ?? measuredHeight
-		};
-		persistImageDimensions(part, resolved);
-		return resolved;
-	} catch {
-		return {
-			width,
-			height
-		};
-	}
+	const measured = measureImageBuffer(buffer);
+	if (!measured) return {
+		width,
+		height
+	};
+	const measuredWidth = getFiniteNumber(measured.width);
+	const measuredHeight = getFiniteNumber(measured.height);
+	if (!measuredWidth || !measuredHeight) return {
+		width,
+		height
+	};
+	const resolved = {
+		width: width ?? measuredWidth,
+		height: height ?? measuredHeight
+	};
+	persistImageDimensions(part, resolved);
+	return resolved;
 }
 function getBase64Size(base64) {
 	const sanitized = base64.replace(/\s+/g, "");
@@ -21400,7 +21433,7 @@ var SyncObservationStrategy = class extends ObservationStrategy {
 				},
 				lastObservedMessageCursor: getLastObservedMessageCursor(messages)
 			});
-			await this.storage.updateThread({
+			await this.storage.patchThread({
 				id: threadId,
 				...shouldUpdateThreadTitle ? { title: newTitle } : {},
 				metadata: newMetadata
@@ -21592,7 +21625,7 @@ var AsyncBufferObservationStrategy = class extends ObservationStrategy {
 						...metadataUpdate.extracted ?? {}
 					}
 				});
-				await this.storage.updateThread({
+				await this.storage.patchThread({
 					id: threadId,
 					...shouldUpdateThreadTitle ? { title: newTitle } : {},
 					metadata: newMetadata
@@ -21937,7 +21970,7 @@ var ResourceScopedObservationStrategy = class extends ObservationStrategy {
 					},
 					lastObservedMessageCursor: update.lastObservedMessageCursor
 				});
-				await this.storage.updateThread({
+				await this.storage.patchThread({
 					id: update.threadId,
 					...shouldUpdateThreadTitle ? { title: newTitle } : {},
 					metadata: newMetadata
@@ -22880,7 +22913,7 @@ async function persistThreadExtractedValues(storage, extractors, threadId, value
 			...metadataUpdate.extracted ?? {}
 		}
 	});
-	await storage.updateThread({
+	await storage.patchThread({
 		id: threadId,
 		metadata: newMetadata
 	});
@@ -25851,7 +25884,7 @@ ${formattedMessages}
 				const oldTitle = thread.title?.trim();
 				const newTitle = chunkThreadTitle?.trim();
 				const shouldUpdateThreadTitle = !!newTitle && newTitle.length >= 3 && newTitle !== oldTitle;
-				await this.storage.updateThread({
+				await this.storage.patchThread({
 					id: threadId,
 					...shouldUpdateThreadTitle ? { title: newTitle } : {},
 					metadata: newMetadata
@@ -26069,7 +26102,7 @@ ${formattedMessages}
 						...metadataUpdate.extracted ?? {}
 					}
 				});
-				await this.storage.updateThread({
+				await this.storage.patchThread({
 					id: threadId,
 					metadata: newMetadata
 				});
@@ -27123,7 +27156,7 @@ var Memory = class extends _mastra_core_memory.MastraMemory {
 		return savedThread;
 	}
 	async updateThread({ id, title, metadata, memoryConfig }) {
-		const updatedThread = await (await this.getMemoryStore()).updateThread({
+		const updatedThread = await (await this.getMemoryStore()).patchThread({
 			id,
 			title,
 			metadata
@@ -27214,7 +27247,7 @@ var Memory = class extends _mastra_core_memory.MastraMemory {
 				else {
 					const thread = await this.getThreadById({ threadId });
 					if (!thread) throw new Error(`Thread ${threadId} not found`);
-					await memoryStore.updateThread({
+					await memoryStore.patchThread({
 						id: threadId,
 						metadata: {
 							...thread.metadata,
@@ -27302,7 +27335,7 @@ ${workingMemory}`;
 			} else {
 				const thread = await this.getThreadById({ threadId });
 				if (!thread) throw new Error(`Thread ${threadId} not found`);
-				await memoryStore.updateThread({
+				await memoryStore.patchThread({
 					id: threadId,
 					metadata: {
 						...thread.metadata,
@@ -28873,4 +28906,4 @@ Object.defineProperty(exports, "wrapInObservationGroup", {
 	}
 });
 
-//# sourceMappingURL=src-kjoZv97r.cjs.map
+//# sourceMappingURL=src-CTwoCwmY.cjs.map