@mastra/server 1.79.0-alpha.10 → 1.79.0-alpha.12

package/dist/server/handlers/memory.js

@@ -1,1731 +1 @@
-import { r as __exportAll } from "../../rolldown-runtime-maW3aOIk.js";
-import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
-import { n as createRoute } from "../../route-builder-BfQYtclb.js";
-import { handleError } from "./error.js";
-import { a as getEffectiveThreadId, g as MastraFGAPermissions, i as getEffectiveResourceId, n as enforceThreadAccess, p as validateBody, r as getContextResourceId } from "../../utils-BBJlS81s.js";
-import { A as listThreadsNetworkQuerySchema, B as searchMemoryQuerySchema, C as getThreadByIdResponseSchema, D as listMessagesNetworkQuerySchema, G as updateThreadBodySchema, H as threadIdPathParams, I as optionalAgentIdQuerySchema, J as updateWorkingMemoryResponseSchema, K as updateThreadNetworkQuerySchema, L as saveMessagesBodySchema, M as listThreadsResponseSchema, N as memoryConfigResponseSchema, O as listMessagesQuerySchema, P as memoryStatusResponseSchema, R as saveMessagesNetworkQuerySchema, S as getThreadByIdQuerySchema, T as getWorkingMemoryResponseSchema, U as transferThreadBodySchema, V as searchMemoryResponseSchema, W as transferThreadResponseSchema, _ as getMemoryStatusNetworkQuerySchema, a as cloneThreadResponseSchema, b as getObservationalMemoryResponseSchema, c as deleteMessagesBodySchema, d as deleteMessagesResponseSchema, f as deleteThreadNetworkQuerySchema, g as getMemoryConfigQuerySchema, i as cloneThreadBodySchema, j as listThreadsQuerySchema, k as listMessagesResponseSchema, l as deleteMessagesNetworkQuerySchema, m as deleteThreadResponseSchema, n as awaitBufferStatusBodySchema, o as createThreadBodySchema, p as deleteThreadQuerySchema, q as updateWorkingMemoryBodySchema, r as awaitBufferStatusResponseSchema, s as createThreadNetworkQuerySchema, t as agentIdQuerySchema, u as deleteMessagesQuerySchema, v as getMemoryStatusQuerySchema, w as getWorkingMemoryQuerySchema, x as getThreadByIdNetworkQuerySchema, y as getObservationalMemoryQuerySchema, z as saveMessagesResponseSchema } from "../../memory-B58Q2LgU.js";
-import { getGatewayClient, isGatewayAgentAsync, toLocalMessage, toLocalOMRecord, toLocalThread } from "./gateway-memory-client.js";
-import { Agent } from "@mastra/core/agent";
-import { ErrorCategory, MastraError } from "@mastra/core/error";
-import { generateEmptyFromSchema } from "@mastra/core/utils";
-//#region src/server/handlers/memory.ts
-var memory_exports = /* @__PURE__ */ __exportAll({
-	AWAIT_BUFFER_STATUS_ROUTE: () => AWAIT_BUFFER_STATUS_ROUTE,
-	CLONE_THREAD_ROUTE: () => CLONE_THREAD_ROUTE,
-	CREATE_THREAD_NETWORK_ROUTE: () => CREATE_THREAD_NETWORK_ROUTE,
-	CREATE_THREAD_ROUTE: () => CREATE_THREAD_ROUTE,
-	DELETE_MESSAGES_NETWORK_ROUTE: () => DELETE_MESSAGES_NETWORK_ROUTE,
-	DELETE_MESSAGES_ROUTE: () => DELETE_MESSAGES_ROUTE,
-	DELETE_THREAD_NETWORK_ROUTE: () => DELETE_THREAD_NETWORK_ROUTE,
-	DELETE_THREAD_ROUTE: () => DELETE_THREAD_ROUTE,
-	GET_MEMORY_CONFIG_ROUTE: () => GET_MEMORY_CONFIG_ROUTE,
-	GET_MEMORY_STATUS_NETWORK_ROUTE: () => GET_MEMORY_STATUS_NETWORK_ROUTE,
-	GET_MEMORY_STATUS_ROUTE: () => GET_MEMORY_STATUS_ROUTE,
-	GET_OBSERVATIONAL_MEMORY_ROUTE: () => GET_OBSERVATIONAL_MEMORY_ROUTE,
-	GET_THREAD_BY_ID_NETWORK_ROUTE: () => GET_THREAD_BY_ID_NETWORK_ROUTE,
-	GET_THREAD_BY_ID_ROUTE: () => GET_THREAD_BY_ID_ROUTE,
-	GET_WORKING_MEMORY_ROUTE: () => GET_WORKING_MEMORY_ROUTE,
-	LIST_MESSAGES_NETWORK_ROUTE: () => LIST_MESSAGES_NETWORK_ROUTE,
-	LIST_MESSAGES_ROUTE: () => LIST_MESSAGES_ROUTE,
-	LIST_THREADS_NETWORK_ROUTE: () => LIST_THREADS_NETWORK_ROUTE,
-	LIST_THREADS_ROUTE: () => LIST_THREADS_ROUTE,
-	SAVE_MESSAGES_NETWORK_ROUTE: () => SAVE_MESSAGES_NETWORK_ROUTE,
-	SAVE_MESSAGES_ROUTE: () => SAVE_MESSAGES_ROUTE,
-	SEARCH_MEMORY_ROUTE: () => SEARCH_MEMORY_ROUTE,
-	TRANSFER_THREAD_ROUTE: () => TRANSFER_THREAD_ROUTE,
-	UPDATE_THREAD_NETWORK_ROUTE: () => UPDATE_THREAD_NETWORK_ROUTE,
-	UPDATE_THREAD_ROUTE: () => UPDATE_THREAD_ROUTE,
-	UPDATE_WORKING_MEMORY_ROUTE: () => UPDATE_WORKING_MEMORY_ROUTE,
-	getTextContent: () => getTextContent
-});
-function hasFGAUser(requestContext) {
-	const user = requestContext?.get("user");
-	return !!user && typeof user === "object";
-}
-function shouldFilterThreadsWithFGA(mastra, requestContext) {
-	return !!mastra.getServer?.()?.fga && hasFGAUser(requestContext);
-}
-async function filterAccessibleThreads({ mastra, requestContext, threads }) {
-	const fgaProvider = mastra.getServer?.()?.fga;
-	if (!fgaProvider || !hasFGAUser(requestContext) || threads.length === 0) return threads;
-	return fgaProvider.filterAccessible(requestContext.get("user"), threads, "thread", MastraFGAPermissions.MEMORY_READ);
-}
-function paginateThreads({ threads, page, perPage }) {
-	const effectivePage = page ?? 0;
-	const effectivePerPage = perPage ?? 100;
-	if (effectivePerPage === false) return {
-		threads,
-		page: effectivePage,
-		perPage: false,
-		total: threads.length,
-		hasMore: false
-	};
-	const start = effectivePage * effectivePerPage;
-	const pagedThreads = threads.slice(start, start + effectivePerPage);
-	return {
-		threads: pagedThreads,
-		page: effectivePage,
-		perPage: effectivePerPage,
-		total: threads.length,
-		hasMore: start + pagedThreads.length < threads.length
-	};
-}
-async function enforceDeleteMessagesThreadAccess({ mastra, requestContext, memoryStore, messageIds, effectiveResourceId }) {
-	const { messages } = await memoryStore.listMessagesById({ messageIds });
-	const threadIds = [...new Set(messages.map((m) => m.threadId).filter(Boolean))];
-	if (messages.some((message) => !message.threadId)) throw new HTTPException(403, { message: "Access denied: unable to verify message thread access" });
-	for (const threadId of threadIds) {
-		const thread = await memoryStore.getThreadById({ threadId });
-		if (!thread) throw new HTTPException(403, { message: "Access denied: unable to verify message thread access" });
-		await enforceThreadAccess({
-			mastra,
-			requestContext,
-			threadId,
-			thread,
-			effectiveResourceId,
-			permission: MastraFGAPermissions.MEMORY_DELETE
-		});
-	}
-}
-function getTextContent(message) {
-	if (typeof message.content === "string") return message.content;
-	if (message.content && typeof message.content === "object" && "parts" in message.content) return message.content.parts.find((p) => p.type === "text")?.text || "";
-	return "";
-}
-async function getMemoryFromContext({ mastra, agentId, requestContext, allowMissingAgent = false }) {
-	const logger = mastra.getLogger();
-	let agent;
-	if (agentId) try {
-		agent = mastra.getAgentById(agentId);
-	} catch (error) {
-		logger.debug("Error getting agent from mastra, searching agents for agent", error);
-	}
-	if (agentId && !agent) {
-		logger.debug("Agent not found in registered agents, trying stored agents", { agentId });
-		try {
-			const storedAgent = await mastra.getEditor()?.agent.getById(agentId) ?? null;
-			if (storedAgent) agent = storedAgent;
-		} catch (error) {
-			logger.debug("Error getting stored agent", error);
-		}
-	}
-	if (agentId && !agent) {
-		logger.debug("Stored agent not found, searching sub-agents", { agentId });
-		const agents = mastra.listAgents();
-		if (Object.keys(agents || {}).length) for (const [_, ag] of Object.entries(agents)) try {
-			const subAgents = await ag.listAgents({ requestContext });
-			if (subAgents[agentId]) {
-				agent = subAgents[agentId];
-				break;
-			}
-		} catch (error) {
-			logger.debug("Error getting agent from agent", error);
-		}
-		if (!agent) {
-			if (allowMissingAgent) {
-				logger.debug("Agent not found in any resolution tier, returning null for storage fallback", { agentId });
-				return null;
-			}
-			throw new HTTPException(404, { message: "Agent not found" });
-		}
-	}
-	if (agent) return await agent?.getMemory({ requestContext });
-}
-/**
-* Gets the storage from context, used as a fallback when agent memory can't be resolved.
-* This covers both cases where no agentId is provided and where the agentId refers to
-* a stored agent whose memory instance can't be hydrated (e.g. no editor configured).
-*/
-function getStorageFromContext({ mastra }) {
-	return mastra.getStorage();
-}
-function agentSupportsMemory(agent) {
-	if (!agent) return true;
-	const candidate = agent;
-	if (typeof candidate.supportsMemory === "function" && !candidate.supportsMemory()) return false;
-	if (typeof candidate.hasOwnMemory === "function" && !candidate.hasOwnMemory()) return false;
-	return true;
-}
-/**
-* Gets the agent from context for OM processor detection.
-*/
-async function getAgentFromContext({ mastra, agentId, requestContext }) {
-	if (!agentId) return null;
-	const logger = mastra.getLogger();
-	let agent = null;
-	try {
-		agent = mastra.getAgentById(agentId);
-	} catch (error) {
-		logger.debug("Error getting agent from mastra", error);
-	}
-	if (!agent) {
-		logger.debug("Agent not found in registered agents, trying stored agents", { agentId });
-		try {
-			const storedAgent = await mastra.getEditor()?.agent.getById(agentId) ?? null;
-			if (storedAgent) agent = storedAgent;
-		} catch (error) {
-			logger.debug("Error getting stored agent", error);
-		}
-	}
-	if (!agent) {
-		logger.debug("Stored agent not found, searching sub-agents", { agentId });
-		const agents = mastra.listAgents();
-		if (Object.keys(agents || {}).length) for (const [_, ag] of Object.entries(agents)) try {
-			const nestedAgent = (await ag.listAgents({ requestContext }))[agentId];
-			if (nestedAgent instanceof Agent) {
-				agent = nestedAgent;
-				break;
-			}
-		} catch (error) {
-			logger.debug("Error getting agent from agent", error);
-		}
-	}
-	return agent;
-}
-/**
-* Gets Observational Memory configuration from an agent's processors.
-* Returns null if OM is not enabled.
-*/
-async function getOMConfigFromAgent(agent, requestContext) {
-	try {
-		if (typeof agent.resolveProcessorById !== "function") return null;
-		const omProcessor = await agent.resolveProcessorById("observational-memory", requestContext);
-		if (!omProcessor) return null;
-		if (typeof omProcessor.getResolvedConfig === "function") {
-			const resolvedConfig = await omProcessor.getResolvedConfig(requestContext);
-			return {
-				enabled: true,
-				scope: resolvedConfig.scope || "resource",
-				shareTokenBudget: resolvedConfig.shareTokenBudget,
-				messageTokens: resolvedConfig.observation?.messageTokens,
-				observationTokens: resolvedConfig.reflection?.observationTokens,
-				observationModel: resolvedConfig.observation?.model,
-				reflectionModel: resolvedConfig.reflection?.model,
-				observationModelRouting: resolvedConfig.observation?.routing,
-				reflectionModelRouting: resolvedConfig.reflection?.routing
-			};
-		}
-		const processorConfig = omProcessor.config || {};
-		return {
-			enabled: true,
-			scope: processorConfig.scope || "resource",
-			shareTokenBudget: processorConfig.shareTokenBudget,
-			messageTokens: processorConfig.observation?.messageTokens,
-			observationTokens: processorConfig.reflection?.observationTokens,
-			observationModel: void 0,
-			reflectionModel: void 0,
-			observationModelRouting: void 0,
-			reflectionModelRouting: void 0
-		};
-	} catch {
-		return null;
-	}
-}
-/**
-* Gets Observational Memory status for a specific resource/thread.
-*/
-async function getOMStatus(memoryStorage, resourceId, threadId) {
-	try {
-		const record = await memoryStorage.getObservationalMemory(threadId ?? null, resourceId);
-		if (!record) return { hasRecord: false };
-		return {
-			hasRecord: true,
-			originType: record.originType,
-			lastObservedAt: record.lastObservedAt ?? null,
-			tokenCount: record.totalTokensObserved,
-			observationTokenCount: record.observationTokenCount,
-			isObserving: record.isObserving,
-			isReflecting: record.isReflecting
-		};
-	} catch {
-		return null;
-	}
-}
-const GET_MEMORY_STATUS_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/status",
-	responseType: "json",
-	queryParamSchema: getMemoryStatusQuerySchema,
-	responseSchema: memoryStatusResponseSchema,
-	summary: "Get memory status",
-	description: "Returns the current status of the memory system including configuration and health information",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, threadId, requestContext }) => {
-		try {
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			const isGateway = agent ? await isGatewayAgentAsync(agent) : false;
-			if (agent && isGateway) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					let omStatus;
-					if (resourceId && threadId) try {
-						const { record } = await gwClient.getObservationRecord(threadId, resourceId);
-						if (record) omStatus = {
-							enabled: true,
-							hasRecord: true,
-							originType: record.originType,
-							lastObservedAt: record.lastObservedAt ? new Date(record.lastObservedAt) : void 0,
-							tokenCount: record.totalTokensObserved,
-							observationTokenCount: record.observationTokenCount,
-							isObserving: record.isObserving,
-							isReflecting: record.isReflecting
-						};
-						else omStatus = {
-							enabled: true,
-							hasRecord: false
-						};
-					} catch {
-						omStatus = { enabled: true };
-					}
-					else omStatus = { enabled: true };
-					return {
-						result: true,
-						memoryType: "gateway",
-						observationalMemory: omStatus
-					};
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (memory) {
-				let omStatus;
-				if (agent) {
-					const omConfig = await getOMConfigFromAgent(agent, requestContext);
-					if (omConfig?.enabled && resourceId) {
-						const omThreadId = omConfig.scope === "resource" ? void 0 : threadId;
-						try {
-							const memoryStore = await memory.storage.getStore("memory");
-							if (memoryStore) {
-								const status = await getOMStatus(memoryStore, resourceId, omThreadId);
-								if (status) omStatus = {
-									enabled: true,
-									...status,
-									lastObservedAt: status.lastObservedAt ?? void 0
-								};
-								else omStatus = {
-									enabled: true,
-									hasRecord: false
-								};
-							}
-						} catch {
-							omStatus = { enabled: true };
-						}
-					} else if (omConfig?.enabled) omStatus = { enabled: true };
-				}
-				return {
-					result: true,
-					memoryType: "local",
-					observationalMemory: omStatus
-				};
-			}
-			if (!agentSupportsMemory(agent)) return { result: false };
-			if (getStorageFromContext({ mastra })) return { result: true };
-			return { result: false };
-		} catch (error) {
-			return handleError(error, "Error getting memory status");
-		}
-	}
-});
-const GET_MEMORY_CONFIG_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/config",
-	responseType: "json",
-	queryParamSchema: getMemoryConfigQuerySchema,
-	responseSchema: memoryConfigResponseSchema,
-	summary: "Get memory configuration",
-	description: "Returns the memory configuration for a specific agent or the system default",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, requestContext }) => {
-		try {
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent) && getGatewayClient()) return {
-				memoryType: "gateway",
-				config: { observationalMemory: {
-					enabled: true,
-					scope: "thread",
-					messageTokens: 3e4,
-					observationTokens: 4e4
-				} }
-			};
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (!memory) return { config: null };
-			const config = memory.getMergedThreadConfig({});
-			let omConfig;
-			if (agent) omConfig = await getOMConfigFromAgent(agent, requestContext) ?? { enabled: false };
-			return { config: {
-				...config,
-				observationalMemory: omConfig
-			} };
-		} catch (error) {
-			return handleError(error, "Error getting memory configuration");
-		}
-	}
-});
-const GET_OBSERVATIONAL_MEMORY_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/observational-memory",
-	responseType: "json",
-	queryParamSchema: getObservationalMemoryQuerySchema,
-	responseSchema: getObservationalMemoryResponseSchema,
-	summary: "Get observational memory data",
-	description: "Returns the current observational memory record and optional history for a resource/thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, threadId, from, to, offset, limit, requestContext }) => {
-		try {
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!agent) throw new HTTPException(404, { message: "Agent not found" });
-			const historyLimit = limit ?? 5;
-			const historyOptions = {
-				from,
-				to,
-				offset
-			};
-			if (await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient && resourceId && threadId) {
-					const [recordResult, historyResult] = await Promise.all([gwClient.getObservationRecord(threadId, resourceId), gwClient.getObservationHistory(threadId, {
-						resourceId,
-						limit: historyLimit,
-						from,
-						to,
-						offset
-					})]);
-					return {
-						record: recordResult.record ? toLocalOMRecord(recordResult.record) : null,
-						history: historyResult.records?.length > 0 ? historyResult.records.map(toLocalOMRecord) : void 0
-					};
-				}
-				return {
-					record: null,
-					history: void 0
-				};
-			}
-			const omConfig = await getOMConfigFromAgent(agent, requestContext);
-			if (!omConfig?.enabled) throw new HTTPException(400, { message: "Observational Memory is not enabled for this agent" });
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not configured for this agent" });
-			let memoryStore;
-			try {
-				memoryStore = await memory.storage.getStore("memory");
-			} catch {
-				throw new HTTPException(400, { message: "Memory storage is not initialized" });
-			}
-			if (!memoryStore) throw new HTTPException(400, { message: "Memory storage is not initialized" });
-			const effectiveResourceId = resourceId;
-			if (!effectiveResourceId) throw new HTTPException(400, { message: "resourceId is required for observational memory lookup" });
-			const omThreadId = omConfig.scope === "resource" ? null : threadId ?? null;
-			const record = await memoryStore.getObservationalMemory(omThreadId, effectiveResourceId);
-			const history = await memoryStore.getObservationalMemoryHistory(omThreadId, effectiveResourceId, historyLimit, historyOptions);
-			return {
-				record: record ?? null,
-				history: history.length > 0 ? history : void 0
-			};
-		} catch (error) {
-			return handleError(error, "Error getting observational memory");
-		}
-	}
-});
-const AWAIT_BUFFER_STATUS_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/observational-memory/buffer-status",
-	responseType: "json",
-	bodySchema: awaitBufferStatusBodySchema,
-	responseSchema: awaitBufferStatusResponseSchema,
-	summary: "Await observational memory buffering completion",
-	description: "Blocks until any in-flight buffering operations complete for the given thread/resource, then returns the updated record",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, threadId, requestContext }) => {
-		try {
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!agent) throw new HTTPException(404, { message: "Agent not found" });
-			if (await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient && resourceId && threadId) {
-					const maxWaitMs = 3e4;
-					const pollIntervalMs = 1e3;
-					const deadline = Date.now() + maxWaitMs;
-					let record = null;
-					while (Date.now() < deadline) {
-						const result = await gwClient.getObservationRecord(threadId, resourceId);
-						record = result.record ? toLocalOMRecord(result.record) : null;
-						if (!record || !record.isBufferingObservation && !record.isBufferingReflection) break;
-						await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-					}
-					return { record };
-				}
-				return { record: null };
-			}
-			const omConfig = await getOMConfigFromAgent(agent, requestContext);
-			if (!omConfig?.enabled) throw new HTTPException(400, { message: "Observational Memory is not enabled for this agent" });
-			const omProcessor = await agent.resolveProcessorById("observational-memory", requestContext);
-			if (!omProcessor || typeof omProcessor.waitForBuffering !== "function") throw new HTTPException(400, { message: "Observational Memory processor not available" });
-			await omProcessor.waitForBuffering(threadId, resourceId);
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not configured for this agent" });
-			let memoryStore;
-			try {
-				memoryStore = await memory.storage.getStore("memory");
-			} catch {
-				throw new HTTPException(400, { message: "Memory storage is not initialized" });
-			}
-			if (!memoryStore) throw new HTTPException(400, { message: "Memory storage is not initialized" });
-			const effectiveResourceId = resourceId;
-			if (!effectiveResourceId) throw new HTTPException(400, { message: "resourceId is required" });
-			const omThreadId = omConfig.scope === "resource" ? null : threadId ?? null;
-			return { record: await memoryStore.getObservationalMemory(omThreadId, effectiveResourceId) ?? null };
-		} catch (error) {
-			console.error("Error awaiting buffer status", error);
-			return handleError(error, "Error awaiting buffer status");
-		}
-	}
-});
-const LIST_THREADS_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/threads",
-	responseType: "json",
-	queryParamSchema: listThreadsQuerySchema,
-	responseSchema: listThreadsResponseSchema,
-	summary: "List memory threads",
-	description: "Returns a paginated list of conversation threads with optional filtering by resource ID and/or metadata",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, metadata, requestContext, page, perPage, orderBy }) => {
-		try {
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			const isGateway = agent ? await isGatewayAgentAsync(agent) : false;
-			if (agent && isGateway) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					if (shouldFilterThreadsWithFGA(mastra, requestContext)) {
-						const initialResult = await gwClient.listThreads({
-							resourceId: effectiveResourceId,
-							limit: 1,
-							offset: 0
-						});
-						return paginateThreads({
-							threads: await filterAccessibleThreads({
-								mastra,
-								requestContext,
-								threads: initialResult.total > 0 ? (await gwClient.listThreads({
-									resourceId: effectiveResourceId,
-									limit: initialResult.total,
-									offset: 0
-								})).threads.map(toLocalThread) : []
-							}),
-							page,
-							perPage
-						});
-					}
-					const effectivePage = page ?? 0;
-					const effectivePerPage = perPage ?? 100;
-					const offset = effectivePage * effectivePerPage;
-					const result = await gwClient.listThreads({
-						resourceId: effectiveResourceId,
-						limit: effectivePerPage,
-						offset
-					});
-					return {
-						threads: result.threads.map(toLocalThread),
-						page: effectivePage,
-						perPage: effectivePerPage,
-						total: result.total,
-						hasMore: offset + result.threads.length < result.total
-					};
-				}
-			}
-			const filter = effectiveResourceId || metadata ? {} : void 0;
-			if (effectiveResourceId) filter.resourceId = effectiveResourceId;
-			if (metadata) filter.metadata = metadata;
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (memory) {
-				const result = await memory.listThreads(shouldFilterThreadsWithFGA(mastra, requestContext) ? {
-					filter,
-					perPage: false,
-					orderBy
-				} : {
-					filter,
-					page,
-					perPage,
-					orderBy
-				});
-				if (!shouldFilterThreadsWithFGA(mastra, requestContext)) return result;
-				return paginateThreads({
-					threads: await filterAccessibleThreads({
-						mastra,
-						requestContext,
-						threads: result.threads
-					}),
-					page,
-					perPage
-				});
-			}
-			const storage = getStorageFromContext({ mastra });
-			if (storage) {
-				const memoryStore = await storage.getStore("memory");
-				if (memoryStore) {
-					const result = await memoryStore.listThreads(shouldFilterThreadsWithFGA(mastra, requestContext) ? {
-						filter,
-						perPage: false,
-						orderBy
-					} : {
-						filter,
-						page,
-						perPage,
-						orderBy
-					});
-					if (!shouldFilterThreadsWithFGA(mastra, requestContext)) return result;
-					return paginateThreads({
-						threads: await filterAccessibleThreads({
-							mastra,
-							requestContext,
-							threads: result.threads
-						}),
-						page,
-						perPage
-					});
-				}
-			}
-			throw new HTTPException(400, { message: "Memory is not initialized" });
-		} catch (error) {
-			return handleError(error, "Error listing threads");
-		}
-	}
-});
-const GET_THREAD_BY_ID_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: getThreadByIdQuerySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Get thread by ID",
-	description: "Returns details for a specific conversation thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, resourceId, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({ threadId: effectiveThreadId });
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			const isGateway = agent ? await isGatewayAgentAsync(agent) : false;
-			if (agent && isGateway) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					const result = await gwClient.getThread(effectiveThreadId);
-					if (!result) return {
-						id: effectiveThreadId,
-						resourceId: effectiveResourceId ?? "",
-						title: "",
-						metadata: {},
-						createdAt: /* @__PURE__ */ new Date(),
-						updatedAt: /* @__PURE__ */ new Date()
-					};
-					const thread = toLocalThread(result.thread);
-					await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread,
-						effectiveResourceId
-					});
-					return thread;
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (memory) {
-				const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-				if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-				await enforceThreadAccess({
-					mastra,
-					requestContext,
-					threadId: effectiveThreadId,
-					thread,
-					effectiveResourceId
-				});
-				return thread;
-			}
-			const storage = getStorageFromContext({ mastra });
-			if (storage) {
-				const memoryStore = await storage.getStore("memory");
-				if (memoryStore) {
-					const thread = await memoryStore.getThreadById({ threadId: effectiveThreadId });
-					if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-					await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread,
-						effectiveResourceId
-					});
-					return thread;
-				}
-			}
-			throw new HTTPException(400, { message: "Memory is not initialized" });
-		} catch (error) {
-			return handleError(error, "Error getting thread");
-		}
-	}
-});
-const LIST_MESSAGES_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/threads/:threadId/messages",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: listMessagesQuerySchema,
-	responseSchema: listMessagesResponseSchema,
-	summary: "List thread messages",
-	description: "Returns a paginated list of messages in a conversation thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: (async ({ mastra, agentId, threadId, resourceId, perPage, page, orderBy, include, filter, includeSystemReminders, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({ threadId: effectiveThreadId });
-			if (!effectiveThreadId) throw new HTTPException(400, { message: "No threadId found" });
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					if (filter?.metadata && Object.keys(filter.metadata).length > 0) throw new HTTPException(501, { message: "Gateway memory message metadata filters are not supported by this gateway endpoint. Remove filter.metadata or query a local memory store." });
-					const threadResult = await gwClient.getThread(effectiveThreadId);
-					if (threadResult) await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread: toLocalThread(threadResult.thread),
-						effectiveResourceId
-					});
-					const effectivePage = page ?? 0;
-					const effectivePerPage = perPage ?? 100;
-					const offset = effectivePage * effectivePerPage;
-					const result = await gwClient.listMessages(effectiveThreadId, {
-						limit: effectivePerPage,
-						offset,
-						order: orderBy?.direction?.toLowerCase()
-					});
-					if (!result) throw new HTTPException(404, { message: "Thread not found" });
-					return {
-						messages: result.messages.map(toLocalMessage),
-						uiMessages: result.messages.map(toLocalMessage)
-					};
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (memory) {
-				const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-				if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-				await enforceThreadAccess({
-					mastra,
-					requestContext,
-					threadId: effectiveThreadId,
-					thread,
-					effectiveResourceId
-				});
-				const result = await memory.recall({
-					threadId: effectiveThreadId,
-					resourceId: effectiveResourceId,
-					perPage,
-					page,
-					orderBy,
-					include,
-					filter,
-					includeSystemReminders
-				});
-				const uiMessages = result.uiMessages;
-				return {
-					...result,
-					uiMessages: Array.isArray(uiMessages) ? uiMessages : null
-				};
-			}
-			const storage = getStorageFromContext({ mastra });
-			if (storage) {
-				const memoryStore = await storage.getStore("memory");
-				if (memoryStore) {
-					const thread = await memoryStore.getThreadById({ threadId: effectiveThreadId });
-					if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-					await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread,
-						effectiveResourceId
-					});
-					return {
-						...await memoryStore.listMessages({
-							threadId: effectiveThreadId,
-							resourceId: effectiveResourceId,
-							perPage,
-							page,
-							orderBy,
-							include,
-							filter
-						}),
-						uiMessages: null
-					};
-				}
-			}
-			return {
-				messages: [],
-				uiMessages: []
-			};
-		} catch (error) {
-			return handleError(error, "Error getting messages");
-		}
-	})
-});
-const GET_WORKING_MEMORY_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/threads/:threadId/working-memory",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: getWorkingMemoryQuerySchema,
-	responseSchema: getWorkingMemoryResponseSchema,
-	summary: "Get working memory",
-	description: "Returns the working memory state for a thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, resourceId, requestContext, memoryConfig }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({ threadId: effectiveThreadId });
-			const gwAgent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (gwAgent && await isGatewayAgentAsync(gwAgent) && getGatewayClient()) return {
-				workingMemory: null,
-				source: "thread",
-				workingMemoryTemplate: null,
-				threadExists: true
-			};
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (!memory) return {
-				workingMemory: null,
-				source: "thread",
-				workingMemoryTemplate: null,
-				threadExists: false
-			};
-			const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-			const source = memory.getMergedThreadConfig(memoryConfig || {}).workingMemory?.scope !== "thread" && effectiveResourceId ? "resource" : "thread";
-			if (thread || source === "resource") await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread,
-				effectiveResourceId
-			});
-			const threadExists = !!thread;
-			const template = await memory.getWorkingMemoryTemplate({ memoryConfig });
-			const workingMemoryTemplate = template?.format === "json" ? {
-				...template,
-				content: JSON.stringify(generateEmptyFromSchema(template.content))
-			} : template;
-			return {
-				workingMemory: await memory.getWorkingMemory({
-					threadId: effectiveThreadId,
-					resourceId: effectiveResourceId,
-					memoryConfig
-				}),
-				source,
-				workingMemoryTemplate,
-				threadExists
-			};
-		} catch (error) {
-			return handleError(error, "Error getting working memory");
-		}
-	}
-});
-const SAVE_MESSAGES_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/save-messages",
-	responseType: "json",
-	queryParamSchema: agentIdQuerySchema,
-	bodySchema: saveMessagesBodySchema,
-	responseSchema: saveMessagesResponseSchema,
-	summary: "Save messages",
-	description: "Saves new messages to memory",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, messages, requestContext }) => {
-		try {
-			const effectiveResourceId = getEffectiveResourceId(requestContext, void 0);
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			if (!messages) throw new HTTPException(400, { message: "Messages are required" });
-			if (!Array.isArray(messages)) throw new HTTPException(400, { message: "Messages should be an array" });
-			const incomingMessages = messages;
-			const resourceIdByThread = /* @__PURE__ */ new Map();
-			for (const message of incomingMessages) {
-				if (!message.threadId || !message.resourceId) continue;
-				const existingResourceId = resourceIdByThread.get(message.threadId);
-				if (!existingResourceId) resourceIdByThread.set(message.threadId, message.resourceId);
-				else if (existingResourceId !== message.resourceId) throw new HTTPException(400, { message: "All messages for the same threadId must use the same resourceId." });
-			}
-			const invalidMessages = incomingMessages.filter((message) => !message.threadId || !message.resourceId);
-			if (invalidMessages.length > 0) throw new HTTPException(400, { message: `All messages must have threadId and resourceId fields. Found ${invalidMessages.length} invalid message(s).` });
-			if (effectiveResourceId) {
-				if (incomingMessages.filter((message) => message.resourceId !== effectiveResourceId).length > 0) throw new HTTPException(403, { message: "Access denied: cannot save messages for a different resource" });
-				const threadIds = [...new Set(incomingMessages.map((m) => m.threadId).filter(Boolean))];
-				for (const threadId of threadIds) await enforceThreadAccess({
-					mastra,
-					requestContext,
-					threadId,
-					thread: await memory.getThreadById({ threadId }),
-					effectiveResourceId,
-					permission: MastraFGAPermissions.MEMORY_WRITE
-				});
-			} else {
-				const threadIds = [...new Set(incomingMessages.map((m) => m.threadId).filter(Boolean))];
-				for (const threadId of threadIds) await enforceThreadAccess({
-					mastra,
-					requestContext,
-					threadId,
-					thread: await memory.getThreadById({ threadId }),
-					effectiveResourceId: resourceIdByThread.get(threadId),
-					permission: MastraFGAPermissions.MEMORY_WRITE
-				});
-			}
-			const processedMessages = incomingMessages.map((message) => ({
-				...message,
-				id: message.id || memory.generateId(),
-				createdAt: message.createdAt ? new Date(message.createdAt) : /* @__PURE__ */ new Date()
-			}));
-			return await memory.saveMessages({
-				messages: processedMessages,
-				memoryConfig: {}
-			});
-		} catch (error) {
-			return handleError(error, "Error saving messages");
-		}
-	}
-});
-const CREATE_THREAD_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/threads",
-	responseType: "json",
-	queryParamSchema: agentIdQuerySchema,
-	bodySchema: createThreadBodySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Create thread",
-	description: "Creates a new conversation thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, title, metadata, threadId, requestContext }) => {
-		try {
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			const effectiveThreadId = threadId ?? mastra.generateId();
-			validateBody({ resourceId: effectiveResourceId });
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					const existing = threadId ? await gwClient.getThread(effectiveThreadId) : null;
-					await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread: existing ? toLocalThread(existing.thread) : null,
-						effectiveResourceId,
-						permission: MastraFGAPermissions.MEMORY_WRITE
-					});
-					return toLocalThread((await gwClient.createThread({
-						id: effectiveThreadId,
-						resourceId: effectiveResourceId,
-						title,
-						metadata
-					})).thread);
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread: threadId ? await memory.getThreadById({ threadId: effectiveThreadId }) : null,
-				effectiveResourceId,
-				permission: MastraFGAPermissions.MEMORY_WRITE
-			});
-			return await memory.createThread({
-				resourceId: effectiveResourceId,
-				title,
-				metadata,
-				threadId: effectiveThreadId
-			});
-		} catch (error) {
-			return handleError(error, "Error saving thread to memory");
-		}
-	}
-});
-const UPDATE_THREAD_ROUTE = createRoute({
-	method: "PATCH",
-	path: "/memory/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: agentIdQuerySchema,
-	bodySchema: updateThreadBodySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Update thread",
-	description: "Updates a conversation thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, title, metadata, resourceId, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({ threadId: effectiveThreadId });
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					const existing = await gwClient.getThread(effectiveThreadId);
-					if (existing) await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread: toLocalThread(existing.thread),
-						effectiveResourceId,
-						permission: MastraFGAPermissions.MEMORY_WRITE
-					});
-					const result = await gwClient.updateThread(effectiveThreadId, {
-						title,
-						metadata
-					});
-					if (!result) throw new HTTPException(404, { message: "Thread not found" });
-					return toLocalThread(result.thread);
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			const updatedAt = /* @__PURE__ */ new Date();
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-			if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread,
-				effectiveResourceId,
-				permission: MastraFGAPermissions.MEMORY_WRITE
-			});
-			const updatedThread = {
-				...thread,
-				title: title !== void 0 ? title : thread.title,
-				metadata: metadata !== void 0 ? metadata : thread.metadata,
-				resourceId: effectiveResourceId || resourceId || thread.resourceId,
-				createdAt: thread.createdAt,
-				updatedAt
-			};
-			const result = await memory.saveThread({ thread: updatedThread });
-			return {
-				...result,
-				resourceId: result.resourceId ?? null
-			};
-		} catch (error) {
-			return handleError(error, "Error updating thread");
-		}
-	}
-});
-const DELETE_THREAD_ROUTE = createRoute({
-	method: "DELETE",
-	path: "/memory/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: deleteThreadQuerySchema,
-	responseSchema: deleteThreadResponseSchema,
-	summary: "Delete thread",
-	description: "Deletes a conversation thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, resourceId, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({ threadId: effectiveThreadId });
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent)) {
-				const gwClient = getGatewayClient();
-				if (gwClient) {
-					const existing = await gwClient.getThread(effectiveThreadId);
-					if (existing) await enforceThreadAccess({
-						mastra,
-						requestContext,
-						threadId: effectiveThreadId,
-						thread: toLocalThread(existing.thread),
-						effectiveResourceId,
-						permission: MastraFGAPermissions.MEMORY_DELETE
-					});
-					if (!(await gwClient.deleteThread(effectiveThreadId)).ok) throw new HTTPException(404, { message: "Thread not found on gateway" });
-					return { result: "Thread deleted" };
-				}
-			}
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-			if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread,
-				effectiveResourceId,
-				permission: MastraFGAPermissions.MEMORY_DELETE
-			});
-			await memory.deleteThread(effectiveThreadId);
-			return { result: "Thread deleted" };
-		} catch (error) {
-			return handleError(error, "Error deleting thread");
-		}
-	}
-});
-const CLONE_THREAD_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/threads/:threadId/clone",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: agentIdQuerySchema,
-	bodySchema: cloneThreadBodySchema,
-	responseSchema: cloneThreadResponseSchema,
-	summary: "Clone thread",
-	description: "Creates a copy of a conversation thread with all its messages",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, newThreadId, resourceId, title, metadata, options, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			const effectiveNewThreadId = newThreadId ?? mastra.generateId();
-			validateBody({ threadId: effectiveThreadId });
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const sourceThread = await memory.getThreadById({ threadId: effectiveThreadId });
-			if (!sourceThread) throw new HTTPException(404, { message: "Source thread not found" });
-			const cloneResourceId = effectiveResourceId ?? sourceThread.resourceId ?? void 0;
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread: sourceThread,
-				effectiveResourceId
-			});
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveNewThreadId,
-				effectiveResourceId: cloneResourceId,
-				permission: MastraFGAPermissions.MEMORY_WRITE
-			});
-			return await memory.cloneThread({
-				sourceThreadId: effectiveThreadId,
-				newThreadId: effectiveNewThreadId,
-				resourceId: cloneResourceId,
-				title,
-				metadata,
-				options
-			});
-		} catch (error) {
-			return handleError(error, "Error cloning thread");
-		}
-	}
-});
-const TRANSFER_THREAD_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/threads/:threadId/transfer",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: optionalAgentIdQuerySchema,
-	bodySchema: transferThreadBodySchema,
-	responseSchema: transferThreadResponseSchema,
-	summary: "Transfer thread ownership",
-	description: "Reassigns a thread and all of its messages to a different resource. Requires a privileged (non-resource-scoped) context.",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, resourceId, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			validateBody({ threadId: effectiveThreadId });
-			if (getContextResourceId(requestContext)) throw new HTTPException(403, { message: "Thread transfer requires a privileged (non-resource-scoped) context" });
-			const server = mastra.getServer?.();
-			if (server?.auth && !server?.fga) throw new HTTPException(403, { message: "Thread transfer requires explicit authorization. Configure an FGA provider (memory:write) to authorize privileged, non-resource-scoped transfers." });
-			const agent = agentId ? await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			}) : void 0;
-			if (agent && await isGatewayAgentAsync(agent)) throw new HTTPException(501, { message: "Thread transfer is not supported for gateway agents" });
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			const memoryStore = memory ? void 0 : await getStorageFromContext({ mastra })?.getStore("memory");
-			if (!memory && !memoryStore) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const sourceThread = memory ? await memory.getThreadById({ threadId: effectiveThreadId }) : await memoryStore.getThreadById({ threadId: effectiveThreadId });
-			if (!sourceThread) throw new HTTPException(404, { message: "Thread not found" });
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread: sourceThread,
-				effectiveResourceId: void 0,
-				permission: MastraFGAPermissions.MEMORY_WRITE
-			});
-			const result = memory ? await memory.updateThreadResourceId({
-				threadId: effectiveThreadId,
-				resourceId
-			}) : await memoryStore.updateThreadResourceId({
-				threadId: effectiveThreadId,
-				resourceId
-			});
-			return {
-				...result,
-				resourceId: result.resourceId ?? null
-			};
-		} catch (error) {
-			return handleError(error, "Error transferring thread");
-		}
-	}
-});
-const UPDATE_WORKING_MEMORY_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/threads/:threadId/working-memory",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: agentIdQuerySchema,
-	bodySchema: updateWorkingMemoryBodySchema,
-	responseSchema: updateWorkingMemoryResponseSchema,
-	summary: "Update working memory",
-	description: "Updates the working memory state for a thread",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, threadId, resourceId, memoryConfig, workingMemory, mode, requestContext }) => {
-		try {
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			validateBody({
-				threadId: effectiveThreadId,
-				workingMemory
-			});
-			const gwAgent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (gwAgent && await isGatewayAgentAsync(gwAgent) && getGatewayClient()) return { success: true };
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-			if (!thread) throw new HTTPException(404, { message: "Thread not found" });
-			await enforceThreadAccess({
-				mastra,
-				requestContext,
-				threadId: effectiveThreadId,
-				thread,
-				effectiveResourceId,
-				permission: MastraFGAPermissions.MEMORY_WRITE
-			});
-			if (mode === "merge") {
-				if (!await memory.supportsAtomicWorkingMemoryMerge()) throw new HTTPException(400, { message: "Working memory merge is not supported by the configured storage adapter" });
-				try {
-					await memory.mergeWorkingMemory({
-						threadId: effectiveThreadId,
-						resourceId: effectiveResourceId,
-						workingMemory,
-						memoryConfig
-					});
-				} catch (error) {
-					if (error instanceof MastraError && error.category === ErrorCategory.USER) throw new HTTPException(400, { message: error.message });
-					throw error;
-				}
-				return { success: true };
-			}
-			await memory.updateWorkingMemory({
-				threadId: effectiveThreadId,
-				resourceId: effectiveResourceId,
-				workingMemory,
-				memoryConfig
-			});
-			return { success: true };
-		} catch (error) {
-			return handleError(error, "Error updating working memory");
-		}
-	}
-});
-const DELETE_MESSAGES_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/messages/delete",
-	responseType: "json",
-	queryParamSchema: deleteMessagesQuerySchema,
-	bodySchema: deleteMessagesBodySchema,
-	responseSchema: deleteMessagesResponseSchema,
-	summary: "Delete messages",
-	description: "Deletes specific messages from memory",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, resourceId, messageIds, requestContext }) => {
-		try {
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			if (messageIds === void 0 || messageIds === null) throw new HTTPException(400, { message: "messageIds is required" });
-			let normalizedIds;
-			if (Array.isArray(messageIds)) normalizedIds = messageIds;
-			else if (typeof messageIds === "string") normalizedIds = [messageIds];
-			else normalizedIds = [messageIds];
-			const stringIds = normalizedIds.map((id) => typeof id === "string" ? id : id.id);
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext,
-				allowMissingAgent: true
-			});
-			if (effectiveResourceId && stringIds.length > 0) {
-				const storage = memory?.storage || getStorageFromContext({ mastra });
-				if (!storage) throw new HTTPException(403, { message: "Access denied: unable to verify message ownership" });
-				const memoryStore = await storage.getStore("memory");
-				if (!memoryStore) throw new HTTPException(400, { message: "Memory is not initialized" });
-				await enforceDeleteMessagesThreadAccess({
-					mastra,
-					requestContext,
-					memoryStore,
-					messageIds: stringIds,
-					effectiveResourceId
-				});
-			} else if (stringIds.length > 0) {
-				const storage = memory?.storage || getStorageFromContext({ mastra });
-				if (!storage) throw new HTTPException(400, { message: "Memory is not initialized" });
-				const memoryStore = await storage.getStore("memory");
-				if (!memoryStore) throw new HTTPException(400, { message: "Memory is not initialized" });
-				await enforceDeleteMessagesThreadAccess({
-					mastra,
-					requestContext,
-					memoryStore,
-					messageIds: stringIds
-				});
-			}
-			if (memory) await memory.deleteMessages(normalizedIds);
-			else {
-				const storage = getStorageFromContext({ mastra });
-				if (storage) {
-					const memoryStore = await storage.getStore("memory");
-					if (memoryStore) await memoryStore.deleteMessages(stringIds);
-					else throw new HTTPException(400, { message: "Memory is not initialized" });
-				} else throw new HTTPException(400, { message: "Memory is not initialized" });
-			}
-			const count = Array.isArray(messageIds) ? messageIds.length : 1;
-			return {
-				success: true,
-				message: `${count} message${count === 1 ? "" : "s"} deleted successfully`
-			};
-		} catch (error) {
-			return handleError(error, "Error deleting messages");
-		}
-	}
-});
-const SEARCH_MEMORY_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/search",
-	responseType: "json",
-	queryParamSchema: searchMemoryQuerySchema,
-	responseSchema: searchMemoryResponseSchema,
-	summary: "Search memory",
-	description: "Searches across memory using semantic or text search",
-	tags: ["Memory"],
-	requiresAuth: true,
-	handler: async ({ mastra, agentId, searchQuery, resourceId, threadId, limit = 20, requestContext, memoryConfig }) => {
-		try {
-			const effectiveResourceId = getEffectiveResourceId(requestContext, resourceId);
-			const effectiveThreadId = getEffectiveThreadId(requestContext, threadId);
-			validateBody({
-				searchQuery,
-				resourceId: effectiveResourceId
-			});
-			const agent = await getAgentFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (agent && await isGatewayAgentAsync(agent) && getGatewayClient()) return {
-				results: [],
-				count: 0,
-				query: searchQuery,
-				searchScope: "resource",
-				searchType: "semantic"
-			};
-			const memory = await getMemoryFromContext({
-				mastra,
-				agentId,
-				requestContext
-			});
-			if (!memory) throw new HTTPException(400, { message: "Memory is not initialized" });
-			const config = memory.getMergedThreadConfig(memoryConfig || {});
-			const hasSemanticRecall = !!config?.semanticRecall;
-			const resourceScope = typeof config?.semanticRecall === "object" ? config?.semanticRecall?.scope !== "thread" : true;
-			const searchResults = [];
-			let accessibleThreadsForResource;
-			let accessibleThreadIds;
-			if (resourceScope && effectiveResourceId && shouldFilterThreadsWithFGA(mastra, requestContext)) {
-				const { threads } = await memory.listThreads({
-					filter: { resourceId: effectiveResourceId },
-					perPage: false,
-					orderBy: {
-						field: "updatedAt",
-						direction: "DESC"
-					}
-				});
-				accessibleThreadsForResource = await filterAccessibleThreads({
-					mastra,
-					requestContext,
-					threads
-				});
-				accessibleThreadIds = new Set(accessibleThreadsForResource.map((thread) => thread.id));
-				if (accessibleThreadsForResource.length === 0) return {
-					results: [],
-					count: 0,
-					query: searchQuery,
-					searchScope: resourceScope ? "resource" : "thread",
-					searchType: hasSemanticRecall ? "semantic" : "text"
-				};
-			}
-			if (effectiveThreadId && !resourceScope) {
-				const thread = await memory.getThreadById({ threadId: effectiveThreadId });
-				if (!thread) return {
-					results: [],
-					count: 0,
-					query: searchQuery,
-					searchScope: resourceScope ? "resource" : "thread",
-					searchType: hasSemanticRecall ? "semantic" : "text"
-				};
-				await enforceThreadAccess({
-					mastra,
-					requestContext,
-					threadId: effectiveThreadId,
-					thread,
-					effectiveResourceId
-				});
-			}
-			let searchThreadId = effectiveThreadId;
-			if (!searchThreadId) {
-				const threads = accessibleThreadsForResource ?? (await memory.listThreads({
-					filter: { resourceId: effectiveResourceId },
-					page: 0,
-					perPage: 1,
-					orderBy: {
-						field: "updatedAt",
-						direction: "DESC"
-					}
-				})).threads;
-				if (threads.length === 0) return {
-					results: [],
-					count: 0,
-					query: searchQuery,
-					searchScope: resourceScope ? "resource" : "thread",
-					searchType: hasSemanticRecall ? "semantic" : "text"
-				};
-				searchThreadId = threads[0].id;
-			}
-			const beforeRange = typeof config.semanticRecall === `boolean` ? 2 : typeof config.semanticRecall?.messageRange === `number` ? config.semanticRecall.messageRange : config.semanticRecall?.messageRange.before || 2;
-			const afterRange = typeof config.semanticRecall === `boolean` ? 2 : typeof config.semanticRecall?.messageRange === `number` ? config.semanticRecall.messageRange : config.semanticRecall?.messageRange.after || 2;
-			if (resourceScope && config.semanticRecall) config.semanticRecall = typeof config.semanticRecall === `boolean` ? {
-				messageRange: 0,
-				topK: 2,
-				scope: "resource"
-			} : {
-				...config.semanticRecall,
-				messageRange: 0
-			};
-			const threadConfig = memory.getMergedThreadConfig(config || {});
-			if (!(threadConfig.lastMessages !== false && (threadConfig.lastMessages || threadConfig.messageHistory)) && !threadConfig.semanticRecall) return {
-				results: [],
-				count: 0,
-				query: searchQuery
-			};
-			const result = await memory.recall({
-				threadId: searchThreadId,
-				resourceId: effectiveResourceId,
-				threadConfig: config,
-				vectorSearchString: threadConfig.semanticRecall && searchQuery ? searchQuery : void 0
-			});
-			const accessibleMessages = accessibleThreadIds ? result.messages.filter((message) => accessibleThreadIds.has(message.threadId || searchThreadId)) : result.messages;
-			if (accessibleMessages.length === 0) return {
-				results: [],
-				count: 0,
-				query: searchQuery,
-				searchScope: resourceScope ? "resource" : "thread",
-				searchType: hasSemanticRecall ? "semantic" : "text"
-			};
-			const threadIds = Array.from(new Set(accessibleMessages.map((m) => m.threadId || searchThreadId).filter(Boolean)));
-			const fetched = await Promise.all(threadIds.map((id) => memory.getThreadById({ threadId: id })));
-			const threadMap = new Map(fetched.filter(Boolean).map((t) => [t.id, t]));
-			for (const msg of accessibleMessages) {
-				const content = getTextContent(msg);
-				const msgThreadId = msg.threadId || searchThreadId;
-				const thread = threadMap.get(msgThreadId);
-				const threadMessages = (await memory.recall({ threadId: msgThreadId })).messages;
-				const messageIndex = threadMessages.findIndex((m) => m.id === msg.id);
-				const searchResult = {
-					id: msg.id,
-					role: msg.role,
-					content,
-					createdAt: msg.createdAt,
-					threadId: msgThreadId,
-					threadTitle: thread?.title || msgThreadId
-				};
-				if (messageIndex !== -1) searchResult.context = {
-					before: threadMessages.slice(Math.max(0, messageIndex - beforeRange), messageIndex).map((m) => ({
-						id: m.id,
-						role: m.role,
-						content: getTextContent(m),
-						createdAt: m.createdAt || /* @__PURE__ */ new Date()
-					})),
-					after: threadMessages.slice(messageIndex + 1, messageIndex + afterRange + 1).map((m) => ({
-						id: m.id,
-						role: m.role,
-						content: getTextContent(m),
-						createdAt: m.createdAt || /* @__PURE__ */ new Date()
-					}))
-				};
-				searchResults.push(searchResult);
-			}
-			const sortedResults = searchResults.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()).slice(0, limit);
-			return {
-				results: sortedResults,
-				count: sortedResults.length,
-				query: searchQuery,
-				searchScope: resourceScope ? "resource" : "thread",
-				searchType: hasSemanticRecall ? "semantic" : "text"
-			};
-		} catch (error) {
-			return handleError(error, "Error searching memory");
-		}
-	}
-});
-const GET_MEMORY_STATUS_NETWORK_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/network/status",
-	responseType: "json",
-	queryParamSchema: getMemoryStatusNetworkQuerySchema,
-	responseSchema: memoryStatusResponseSchema,
-	summary: "Get memory status (network)",
-	description: "Returns the current status of the memory system (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: GET_MEMORY_STATUS_ROUTE.handler
-});
-const LIST_THREADS_NETWORK_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/network/threads",
-	responseType: "json",
-	queryParamSchema: listThreadsNetworkQuerySchema,
-	responseSchema: listThreadsResponseSchema,
-	summary: "List memory threads (network)",
-	description: "Returns a paginated list of conversation threads (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: LIST_THREADS_ROUTE.handler
-});
-const GET_THREAD_BY_ID_NETWORK_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/network/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: getThreadByIdNetworkQuerySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Get thread by ID (network)",
-	description: "Returns details for a specific conversation thread (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: GET_THREAD_BY_ID_ROUTE.handler
-});
-const LIST_MESSAGES_NETWORK_ROUTE = createRoute({
-	method: "GET",
-	path: "/memory/network/threads/:threadId/messages",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: listMessagesNetworkQuerySchema,
-	responseSchema: listMessagesResponseSchema,
-	summary: "List thread messages (network)",
-	description: "Returns a paginated list of messages in a conversation thread (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: LIST_MESSAGES_ROUTE.handler
-});
-const SAVE_MESSAGES_NETWORK_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/network/save-messages",
-	responseType: "json",
-	queryParamSchema: saveMessagesNetworkQuerySchema,
-	bodySchema: saveMessagesBodySchema,
-	responseSchema: saveMessagesResponseSchema,
-	summary: "Save messages (network)",
-	description: "Saves new messages to memory (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: SAVE_MESSAGES_ROUTE.handler
-});
-const CREATE_THREAD_NETWORK_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/network/threads",
-	responseType: "json",
-	queryParamSchema: createThreadNetworkQuerySchema,
-	bodySchema: createThreadBodySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Create thread (network)",
-	description: "Creates a new conversation thread (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: CREATE_THREAD_ROUTE.handler
-});
-const UPDATE_THREAD_NETWORK_ROUTE = createRoute({
-	method: "PATCH",
-	path: "/memory/network/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: updateThreadNetworkQuerySchema,
-	bodySchema: updateThreadBodySchema,
-	responseSchema: getThreadByIdResponseSchema,
-	summary: "Update thread (network)",
-	description: "Updates a conversation thread (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: UPDATE_THREAD_ROUTE.handler
-});
-const DELETE_THREAD_NETWORK_ROUTE = createRoute({
-	method: "DELETE",
-	path: "/memory/network/threads/:threadId",
-	responseType: "json",
-	pathParamSchema: threadIdPathParams,
-	queryParamSchema: deleteThreadNetworkQuerySchema,
-	responseSchema: deleteThreadResponseSchema,
-	summary: "Delete thread (network)",
-	description: "Deletes a conversation thread (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: DELETE_THREAD_ROUTE.handler
-});
-const DELETE_MESSAGES_NETWORK_ROUTE = createRoute({
-	method: "POST",
-	path: "/memory/network/messages/delete",
-	responseType: "json",
-	queryParamSchema: deleteMessagesNetworkQuerySchema,
-	bodySchema: deleteMessagesBodySchema,
-	responseSchema: deleteMessagesResponseSchema,
-	summary: "Delete messages (network)",
-	description: "Deletes specific messages from memory (network route)",
-	tags: ["Memory - Network"],
-	requiresAuth: true,
-	handler: DELETE_MESSAGES_ROUTE.handler
-});
-//#endregion
-export { AWAIT_BUFFER_STATUS_ROUTE, CLONE_THREAD_ROUTE, CREATE_THREAD_NETWORK_ROUTE, CREATE_THREAD_ROUTE, DELETE_MESSAGES_NETWORK_ROUTE, DELETE_MESSAGES_ROUTE, DELETE_THREAD_NETWORK_ROUTE, DELETE_THREAD_ROUTE, GET_MEMORY_CONFIG_ROUTE, GET_MEMORY_STATUS_NETWORK_ROUTE, GET_MEMORY_STATUS_ROUTE, GET_OBSERVATIONAL_MEMORY_ROUTE, GET_THREAD_BY_ID_NETWORK_ROUTE, GET_THREAD_BY_ID_ROUTE, GET_WORKING_MEMORY_ROUTE, LIST_MESSAGES_NETWORK_ROUTE, LIST_MESSAGES_ROUTE, LIST_THREADS_NETWORK_ROUTE, LIST_THREADS_ROUTE, SAVE_MESSAGES_NETWORK_ROUTE, SAVE_MESSAGES_ROUTE, SEARCH_MEMORY_ROUTE, TRANSFER_THREAD_ROUTE, UPDATE_THREAD_NETWORK_ROUTE, UPDATE_THREAD_ROUTE, UPDATE_WORKING_MEMORY_ROUTE, getTextContent, memory_exports as t };
-
-//# sourceMappingURL=memory.js.map
+export { t as AWAIT_BUFFER_STATUS_ROUTE, n as CLONE_THREAD_ROUTE, r as CREATE_THREAD_NETWORK_ROUTE, i as CREATE_THREAD_ROUTE, a as DELETE_MESSAGES_NETWORK_ROUTE, o as DELETE_MESSAGES_ROUTE, s as DELETE_THREAD_NETWORK_ROUTE, c as DELETE_THREAD_ROUTE, l as GET_MEMORY_CONFIG_ROUTE, u as GET_MEMORY_STATUS_NETWORK_ROUTE, d as GET_MEMORY_STATUS_ROUTE, f as GET_OBSERVATIONAL_MEMORY_ROUTE, p as GET_THREAD_BY_ID_NETWORK_ROUTE, m as GET_THREAD_BY_ID_ROUTE, h as GET_WORKING_MEMORY_ROUTE, g as LIST_MESSAGES_NETWORK_ROUTE, _ as LIST_MESSAGES_ROUTE, v as LIST_THREADS_NETWORK_ROUTE, y as LIST_THREADS_ROUTE, b as SAVE_MESSAGES_NETWORK_ROUTE, x as SAVE_MESSAGES_ROUTE, S as SEARCH_MEMORY_ROUTE, C as TRANSFER_THREAD_ROUTE, w as UPDATE_THREAD_NETWORK_ROUTE, T as UPDATE_THREAD_ROUTE, E as UPDATE_WORKING_MEMORY_ROUTE, D as getTextContent } from "../../memory-BHtTSzvJ.js";