@mastra/memory 1.28.3 → 1.29.0-alpha.1

package/dist/{src-BFP4tRqs.js → src-BNB8ko_o.js}

@@ -18892,11 +18892,11 @@ function formatObserverAttachmentPlaceholder(part, counter) {
 	const label = resolveObserverAttachmentLabel(part);
 	return label ? `[${attachmentType} #${attachmentId}: ${label}]` : `[${attachmentType} #${attachmentId}]`;
 }
-function isRecord$3(value) {
+function isRecord$4(value) {
 	return !!value && typeof value === "object";
 }
 function mapToolResultBlockToAttachment(block) {
-	if (!isRecord$3(block) || typeof block.type !== "string") return;
+	if (!isRecord$4(block) || typeof block.type !== "string") return;
 	const mediaType = typeof block.mediaType === "string" ? block.mediaType : void 0;
 	const filename = typeof block.filename === "string" ? block.filename : void 0;
 	switch (block.type) {
@@ -18957,7 +18957,7 @@ function mapToolResultBlockToAttachment(block) {
 	}
 }
 function extractToolResultAttachments(result, counter, attachmentFilter) {
-	if (!isRecord$3(result) || result.type !== "content" || !Array.isArray(result.value)) return {
+	if (!isRecord$4(result) || result.type !== "content" || !Array.isArray(result.value)) return {
 		resultWithoutAttachments: result,
 		attachments: []
 	};
@@ -18971,7 +18971,7 @@ function extractToolResultAttachments(result, counter, attachmentFilter) {
 		if (shouldIncludeObserverAttachment(attachment, attachmentFilter)) attachments.push(toObserverInputAttachmentPart(attachment));
 		const placeholder = formatObserverAttachmentPlaceholder(attachment, counter);
 		return {
-			type: isRecord$3(block) ? block.type : void 0,
+			type: isRecord$4(block) ? block.type : void 0,
 			placeholder
 		};
 	});
@@ -19592,17 +19592,17 @@ const TRANSIENT_MESSAGE_SUBSTRINGS = [
 	"connection reset",
 	"connection closed"
 ];
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null;
 }
 function isAbortError(error) {
-	if (!isRecord$2(error)) return false;
+	if (!isRecord$3(error)) return false;
 	if (error.name === "AbortError") return true;
 	if (typeof error.code === "string" && error.code === "ABORT_ERR") return true;
 	return false;
 }
 function hasTransientMessage(value) {
-	if (!isRecord$2(value)) return false;
+	if (!isRecord$3(value)) return false;
 	const message = typeof value.message === "string" ? value.message.toLowerCase() : "";
 	if (message && TRANSIENT_MESSAGE_SUBSTRINGS.some((sub) => message.includes(sub))) return true;
 	if (typeof value.code === "string" && value.code.toUpperCase().startsWith("UND_ERR_")) return true;
@@ -19613,13 +19613,13 @@ function isRetryableHttpStatus(status) {
 	return status >= 500 && status <= 599;
 }
 function hasRetryableHttpStatus(value) {
-	if (!isRecord$2(value)) return false;
+	if (!isRecord$3(value)) return false;
 	if (typeof value.statusCode === "number" && isRetryableHttpStatus(value.statusCode)) return true;
 	if (typeof value.code === "number" && isRetryableHttpStatus(value.code)) return true;
 	return false;
 }
 function hasIsRetryableFlag(value) {
-	if (!isRecord$2(value)) return false;
+	if (!isRecord$3(value)) return false;
 	return value.isRetryable === true;
 }
 /**
@@ -19637,14 +19637,14 @@ function isTransientLLMError(error) {
 	if (isAbortError(error)) return false;
 	const visited = /* @__PURE__ */ new WeakSet();
 	function visit(candidate) {
-		if (isRecord$2(candidate)) {
+		if (isRecord$3(candidate)) {
 			if (visited.has(candidate)) return false;
 			visited.add(candidate);
 		}
 		if (hasTransientMessage(candidate)) return true;
 		if (hasRetryableHttpStatus(candidate)) return true;
 		if (hasIsRetryableFlag(candidate)) return true;
-		if (isRecord$2(candidate)) {
+		if (isRecord$3(candidate)) {
 			if (visit(candidate.cause)) return true;
 			if (visit(candidate.error)) return true;
 		}
@@ -19789,6 +19789,37 @@ async function withOmTracingSpan({ phase, model, inputTokens, requestContext, ob
 	});
 }
 //#endregion
+//#region src/processors/observational-memory/transform-hooks.ts
+/**
+* Run the `beforeObservation` transform hook. Returns the (possibly replaced)
+* message array; `undefined` from the hook means passthrough.
+*/
+async function applyBeforeObservation(hooks, messages, context) {
+	if (!hooks?.beforeObservation) return messages;
+	const result = await hooks.beforeObservation({
+		...context,
+		messages
+	});
+	if (!result) return messages;
+	omDebug(`[OM:hooks] beforeObservation replaced messages: ${messages.length} -> ${result.messages.length}`);
+	return result.messages;
+}
+/**
+* Run one of the text transform hooks. Returns the (possibly replaced)
+* observation text; `undefined` from the hook means passthrough.
+*/
+async function applyTextTransform(hooks, name, observations, context) {
+	const hook = hooks?.[name];
+	if (!hook) return observations;
+	const result = await hook({
+		...context,
+		observations
+	});
+	if (!result) return observations;
+	omDebug(`[OM:hooks] ${name} replaced observations: ${observations.length} -> ${result.observations.length} chars`);
+	return result.observations;
+}
+//#endregion
 //#region src/processors/observational-memory/observer-runner.ts
 function filterObserverExtractors(extractors, skipContinuationHints) {
 	const configuredExtractors = extractors ?? [];
@@ -19801,6 +19832,7 @@ var ObserverRunner = class {
 	resolveModel;
 	tokenCounter;
 	memory;
+	hooks;
 	mastra;
 	/** Captured prompt/response from the last observer call (for repro capture). */
 	lastExchange;
@@ -19811,6 +19843,7 @@ var ObserverRunner = class {
 		this.tokenCounter = opts.tokenCounter;
 		this.mastra = opts.mastra;
 		this.memory = opts.memory;
+		this.hooks = opts.hooks;
 	}
 	__registerMastra(mastra) {
 		this.mastra = mastra;
@@ -19864,9 +19897,25 @@ var ObserverRunner = class {
 		return result;
 	}
 	/**
-	* Call the Observer agent for a single thread.
+	* Call the Observer agent for a single thread, running the config-level
+	* `beforeObservation` / `afterObservation` transform hooks around it.
 	*/
 	async call(existingObservations, messagesToObserve, abortSignal, options) {
+		const context = {
+			threadId: options?.threadId ?? messagesToObserve[0]?.threadId,
+			resourceId: options?.resourceId,
+			trigger: options?.trigger
+		};
+		const messages = await applyBeforeObservation(this.hooks, messagesToObserve, context);
+		if (messages.length === 0) {
+			omDebug("[OM:callObserver] beforeObservation returned no messages, skipping observer call");
+			return { observations: "" };
+		}
+		const result = await this.callObserver(existingObservations, messages, abortSignal, options);
+		result.observations = await applyTextTransform(this.hooks, "afterObservation", result.observations, context);
+		return result;
+	}
+	async callObserver(existingObservations, messagesToObserve, abortSignal, options) {
 		const inputTokens = this.tokenCounter.countMessages(messagesToObserve);
 		const resolvedModel = options?.model ? { model: options.model } : this.resolveModel(inputTokens);
 		const activeExtractors = await resolveExtractors(filterObserverExtractors(this.observationConfig.extractors, options?.skipContinuationHints), {
@@ -19985,7 +20034,30 @@ var ObserverRunner = class {
 	/**
 	* Call the Observer agent for multiple threads in a single batched request.
 	*/
-	async callMultiThread(existingObservations, messagesByThread, threadOrder, abortSignal, requestContext, priorMetadataByThread, observabilityContext, model) {
+	async callMultiThread(existingObservations, allMessagesByThread, allThreadOrder, abortSignal, requestContext, priorMetadataByThread, observabilityContext, model, hookContext) {
+		const contextFor = (threadId) => ({
+			threadId,
+			...hookContext
+		});
+		const messagesByThread = /* @__PURE__ */ new Map();
+		for (const threadId of allThreadOrder) {
+			const filtered = await applyBeforeObservation(this.hooks, allMessagesByThread.get(threadId) ?? [], contextFor(threadId));
+			if (filtered.length > 0) messagesByThread.set(threadId, filtered);
+		}
+		const threadOrder = allThreadOrder.filter((threadId) => messagesByThread.has(threadId));
+		const output = await this.callMultiThreadObserver(existingObservations, messagesByThread, threadOrder, abortSignal, requestContext, priorMetadataByThread, observabilityContext, model);
+		for (const threadId of allThreadOrder) {
+			const threadResult = output.results.get(threadId);
+			if (!threadResult) {
+				output.results.set(threadId, { observations: "" });
+				continue;
+			}
+			threadResult.observations = await applyTextTransform(this.hooks, "afterObservation", threadResult.observations, contextFor(threadId));
+		}
+		return output;
+	}
+	async callMultiThreadObserver(existingObservations, messagesByThread, threadOrder, abortSignal, requestContext, priorMetadataByThread, observabilityContext, model) {
+		if (threadOrder.length === 0) return { results: /* @__PURE__ */ new Map() };
 		const inputTokens = Array.from(messagesByThread.values()).reduce((total, messages) => total + this.tokenCounter.countMessages(messages), 0);
 		const resolvedModel = model ? { model } : this.resolveModel(inputTokens);
 		const firstThreadMessages = messagesByThread.get(threadOrder[0] ?? "") ?? [];
@@ -20004,7 +20076,7 @@ var ObserverRunner = class {
 				totalTokens: 0
 			};
 			for (const threadId of threadOrder) {
-				const threadResult = await this.call(existingObservations, messagesByThread.get(threadId) ?? [], abortSignal, {
+				const threadResult = await this.callObserver(existingObservations, messagesByThread.get(threadId) ?? [], abortSignal, {
 					requestContext,
 					observabilityContext,
 					priorCurrentTask: priorMetadataByThread?.get(threadId)?.currentTask,
@@ -23337,6 +23409,45 @@ function didProviderChange(actorModel, lastModel) {
 	return false;
 }
 //#endregion
+//#region src/processors/observational-memory/error.ts
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null;
+}
+/** Keep provider diagnostics in streamed/persisted markers, not whole API request/response objects. */
+function formatOmError(error) {
+	const details = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const add = (value) => {
+		if (typeof value === "string" && value.trim()) details.add(value.trim().slice(0, 2e3));
+	};
+	function collectErrorDetails(value, depth) {
+		if (depth > 5) return;
+		if (!isRecord$2(value)) {
+			if (value !== void 0) add(String(value));
+			return;
+		}
+		if (visited.has(value)) return;
+		visited.add(value);
+		add(value.message);
+		if (typeof value.statusCode === "number") add(`HTTP ${value.statusCode}`);
+		if (typeof value.responseBody === "string") try {
+			const body = JSON.parse(value.responseBody);
+			if (isRecord$2(body)) {
+				add(body.message);
+				if (isRecord$2(body.error)) add(body.error.message);
+				else add(body.error);
+			}
+		} catch {}
+		if (value.cause !== void 0) collectErrorDetails(value.cause, depth + 1);
+		if (value.error !== void 0) collectErrorDetails(value.error, depth + 1);
+	}
+	try {
+		collectErrorDetails(error, 0);
+	} catch {}
+	const message = [...details].join(": ") || "Unknown error";
+	return message.length > 2e3 ? `${message.slice(0, 1997)}...` : message;
+}
+//#endregion
 //#region src/processors/observational-memory/markers.ts
 /**
 * Create a start marker for when observation begins.
@@ -23395,7 +23506,7 @@ function createObservationFailedMarker(params) {
 			failedAt,
 			durationMs,
 			tokensAttempted: params.tokensAttempted,
-			error: params.error,
+			error: formatOmError(params.error),
 			recordId: params.recordId,
 			threadId: params.threadId
 		}
@@ -23456,7 +23567,7 @@ function createBufferingFailedMarker(params) {
 			failedAt,
 			durationMs,
 			tokensAttempted: params.tokensAttempted,
-			error: params.error,
+			error: formatOmError(params.error),
 			recordId: params.recordId,
 			threadId: params.threadId
 		}
@@ -24061,6 +24172,7 @@ var ObservationStrategy = class ObservationStrategy {
 				sendSignal: this.opts.sendSignal,
 				sendStateSignal: this.opts.sendStateSignal,
 				reflectionHooks,
+				trigger: this.opts.trigger,
 				requestContext,
 				observabilityContext: this.opts.observabilityContext
 			});
@@ -24078,7 +24190,7 @@ var ObservationStrategy = class ObservationStrategy {
 						cycleId,
 						operationType: "observation",
 						startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-						error: error instanceof Error ? error.message : String(error),
+						error: formatOmError(error),
 						recordId: record.id,
 						threadId
 					}
@@ -24341,7 +24453,9 @@ var SyncObservationStrategy = class extends ObservationStrategy {
 			priorSuggestedResponse: omMeta?.suggestedResponse,
 			priorThreadTitle: omMeta?.threadTitle,
 			priorExtractedValues: this.priorExtractedValues,
+			threadId: this.opts.threadId,
 			resourceId: this.opts.resourceId,
+			trigger: this.opts.trigger,
 			mainAgent: this.opts.agent
 		});
 		const hookedValues = await applyExtractorHooks({
@@ -24477,7 +24591,7 @@ var SyncObservationStrategy = class extends ObservationStrategy {
 				operationType: "observation",
 				startedAt: this.startedAt,
 				tokensAttempted: this.tokensToObserve,
-				error: error instanceof Error ? error.message : String(error),
+				error,
 				recordId: this.opts.record.id,
 				threadId: this.opts.threadId
 			});
@@ -24526,7 +24640,9 @@ var AsyncBufferObservationStrategy = class extends ObservationStrategy {
 			requestContext: this.opts.requestContext,
 			observabilityContext: this.opts.observabilityContext,
 			priorExtractedValues: this.priorExtractedValues,
+			threadId: this.opts.threadId,
 			resourceId: this.opts.resourceId,
+			trigger: this.opts.trigger,
 			mainAgent: this.opts.agent
 		});
 		const hookedValues = await applyExtractorHooks({
@@ -24676,7 +24792,7 @@ var AsyncBufferObservationStrategy = class extends ObservationStrategy {
 			operationType: "observation",
 			startedAt: this.startedAt,
 			tokensAttempted,
-			error: error instanceof Error ? error.message : String(error),
+			error,
 			recordId: record.id,
 			threadId
 		});
@@ -24850,7 +24966,10 @@ var ResourceScopedObservationStrategy = class extends ObservationStrategy {
 		}
 		if (currentBatch.threadIds.length > 0) batches.push(currentBatch);
 		const batchResults = await Promise.all(batches.map(async (batch) => {
-			return this.deps.observer.callMultiThread(_existingObservations, batch.threadMap, batch.threadIds, this.opts.abortSignal, this.opts.requestContext, this.priorMetadataByThread, this.opts.observabilityContext);
+			return this.deps.observer.callMultiThread(_existingObservations, batch.threadMap, batch.threadIds, this.opts.abortSignal, this.opts.requestContext, this.priorMetadataByThread, this.opts.observabilityContext, void 0, {
+				resourceId: this.opts.resourceId,
+				trigger: this.opts.trigger
+			});
 		}));
 		for (const batchResult of batchResults) {
 			for (const [threadId, result] of batchResult.results) this.multiThreadResults.set(threadId, result);
@@ -25041,7 +25160,7 @@ var ResourceScopedObservationStrategy = class extends ObservationStrategy {
 				operationType: "observation",
 				startedAt: this.startedAt,
 				tokensAttempted,
-				error: error instanceof Error ? error.message : String(error),
+				error,
 				recordId: this.opts.record.id,
 				threadId
 			});
@@ -25188,7 +25307,8 @@ var ObservationStep = class {
 					threadId,
 					resourceId,
 					trigger: "turn-sync"
-				})
+				}),
+				trigger: "turn-sync"
 			});
 			await this.turn.refreshRecord();
 			if (this.turn.record.generationCount > preReflectGeneration) reflected = true;
@@ -25391,7 +25511,8 @@ var ObservationStep = class {
 						threadId,
 						resourceId,
 						trigger: "turn-sync"
-					})
+					}),
+					trigger: "turn-sync"
 				});
 				return {
 					succeeded: true,
@@ -26028,6 +26149,7 @@ var ReflectorRunner = class {
 	getCompressionStartLevel;
 	memory;
 	onReflectionCommitted;
+	hooks;
 	mastra;
 	/**
 	* Per-lock-key observation-token count of the last unproductive synchronous
@@ -26059,6 +26181,7 @@ var ReflectorRunner = class {
 		this.mastra = opts.mastra;
 		this.memory = opts.memory;
 		this.onReflectionCommitted = opts.onReflectionCommitted;
+		this.hooks = opts.hooks;
 	}
 	__registerMastra(mastra) {
 		this.mastra = mastra;
@@ -26281,7 +26404,7 @@ var ReflectorRunner = class {
 	/**
 	* Start an async buffered reflection in the background.
 	*/
-	startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal) {
+	startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal, trigger) {
 		const bufferKey = this.buffering.getReflectionBufferKey(lockKey);
 		if (this.buffering.isAsyncBufferingInProgress(bufferKey)) return;
 		BufferingCoordinator.lastBufferedBoundary.set(bufferKey, observationTokens);
@@ -26294,7 +26417,7 @@ var ReflectorRunner = class {
 			let reflectionError;
 			try {
 				await reflectionHooks?.onReflectionStart?.();
-				outcome = await this.doAsyncBufferedReflection(record, bufferKey, writer, requestContext, observabilityContext, priorExtractedValues, mainAgent, sendSignal);
+				outcome = await this.doAsyncBufferedReflection(record, bufferKey, writer, requestContext, observabilityContext, priorExtractedValues, mainAgent, sendSignal, trigger);
 			} catch (error) {
 				reflectionError = error instanceof Error ? error : new Error(String(error));
 				if (writer) try {
@@ -26303,7 +26426,7 @@ var ReflectorRunner = class {
 						operationType: "reflection",
 						startedAt: (/* @__PURE__ */ new Date()).toISOString(),
 						tokensAttempted: observationTokens,
-						error: reflectionError.message,
+						error,
 						recordId: record.id,
 						threadId: record.threadId ?? ""
 					});
@@ -26340,7 +26463,7 @@ var ReflectorRunner = class {
 	* Perform async buffered reflection — reflects observations and stores to bufferedReflection.
 	* Does NOT create a new generation or update activeObservations.
 	*/
-	async doAsyncBufferedReflection(record, _bufferKey, writer, requestContext, observabilityContext, priorExtractedValues, mainAgent, sendSignal) {
+	async doAsyncBufferedReflection(record, _bufferKey, writer, requestContext, observabilityContext, priorExtractedValues, mainAgent, sendSignal, trigger) {
 		const currentRecord = await this.storage.getObservationalMemory(record.threadId, record.resourceId) ?? record;
 		const observationTokens = currentRecord.observationTokenCount ?? 0;
 		const reflectThreshold = getMaxThreshold(this.getEffectiveReflectionTokens(currentRecord));
@@ -26353,7 +26476,12 @@ var ReflectorRunner = class {
 		const avgTokensPerLine = totalLines > 0 ? observationTokens / totalLines : 0;
 		const activationPointTokens = reflectThreshold * bufferActivation;
 		const linesToReflect = avgTokensPerLine > 0 ? Math.min(Math.floor(activationPointTokens / avgTokensPerLine), totalLines) : totalLines;
-		const activeObservations = allLines.slice(0, linesToReflect).join("\n");
+		const hookContext = {
+			threadId: currentRecord.threadId ?? void 0,
+			resourceId: currentRecord.resourceId ?? void 0,
+			trigger
+		};
+		const activeObservations = await applyTextTransform(this.hooks, "beforeReflection", allLines.slice(0, linesToReflect).join("\n"), hookContext);
 		const reflectedObservationLineCount = linesToReflect;
 		const sliceTokenEstimate = Math.round(avgTokensPerLine * linesToReflect);
 		const compressionTarget = Math.round(sliceTokenEstimate * .75);
@@ -26377,6 +26505,7 @@ var ReflectorRunner = class {
 		}
 		const compressionStartLevel = await this.getCompressionStartLevel(requestContext);
 		const reflectResult = await this.call(activeObservations, void 0, void 0, compressionTarget, void 0, true, compressionStartLevel, requestContext, priorExtractedValues, observabilityContext, void 0, mainAgent, sendSignal);
+		reflectResult.observations = await applyTextTransform(this.hooks, "afterReflection", reflectResult.observations, hookContext);
 		await persistThreadExtractedValues(this.storage, this.reflectionConfig.extractors, currentRecord.threadId ?? void 0, reflectResult.extractedValues);
 		const reflectionTokenCount = this.tokenCounter.countObservations(reflectResult.observations);
 		omDebug(`[OM:reflect] doAsyncBufferedReflection: reflector returned ${reflectionTokenCount} tokens (${reflectResult.observations?.length} chars), saving to recordId=${currentRecord.id}`);
@@ -26523,7 +26652,7 @@ var ReflectorRunner = class {
 	* @internal Used by observation strategies. Do not call directly.
 	*/
 	async maybeReflect(opts) {
-		const { record, observationTokens, writer, abortSignal, mainAgent, sendSignal, sendStateSignal, messageList, currentModel, reflectionHooks, requestContext, observabilityContext, lastActivityAt, threadId: requestedThreadId } = opts;
+		const { record, observationTokens, writer, abortSignal, mainAgent, sendSignal, sendStateSignal, messageList, currentModel, reflectionHooks, trigger, requestContext, observabilityContext, lastActivityAt, threadId: requestedThreadId } = opts;
 		const lockKey = this.buffering.getLockKey(record.threadId, record.resourceId);
 		const reflectThreshold = getMaxThreshold(this.getEffectiveReflectionTokens(record));
 		const priorExtractedValues = await getThreadExtractedValues(this.storage, this.reflectionConfig.extractors, requestedThreadId ?? record.threadId);
@@ -26541,7 +26670,7 @@ var ReflectorRunner = class {
 				if (record.bufferedReflection) return false;
 				const activationPoint = reflectThreshold * this.reflectionConfig.bufferActivation;
 				return observationTokens >= activationPoint;
-			})()) this.startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal);
+			})()) this.startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal, trigger);
 		}
 		const activateAfterIdle = resolveActivationTTL(this.reflectionConfig.activateAfterIdle, currentModel);
 		const ttlExpiredMs = activateAfterIdle !== void 0 && lastActivityAt !== void 0 ? Date.now() - lastActivityAt : void 0;
@@ -26590,7 +26719,7 @@ var ReflectorRunner = class {
 					return;
 				}
 				omDebug(`[OM:reflect] async activation failed, no blockAfter or below it (obsTokens=${observationTokens}, blockAfter=${this.reflectionConfig.blockAfter}) — starting background reflection`);
-				this.startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal);
+				this.startAsyncBufferedReflection(record, observationTokens, lockKey, writer, requestContext, observabilityContext, reflectionHooks, priorExtractedValues, mainAgent, sendSignal, trigger);
 				return;
 			}
 		}
@@ -26651,7 +26780,13 @@ var ReflectorRunner = class {
 				throw error;
 			}
 			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);
+			const hookContext = {
+				threadId: requestedThreadId ?? record.threadId ?? void 0,
+				resourceId: record.resourceId ?? void 0,
+				trigger
+			};
+			const reflectResult = await this.call(await applyTextTransform(this.hooks, "beforeReflection", record.activeObservations, hookContext), void 0, streamContext, reflectThreshold, abortSignal, void 0, compressionStartLevel, requestContext, priorExtractedValues, observabilityContext, void 0, mainAgent, sendSignal);
+			reflectResult.observations = await applyTextTransform(this.hooks, "afterReflection", reflectResult.observations, hookContext);
 			reflectionUsage = reflectResult.usage;
 			reflectionProviderMetadata = reflectResult.providerMetadata;
 			await persistThreadExtractedValues(this.storage, this.reflectionConfig.extractors, record.threadId ?? void 0, reflectResult.extractedValues);
@@ -26710,7 +26845,7 @@ var ReflectorRunner = class {
 					operationType: "reflection",
 					startedAt: streamContext.startedAt,
 					tokensAttempted: observationTokens,
-					error: error instanceof Error ? error.message : String(error),
+					error,
 					recordId: record.id,
 					threadId
 				});
@@ -27402,7 +27537,8 @@ var ObservationalMemory = class ObservationalMemory {
 			resolveModel: (inputTokens) => this.resolveObservationModel(inputTokens),
 			tokenCounter: this.tokenCounter,
 			mastra: config.mastra,
-			memory: this.memory
+			memory: this.memory,
+			hooks: this.hooks
 		});
 		this.buffering = new BufferingCoordinator({
 			observationConfig: this.observationConfig,
@@ -27423,7 +27559,8 @@ var ObservationalMemory = class ObservationalMemory {
 			resolveModel: (inputTokens) => this.resolveReflectionModel(inputTokens),
 			mastra: config.mastra,
 			memory: this.memory,
-			onReflectionCommitted: config.onReflectionCommitted
+			onReflectionCommitted: config.onReflectionCommitted,
+			hooks: this.hooks
 		});
 		this.validateBufferConfig();
 		omDebug(`[OM:init] new ObservationalMemory instance created — scope=${this.scope}, messageTokens=${JSON.stringify(this.observationConfig.messageTokens)}, obsAsyncEnabled=${this.buffering.isAsyncObservationEnabled()}, bufferTokens=${this.observationConfig.bufferTokens}, bufferActivation=${this.observationConfig.bufferActivation}, blockAfter=${this.observationConfig.blockAfter}, reflectionTokens=${this.reflectionConfig.observationTokens}, refAsyncEnabled=${this.buffering.isAsyncReflectionEnabled()}, refAsyncActivation=${this.reflectionConfig.bufferActivation}, refBlockAfter=${this.reflectionConfig.blockAfter}`);
@@ -28279,7 +28416,8 @@ ${formattedMessages}
 			startedAt,
 			writer,
 			requestContext,
-			observabilityContext
+			observabilityContext,
+			trigger: "async-buffer"
 		}).run());
 		const maxTs = this.getMaxMessageTimestamp(messagesToBuffer);
 		const cursor = new Date(maxTs.getTime() + 1);
@@ -28900,7 +29038,8 @@ ${formattedMessages}
 				sendStateSignal: opts.sendStateSignal,
 				requestContext,
 				currentModel: opts.currentModel,
-				observabilityContext
+				observabilityContext,
+				trigger: "async-buffer"
 			}).run());
 			if (isOmReproCaptureEnabled()) writeObserverExchangeReproCapture({
 				threadId,
@@ -29214,10 +29353,11 @@ ${formattedMessages}
 	async observe(opts) {
 		const { threadId, resourceId, messages, requestContext } = opts;
 		const lockKey = this.buffering.getLockKey(threadId, resourceId);
+		const trigger = opts.trigger ?? "manual";
 		const hooks = this.composeHooks(opts.hooks, {
 			threadId,
 			resourceId,
-			trigger: opts.trigger ?? "manual"
+			trigger
 		});
 		const reflectionHooks = hooks ? {
 			onReflectionStart: hooks.onReflectionStart,
@@ -29248,6 +29388,7 @@ ${formattedMessages}
 					messages: unobservedMessages,
 					messageList: opts.messageList,
 					reflectionHooks,
+					trigger,
 					agent: opts.agent,
 					sendSignal: opts.sendSignal,
 					sendStateSignal: opts.sendStateSignal,
@@ -29314,11 +29455,12 @@ ${formattedMessages}
 		}
 		await this.storage.setReflectingFlag(record.id, true);
 		registerOp(record.id, "reflecting");
-		const hooks = this.composeHooks(void 0, {
+		const hookContext = {
 			threadId,
 			resourceId,
 			trigger: "manual"
-		});
+		};
+		const hooks = this.composeHooks(void 0, hookContext);
 		let reflectionUsage;
 		let reflectionProviderMetadata;
 		let reflectionError;
@@ -29335,7 +29477,8 @@ ${formattedMessages}
 			const previousOmMetadata = getThreadOMMetadata(thread?.metadata);
 			const priorExtractedValues = getPriorExtractedValues(previousOmMetadata, this.reflectionConfig.extractors);
 			const reflectThreshold = getMaxThreshold(this.getEffectiveReflectionTokens(record));
-			const reflectResult = await this.reflector.call(record.activeObservations, prompt, void 0, reflectThreshold, void 0, void 0, void 0, requestContext, priorExtractedValues, observabilityContext, void 0);
+			const reflectResult = await this.reflector.call(await applyTextTransform(this.hooks, "beforeReflection", record.activeObservations, hookContext), prompt, void 0, reflectThreshold, void 0, void 0, void 0, requestContext, priorExtractedValues, observabilityContext, void 0);
+			reflectResult.observations = await applyTextTransform(this.hooks, "afterReflection", reflectResult.observations, hookContext);
 			const reflectionTokenCount = this.tokenCounter.countObservations(reflectResult.observations);
 			await this.storage.createReflectionGeneration({
 				currentRecord: record,
@@ -30233,7 +30376,7 @@ var Memory = class Memory extends MastraMemory {
 		});
 	}
 	async recall(args) {
-		const { threadId, resourceId, perPage: perPageArg, page, orderBy, threadConfig, vectorSearchString, includeSystemReminders, filter } = args;
+		const { threadId, resourceId, perPage: perPageArg, page, orderBy, threadConfig, vectorSearchString, includeSystemReminders, filter, includeTotal } = args;
 		const config = this.getMergedThreadConfig(threadConfig || {});
 		const semanticRecallEnabled = Boolean(config.semanticRecall);
 		const span = this.createMemorySpan("recall", args.observabilityContext, {
@@ -30320,6 +30463,7 @@ var Memory = class Memory extends MastraMemory {
 				page,
 				orderBy: effectiveOrderBy,
 				filter,
+				...includeTotal !== void 0 ? { includeTotal } : {},
 				...filteredVectorResults?.length ? { include: filteredVectorResults.map((r) => ({
 					id: r.metadata?.message_id,
 					threadId: r.metadata?.thread_id,
@@ -30932,6 +31076,7 @@ ${workingMemory}`;
 							direction: "ASC"
 						},
 						perPage: false,
+						includeTotal: false,
 						filter: dateFilter
 					})).messages;
 				};
@@ -30945,6 +31090,7 @@ ${workingMemory}`;
 							direction: "ASC"
 						},
 						perPage: false,
+						includeTotal: false,
 						filter: dateFilter
 					})).messages;
 				};
@@ -30960,7 +31106,8 @@ ${workingMemory}`;
 					field: "createdAt",
 					direction: "DESC"
 				},
-				perPage: typeof lastMessages === "number" ? lastMessages : void 0
+				perPage: typeof lastMessages === "number" ? lastMessages : void 0,
+				includeTotal: false
 			})).messages.reverse();
 		}
 		return {
@@ -31322,7 +31469,8 @@ Notes:
 				threadId,
 				resourceId,
 				perPage: SUMMARIZE_THREAD_DEFAULTS.pageSize,
-				page
+				page,
+				includeTotal: false
 			});
 			if (batch.length === 0) break;
 			let reachedLimit = false;
@@ -31973,4 +32121,4 @@ Notes:
 //#endregion
 export { formatMessagesForObserver as A, OBSERVATION_CONTINUATION_HINT as B, SUMMARIZE_THREAD_DEFAULTS as C, buildObserverPrompt as D, OBSERVER_SYSTEM_PROMPT as E, parseAnchorId as F, ModelByInputTokens as G, KnowledgeSemanticIndexCoordinator as H, stripEphemeralAnchorIds as I, publishSubconsciousActivity as J, SUBCONSCIOUS_ACTIVITY_STATE_ID as K, OBSERVATIONAL_MEMORY_DEFAULTS as L, optimizeObservationsForContext as M, parseObserverOutput as N, buildObserverSystemPrompt as O, injectAnchorIds as P, OBSERVATION_CONTEXT_INSTRUCTIONS as R, WorkingMemoryExtractor as S, TokenCounter as T, StaleKnowledgeSemanticIndexError as U, Subconscious as V, SubconsciousRemindExtractor as W, Extractor as X, renderSubconsciousActivity as Y, wrapInObservationGroup as _, extractWorkingMemoryContent as a, WorkingMemoryStateProcessor as b, getObservationsAsOf as c, combineObservationGroupRanges as d, deriveObservationGroupProvenance as f, stripObservationGroups as g, renderObservationGroupsForReflection as h, WorkingMemory as i, hasCurrentTaskSection as j, extractCurrentTask as k, ObservationalMemoryProcessor as l, reconcileObservationGroupsFromReflection as m, MessageHistory$1 as n, extractWorkingMemoryTags as o, parseObservationGroups as p, buildSubconsciousActivitySnapshot as q, SemanticRecall as r, removeWorkingMemoryTags as s, Memory as t, ObservationalMemory as u, WORKING_MEMORY_STATE_ID as v, summarizeConversation as w, deepMergeWorkingMemory as x, WORKING_MEMORY_STATE_PROCESSOR_ID as y, OBSERVATION_CONTEXT_PROMPT as z };
 
-//# sourceMappingURL=src-BFP4tRqs.js.map
+//# sourceMappingURL=src-BNB8ko_o.js.map