@mastra/memory 1.28.0-alpha.3 → 1.28.0

package/dist/{src-D8byb8Ge.cjs → src-C7Ozl6Pf.cjs}

@@ -57,8 +57,8 @@ probe_image_size_sync_js = __toESM$1(probe_image_size_sync_js, 1);
 let _mastra_core_schema = require("@mastra/core/schema");
 let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_processors = require("@mastra/core/processors");
-let util = require("util");
 let diff = require("diff");
+let util = require("util");
 //#region ../_vendored/ai_v4/dist/dist-Cm5DZgxA.js
 var marker$6 = "vercel.ai.error";
 var symbol$6 = Symbol.for(marker$6);
@@ -22436,6 +22436,151 @@ function createWorkingMemoryTool(config, options = {}) {
 	};
 }
 //#endregion
+//#region src/processors/working-memory-state/processor.ts
+/**
+* WorkingMemoryStateProcessor
+*
+* Experimental: delivers working memory to the model as a state signal instead
+* of folding it into the system message. Storage and the `setWorkingMemory`
+* tool are unchanged — this processor only changes the delivery path.
+*
+* Pattern matches `BrowserContextProcessor` in `@mastra/core/browser`:
+* - `stateId` namespaces the state lane on the thread.
+* - `cacheKey` is derived from the rendered payload so dedup is automatic.
+* - `contextWindow.hasSnapshot` re-injection ensures the model still sees the
+*   current snapshot after older messages drop out of the window.
+*
+* Delta emission (markdown mode only): when a prior snapshot exists in the
+* context window, the processor emits a unified-diff delta against that
+* snapshot's contents. Schema mode and the snapshot fallback always emit a
+* full snapshot.
+*
+* @example
+* ```ts
+* new Memory({
+*   options: {
+*     workingMemory: {
+*       enabled: true,
+*       template: '...',
+*       useStateSignals: true, // auto-attaches this processor
+*     },
+*   },
+* });
+* ```
+*/
+const WORKING_MEMORY_STATE_ID = "working-memory";
+const WORKING_MEMORY_STATE_PROCESSOR_ID = "working-memory-state";
+var WorkingMemoryStateProcessor = class {
+	memory;
+	memoryConfig;
+	id = WORKING_MEMORY_STATE_PROCESSOR_ID;
+	stateId = WORKING_MEMORY_STATE_ID;
+	constructor(memory, memoryConfig) {
+		this.memory = memory;
+		this.memoryConfig = memoryConfig;
+	}
+	async computeStateSignal(args) {
+		const template = await this.memory.getWorkingMemoryTemplate({ memoryConfig: this.memoryConfig });
+		if (!template) return;
+		const contents = (await this.memory.getWorkingMemory({
+			threadId: args.threadId,
+			resourceId: args.resourceId,
+			memoryConfig: this.memoryConfig
+		}))?.trim();
+		if (!contents) return;
+		const cacheKey = stableWorkingMemoryCacheKey({
+			format: template.format,
+			data: contents
+		});
+		const shouldMakeSnapshot = !args.contextWindow.hasSnapshot;
+		if (args.tracking?.currentCacheKey === cacheKey && !shouldMakeSnapshot) return;
+		const scope = this.memory.getMergedThreadConfig(this.memoryConfig).workingMemory?.scope ?? "resource";
+		const deltaCandidate = template.format === "markdown" && !shouldMakeSnapshot ? buildMarkdownDelta({
+			lastSnapshot: args.lastSnapshot,
+			deltasSinceSnapshot: args.deltasSinceSnapshot,
+			nextContents: contents
+		}) : void 0;
+		if (deltaCandidate) return {
+			id: WORKING_MEMORY_STATE_ID,
+			mode: "delta",
+			cacheKey,
+			tagName: "working-memory",
+			contents: deltaCandidate.contents,
+			delta: deltaCandidate.contents,
+			value: contents,
+			attributes: {
+				format: template.format,
+				scope,
+				patch: "unified-diff"
+			}
+		};
+		return {
+			id: WORKING_MEMORY_STATE_ID,
+			mode: "snapshot",
+			cacheKey,
+			tagName: "working-memory",
+			contents,
+			value: contents,
+			attributes: {
+				format: template.format,
+				scope
+			}
+		};
+	}
+};
+/**
+* Stable cache key for the rendered working memory payload. Returns a SHA-256
+* digest so dedup metadata stays compact regardless of payload size (working
+* memory blobs can grow arbitrarily long).
+*/
+function stableWorkingMemoryCacheKey(input) {
+	const hash = (0, crypto$1.createHash)("sha256");
+	hash.update(input.format);
+	hash.update("\0");
+	hash.update(input.data ?? "");
+	return `sha256:${hash.digest("hex")}`;
+}
+/**
+* Build a unified-diff delta against the most recently emitted state. Prefers
+* the latest delta's `value` (the post-edit full text) when available, falling
+* back to the snapshot's `value` and finally the snapshot's `contents`. This
+* keeps deltas incremental (B→C) instead of cumulative against a stale
+* snapshot (A→C), which matters when many small edits land between snapshots.
+*
+* Returns undefined when:
+* - there's no prior state to diff against
+* - the prior state isn't a plain string (multimodal signal)
+*
+* In either case the caller falls back to emitting a full snapshot.
+*/
+function buildMarkdownDelta(args) {
+	const { lastSnapshot, deltasSinceSnapshot, nextContents } = args;
+	const prior = pickStringValue(readSignalValue(deltasSinceSnapshot.at(-1))) ?? pickStringValue(readSignalValue(lastSnapshot)) ?? (typeof lastSnapshot?.contents === "string" ? lastSnapshot.contents : void 0);
+	if (!prior) return;
+	return { contents: renderHunksOnly(prior, nextContents) };
+}
+function pickStringValue(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function readSignalValue(signal) {
+	return (signal?.metadata)?.value;
+}
+/**
+* Render a unified-diff-style patch body containing only `@@` hunks and their
+* lines — dropping the filename preamble (`Index:` / `===` / `---` / `+++`)
+* that `createPatch` emits and the `` trailer.
+* The preamble exists for tooling like `patch -p1` to know which file to
+* apply to; we only ever diff a single working-memory blob. The newline
+* trailer is semantically meaningless to the model and adds noise to the
+* state signal.
+*/
+function renderHunksOnly(prior, next) {
+	const { hunks } = (0, diff.structuredPatch)("", "", prior, next, "", "", { context: 0 });
+	return hunks.map((hunk) => {
+		return [`@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`, ...hunk.lines.filter((line) => !line.startsWith("\"))].join("\n");
+	}).join("\n");
+}
+//#endregion
 //#region src/processors/observational-memory/activation-ttl.ts
 const MINUTE = 6e4;
 const HOUR = 60 * MINUTE;
@@ -26454,10 +26599,24 @@ function getLatestStepParts(parts) {
 	return parts;
 }
 /**
-* Returns true when a message contains at least one part with visible user/assistant
-* content (text, tool-invocation, reasoning, image, file).  Messages that only carry
-* internal `data-*` parts (buffering markers, observation markers, etc.) return false.
+* Returns true for persisted Working Memory state signals (`role: 'signal'`,
+* `signal.type: 'state'`, `state.id: 'working-memory'`). OM must not observe these:
+* they mirror memory OM itself manages, and re-observing them creates a self-feedback
+* loop that can overwrite stored working memory (#21961). Only the working-memory lane
+* is filtered — other state lanes are outside OM's write path, so re-observing them
+* cannot corrupt OM-managed state; excluding them broadly is a separate decision.
 */
+function isWorkingMemoryStateSignal(message) {
+	if (message.role !== "signal") return false;
+	const signal = message.content.metadata?.signal;
+	if (!signal || typeof signal !== "object" || Array.isArray(signal)) return false;
+	const signalRecord = signal;
+	if ((signalRecord.type ?? message.type) !== "state") return false;
+	const metadata = signalRecord.metadata;
+	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return false;
+	const state = metadata.state;
+	return !!state && typeof state === "object" && !Array.isArray(state) && state.id === "working-memory";
+}
 function messageHasVisibleContent(msg) {
 	const content = msg.content;
 	if (content?.parts && Array.isArray(content.parts)) return content.parts.some((p) => {
@@ -27228,7 +27387,7 @@ var ObservationalMemory = class ObservationalMemory {
 		}
 		const result = [];
 		for (const msg of allMessages) {
-			if (msg.role === "system") continue;
+			if (msg.role === "system" || isWorkingMemoryStateSignal(msg)) continue;
 			if (observedMessageIds?.has(msg.id)) continue;
 			const endMarkerIndex = findLastCompletedObservationBoundary(msg);
 			if (this.hasInProgressObservation(msg)) result.push(msg);
@@ -27450,7 +27609,7 @@ var ObservationalMemory = class ObservationalMemory {
 			},
 			filter: startDate ? { dateRange: { start: startDate } } : void 0
 		});
-		return result.messages.filter((msg) => msg.role !== "system");
+		return result.messages.filter((msg) => msg.role !== "system" && !isWorkingMemoryStateSignal(msg));
 	}
 	/**
 	* Format unobserved messages from other threads as <unobserved-context> blocks.
@@ -27909,7 +28068,7 @@ ${formattedMessages}
 					direction: "ASC"
 				},
 				filter: startDate ? { dateRange: { start: startDate } } : void 0
-			})).messages.filter((m) => !this.observedMessageIds.has(m.id));
+			})).messages.filter((message) => !this.observedMessageIds.has(message.id) && !isWorkingMemoryStateSignal(message));
 			if (filtered.length > 0) messagesByThread.set(thread.id, filtered);
 		}
 		if (messagesByThread.size === 0) return void 0;
@@ -29335,151 +29494,6 @@ var observational_memory_exports = /* @__PURE__ */ __exportAll({
 	wrapInObservationGroup: () => wrapInObservationGroup
 });
 //#endregion
-//#region src/processors/working-memory-state/processor.ts
-/**
-* WorkingMemoryStateProcessor
-*
-* Experimental: delivers working memory to the model as a state signal instead
-* of folding it into the system message. Storage and the `setWorkingMemory`
-* tool are unchanged — this processor only changes the delivery path.
-*
-* Pattern matches `BrowserContextProcessor` in `@mastra/core/browser`:
-* - `stateId` namespaces the state lane on the thread.
-* - `cacheKey` is derived from the rendered payload so dedup is automatic.
-* - `contextWindow.hasSnapshot` re-injection ensures the model still sees the
-*   current snapshot after older messages drop out of the window.
-*
-* Delta emission (markdown mode only): when a prior snapshot exists in the
-* context window, the processor emits a unified-diff delta against that
-* snapshot's contents. Schema mode and the snapshot fallback always emit a
-* full snapshot.
-*
-* @example
-* ```ts
-* new Memory({
-*   options: {
-*     workingMemory: {
-*       enabled: true,
-*       template: '...',
-*       useStateSignals: true, // auto-attaches this processor
-*     },
-*   },
-* });
-* ```
-*/
-const WORKING_MEMORY_STATE_ID = "working-memory";
-const WORKING_MEMORY_STATE_PROCESSOR_ID = "working-memory-state";
-var WorkingMemoryStateProcessor = class {
-	memory;
-	memoryConfig;
-	id = WORKING_MEMORY_STATE_PROCESSOR_ID;
-	stateId = WORKING_MEMORY_STATE_ID;
-	constructor(memory, memoryConfig) {
-		this.memory = memory;
-		this.memoryConfig = memoryConfig;
-	}
-	async computeStateSignal(args) {
-		const template = await this.memory.getWorkingMemoryTemplate({ memoryConfig: this.memoryConfig });
-		if (!template) return;
-		const contents = (await this.memory.getWorkingMemory({
-			threadId: args.threadId,
-			resourceId: args.resourceId,
-			memoryConfig: this.memoryConfig
-		}))?.trim();
-		if (!contents) return;
-		const cacheKey = stableWorkingMemoryCacheKey({
-			format: template.format,
-			data: contents
-		});
-		const shouldMakeSnapshot = !args.contextWindow.hasSnapshot;
-		if (args.tracking?.currentCacheKey === cacheKey && !shouldMakeSnapshot) return;
-		const scope = this.memory.getMergedThreadConfig(this.memoryConfig).workingMemory?.scope ?? "resource";
-		const deltaCandidate = template.format === "markdown" && !shouldMakeSnapshot ? buildMarkdownDelta({
-			lastSnapshot: args.lastSnapshot,
-			deltasSinceSnapshot: args.deltasSinceSnapshot,
-			nextContents: contents
-		}) : void 0;
-		if (deltaCandidate) return {
-			id: WORKING_MEMORY_STATE_ID,
-			mode: "delta",
-			cacheKey,
-			tagName: "working-memory",
-			contents: deltaCandidate.contents,
-			delta: deltaCandidate.contents,
-			value: contents,
-			attributes: {
-				format: template.format,
-				scope,
-				patch: "unified-diff"
-			}
-		};
-		return {
-			id: WORKING_MEMORY_STATE_ID,
-			mode: "snapshot",
-			cacheKey,
-			tagName: "working-memory",
-			contents,
-			value: contents,
-			attributes: {
-				format: template.format,
-				scope
-			}
-		};
-	}
-};
-/**
-* Stable cache key for the rendered working memory payload. Returns a SHA-256
-* digest so dedup metadata stays compact regardless of payload size (working
-* memory blobs can grow arbitrarily long).
-*/
-function stableWorkingMemoryCacheKey(input) {
-	const hash = (0, crypto$1.createHash)("sha256");
-	hash.update(input.format);
-	hash.update("\0");
-	hash.update(input.data ?? "");
-	return `sha256:${hash.digest("hex")}`;
-}
-/**
-* Build a unified-diff delta against the most recently emitted state. Prefers
-* the latest delta's `value` (the post-edit full text) when available, falling
-* back to the snapshot's `value` and finally the snapshot's `contents`. This
-* keeps deltas incremental (B→C) instead of cumulative against a stale
-* snapshot (A→C), which matters when many small edits land between snapshots.
-*
-* Returns undefined when:
-* - there's no prior state to diff against
-* - the prior state isn't a plain string (multimodal signal)
-*
-* In either case the caller falls back to emitting a full snapshot.
-*/
-function buildMarkdownDelta(args) {
-	const { lastSnapshot, deltasSinceSnapshot, nextContents } = args;
-	const prior = pickStringValue(readSignalValue(deltasSinceSnapshot.at(-1))) ?? pickStringValue(readSignalValue(lastSnapshot)) ?? (typeof lastSnapshot?.contents === "string" ? lastSnapshot.contents : void 0);
-	if (!prior) return;
-	return { contents: renderHunksOnly(prior, nextContents) };
-}
-function pickStringValue(value) {
-	return typeof value === "string" ? value : void 0;
-}
-function readSignalValue(signal) {
-	return (signal?.metadata)?.value;
-}
-/**
-* Render a unified-diff-style patch body containing only `@@` hunks and their
-* lines — dropping the filename preamble (`Index:` / `===` / `---` / `+++`)
-* that `createPatch` emits and the `` trailer.
-* The preamble exists for tooling like `patch -p1` to know which file to
-* apply to; we only ever diff a single working-memory blob. The newline
-* trailer is semantically meaningless to the model and adds noise to the
-* state signal.
-*/
-function renderHunksOnly(prior, next) {
-	const { hunks } = (0, diff.structuredPatch)("", "", prior, next, "", "", { context: 0 });
-	return hunks.map((hunk) => {
-		return [`@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`, ...hunk.lines.filter((line) => !line.startsWith("\"))].join("\n");
-	}).join("\n");
-}
-//#endregion
 //#region src/processors/working-memory-state/index.ts
 var working_memory_state_exports = /* @__PURE__ */ __exportAll({
 	WORKING_MEMORY_STATE_ID: () => WORKING_MEMORY_STATE_ID,
@@ -31795,4 +31809,4 @@ Object.defineProperty(exports, "wrapInObservationGroup", {
 	}
 });
 
-//# sourceMappingURL=src-D8byb8Ge.cjs.map
+//# sourceMappingURL=src-C7Ozl6Pf.cjs.map