@mastra/server 1.56.0-alpha.2 → 1.56.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 1.56.0-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`594f7b2`](https://github.com/mastra-ai/mastra/commit/594f7b28f5263fb9982fd50d95c471fb971ea984), [`311f943`](https://github.com/mastra-ai/mastra/commit/311f943bee60e8fdf5c84499ea50e884276c936c), [`0c89896`](https://github.com/mastra-ai/mastra/commit/0c8989673fb7d106837098398131e570c6023b68), [`23b4238`](https://github.com/mastra-ai/mastra/commit/23b423844ad0bcf2a502a68dd62866d6160f9f6d), [`e320a76`](https://github.com/mastra-ai/mastra/commit/e320a763feaf65c6be3cebecf746defcbde161b3), [`03b4918`](https://github.com/mastra-ai/mastra/commit/03b4918c80d188ce375334c393e131c6e94bd7eb), [`14ef73a`](https://github.com/mastra-ai/mastra/commit/14ef73a4bbd73e7808414816eb0628ce1d80b5d7), [`1d677d5`](https://github.com/mastra-ai/mastra/commit/1d677d5f99d7db403f7828585e8c25f299f72628), [`93e28ec`](https://github.com/mastra-ai/mastra/commit/93e28ecce9031c02397e0ae8406593e5c7a95883), [`729dab4`](https://github.com/mastra-ai/mastra/commit/729dab408faccfaef0cbb048e5a4338f9172847e), [`484003d`](https://github.com/mastra-ai/mastra/commit/484003d33ff59330c86b19863e4a38732d7e4155), [`933d291`](https://github.com/mastra-ai/mastra/commit/933d291146b789c19442ad206f94da3e4be90c64)]:
+  - @mastra/core@1.56.0-alpha.3
+
 ## 1.56.0-alpha.2
 
 ### Patch Changes

package/dist/{dist-CgHgmUmP.js → dist-CagLZOyx.js}

@@ -5958,7 +5958,7 @@ function splitLines(text) {
 	return result;
 }
 //#endregion
-//#region ../memory/dist/src-Ci_GvBVm.js
+//#region ../memory/dist/src-BYZh9IBv.js
 var __defProp$4 = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -26649,7 +26649,10 @@ var ObservationStrategy = class ObservationStrategy {
 				await this.persistMarkerToStorage(failedMarkerForStorage, threadId, this.opts.resourceId).catch(() => {});
 				if (abortSignal?.aborted) throw error;
 				omError("[OM] Observation failed", error);
-				return { observed: false };
+				return {
+					observed: false,
+					error: error instanceof Error ? error : new Error(String(error))
+				};
 			}
 			omError("[OM] Observation failed", error);
 			throw error;
@@ -27687,7 +27690,12 @@ var ObservationStep = class {
 				currentModel: this.turn.actorModelContext,
 				requestContext: this.turn.requestContext,
 				observabilityContext: this.turn.observabilityContext,
-				lastActivityAt: getLastActivityFromMessages(messageList.get.all.db())
+				lastActivityAt: getLastActivityFromMessages(messageList.get.all.db()),
+				reflectionHooks: om.composeHooks(void 0, {
+					threadId,
+					resourceId,
+					trigger: "turn-sync"
+				})
 			});
 			await this.turn.refreshRecord();
 			if (this.turn.record.generationCount > preReflectGeneration) reflected = true;
@@ -27847,7 +27855,12 @@ var ObservationStep = class {
 					currentModel: this.turn.actorModelContext,
 					requestContext: this.turn.requestContext,
 					observabilityContext: this.turn.observabilityContext,
-					lastActivityAt: getLastActivityFromMessages(messageList.get.all.db())
+					lastActivityAt: getLastActivityFromMessages(messageList.get.all.db()),
+					reflectionHooks: om.composeHooks(void 0, {
+						threadId,
+						resourceId,
+						trigger: "turn-sync"
+					})
 				});
 				return {
 					succeeded: true,
@@ -27860,6 +27873,7 @@ var ObservationStep = class {
 			threadId,
 			resourceId,
 			messages: messageList.get.all.db(),
+			trigger: "turn-sync",
 			requestContext: this.turn.requestContext,
 			writer: this.turn.writer,
 			observabilityContext: this.turn.observabilityContext
@@ -28685,12 +28699,16 @@ var ReflectorRunner = class {
 		});
 		reflectionHooks?.onReflectionStart?.();
 		const asyncOp = this.doAsyncBufferedReflection(record, bufferKey, writer, requestContext, observabilityContext, priorExtractedValues, mainAgent, sendSignal).then((outcome) => {
-			reflectionHooks?.onReflectionEnd?.({
-				usage: outcome?.usage,
-				...outcome?.providerMetadata ? { providerMetadata: outcome.providerMetadata } : {}
-			});
-		}).catch(async (error) => {
-			if (writer) {
+			try {
+				reflectionHooks?.onReflectionEnd?.({
+					usage: outcome?.usage,
+					...outcome?.providerMetadata ? { providerMetadata: outcome.providerMetadata } : {}
+				});
+			} catch (hookError) {
+				omError("[OM] onReflectionEnd hook failed after async buffered reflection", hookError);
+			}
+		}, async (error) => {
+			if (writer) try {
 				const failedMarker = createBufferingFailedMarker({
 					cycleId: `reflect-buf-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,
 					operationType: "reflection",
@@ -28705,12 +28723,18 @@ var ReflectorRunner = class {
 					transient: true
 				}).catch(() => {});
 				await this.persistMarkerToStorage(failedMarker, record.threadId ?? "", record.resourceId ?? void 0);
+			} catch (markerError) {
+				omError("[OM] Failed to persist buffering-failed marker after async buffered reflection failure", markerError);
 			}
 			omError("[OM] Async buffered reflection failed", error);
-			reflectionHooks?.onReflectionEnd?.({
-				usage: void 0,
-				error: error instanceof Error ? error : new Error(String(error))
-			});
+			try {
+				reflectionHooks?.onReflectionEnd?.({
+					usage: void 0,
+					error: error instanceof Error ? error : new Error(String(error))
+				});
+			} catch (hookError) {
+				omError("[OM] onReflectionEnd hook failed after async buffered reflection failure", hookError);
+			}
 			BufferingCoordinator.lastBufferedBoundary.delete(bufferKey);
 		}).finally(() => {
 			BufferingCoordinator.asyncBufferingOps.delete(bufferKey);
@@ -28957,7 +28981,6 @@ var ReflectorRunner = class {
 				return;
 			}
 		}
-		reflectionHooks?.onReflectionStart?.();
 		await this.storage.setReflectingFlag(record.id, true);
 		registerOp(record.id, "reflecting");
 		const cycleId = crypto.randomUUID();
@@ -28998,6 +29021,7 @@ var ReflectorRunner = class {
 		let reflectionUsage;
 		let reflectionProviderMetadata;
 		let reflectionError;
+		reflectionHooks?.onReflectionStart?.();
 		try {
 			const compressionStartLevel = await this.getCompressionStartLevel(requestContext);
 			const reflectResult = await this.call(record.activeObservations, void 0, streamContext, reflectThreshold, abortSignal, void 0, compressionStartLevel, requestContext, priorExtractedValues, observabilityContext, void 0, mainAgent, sendSignal);
@@ -29061,12 +29085,15 @@ var ReflectorRunner = class {
 			omError("[OM] Reflection failed", error);
 		} finally {
 			await this.storage.setReflectingFlag(record.id, false);
-			reflectionHooks?.onReflectionEnd?.({
-				usage: reflectionUsage,
-				error: reflectionError,
-				...reflectionProviderMetadata ? { providerMetadata: reflectionProviderMetadata } : {}
-			});
-			unregisterOp(record.id, "reflecting");
+			try {
+				reflectionHooks?.onReflectionEnd?.({
+					usage: reflectionUsage,
+					error: reflectionError,
+					...reflectionProviderMetadata ? { providerMetadata: reflectionProviderMetadata } : {}
+				});
+			} finally {
+				unregisterOp(record.id, "reflecting");
+			}
 		}
 	}
 };
@@ -29515,6 +29542,8 @@ var ObservationalMemory = class ObservationalMemory {
 	reflectionConfig;
 	onDebugEvent;
 	onIndexObservations;
+	/** Config-level lifecycle hooks fired for every observation/reflection cycle. */
+	hooks;
 	/** Observer agent runner — handles LLM calls for extracting observations. */
 	observer;
 	/** Reflector agent runner — handles LLM calls for compressing observations. */
@@ -29575,6 +29604,7 @@ var ObservationalMemory = class ObservationalMemory {
 		this.scope = config.scope ?? "thread";
 		this.retrieval = Boolean(config.retrieval);
 		this.onIndexObservations = config.onIndexObservations;
+		this.hooks = config.hooks;
 		this.mastra = config.mastra;
 		this.memory = config.memory;
 		const resolveModel = (model, defaultModel) => model === "default" ? defaultModel : model;
@@ -30496,7 +30526,11 @@ ${formattedMessages}
 			transient: true
 		}).catch(() => {});
 		omDebug(`[OM:bufferInput] cycleId=${cycleId}, msgCount=${messagesToBuffer.length}, msgTokens=${tokensToBuffer}, ids=${messagesToBuffer.map((m) => `${m.id?.slice(0, 8)}@${m.createdAt ? new Date(m.createdAt).toISOString() : "none"}`).join(",")}`);
-		await ObservationStrategy.create(this, {
+		await this.runBufferedObservationCycle({
+			threadId,
+			resourceId: freshRecord.resourceId ?? void 0,
+			trigger: "async-buffer"
+		}, () => ObservationStrategy.create(this, {
 			record: freshRecord,
 			threadId,
 			resourceId: freshRecord.resourceId ?? void 0,
@@ -30506,7 +30540,7 @@ ${formattedMessages}
 			writer,
 			requestContext,
 			observabilityContext
-		}).run();
+		}).run());
 		const maxTs = this.getMaxMessageTimestamp(messagesToBuffer);
 		const cursor = new Date(maxTs.getTime() + 1);
 		BufferingCoordinator.lastBufferedAtTime.set(bufferKey, cursor);
@@ -31079,7 +31113,11 @@ ${formattedMessages}
 				...startMarker,
 				transient: true
 			}).catch(() => {});
-			await ObservationStrategy.create(this, {
+			await this.runBufferedObservationCycle({
+				threadId,
+				resourceId: record.resourceId ?? resourceId,
+				trigger: "async-buffer"
+			}, () => ObservationStrategy.create(this, {
 				record,
 				threadId,
 				resourceId: record.resourceId ?? void 0,
@@ -31092,7 +31130,7 @@ ${formattedMessages}
 				requestContext,
 				currentModel: opts.currentModel,
 				observabilityContext
-			}).run();
+			}).run());
 			if (isOmReproCaptureEnabled()) writeObserverExchangeReproCapture({
 				threadId,
 				resourceId: record.resourceId ?? void 0,
@@ -31302,6 +31340,88 @@ ${formattedMessages}
 		};
 	}
 	/**
+	* Compose the config-level hooks with optional per-call hooks into a single
+	* `ObserveHooks` object, binding call context onto the config-level
+	* callbacks. Config-level hooks are guarded so a throwing consumer hook can
+	* never fail an observation/reflection cycle; per-call hooks keep their
+	* existing payloads and propagation semantics. Returns undefined when
+	* neither is configured, so call sites stay zero-cost.
+	*
+	* Used internally by every pipeline path (manual observe/reflect,
+	* turn-engine sync observation, async buffering); public only so the
+	* observation turn engine can thread config-level reflection hooks into
+	* reflector calls.
+	*
+	* @internal
+	*/
+	composeHooks(callHooks, context) {
+		const configHooks = this.hooks;
+		if (!configHooks) return callHooks;
+		if (!callHooks && !Object.keys(configHooks).length) return void 0;
+		const fireConfigHook = (name, arg) => {
+			const hook = configHooks[name];
+			if (!hook) return;
+			const logHookFailure = (error) => omDebug(`[OM:hooks] config-level ${name} hook failed: ${error instanceof Error ? error.message : String(error)}`);
+			try {
+				const out = hook(arg);
+				if (out && typeof out.then === "function") out.then(void 0, logHookFailure);
+			} catch (error) {
+				logHookFailure(error);
+			}
+		};
+		return {
+			onObservationStart: () => {
+				fireConfigHook("onObservationStart", context);
+				callHooks?.onObservationStart?.();
+			},
+			onObservationEnd: (result) => {
+				fireConfigHook("onObservationEnd", {
+					...context,
+					...result
+				});
+				callHooks?.onObservationEnd?.(result);
+			},
+			onReflectionStart: () => {
+				fireConfigHook("onReflectionStart", context);
+				callHooks?.onReflectionStart?.();
+			},
+			onReflectionEnd: (result) => {
+				fireConfigHook("onReflectionEnd", {
+					...context,
+					...result
+				});
+				callHooks?.onReflectionEnd?.(result);
+			}
+		};
+	}
+	/**
+	* Run one buffered observation cycle, firing config-level hooks around it.
+	* Shared by both async-buffer lanes — buffer() and
+	* runAsyncBufferedObservation() — whose fire-and-forget callers never see
+	* the strategy result. The async-buffer strategy swallows failures
+	* (rethrowOnFailure=false) and surfaces them on the result instead, so the
+	* end hook reports `error` for failed cycles even though nothing throws.
+	*/
+	async runBufferedObservationCycle(context, run) {
+		const hooks = this.composeHooks(void 0, context);
+		hooks?.onObservationStart?.();
+		let runResult;
+		let runError;
+		try {
+			runResult = await run();
+			return runResult;
+		} catch (error) {
+			runError = error instanceof Error ? error : new Error(String(error));
+			throw error;
+		} finally {
+			hooks?.onObservationEnd?.({
+				usage: runResult?.usage,
+				error: runError ?? runResult?.error,
+				...runResult?.providerMetadata ? { providerMetadata: runResult.providerMetadata } : {}
+			});
+		}
+	}
+	/**
 	* Manually trigger observation.
 	*
 	* When `messages` is provided, those are used directly (filtered for unobserved)
@@ -31312,8 +31432,13 @@ ${formattedMessages}
 	* along with the updated record.
 	*/
 	async observe(opts) {
-		const { threadId, resourceId, messages, hooks, requestContext } = opts;
+		const { threadId, resourceId, messages, requestContext } = opts;
 		const lockKey = this.buffering.getLockKey(threadId, resourceId);
+		const hooks = this.composeHooks(opts.hooks, {
+			threadId,
+			resourceId,
+			trigger: opts.trigger ?? "manual"
+		});
 		const reflectionHooks = hooks ? {
 			onReflectionStart: hooks.onReflectionStart,
 			onReflectionEnd: hooks.onReflectionEnd
@@ -31386,6 +31511,15 @@ ${formattedMessages}
 		};
 		await this.storage.setReflectingFlag(record.id, true);
 		registerOp(record.id, "reflecting");
+		const hooks = this.composeHooks(void 0, {
+			threadId,
+			resourceId,
+			trigger: "manual"
+		});
+		hooks?.onReflectionStart?.();
+		let reflectionUsage;
+		let reflectionProviderMetadata;
+		let reflectionError;
 		try {
 			const thread = await this.storage.getThreadById({ threadId });
 			const previousOmMetadata = getThreadOMMetadata(thread?.metadata);
@@ -31415,12 +31549,16 @@ ${formattedMessages}
 					metadata: newMetadata
 				});
 			}
+			const updatedRecord = await this.getOrCreateRecord(threadId, resourceId);
+			reflectionUsage = reflectResult.usage;
+			reflectionProviderMetadata = reflectResult.providerMetadata;
 			return {
 				reflected: true,
-				record: await this.getOrCreateRecord(threadId, resourceId),
+				record: updatedRecord,
 				usage: reflectResult.usage
 			};
 		} catch (error) {
+			reflectionError = error instanceof Error ? error : new Error(String(error));
 			omError("[OM] reflect() failed", error);
 			return {
 				reflected: false,
@@ -31428,6 +31566,11 @@ ${formattedMessages}
 				usage: void 0
 			};
 		} finally {
+			hooks?.onReflectionEnd?.({
+				usage: reflectionUsage,
+				error: reflectionError,
+				...reflectionProviderMetadata ? { providerMetadata: reflectionProviderMetadata } : {}
+			});
 			await this.storage.setReflectingFlag(record.id, false);
 			unregisterOp(record.id, "reflecting");
 		}
@@ -32994,6 +33137,7 @@ ${workingMemory}`;
 			model: omConfig.model,
 			mastra: this._mastraInstance,
 			onIndexObservations,
+			hooks: omConfig.hooks,
 			observation: omConfig.observation ? {
 				model: omConfig.observation.model,
 				messageTokens: omConfig.observation.messageTokens,
@@ -44282,4 +44426,4 @@ const agentBuilderWorkflows = {
 //#endregion
 export { agentBuilderWorkflows };
 
-//# sourceMappingURL=dist-CgHgmUmP.js.map
+//# sourceMappingURL=dist-CagLZOyx.js.map