npm - @mastra/server - Versions diffs - 1.82.0-alpha.3 → 1.83.0-alpha.0 - Mend

@mastra/server 1.82.0-alpha.3 → 1.83.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (395) hide show

package/dist/{mcp-BkmWZD6M.js.map → mcp-CntC59iU.js.map} RENAMED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mcp-BkmWZD6M.js","names":[],"sources":["../src/server/handlers/mcp.ts"],"sourcesContent":["import { MastraError } from '@mastra/core/error';\nimport type { Mastra } from '@mastra/core/mastra';\nimport type {\n MCP_SERVER_EVENT_ERROR_IDS,\n MCPServerBase as MastraMCPServerImplementation,\n MCPServerEventStreamFrame,\n MCPServerEventsInspector,\n MCPServerTasksInspector,\n MCPToolExecutionResultV2,\n ServerInfo,\n} from '@mastra/core/mcp';\nimport type { z } from 'zod';\nimport { HTTPException } from '../http-exception';\nimport {\n mcpServerDetailPathParams,\n mcpServerToolPathParams,\n executeToolBodySchema,\n listMcpServersQuerySchema,\n getMcpServerDetailQuerySchema,\n listMcpServersResponseSchema,\n serverDetailSchema,\n mcpServerIdPathParams,\n listMcpServerToolsResponseSchema,\n mcpToolInfoSchema,\n executeToolResponseSchema,\n mcpServerResourcePathParams,\n readResourceBodySchema,\n readResourceResponseSchema,\n listResourcesResponseSchema,\n mcpServerEventPathParams,\n listMcpServerEventsResponseSchema,\n pollMcpServerEventBodySchema,\n pollMcpServerEventResponseSchema,\n streamMcpServerEventBodySchema,\n mcpServerEventStreamFrameSchema,\n emitMcpServerEventBodySchema,\n emitMcpServerEventResponseSchema,\n mcpServerTaskPathParams,\n DEFAULT_MCP_SERVER_TASKS_LIMIT,\n listMcpServerTasksQuerySchema,\n listMcpServerTasksResponseSchema,\n findMcpServerTaskBodySchema,\n findMcpServerTaskResponseSchema,\n answerMcpServerTaskBodySchema,\n mcpServerTaskActionResponseSchema,\n} from '../schemas/mcp';\nimport type { MCPServerTransport } from '../schemas/mcp';\nimport type { ServerContext } from '../server-adapter';\nimport type { SetMcpRequestAuth } from '../server-adapter/mcp-auth';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { getContextResourceId } from './utils';\n\n// ============================================================================\n// Route Definitions (createRoute pattern for server adapters)\n// ============================================================================\n\n/*\n Only `@mastra/mcp` 1.x servers implement the standalone HTTP+SSE transport; on a\n * 2026-07-28 server the inherited `startSSE`/`startHonoSSE` throw.\n /\nfunction hasSSETransport(server: MastraMCPServerImplementation): boolean {\n return server.mcpVersion !== 2;\n}\n\nexport interface MCPServerInfoResponse extends ServerInfo {\n /* Endpoints served under `/mcp/:serverId`; 2026-07-28 servers speak Streamable HTTP only. /\n transports: MCPServerTransport[];\n events_capability?: boolean;\n tasks_capability?: boolean;\n}\n\nfunction transportsOf(server: MastraMCPServerImplementation): MCPServerTransport[] {\n return hasSSETransport(server) ? ['streamable-http', 'sse'] : ['streamable-http'];\n}\n\nexport const LIST_MCP_SERVERS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/v0/servers',\n responseType: 'json',\n queryParamSchema: listMcpServersQuerySchema,\n responseSchema: listMcpServersResponseSchema,\n summary: 'List MCP servers',\n description: 'Returns a list of registered MCP servers with pagination support',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n routePrefix,\n page,\n perPage,\n limit,\n offset,\n }: ServerContext & { page?: number; perPage?: number; limit?: number; offset?: number }) => {\n if (!mastra \|\| typeof mastra.listMCPServers !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or listMCPServers method not available' });\n }\n\n const servers = mastra.listMCPServers();\n\n if (!servers) {\n return { servers: [], total_count: 0, next: null };\n }\n\n const serverList = Object.values(servers);\n const totalCount = serverList.length;\n\n // Support both page/perPage and limit/offset for backwards compatibility\n // Detect which format user is using - prefer page/perPage if both provided\n const useLegacyFormat =\n (limit !== undefined \|\| offset !== undefined) && page === undefined && perPage === undefined;\n\n // If perPage provided, use it; otherwise fall back to limit\n const finalPerPage = perPage ?? limit;\n // If page provided, use it; otherwise convert from offset\n let finalPage = page;\n if (finalPage === undefined && offset !== undefined && finalPerPage !== undefined && finalPerPage > 0) {\n finalPage = Math.floor(offset / finalPerPage);\n }\n\n // Calculate offset from page/perPage\n const actualOffset = finalPage !== undefined && finalPerPage !== undefined ? finalPage finalPerPage : 0;\n\n // Apply pagination\n let paginatedServers = serverList;\n let nextUrl: string \| null = null;\n\n if (finalPerPage !== undefined) {\n paginatedServers = serverList.slice(actualOffset, actualOffset + finalPerPage);\n\n // Calculate next URL if there are more results\n if (actualOffset + finalPerPage < totalCount) {\n const nextPage = (finalPage ?? 0) + 1;\n // Return next URL in same format as request (legacy limit/offset or page/perPage)\n const prefix = routePrefix ?? '';\n if (useLegacyFormat) {\n const nextOffset = actualOffset + finalPerPage;\n nextUrl = `${prefix}/mcp/v0/servers?limit=${finalPerPage}&offset=${nextOffset}`;\n } else {\n nextUrl = `${prefix}/mcp/v0/servers?perPage=${finalPerPage}&page=${nextPage}`;\n }\n }\n }\n\n // Get server info for each server\n const serverInfoList: MCPServerInfoResponse[] = paginatedServers.map(server => ({\n ...server.getServerInfo(),\n transports: transportsOf(server),\n ...eventsCapabilityOf(server),\n ...tasksCapabilityOf(server),\n }));\n\n return {\n servers: serverInfoList,\n total_count: totalCount,\n next: nextUrl,\n };\n },\n});\n\nexport const GET_MCP_SERVER_DETAIL_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/v0/servers/:id',\n responseType: 'json',\n pathParamSchema: mcpServerDetailPathParams,\n queryParamSchema: getMcpServerDetailQuerySchema,\n responseSchema: serverDetailSchema,\n summary: 'Get MCP server details',\n description: 'Returns detailed information about a specific MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, id, version }: ServerContext & { id: string; version?: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(id);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${id}' not found` });\n }\n\n const serverDetail = {\n ...server.getServerDetail(),\n transports: transportsOf(server),\n ...eventsCapabilityOf(server),\n ...tasksCapabilityOf(server),\n };\n\n // If a specific version was requested, check if it matches\n if (version && serverDetail.version_detail.version !== version) {\n throw new HTTPException(404, {\n message: `MCP server with ID '${id}' found, but not version '${version}'. Available version: ${serverDetail.version_detail.version}`,\n });\n }\n\n return serverDetail;\n },\n});\n\nexport const LIST_MCP_SERVER_TOOLS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tools',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n responseSchema: listMcpServerToolsResponseSchema,\n summary: 'List MCP server tools',\n description: 'Returns a list of tools available on the specified MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, requestContext }: ServerContext & { serverId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.getToolListInfo !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot list tools in this way.` });\n }\n\n return await server.getToolListInfo(requestContext);\n },\n});\n\nexport const GET_MCP_SERVER_TOOL_DETAIL_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tools/:toolId',\n responseType: 'json',\n pathParamSchema: mcpServerToolPathParams,\n responseSchema: mcpToolInfoSchema,\n summary: 'Get MCP server tool details',\n description: 'Returns detailed information about a specific tool on the MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, toolId }: ServerContext & { serverId: string; toolId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.getToolInfo !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot provide tool details in this way.` });\n }\n\n const toolInfo = await server.getToolInfo(toolId);\n if (!toolInfo) {\n throw new HTTPException(404, { message: `Tool with ID '${toolId}' not found on MCP server '${serverId}'` });\n }\n\n return toolInfo;\n },\n});\n\nexport const EXECUTE_MCP_SERVER_TOOL_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tools/:toolId/execute',\n responseType: 'json',\n pathParamSchema: mcpServerToolPathParams,\n bodySchema: executeToolBodySchema,\n responseSchema: executeToolResponseSchema,\n summary: 'Execute MCP server tool',\n description: 'Executes a tool on the specified MCP server with the provided arguments',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n toolId,\n data,\n resumeData,\n suspendPayload,\n requestContext,\n }: ServerContext & {\n serverId: string;\n toolId: string;\n data?: unknown;\n resumeData?: unknown;\n suspendPayload?: unknown;\n }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.executeTool !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot execute tools in this way.` });\n }\n\n if (server.mcpVersion === 2) {\n // A 2026-07-28 server runs the tool with no protocol client attached: a tool\n // that suspends for input is reported as such instead of pretending it finished, and\n // the caller answers by sending the same args with `resumeData` and `suspendPayload`.\n let execution: MCPToolExecutionResultV2;\n try {\n execution = await server.executeTool(toolId, data, { requestContext, resumeData, suspendPayload });\n } catch (error) {\n if (error instanceof MastraError && error.id === 'MCP_SERVER_TOOL_INVALID_INPUT') {\n throw new HTTPException(400, { message: error.message, cause: error });\n }\n throw error;\n }\n if (execution.status === 'suspended') {\n return {\n status: 'suspended' as const,\n suspendPayload: execution.suspendPayload,\n resumeSchema: execution.resumeSchema,\n };\n }\n return { result: execution.output };\n }\n\n const result = await server.executeTool(toolId, data, { requestContext });\n return { result };\n },\n});\n\n// ============================================================================\n// MCP Resource Routes\n// ============================================================================\n\nexport const LIST_MCP_SERVER_RESOURCES_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/resources',\n responseType: 'json',\n pathParamSchema: mcpServerResourcePathParams,\n responseSchema: listResourcesResponseSchema,\n summary: 'List MCP server resources',\n description: 'Returns a list of resources available on the MCP server, including ui:// app resources',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.listResources !== 'function') {\n return { resources: [] };\n }\n\n return server.listResources();\n },\n});\n\nexport const READ_MCP_SERVER_RESOURCE_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/resources/read',\n responseType: 'json',\n pathParamSchema: mcpServerResourcePathParams,\n bodySchema: readResourceBodySchema,\n responseSchema: readResourceResponseSchema,\n summary: 'Read MCP server resource content',\n description: 'Reads the content of a resource by URI, used for rendering MCP App ui:// resources',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, uri }: ServerContext & { serverId: string; uri: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.readResource !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' does not support reading resources` });\n }\n\n try {\n return await server.readResource(uri);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n if (message.includes('not found') \|\| message.includes('not configured')) {\n throw new HTTPException(404, { message: `Resource '${uri}' not found on server '${serverId}'` });\n }\n throw error;\n }\n },\n});\n\n// ============================================================================\n// MCP Event Routes (experimental; used by Studio)\n// ============================================================================\n\n/** Present only for servers that declare event types, so older responses stay unchanged. /\nfunction eventsCapabilityOf(server: MastraMCPServerImplementation): { events_capability?: true } {\n const events = typeof server.getEventsInfo === 'function' ? server.getEventsInfo()?.events : undefined;\n return events && events.length > 0 ? { events_capability: true } : {};\n}\n\nfunction isTestEmitEnabled(): boolean {\n return process.env.MASTRA_DEV === 'true';\n}\n\nfunction getEventsServer(mastra: Mastra \| undefined, serverId: string): MastraMCPServerImplementation {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n const server = mastra.getMCPServerById(serverId);\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n return server;\n}\n\nfunction getEventsInspector(server: MastraMCPServerImplementation): MCPServerEventsInspector {\n const inspector = typeof server.getEventsInspector === 'function' ? server.getEventsInspector() : undefined;\n if (!inspector) throw new HTTPException(404, { message: 'Event not found' });\n return inspector;\n}\n\ntype EventErrorId = (typeof MCP_SERVER_EVENT_ERROR_IDS)[keyof typeof MCP_SERVER_EVENT_ERROR_IDS];\n\n// Keyed by the literal ids rather than the core constant, so @mastra/server still\n// runs against a @mastra/core release that doesn't export MCP_SERVER_EVENT_ERROR_IDS.\n// The record type keeps the ids in sync with core at compile time.\nconst EVENT_ERROR_RESPONSES: Record<EventErrorId, { status: 400 \| 403 \| 404 \| 429; message: string }> = {\n MCP_SERVER_UNKNOWN_EVENT: { status: 404, message: 'Event not found' },\n MCP_SERVER_EVENT_UNSUPPORTED_DELIVERY: {\n status: 400,\n message: 'This event does not support streaming; poll it instead',\n },\n MCP_SERVER_EVENT_INVALID_ARGUMENTS: { status: 400, message: 'Invalid event arguments' },\n MCP_SERVER_EVENT_NOT_EMITTABLE: {\n status: 400,\n message: 'This event is fed by a poll source and cannot be emitted',\n },\n MCP_SERVER_EVENT_INVALID_PAYLOAD: { status: 400, message: 'Invalid event data' },\n MCP_SERVER_EVENT_FORBIDDEN: { status: 403, message: 'Not allowed to use this event' },\n MCP_SERVER_EVENT_TOO_MANY_STREAMS: { status: 429, message: 'Too many open event streams' },\n};\n\n/\n Maps event errors to generic HTTP errors. The details (which can come from a poll\n * source or an upstream API) are only logged, never returned.\n /\nfunction toEventsHttpError(error: unknown, mastra: Mastra \| undefined, context: string): HTTPException {\n if (error instanceof HTTPException) return error;\n const known = error instanceof MastraError ? EVENT_ERROR_RESPONSES[error.id as EventErrorId] : undefined;\n if (known) return new HTTPException(known.status, { message: known.message });\n mastra?.getLogger()?.error(`MCP event request failed: ${context}`, { error });\n return new HTTPException(500, { message: 'Event request failed' });\n}\n\nexport const LIST_MCP_SERVER_EVENTS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/events',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n responseSchema: listMcpServerEventsResponseSchema,\n summary: 'List MCP server events',\n description: 'Returns the event types the MCP server declares (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }) => {\n const server = getEventsServer(mastra, serverId);\n const events = typeof server.getEventsInfo === 'function' ? (server.getEventsInfo()?.events ?? []) : [];\n return { events, testEmit: isTestEmitEnabled() };\n },\n});\n\nexport const POLL_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/poll',\n responseType: 'json',\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: pollMcpServerEventBodySchema,\n responseSchema: pollMcpServerEventResponseSchema,\n summary: 'Poll an MCP server event',\n description: 'Reads occurrences of an event type, like the events/poll MCP request (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n // Same permission as streaming: both read occurrences through the event's source.\n requiresPermission: 'mcp:execute',\n handler: async ({\n mastra,\n serverId,\n eventName,\n arguments: args,\n cursor,\n maxEvents,\n requestContext,\n abortSignal,\n }: ServerContext & {\n serverId: string;\n eventName: string;\n arguments?: Record<string, unknown>;\n cursor?: string \| null;\n maxEvents?: number;\n }) => {\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n try {\n return await inspector.poll(\n eventName,\n { arguments: args, cursor, maxEvents },\n { requestContext, signal: abortSignal },\n );\n } catch (error) {\n throw toEventsHttpError(error, mastra, `poll ${serverId}/${eventName}`);\n }\n },\n});\n\nexport const STREAM_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/stream',\n responseType: 'stream' as const,\n streamFormat: 'sse' as const,\n sseFlushOnConnect: true,\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: streamMcpServerEventBodySchema,\n responseSchema: mcpServerEventStreamFrameSchema,\n summary: 'Stream an MCP server event',\n description:\n 'Streams occurrences of an event type as server-sent events, like the events/stream MCP request (experimental)',\n tags: ['MCP', 'Streaming'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n eventName,\n arguments: args,\n cursor,\n requestContext,\n abortSignal,\n }: ServerContext & {\n serverId: string;\n eventName: string;\n arguments?: Record<string, unknown>;\n cursor?: string \| null;\n }) => {\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n const controller = new AbortController();\n const abort = () => controller.abort();\n if (abortSignal?.aborted) abort();\n else abortSignal?.addEventListener('abort', abort, { once: true });\n\n // Frames sent before the stream's `start` runs are buffered here.\n const buffered: MCPServerEventStreamFrame[] = [];\n let sink: ReadableStreamDefaultController<MCPServerEventStreamFrame> \| undefined;\n let done = false;\n const finish = () => {\n if (done) return;\n done = true;\n abortSignal?.removeEventListener('abort', abort);\n abort();\n try {\n sink?.close();\n } catch {\n // Already closed or cancelled by the client.\n }\n };\n\n let closed: Promise<void>;\n try {\n ({ closed } = await inspector.stream(\n eventName,\n { arguments: args, cursor },\n {\n signal: controller.signal,\n requestContext,\n onFrame: frame => {\n if (done) return;\n if (sink) sink.enqueue(frame);\n else buffered.push(frame);\n if (frame.type === 'terminated') finish();\n },\n },\n ));\n } catch (error) {\n finish();\n throw toEventsHttpError(error, mastra, `stream ${serverId}/${eventName}`);\n }\n void closed.then(finish);\n\n return new ReadableStream<MCPServerEventStreamFrame>({\n start(streamController) {\n if (done) {\n for (const frame of buffered.splice(0)) streamController.enqueue(frame);\n streamController.close();\n return;\n }\n sink = streamController;\n for (const frame of buffered.splice(0)) streamController.enqueue(frame);\n },\n cancel() {\n finish();\n },\n });\n },\n});\n\nexport const EMIT_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/emit',\n responseType: 'json',\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: emitMcpServerEventBodySchema,\n responseSchema: emitMcpServerEventResponseSchema,\n summary: 'Send a test MCP server event',\n description:\n 'Emits a test occurrence of an emit-fed event type. Only served under `mastra dev`; otherwise 404 (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n eventName,\n data,\n }: ServerContext & { serverId: string; eventName: string; data: Record<string, unknown> }) => {\n if (!isTestEmitEnabled()) throw new HTTPException(404, { message: 'Not Found' });\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n try {\n return { occurrence: await inspector.emit(eventName, data) };\n } catch (error) {\n throw toEventsHttpError(error, mastra, `emit ${serverId}/${eventName}`);\n }\n },\n});\n\n// ============================================================================\n// MCP Task Routes (experimental; Studio admin view)\n// ============================================================================\n\n/* Present only for servers that run something as an MCP task, so older responses stay unchanged. /\nfunction tasksCapabilityOf(server: MastraMCPServerImplementation): { tasks_capability?: true } {\n const info = typeof server.getTasksInfo === 'function' ? server.getTasksInfo() : undefined;\n return info?.enabled ? { tasks_capability: true } : {};\n}\n\nconst TASK_NOT_FOUND = 'Task not found';\n\n/\n Tasks belong to MCP principals, which have no mapping to Mastra resources, so a\n * resource-scoped caller can't be shown or act on any of them. Only an unscoped caller\n * (no resource in the request context) gets the inspector.\n /\nfunction getTasksInspector(\n server: MastraMCPServerImplementation,\n requestContext: ServerContext['requestContext'],\n): MCPServerTasksInspector \| undefined {\n if (getContextResourceId(requestContext) !== undefined) return undefined;\n return typeof server.getTasksInspector === 'function' ? server.getTasksInspector() : undefined;\n}\n\nfunction toTasksHttpError(error: unknown, mastra: Mastra \| undefined, context: string): HTTPException {\n if (error instanceof HTTPException) return error;\n mastra?.getLogger()?.error(`MCP task request failed: ${context}`, { error });\n return new HTTPException(500, { message: 'Task request failed' });\n}\n\nexport const LIST_MCP_SERVER_TASKS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tasks',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n queryParamSchema: listMcpServerTasksQuerySchema,\n responseSchema: listMcpServerTasksResponseSchema,\n summary: 'List MCP server tasks',\n description:\n \"Returns which tools run as MCP tasks and the server's recent tasks across principals, identified by task key; never task ids or principals (experimental)\",\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n limit,\n cursor,\n status,\n surface,\n client,\n key,\n requestContext,\n }: ServerContext & { serverId: string } & z.infer<typeof listMcpServerTasksQuerySchema>) => {\n const server = getEventsServer(mastra, serverId);\n const info = typeof server.getTasksInfo === 'function' ? server.getTasksInfo() : undefined;\n if (!info?.enabled) return { surfaces: [], tasks: [] };\n const base = { surfaces: info.surfaces };\n if (getContextResourceId(requestContext) !== undefined) {\n return { ...base, unavailable: 'resource_scoped' as const, tasks: [] };\n }\n const inspector = getTasksInspector(server, requestContext);\n if (!inspector) return { ...base, unavailable: 'not_listable' as const, tasks: [] };\n try {\n const { tasks, nextCursor } = await inspector.list({\n limit: limit ?? DEFAULT_MCP_SERVER_TASKS_LIMIT,\n cursor,\n status,\n surface,\n principalKey: client,\n taskKey: key,\n });\n return { ...base, tasks, ...(nextCursor && { nextCursor }) };\n } catch (error) {\n throw toTasksHttpError(error, mastra, `list ${serverId}`);\n }\n },\n});\n\nexport const FIND_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/find',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n bodySchema: findMcpServerTaskBodySchema,\n responseSchema: findMcpServerTaskResponseSchema,\n summary: 'Find an MCP server task by task id',\n description:\n 'Finds a task by its MCP task id, as a client sees it. The id is hashed before the lookup and is not kept or returned (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n // A lookup, not a change: POST only keeps the raw id out of URLs, so it needs read like the list.\n requiresPermission: 'mcp:read',\n handler: async ({\n mastra,\n serverId,\n taskId,\n requestContext,\n }: ServerContext & { serverId: string; taskId: string }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let task: Awaited<ReturnType<MCPServerTasksInspector['find']>>;\n try {\n task = await inspector.find(taskId);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `find ${serverId}`);\n }\n if (!task) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { task };\n },\n});\n\nexport const CANCEL_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/:taskKey/cancel',\n responseType: 'json',\n pathParamSchema: mcpServerTaskPathParams,\n responseSchema: mcpServerTaskActionResponseSchema,\n summary: 'Cancel an MCP server task',\n description: 'Cancels a running task by key, like the tasks/cancel MCP request (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n requiresPermission: 'mcp:write',\n handler: async ({\n mastra,\n serverId,\n taskKey,\n requestContext,\n }: ServerContext & { serverId: string; taskKey: string }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let cancelled: boolean;\n try {\n cancelled = await inspector.cancel(taskKey);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `cancel ${serverId}`);\n }\n if (!cancelled) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { success: true as const };\n },\n});\n\nexport const ANSWER_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/:taskKey/input',\n responseType: 'json',\n pathParamSchema: mcpServerTaskPathParams,\n bodySchema: answerMcpServerTaskBodySchema,\n responseSchema: mcpServerTaskActionResponseSchema,\n summary: 'Answer an MCP server task input request',\n description:\n \"Answers a task's open input requests by key, like the tasks/update MCP request; 404 unless the task is waiting for one of them (experimental)\",\n tags: ['MCP'],\n requiresAuth: true,\n requiresPermission: 'mcp:write',\n handler: async ({\n mastra,\n serverId,\n taskKey,\n inputResponses,\n requestContext,\n }: ServerContext & {\n serverId: string;\n taskKey: string;\n inputResponses: Record<string, Record<string, unknown>>;\n }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let answered: boolean;\n try {\n answered = await inspector.answer(taskKey, inputResponses);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `answer ${serverId}`);\n }\n if (!answered) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { success: true as const };\n },\n});\n\n// ============================================================================\n// MCP Transport Routes (Streamable HTTP and SSE)\n// ============================================================================\n\n/\n MCP transport options that can be passed to startHTTP() or startSSE().\n * Includes serverless mode for running in stateless environments like Cloudflare Workers or Vercel Edge.\n /\nexport interface MCPTransportOptions {\n /\n When true, runs in stateless mode without session management.\n * Ideal for serverless environments where you can't maintain persistent connections.\n /\n serverless?: boolean;\n /\n Custom session ID generator function.\n /\n sessionIdGenerator?: () => string;\n /\n Sets `req.auth` before the MCP transport reads it. Overrides the default\n * bridge that forwards the principal resolved by `server.auth`.\n /\n setRequestAuth?: SetMcpRequestAuth;\n}\n\n/\n MCP HTTP Transport response type.\n * Adapters use this to set up the HTTP transport via MCPServer.startHTTP()\n /\nexport interface MCPHttpTransportResult {\n server: MastraMCPServerImplementation;\n httpPath: string;\n /\n Optional MCP transport options for this specific route.\n * These override any class-level mcpOptions configured on the adapter.\n /\n mcpOptions?: MCPTransportOptions;\n}\n\n/\n MCP SSE Transport response type.\n * Adapters use this to set up the SSE transport via MCPServer.startSSE() or startHonoSSE()\n \n Note: SSE transport is inherently stateful and doesn't support serverless mode.\n /\nexport interface MCPSseTransportResult {\n /* A 1.x server: the SSE route only resolves servers that still implement the transport. */\n server: MastraMCPServerImplementation;\n ssePath: string;\n messagePath: string;\n}\n\nexport const MCP_HTTP_TRANSPORT_ROUTE = createRoute({\n method: 'ALL',\n path: '/mcp/:serverId/mcp',\n responseType: 'mcp-http',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP HTTP Transport',\n description: 'Streamable HTTP transport endpoint for MCP protocol communication',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPHttpTransportResult> => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n }\n\n return {\n server,\n httpPath: `/mcp/${serverId}/mcp`,\n };\n },\n});\n\nexport const MCP_SSE_TRANSPORT_ROUTE = createRoute({\n method: 'ALL',\n path: '/mcp/:serverId/sse',\n responseType: 'mcp-sse',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP SSE Transport',\n description: 'SSE transport endpoint for MCP protocol communication',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPSseTransportResult> => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n }\n\n if (!hasSSETransport(server)) {\n throw new HTTPException(404, { message: 'Legacy SSE transport is unavailable for MCP v2 servers' });\n }\n\n return {\n server,\n ssePath: `/mcp/${serverId}/sse`,\n messagePath: `/mcp/${serverId}/messages`,\n };\n },\n});\n\nexport const MCP_SSE_MESSAGES_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/messages',\n responseType: 'mcp-sse',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP SSE Messages',\n description: 'Message endpoint for SSE transport (posts messages to active SSE streams)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: MCP_SSE_TRANSPORT_ROUTE.handler,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAS,gBAAgB,QAAgD;CACvE,OAAO,OAAO,eAAe;AAC/B;AASA,SAAS,aAAa,QAA6D;CACjF,OAAO,gBAAgB,MAAM,IAAI,CAAC,mBAAmB,KAAK,IAAI,CAAC,iBAAiB;AAClF;AAEA,MAAa,yBAAyB,YAAY;CAChD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,kBAAkB;CAClB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EACd,QACA,aACA,MACA,SACA,OACA,aAC0F;EAC1F,IAAI,CAAC,UAAU,OAAO,OAAO,mBAAmB,YAC9C,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,yDAAyD,CAAC;EAGpG,MAAM,UAAU,OAAO,eAAe;EAEtC,IAAI,CAAC,SACH,OAAO;GAAE,SAAS,CAAC;GAAG,aAAa;GAAG,MAAM;EAAK;EAGnD,MAAM,aAAa,OAAO,OAAO,OAAO;EACxC,MAAM,aAAa,WAAW;EAI9B,MAAM,mBACH,UAAU,KAAA,KAAa,WAAW,KAAA,MAAc,SAAS,KAAA,KAAa,YAAY,KAAA;EAGrF,MAAM,eAAe,WAAW;EAEhC,IAAI,YAAY;EAChB,IAAI,cAAc,KAAA,KAAa,WAAW,KAAA,KAAa,iBAAiB,KAAA,KAAa,eAAe,GAClG,YAAY,KAAK,MAAM,SAAS,YAAY;EAI9C,MAAM,eAAe,cAAc,KAAA,KAAa,iBAAiB,KAAA,IAAY,YAAY,eAAe;EAGxG,IAAI,mBAAmB;EACvB,IAAI,UAAyB;EAE7B,IAAI,iBAAiB,KAAA,GAAW;GAC9B,mBAAmB,WAAW,MAAM,cAAc,eAAe,YAAY;GAG7E,IAAI,eAAe,eAAe,YAAY;IAC5C,MAAM,YAAY,aAAa,KAAK;IAEpC,MAAM,SAAS,eAAe;IAC9B,IAAI,iBAEF,UAAU,GAAG,OAAO,wBAAwB,aAAa,UADtC,eAAe;SAGlC,UAAU,GAAG,OAAO,0BAA0B,aAAa,QAAQ;GAEvE;EACF;EAUA,OAAO;GACL,SAR8C,iBAAiB,KAAI,YAAW;IAC9E,GAAG,OAAO,cAAc;IACxB,YAAY,aAAa,MAAM;IAC/B,GAAG,mBAAmB,MAAM;IAC5B,GAAG,kBAAkB,MAAM;GAC7B,EAGwB;GACtB,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC;AAED,MAAa,8BAA8B,YAAY;CACrD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,IAAI,cAAgE;EAC5F,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,EAAE;EAEzC,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,GAAG,aAAa,CAAC;EAGlF,MAAM,eAAe;GACnB,GAAG,OAAO,gBAAgB;GAC1B,YAAY,aAAa,MAAM;GAC/B,GAAG,mBAAmB,MAAM;GAC5B,GAAG,kBAAkB,MAAM;EAC7B;EAGA,IAAI,WAAW,aAAa,eAAe,YAAY,SACrD,MAAM,IAAI,cAAc,KAAK,EAC3B,SAAS,uBAAuB,GAAG,4BAA4B,QAAQ,wBAAwB,aAAa,eAAe,UAC7H,CAAC;EAGH,OAAO;CACT;AACF,CAAC;AAED,MAAa,8BAA8B,YAAY;CACrD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,UAAU,qBAA2D;EAC7F,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;EAGxF,IAAI,OAAO,OAAO,oBAAoB,YACpC,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,WAAW,SAAS,kCAAkC,CAAC;EAGjG,OAAO,MAAM,OAAO,gBAAgB,cAAc;CACpD;AACF,CAAC;AAED,MAAa,mCAAmC,YAAY;CAC1D,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,UAAU,aAAmE;EACrG,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;EAGxF,IAAI,OAAO,OAAO,gBAAgB,YAChC,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,WAAW,SAAS,4CAA4C,CAAC;EAG3G,MAAM,WAAW,MAAM,OAAO,YAAY,MAAM;EAChD,IAAI,CAAC,UACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,iBAAiB,OAAO,6BAA6B,SAAS,GAAG,CAAC;EAG5G,OAAO;CACT;AACF,CAAC;AAED,MAAa,gCAAgC,YAAY;CACvD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EACd,QACA,UACA,QACA,MACA,YACA,gBACA,qBAOI;EACJ,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;EAGxF,IAAI,OAAO,OAAO,gBAAgB,YAChC,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,WAAW,SAAS,qCAAqC,CAAC;EAGpG,IAAI,OAAO,eAAe,GAAG;GAI3B,IAAI;GACJ,IAAI;IACF,YAAY,MAAM,OAAO,YAAY,QAAQ,MAAM;KAAE;KAAgB;KAAY;IAAe,CAAC;GACnG,SAAS,OAAO;IACd,IAAI,iBAAiB,eAAe,MAAM,OAAO,iCAC/C,MAAM,IAAI,cAAc,KAAK;KAAE,SAAS,MAAM;KAAS,OAAO;IAAM,CAAC;IAEvE,MAAM;GACR;GACA,IAAI,UAAU,WAAW,aACvB,OAAO;IACL,QAAQ;IACR,gBAAgB,UAAU;IAC1B,cAAc,UAAU;GAC1B;GAEF,OAAO,EAAE,QAAQ,UAAU,OAAO;EACpC;EAGA,OAAO,EAAE,QAAA,MADY,OAAO,YAAY,QAAQ,MAAM,EAAE,eAAe,CAAC,EACxD;CAClB;AACF,CAAC;AAMD,MAAa,kCAAkC,YAAY;CACzD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,eAAqD;EAC7E,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;EAGxF,IAAI,OAAO,OAAO,kBAAkB,YAClC,OAAO,EAAE,WAAW,CAAC,EAAE;EAGzB,OAAO,OAAO,cAAc;CAC9B;AACF,CAAC;AAED,MAAa,iCAAiC,YAAY;CACxD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,UAAU,UAA6D;EAC/F,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;EAGxF,IAAI,OAAO,OAAO,iBAAiB,YACjC,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,WAAW,SAAS,sCAAsC,CAAC;EAGrG,IAAI;GACF,OAAO,MAAM,OAAO,aAAa,GAAG;EACtC,SAAS,OAAO;GACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACrE,IAAI,QAAQ,SAAS,WAAW,KAAK,QAAQ,SAAS,gBAAgB,GACpE,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,aAAa,IAAI,yBAAyB,SAAS,GAAG,CAAC;GAEjG,MAAM;EACR;CACF;AACF,CAAC;;AAOD,SAAS,mBAAmB,QAAqE;CAC/F,MAAM,SAAS,OAAO,OAAO,kBAAkB,aAAa,OAAO,cAAc,CAAC,EAAE,SAAS,KAAA;CAC7F,OAAO,UAAU,OAAO,SAAS,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;AACtE;AAEA,SAAS,oBAA6B;CACpC,OAAO,QAAQ,IAAI,eAAe;AACpC;AAEA,SAAS,gBAAgB,QAA4B,UAAiD;CACpG,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;CAEtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;CAC/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,SAAS,aAAa,CAAC;CAExF,OAAO;AACT;AAEA,SAAS,mBAAmB,QAAiE;CAC3F,MAAM,YAAY,OAAO,OAAO,uBAAuB,aAAa,OAAO,mBAAmB,IAAI,KAAA;CAClG,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,kBAAkB,CAAC;CAC3E,OAAO;AACT;AAOA,MAAM,wBAAkG;CACtG,0BAA0B;EAAE,QAAQ;EAAK,SAAS;CAAkB;CACpE,uCAAuC;EACrC,QAAQ;EACR,SAAS;CACX;CACA,oCAAoC;EAAE,QAAQ;EAAK,SAAS;CAA0B;CACtF,gCAAgC;EAC9B,QAAQ;EACR,SAAS;CACX;CACA,kCAAkC;EAAE,QAAQ;EAAK,SAAS;CAAqB;CAC/E,4BAA4B;EAAE,QAAQ;EAAK,SAAS;CAAgC;CACpF,mCAAmC;EAAE,QAAQ;EAAK,SAAS;CAA8B;AAC3F;;;;;AAMA,SAAS,kBAAkB,OAAgB,QAA4B,SAAgC;CACrG,IAAI,iBAAiB,eAAe,OAAO;CAC3C,MAAM,QAAQ,iBAAiB,cAAc,sBAAsB,MAAM,MAAsB,KAAA;CAC/F,IAAI,OAAO,OAAO,IAAI,cAAc,MAAM,QAAQ,EAAE,SAAS,MAAM,QAAQ,CAAC;CAC5E,QAAQ,UAAU,CAAC,EAAE,MAAM,6BAA6B,WAAW,EAAE,MAAM,CAAC;CAC5E,OAAO,IAAI,cAAc,KAAK,EAAE,SAAS,uBAAuB,CAAC;AACnE;AAEA,MAAa,+BAA+B,YAAY;CACtD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,eAAqD;EAC7E,MAAM,SAAS,gBAAgB,QAAQ,QAAQ;EAE/C,OAAO;GAAE,QADM,OAAO,OAAO,kBAAkB,aAAc,OAAO,cAAc,CAAC,EAAE,UAAU,CAAC,IAAK,CAAC;GACrF,UAAU,kBAAkB;EAAE;CACjD;AACF,CAAC;AAED,MAAa,8BAA8B,YAAY;CACrD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CAEd,oBAAoB;CACpB,SAAS,OAAO,EACd,QACA,UACA,WACA,WAAW,MACX,QACA,WACA,gBACA,kBAOI;EACJ,MAAM,YAAY,mBAAmB,gBAAgB,QAAQ,QAAQ,CAAC;EACtE,IAAI;GACF,OAAO,MAAM,UAAU,KACrB,WACA;IAAE,WAAW;IAAM;IAAQ;GAAU,GACrC;IAAE;IAAgB,QAAQ;GAAY,CACxC;EACF,SAAS,OAAO;GACd,MAAM,kBAAkB,OAAO,QAAQ,QAAQ,SAAS,GAAG,WAAW;EACxE;CACF;AACF,CAAC;AAED,MAAa,gCAAgC,YAAY;CACvD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,cAAc;CACd,mBAAmB;CACnB,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aACE;CACF,MAAM,CAAC,OAAO,WAAW;CACzB,cAAc;CACd,SAAS,OAAO,EACd,QACA,UACA,WACA,WAAW,MACX,QACA,gBACA,kBAMI;EACJ,MAAM,YAAY,mBAAmB,gBAAgB,QAAQ,QAAQ,CAAC;EACtE,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,cAAc,WAAW,MAAM;EACrC,IAAI,aAAa,SAAS,MAAM;OAC3B,aAAa,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;EAGjE,MAAM,WAAwC,CAAC;EAC/C,IAAI;EACJ,IAAI,OAAO;EACX,MAAM,eAAe;GACnB,IAAI,MAAM;GACV,OAAO;GACP,aAAa,oBAAoB,SAAS,KAAK;GAC/C,MAAM;GACN,IAAI;IACF,MAAM,MAAM;GACd,QAAQ,CAER;EACF;EAEA,IAAI;EACJ,IAAI;GACF,CAAC,CAAE,UAAW,MAAM,UAAU,OAC5B,WACA;IAAE,WAAW;IAAM;GAAO,GAC1B;IACE,QAAQ,WAAW;IACnB;IACA,UAAS,UAAS;KAChB,IAAI,MAAM;KACV,IAAI,MAAM,KAAK,QAAQ,KAAK;UACvB,SAAS,KAAK,KAAK;KACxB,IAAI,MAAM,SAAS,cAAc,OAAO;IAC1C;GACF,CACF;EACF,SAAS,OAAO;GACd,OAAO;GACP,MAAM,kBAAkB,OAAO,QAAQ,UAAU,SAAS,GAAG,WAAW;EAC1E;EACA,OAAY,KAAK,MAAM;EAEvB,OAAO,IAAI,eAA0C;GACnD,MAAM,kBAAkB;IACtB,IAAI,MAAM;KACR,KAAK,MAAM,SAAS,SAAS,OAAO,CAAC,GAAG,iBAAiB,QAAQ,KAAK;KACtE,iBAAiB,MAAM;KACvB;IACF;IACA,OAAO;IACP,KAAK,MAAM,SAAS,SAAS,OAAO,CAAC,GAAG,iBAAiB,QAAQ,KAAK;GACxE;GACA,SAAS;IACP,OAAO;GACT;EACF,CAAC;CACH;AACF,CAAC;AAED,MAAa,8BAA8B,YAAY;CACrD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aACE;CACF,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EACd,QACA,UACA,WACA,WAC4F;EAC5F,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,YAAY,CAAC;EAC/E,MAAM,YAAY,mBAAmB,gBAAgB,QAAQ,QAAQ,CAAC;EACtE,IAAI;GACF,OAAO,EAAE,YAAY,MAAM,UAAU,KAAK,WAAW,IAAI,EAAE;EAC7D,SAAS,OAAO;GACd,MAAM,kBAAkB,OAAO,QAAQ,QAAQ,SAAS,GAAG,WAAW;EACxE;CACF;AACF,CAAC;;AAOD,SAAS,kBAAkB,QAAoE;CAE7F,QADa,OAAO,OAAO,iBAAiB,aAAa,OAAO,aAAa,IAAI,KAAA,EAAA,EACpE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CAAC;AACvD;AAEA,MAAM,iBAAiB;;;;;;AAOvB,SAAS,kBACP,QACA,gBACqC;CACrC,IAAI,qBAAqB,cAAc,MAAM,KAAA,GAAW,OAAO,KAAA;CAC/D,OAAO,OAAO,OAAO,sBAAsB,aAAa,OAAO,kBAAkB,IAAI,KAAA;AACvF;AAEA,SAAS,iBAAiB,OAAgB,QAA4B,SAAgC;CACpG,IAAI,iBAAiB,eAAe,OAAO;CAC3C,QAAQ,UAAU,CAAC,EAAE,MAAM,4BAA4B,WAAW,EAAE,MAAM,CAAC;CAC3E,OAAO,IAAI,cAAc,KAAK,EAAE,SAAS,sBAAsB,CAAC;AAClE;AAEA,MAAa,8BAA8B,YAAY;CACrD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;CAChB,SAAS;CACT,aACE;CACF,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EACd,QACA,UACA,OACA,QACA,QACA,SACA,QACA,KACA,qBAC0F;EAC1F,MAAM,SAAS,gBAAgB,QAAQ,QAAQ;EAC/C,MAAM,OAAO,OAAO,OAAO,iBAAiB,aAAa,OAAO,aAAa,IAAI,KAAA;EACjF,IAAI,CAAC,MAAM,SAAS,OAAO;GAAE,UAAU,CAAC;GAAG,OAAO,CAAC;EAAE;EACrD,MAAM,OAAO,EAAE,UAAU,KAAK,SAAS;EACvC,IAAI,qBAAqB,cAAc,MAAM,KAAA,GAC3C,OAAO;GAAE,GAAG;GAAM,aAAa;GAA4B,OAAO,CAAC;EAAE;EAEvE,MAAM,YAAY,kBAAkB,QAAQ,cAAc;EAC1D,IAAI,CAAC,WAAW,OAAO;GAAE,GAAG;GAAM,aAAa;GAAyB,OAAO,CAAC;EAAE;EAClF,IAAI;GACF,MAAM,EAAE,OAAO,eAAe,MAAM,UAAU,KAAK;IACjD,OAAO,SAAA;IACP;IACA;IACA;IACA,cAAc;IACd,SAAS;GACX,CAAC;GACD,OAAO;IAAE,GAAG;IAAM;IAAO,GAAI,cAAc,EAAE,WAAW;GAAG;EAC7D,SAAS,OAAO;GACd,MAAM,iBAAiB,OAAO,QAAQ,QAAQ,UAAU;EAC1D;CACF;AACF,CAAC;AAED,MAAa,6BAA6B,YAAY;CACpD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aACE;CACF,MAAM,CAAC,KAAK;CACZ,cAAc;CAEd,oBAAoB;CACpB,SAAS,OAAO,EACd,QACA,UACA,QACA,qBAC0D;EAC1D,MAAM,YAAY,kBAAkB,gBAAgB,QAAQ,QAAQ,GAAG,cAAc;EACrF,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACxE,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,UAAU,KAAK,MAAM;EACpC,SAAS,OAAO;GACd,MAAM,iBAAiB,OAAO,QAAQ,QAAQ,UAAU;EAC1D;EACA,IAAI,CAAC,MAAM,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACnE,OAAO,EAAE,KAAK;CAChB;AACF,CAAC;AAED,MAAa,+BAA+B,YAAY;CACtD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,oBAAoB;CACpB,SAAS,OAAO,EACd,QACA,UACA,SACA,qBAC2D;EAC3D,MAAM,YAAY,kBAAkB,gBAAgB,QAAQ,QAAQ,GAAG,cAAc;EACrF,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACxE,IAAI;EACJ,IAAI;GACF,YAAY,MAAM,UAAU,OAAO,OAAO;EAC5C,SAAS,OAAO;GACd,MAAM,iBAAiB,OAAO,QAAQ,UAAU,UAAU;EAC5D;EACA,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACxE,OAAO,EAAE,SAAS,KAAc;CAClC;AACF,CAAC;AAED,MAAa,+BAA+B,YAAY;CACtD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACT,aACE;CACF,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,oBAAoB;CACpB,SAAS,OAAO,EACd,QACA,UACA,SACA,gBACA,qBAKI;EACJ,MAAM,YAAY,kBAAkB,gBAAgB,QAAQ,QAAQ,GAAG,cAAc;EACrF,IAAI,CAAC,WAAW,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACxE,IAAI;EACJ,IAAI;GACF,WAAW,MAAM,UAAU,OAAO,SAAS,cAAc;EAC3D,SAAS,OAAO;GACd,MAAM,iBAAiB,OAAO,QAAQ,UAAU,UAAU;EAC5D;EACA,IAAI,CAAC,UAAU,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,CAAC;EACvE,OAAO,EAAE,SAAS,KAAc;CAClC;AACF,CAAC;AAsDD,MAAa,2BAA2B,YAAY;CAClD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,eAAsF;EAC9G,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,SAAS,aAAa,CAAC;EAGhF,OAAO;GACL;GACA,UAAU,QAAQ,SAAS;EAC7B;CACF;AACF,CAAC;AAED,MAAa,0BAA0B,YAAY;CACjD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,OAAO,EAAE,QAAQ,eAAqF;EAC7G,IAAI,CAAC,UAAU,OAAO,OAAO,qBAAqB,YAChD,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2DAA2D,CAAC;EAGtG,MAAM,SAAS,OAAO,iBAAiB,QAAQ;EAE/C,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,eAAe,SAAS,aAAa,CAAC;EAGhF,IAAI,CAAC,gBAAgB,MAAM,GACzB,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,yDAAyD,CAAC;EAGpG,OAAO;GACL;GACA,SAAS,QAAQ,SAAS;GAC1B,aAAa,QAAQ,SAAS;EAChC;CACF;AACF,CAAC;AAED,MAAa,yBAAyB,YAAY;CAChD,QAAQ;CACR,MAAM;CACN,cAAc;CACd,iBAAiB;CACjB,SAAS;CACT,aAAa;CACb,MAAM,CAAC,KAAK;CACZ,cAAc;CACd,SAAS,wBAAwB;AACnC,CAAC"}
1	+ {"version":3,"file":"mcp-CntC59iU.js","names":[],"sources":["../src/server/handlers/mcp.ts"],"sourcesContent":["import { MastraError } from '@mastra/core/error';\nimport type { Mastra } from '@mastra/core/mastra';\nimport type {\n MCP_SERVER_EVENT_ERROR_IDS,\n MCPServerBase as MastraMCPServerImplementation,\n MCPServerEventStreamFrame,\n MCPServerEventsInspector,\n MCPServerTasksInspector,\n MCPToolExecutionResultV2,\n ServerInfo,\n} from '@mastra/core/mcp';\nimport type { z } from 'zod';\nimport { HTTPException } from '../http-exception';\nimport {\n mcpServerDetailPathParams,\n mcpServerToolPathParams,\n executeToolBodySchema,\n listMcpServersQuerySchema,\n getMcpServerDetailQuerySchema,\n listMcpServersResponseSchema,\n serverDetailSchema,\n mcpServerIdPathParams,\n listMcpServerToolsResponseSchema,\n mcpToolInfoSchema,\n executeToolResponseSchema,\n mcpServerResourcePathParams,\n readResourceBodySchema,\n readResourceResponseSchema,\n listResourcesResponseSchema,\n mcpServerEventPathParams,\n listMcpServerEventsResponseSchema,\n pollMcpServerEventBodySchema,\n pollMcpServerEventResponseSchema,\n streamMcpServerEventBodySchema,\n mcpServerEventStreamFrameSchema,\n emitMcpServerEventBodySchema,\n emitMcpServerEventResponseSchema,\n mcpServerTaskPathParams,\n DEFAULT_MCP_SERVER_TASKS_LIMIT,\n listMcpServerTasksQuerySchema,\n listMcpServerTasksResponseSchema,\n findMcpServerTaskBodySchema,\n findMcpServerTaskResponseSchema,\n answerMcpServerTaskBodySchema,\n mcpServerTaskActionResponseSchema,\n} from '../schemas/mcp';\nimport type { MCPServerTransport } from '../schemas/mcp';\nimport type { ServerContext } from '../server-adapter';\nimport type { SetMcpRequestAuth } from '../server-adapter/mcp-auth';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { getContextResourceId } from './utils';\n\n// ============================================================================\n// Route Definitions (createRoute pattern for server adapters)\n// ============================================================================\n\n/*\n Only `@mastra/mcp` 1.x servers implement the standalone HTTP+SSE transport; on a\n * 2026-07-28 server the inherited `startSSE`/`startHonoSSE` throw.\n /\nfunction hasSSETransport(server: MastraMCPServerImplementation): boolean {\n return server.mcpVersion !== 2;\n}\n\nexport interface MCPServerInfoResponse extends ServerInfo {\n /* Endpoints served under `/mcp/:serverId`; 2026-07-28 servers speak Streamable HTTP only. /\n transports: MCPServerTransport[];\n events_capability?: boolean;\n tasks_capability?: boolean;\n}\n\nfunction transportsOf(server: MastraMCPServerImplementation): MCPServerTransport[] {\n return hasSSETransport(server) ? ['streamable-http', 'sse'] : ['streamable-http'];\n}\n\nexport const LIST_MCP_SERVERS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/v0/servers',\n responseType: 'json',\n queryParamSchema: listMcpServersQuerySchema,\n responseSchema: listMcpServersResponseSchema,\n summary: 'List MCP servers',\n description: 'Returns a list of registered MCP servers with pagination support',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n routePrefix,\n page,\n perPage,\n limit,\n offset,\n }: ServerContext & { page?: number; perPage?: number; limit?: number; offset?: number }) => {\n if (!mastra \|\| typeof mastra.listMCPServers !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or listMCPServers method not available' });\n }\n\n const servers = mastra.listMCPServers();\n\n if (!servers) {\n return { servers: [], total_count: 0, next: null };\n }\n\n const serverList = Object.values(servers);\n const totalCount = serverList.length;\n\n // Support both page/perPage and limit/offset for backwards compatibility\n // Detect which format user is using - prefer page/perPage if both provided\n const useLegacyFormat =\n (limit !== undefined \|\| offset !== undefined) && page === undefined && perPage === undefined;\n\n // If perPage provided, use it; otherwise fall back to limit\n const finalPerPage = perPage ?? limit;\n // If page provided, use it; otherwise convert from offset\n let finalPage = page;\n if (finalPage === undefined && offset !== undefined && finalPerPage !== undefined && finalPerPage > 0) {\n finalPage = Math.floor(offset / finalPerPage);\n }\n\n // Calculate offset from page/perPage\n const actualOffset = finalPage !== undefined && finalPerPage !== undefined ? finalPage finalPerPage : 0;\n\n // Apply pagination\n let paginatedServers = serverList;\n let nextUrl: string \| null = null;\n\n if (finalPerPage !== undefined) {\n paginatedServers = serverList.slice(actualOffset, actualOffset + finalPerPage);\n\n // Calculate next URL if there are more results\n if (actualOffset + finalPerPage < totalCount) {\n const nextPage = (finalPage ?? 0) + 1;\n // Return next URL in same format as request (legacy limit/offset or page/perPage)\n const prefix = routePrefix ?? '';\n if (useLegacyFormat) {\n const nextOffset = actualOffset + finalPerPage;\n nextUrl = `${prefix}/mcp/v0/servers?limit=${finalPerPage}&offset=${nextOffset}`;\n } else {\n nextUrl = `${prefix}/mcp/v0/servers?perPage=${finalPerPage}&page=${nextPage}`;\n }\n }\n }\n\n // Get server info for each server\n const serverInfoList: MCPServerInfoResponse[] = paginatedServers.map(server => ({\n ...server.getServerInfo(),\n transports: transportsOf(server),\n ...eventsCapabilityOf(server),\n ...tasksCapabilityOf(server),\n }));\n\n return {\n servers: serverInfoList,\n total_count: totalCount,\n next: nextUrl,\n };\n },\n});\n\nexport const GET_MCP_SERVER_DETAIL_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/v0/servers/:id',\n responseType: 'json',\n pathParamSchema: mcpServerDetailPathParams,\n queryParamSchema: getMcpServerDetailQuerySchema,\n responseSchema: serverDetailSchema,\n summary: 'Get MCP server details',\n description: 'Returns detailed information about a specific MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, id, version }: ServerContext & { id: string; version?: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(id);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${id}' not found` });\n }\n\n const serverDetail = {\n ...server.getServerDetail(),\n transports: transportsOf(server),\n ...eventsCapabilityOf(server),\n ...tasksCapabilityOf(server),\n };\n\n // If a specific version was requested, check if it matches\n if (version && serverDetail.version_detail.version !== version) {\n throw new HTTPException(404, {\n message: `MCP server with ID '${id}' found, but not version '${version}'. Available version: ${serverDetail.version_detail.version}`,\n });\n }\n\n return serverDetail;\n },\n});\n\nexport const LIST_MCP_SERVER_TOOLS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tools',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n responseSchema: listMcpServerToolsResponseSchema,\n summary: 'List MCP server tools',\n description: 'Returns a list of tools available on the specified MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, requestContext }: ServerContext & { serverId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.getToolListInfo !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot list tools in this way.` });\n }\n\n return await server.getToolListInfo(requestContext);\n },\n});\n\nexport const GET_MCP_SERVER_TOOL_DETAIL_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tools/:toolId',\n responseType: 'json',\n pathParamSchema: mcpServerToolPathParams,\n responseSchema: mcpToolInfoSchema,\n summary: 'Get MCP server tool details',\n description: 'Returns detailed information about a specific tool on the MCP server',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, toolId }: ServerContext & { serverId: string; toolId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.getToolInfo !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot provide tool details in this way.` });\n }\n\n const toolInfo = await server.getToolInfo(toolId);\n if (!toolInfo) {\n throw new HTTPException(404, { message: `Tool with ID '${toolId}' not found on MCP server '${serverId}'` });\n }\n\n return toolInfo;\n },\n});\n\nexport const EXECUTE_MCP_SERVER_TOOL_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tools/:toolId/execute',\n responseType: 'json',\n pathParamSchema: mcpServerToolPathParams,\n bodySchema: executeToolBodySchema,\n responseSchema: executeToolResponseSchema,\n summary: 'Execute MCP server tool',\n description: 'Executes a tool on the specified MCP server with the provided arguments',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n toolId,\n data,\n resumeData,\n suspendPayload,\n requestContext,\n }: ServerContext & {\n serverId: string;\n toolId: string;\n data?: unknown;\n resumeData?: unknown;\n suspendPayload?: unknown;\n }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.executeTool !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' cannot execute tools in this way.` });\n }\n\n if (server.mcpVersion === 2) {\n // A 2026-07-28 server runs the tool with no protocol client attached: a tool\n // that suspends for input is reported as such instead of pretending it finished, and\n // the caller answers by sending the same args with `resumeData` and `suspendPayload`.\n let execution: MCPToolExecutionResultV2;\n try {\n execution = await server.executeTool(toolId, data, { requestContext, resumeData, suspendPayload });\n } catch (error) {\n if (error instanceof MastraError && error.id === 'MCP_SERVER_TOOL_INVALID_INPUT') {\n throw new HTTPException(400, { message: error.message, cause: error });\n }\n throw error;\n }\n if (execution.status === 'suspended') {\n return {\n status: 'suspended' as const,\n suspendPayload: execution.suspendPayload,\n resumeSchema: execution.resumeSchema,\n };\n }\n return { result: execution.output };\n }\n\n const result = await server.executeTool(toolId, data, { requestContext });\n return { result };\n },\n});\n\n// ============================================================================\n// MCP Resource Routes\n// ============================================================================\n\nexport const LIST_MCP_SERVER_RESOURCES_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/resources',\n responseType: 'json',\n pathParamSchema: mcpServerResourcePathParams,\n responseSchema: listResourcesResponseSchema,\n summary: 'List MCP server resources',\n description: 'Returns a list of resources available on the MCP server, including ui:// app resources',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.listResources !== 'function') {\n return { resources: [] };\n }\n\n return server.listResources();\n },\n});\n\nexport const READ_MCP_SERVER_RESOURCE_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/resources/read',\n responseType: 'json',\n pathParamSchema: mcpServerResourcePathParams,\n bodySchema: readResourceBodySchema,\n responseSchema: readResourceResponseSchema,\n summary: 'Read MCP server resource content',\n description: 'Reads the content of a resource by URI, used for rendering MCP App ui:// resources',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId, uri }: ServerContext & { serverId: string; uri: string }) => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n\n if (typeof server.readResource !== 'function') {\n throw new HTTPException(501, { message: `Server '${serverId}' does not support reading resources` });\n }\n\n try {\n return await server.readResource(uri);\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n if (message.includes('not found') \|\| message.includes('not configured')) {\n throw new HTTPException(404, { message: `Resource '${uri}' not found on server '${serverId}'` });\n }\n throw error;\n }\n },\n});\n\n// ============================================================================\n// MCP Event Routes (experimental; used by Studio)\n// ============================================================================\n\n/** Present only for servers that declare event types, so older responses stay unchanged. /\nfunction eventsCapabilityOf(server: MastraMCPServerImplementation): { events_capability?: true } {\n const events = typeof server.getEventsInfo === 'function' ? server.getEventsInfo()?.events : undefined;\n return events && events.length > 0 ? { events_capability: true } : {};\n}\n\nfunction isTestEmitEnabled(): boolean {\n return process.env.MASTRA_DEV === 'true';\n}\n\nfunction getEventsServer(mastra: Mastra \| undefined, serverId: string): MastraMCPServerImplementation {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n const server = mastra.getMCPServerById(serverId);\n if (!server) {\n throw new HTTPException(404, { message: `MCP server with ID '${serverId}' not found` });\n }\n return server;\n}\n\nfunction getEventsInspector(server: MastraMCPServerImplementation): MCPServerEventsInspector {\n const inspector = typeof server.getEventsInspector === 'function' ? server.getEventsInspector() : undefined;\n if (!inspector) throw new HTTPException(404, { message: 'Event not found' });\n return inspector;\n}\n\ntype EventErrorId = (typeof MCP_SERVER_EVENT_ERROR_IDS)[keyof typeof MCP_SERVER_EVENT_ERROR_IDS];\n\n// Keyed by the literal ids rather than the core constant, so @mastra/server still\n// runs against a @mastra/core release that doesn't export MCP_SERVER_EVENT_ERROR_IDS.\n// The record type keeps the ids in sync with core at compile time.\nconst EVENT_ERROR_RESPONSES: Record<EventErrorId, { status: 400 \| 403 \| 404 \| 429; message: string }> = {\n MCP_SERVER_UNKNOWN_EVENT: { status: 404, message: 'Event not found' },\n MCP_SERVER_EVENT_UNSUPPORTED_DELIVERY: {\n status: 400,\n message: 'This event does not support streaming; poll it instead',\n },\n MCP_SERVER_EVENT_INVALID_ARGUMENTS: { status: 400, message: 'Invalid event arguments' },\n MCP_SERVER_EVENT_NOT_EMITTABLE: {\n status: 400,\n message: 'This event is fed by a poll source and cannot be emitted',\n },\n MCP_SERVER_EVENT_INVALID_PAYLOAD: { status: 400, message: 'Invalid event data' },\n MCP_SERVER_EVENT_FORBIDDEN: { status: 403, message: 'Not allowed to use this event' },\n MCP_SERVER_EVENT_TOO_MANY_STREAMS: { status: 429, message: 'Too many open event streams' },\n};\n\n/\n Maps event errors to generic HTTP errors. The details (which can come from a poll\n * source or an upstream API) are only logged, never returned.\n /\nfunction toEventsHttpError(error: unknown, mastra: Mastra \| undefined, context: string): HTTPException {\n if (error instanceof HTTPException) return error;\n const known = error instanceof MastraError ? EVENT_ERROR_RESPONSES[error.id as EventErrorId] : undefined;\n if (known) return new HTTPException(known.status, { message: known.message });\n mastra?.getLogger()?.error(`MCP event request failed: ${context}`, { error });\n return new HTTPException(500, { message: 'Event request failed' });\n}\n\nexport const LIST_MCP_SERVER_EVENTS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/events',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n responseSchema: listMcpServerEventsResponseSchema,\n summary: 'List MCP server events',\n description: 'Returns the event types the MCP server declares (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }) => {\n const server = getEventsServer(mastra, serverId);\n const events = typeof server.getEventsInfo === 'function' ? (server.getEventsInfo()?.events ?? []) : [];\n return { events, testEmit: isTestEmitEnabled() };\n },\n});\n\nexport const POLL_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/poll',\n responseType: 'json',\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: pollMcpServerEventBodySchema,\n responseSchema: pollMcpServerEventResponseSchema,\n summary: 'Poll an MCP server event',\n description: 'Reads occurrences of an event type, like the events/poll MCP request (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n // Same permission as streaming: both read occurrences through the event's source.\n requiresPermission: 'mcp:execute',\n handler: async ({\n mastra,\n serverId,\n eventName,\n arguments: args,\n cursor,\n maxEvents,\n requestContext,\n abortSignal,\n }: ServerContext & {\n serverId: string;\n eventName: string;\n arguments?: Record<string, unknown>;\n cursor?: string \| null;\n maxEvents?: number;\n }) => {\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n try {\n return await inspector.poll(\n eventName,\n { arguments: args, cursor, maxEvents },\n { requestContext, signal: abortSignal },\n );\n } catch (error) {\n throw toEventsHttpError(error, mastra, `poll ${serverId}/${eventName}`);\n }\n },\n});\n\nexport const STREAM_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/stream',\n responseType: 'stream' as const,\n streamFormat: 'sse' as const,\n sseFlushOnConnect: true,\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: streamMcpServerEventBodySchema,\n responseSchema: mcpServerEventStreamFrameSchema,\n summary: 'Stream an MCP server event',\n description:\n 'Streams occurrences of an event type as server-sent events, like the events/stream MCP request (experimental)',\n tags: ['MCP', 'Streaming'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n eventName,\n arguments: args,\n cursor,\n requestContext,\n abortSignal,\n }: ServerContext & {\n serverId: string;\n eventName: string;\n arguments?: Record<string, unknown>;\n cursor?: string \| null;\n }) => {\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n const controller = new AbortController();\n const abort = () => controller.abort();\n if (abortSignal?.aborted) abort();\n else abortSignal?.addEventListener('abort', abort, { once: true });\n\n // Frames sent before the stream's `start` runs are buffered here.\n const buffered: MCPServerEventStreamFrame[] = [];\n let sink: ReadableStreamDefaultController<MCPServerEventStreamFrame> \| undefined;\n let done = false;\n const finish = () => {\n if (done) return;\n done = true;\n abortSignal?.removeEventListener('abort', abort);\n abort();\n try {\n sink?.close();\n } catch {\n // Already closed or cancelled by the client.\n }\n };\n\n let closed: Promise<void>;\n try {\n ({ closed } = await inspector.stream(\n eventName,\n { arguments: args, cursor },\n {\n signal: controller.signal,\n requestContext,\n onFrame: frame => {\n if (done) return;\n if (sink) sink.enqueue(frame);\n else buffered.push(frame);\n if (frame.type === 'terminated') finish();\n },\n },\n ));\n } catch (error) {\n finish();\n throw toEventsHttpError(error, mastra, `stream ${serverId}/${eventName}`);\n }\n void closed.then(finish);\n\n return new ReadableStream<MCPServerEventStreamFrame>({\n start(streamController) {\n if (done) {\n for (const frame of buffered.splice(0)) streamController.enqueue(frame);\n streamController.close();\n return;\n }\n sink = streamController;\n for (const frame of buffered.splice(0)) streamController.enqueue(frame);\n },\n cancel() {\n finish();\n },\n });\n },\n});\n\nexport const EMIT_MCP_SERVER_EVENT_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/events/:eventName/emit',\n responseType: 'json',\n pathParamSchema: mcpServerEventPathParams,\n bodySchema: emitMcpServerEventBodySchema,\n responseSchema: emitMcpServerEventResponseSchema,\n summary: 'Send a test MCP server event',\n description:\n 'Emits a test occurrence of an emit-fed event type. Only served under `mastra dev`; otherwise 404 (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n eventName,\n data,\n }: ServerContext & { serverId: string; eventName: string; data: Record<string, unknown> }) => {\n if (!isTestEmitEnabled()) throw new HTTPException(404, { message: 'Not Found' });\n const inspector = getEventsInspector(getEventsServer(mastra, serverId));\n try {\n return { occurrence: await inspector.emit(eventName, data) };\n } catch (error) {\n throw toEventsHttpError(error, mastra, `emit ${serverId}/${eventName}`);\n }\n },\n});\n\n// ============================================================================\n// MCP Task Routes (experimental; Studio admin view)\n// ============================================================================\n\n/* Present only for servers that run something as an MCP task, so older responses stay unchanged. /\nfunction tasksCapabilityOf(server: MastraMCPServerImplementation): { tasks_capability?: true } {\n const info = typeof server.getTasksInfo === 'function' ? server.getTasksInfo() : undefined;\n return info?.enabled ? { tasks_capability: true } : {};\n}\n\nconst TASK_NOT_FOUND = 'Task not found';\n\n/\n Tasks belong to MCP principals, which have no mapping to Mastra resources, so a\n * resource-scoped caller can't be shown or act on any of them. Only an unscoped caller\n * (no resource in the request context) gets the inspector.\n /\nfunction getTasksInspector(\n server: MastraMCPServerImplementation,\n requestContext: ServerContext['requestContext'],\n): MCPServerTasksInspector \| undefined {\n if (getContextResourceId(requestContext) !== undefined) return undefined;\n return typeof server.getTasksInspector === 'function' ? server.getTasksInspector() : undefined;\n}\n\nfunction toTasksHttpError(error: unknown, mastra: Mastra \| undefined, context: string): HTTPException {\n if (error instanceof HTTPException) return error;\n mastra?.getLogger()?.error(`MCP task request failed: ${context}`, { error });\n return new HTTPException(500, { message: 'Task request failed' });\n}\n\nexport const LIST_MCP_SERVER_TASKS_ROUTE = createRoute({\n method: 'GET',\n path: '/mcp/:serverId/tasks',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n queryParamSchema: listMcpServerTasksQuerySchema,\n responseSchema: listMcpServerTasksResponseSchema,\n summary: 'List MCP server tasks',\n description:\n \"Returns which tools run as MCP tasks and the server's recent tasks across principals, identified by task key; never task ids or principals (experimental)\",\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({\n mastra,\n serverId,\n limit,\n cursor,\n status,\n surface,\n client,\n key,\n requestContext,\n }: ServerContext & { serverId: string } & z.infer<typeof listMcpServerTasksQuerySchema>) => {\n const server = getEventsServer(mastra, serverId);\n const info = typeof server.getTasksInfo === 'function' ? server.getTasksInfo() : undefined;\n if (!info?.enabled) return { surfaces: [], tasks: [] };\n const base = { surfaces: info.surfaces };\n if (getContextResourceId(requestContext) !== undefined) {\n return { ...base, unavailable: 'resource_scoped' as const, tasks: [] };\n }\n const inspector = getTasksInspector(server, requestContext);\n if (!inspector) return { ...base, unavailable: 'not_listable' as const, tasks: [] };\n try {\n const { tasks, nextCursor } = await inspector.list({\n limit: limit ?? DEFAULT_MCP_SERVER_TASKS_LIMIT,\n cursor,\n status,\n surface,\n principalKey: client,\n taskKey: key,\n });\n return { ...base, tasks, ...(nextCursor && { nextCursor }) };\n } catch (error) {\n throw toTasksHttpError(error, mastra, `list ${serverId}`);\n }\n },\n});\n\nexport const FIND_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/find',\n responseType: 'json',\n pathParamSchema: mcpServerIdPathParams,\n bodySchema: findMcpServerTaskBodySchema,\n responseSchema: findMcpServerTaskResponseSchema,\n summary: 'Find an MCP server task by task id',\n description:\n 'Finds a task by its MCP task id, as a client sees it. The id is hashed before the lookup and is not kept or returned (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n // A lookup, not a change: POST only keeps the raw id out of URLs, so it needs read like the list.\n requiresPermission: 'mcp:read',\n handler: async ({\n mastra,\n serverId,\n taskId,\n requestContext,\n }: ServerContext & { serverId: string; taskId: string }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let task: Awaited<ReturnType<MCPServerTasksInspector['find']>>;\n try {\n task = await inspector.find(taskId);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `find ${serverId}`);\n }\n if (!task) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { task };\n },\n});\n\nexport const CANCEL_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/:taskKey/cancel',\n responseType: 'json',\n pathParamSchema: mcpServerTaskPathParams,\n responseSchema: mcpServerTaskActionResponseSchema,\n summary: 'Cancel an MCP server task',\n description: 'Cancels a running task by key, like the tasks/cancel MCP request (experimental)',\n tags: ['MCP'],\n requiresAuth: true,\n requiresPermission: 'mcp:write',\n handler: async ({\n mastra,\n serverId,\n taskKey,\n requestContext,\n }: ServerContext & { serverId: string; taskKey: string }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let cancelled: boolean;\n try {\n cancelled = await inspector.cancel(taskKey);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `cancel ${serverId}`);\n }\n if (!cancelled) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { success: true as const };\n },\n});\n\nexport const ANSWER_MCP_SERVER_TASK_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/tasks/:taskKey/input',\n responseType: 'json',\n pathParamSchema: mcpServerTaskPathParams,\n bodySchema: answerMcpServerTaskBodySchema,\n responseSchema: mcpServerTaskActionResponseSchema,\n summary: 'Answer an MCP server task input request',\n description:\n \"Answers a task's open input requests by key, like the tasks/update MCP request; 404 unless the task is waiting for one of them (experimental)\",\n tags: ['MCP'],\n requiresAuth: true,\n requiresPermission: 'mcp:write',\n handler: async ({\n mastra,\n serverId,\n taskKey,\n inputResponses,\n requestContext,\n }: ServerContext & {\n serverId: string;\n taskKey: string;\n inputResponses: Record<string, Record<string, unknown>>;\n }) => {\n const inspector = getTasksInspector(getEventsServer(mastra, serverId), requestContext);\n if (!inspector) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n let answered: boolean;\n try {\n answered = await inspector.answer(taskKey, inputResponses);\n } catch (error) {\n throw toTasksHttpError(error, mastra, `answer ${serverId}`);\n }\n if (!answered) throw new HTTPException(404, { message: TASK_NOT_FOUND });\n return { success: true as const };\n },\n});\n\n// ============================================================================\n// MCP Transport Routes (Streamable HTTP and SSE)\n// ============================================================================\n\n/\n MCP transport options that can be passed to startHTTP() or startSSE().\n * Includes serverless mode for running in stateless environments like Cloudflare Workers or Vercel Edge.\n /\nexport interface MCPTransportOptions {\n /\n When true, runs in stateless mode without session management.\n * Ideal for serverless environments where you can't maintain persistent connections.\n /\n serverless?: boolean;\n /\n Custom session ID generator function.\n /\n sessionIdGenerator?: () => string;\n /\n Sets `req.auth` before the MCP transport reads it. Overrides the default\n * bridge that forwards the principal resolved by `server.auth`.\n /\n setRequestAuth?: SetMcpRequestAuth;\n}\n\n/\n MCP HTTP Transport response type.\n * Adapters use this to set up the HTTP transport via MCPServer.startHTTP()\n /\nexport interface MCPHttpTransportResult {\n server: MastraMCPServerImplementation;\n httpPath: string;\n /\n Optional MCP transport options for this specific route.\n * These override any class-level mcpOptions configured on the adapter.\n /\n mcpOptions?: MCPTransportOptions;\n}\n\n/\n MCP SSE Transport response type.\n * Adapters use this to set up the SSE transport via MCPServer.startSSE() or startHonoSSE()\n \n Note: SSE transport is inherently stateful and doesn't support serverless mode.\n /\nexport interface MCPSseTransportResult {\n /* A 1.x server: the SSE route only resolves servers that still implement the transport. */\n server: MastraMCPServerImplementation;\n ssePath: string;\n messagePath: string;\n}\n\nexport const MCP_HTTP_TRANSPORT_ROUTE = createRoute({\n method: 'ALL',\n path: '/mcp/:serverId/mcp',\n responseType: 'mcp-http',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP HTTP Transport',\n description: 'Streamable HTTP transport endpoint for MCP protocol communication',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPHttpTransportResult> => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n }\n\n return {\n server,\n httpPath: `/mcp/${serverId}/mcp`,\n };\n },\n});\n\nexport const MCP_SSE_TRANSPORT_ROUTE = createRoute({\n method: 'ALL',\n path: '/mcp/:serverId/sse',\n responseType: 'mcp-sse',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP SSE Transport',\n description: 'SSE transport endpoint for MCP protocol communication',\n tags: ['MCP'],\n requiresAuth: true,\n handler: async ({ mastra, serverId }: ServerContext & { serverId: string }): Promise<MCPSseTransportResult> => {\n if (!mastra \|\| typeof mastra.getMCPServerById !== 'function') {\n throw new HTTPException(500, { message: 'Mastra instance or getMCPServerById method not available' });\n }\n\n const server = mastra.getMCPServerById(serverId);\n\n if (!server) {\n throw new HTTPException(404, { message: `MCP server '${serverId}' not found` });\n }\n\n if (!hasSSETransport(server)) {\n throw new HTTPException(404, { message: 'Legacy SSE transport is unavailable for MCP v2 servers' });\n }\n\n return {\n server,\n ssePath: `/mcp/${serverId}/sse`,\n messagePath: `/mcp/${serverId}/messages`,\n };\n },\n});\n\nexport const MCP_SSE_MESSAGES_ROUTE = createRoute({\n method: 'POST',\n path: '/mcp/:serverId/messages',\n responseType: 'mcp-sse',\n pathParamSchema: mcpServerIdPathParams,\n summary: 'MCP SSE Messages',\n description: 'Message endpoint for SSE transport (posts messages to active SSE streams)',\n tags: ['MCP'],\n requiresAuth: true,\n handler: MCP_SSE_TRANSPORT_ROUTE.handler,\n});\n"],"mappings":"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"}

package/dist/{memory-Dqod_AK9.cjs → memory-DIos0BE-.cjs} RENAMED Viewed

@@ -1,9 +1,9 @@
 const require_rolldown_runtime = require("./rolldown-runtime-10nMEhjP.cjs");
+const require_utils = require("./utils-BXEJ6FZC.cjs");
 const require_http_exception = require("./http-exception-Co3MbFUf.cjs");
-const require_route_builder = require("./route-builder-CvARmqnA.cjs");
-const require_server_handlers_error = require("./server/handlers/error.cjs");
-const require_utils = require("./utils-9PRHHTGC.cjs");
 const require_memory = require("./memory--xJDrSwF.cjs");
+const require_route_builder = require("./route-builder-DHqDrSSy.cjs");
+const require_server_handlers_error = require("./server/handlers/error.cjs");
 const require_server_handlers_gateway_memory_client = require("./server/handlers/gateway-memory-client.cjs");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_error = require("@mastra/core/error");
@@ -300,12 +300,29 @@ const GET_MEMORY_STATUS_ROUTE = require_route_builder.createRoute({
 				let omStatus;
 				if (agent) {
 					const omConfig = await getOMConfigFromAgent(agent, requestContext);
-					if (omConfig?.enabled && resourceId) {
+					const effectiveResourceId = require_utils.getEffectiveResourceId(requestContext, resourceId);
+					let threadMissing = false;
+					if (omConfig?.enabled && effectiveResourceId && threadId) {
+						const thread = await memory.getThreadById({ threadId });
+						await require_utils.enforceThreadAccess({
+							mastra,
+							requestContext,
+							threadId,
+							thread,
+							effectiveResourceId
+						});
+						threadMissing = !thread && omConfig.scope !== "resource";
+					}
+					if (omConfig?.enabled && effectiveResourceId && threadMissing) omStatus = {
+						enabled: true,
+						hasRecord: false
+					};
+					else if (omConfig?.enabled && effectiveResourceId) {
 						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);
+								const status = await getOMStatus(memoryStore, effectiveResourceId, omThreadId);
 								if (status) omStatus = {
 									enabled: true,
 									...status,
@@ -404,9 +421,9 @@ const GET_OBSERVATIONAL_MEMORY_ROUTE = require_route_builder.createRoute({
 				to,
 				offset
 			};
-			if (await require_server_handlers_gateway_memory_client.isGatewayAgentAsync(agent)) {
-				const gwClient = require_server_handlers_gateway_memory_client.getGatewayClient();
-				if (gwClient && resourceId && threadId) {
+			const gwClient = await require_server_handlers_gateway_memory_client.isGatewayAgentAsync(agent) ? require_server_handlers_gateway_memory_client.getGatewayClient() : null;
+			if (gwClient) {
+				if (resourceId && threadId) {
 					const [recordResult, historyResult] = await Promise.all([gwClient.getObservationRecord(threadId, resourceId), gwClient.getObservationHistory(threadId, {
 						resourceId,
 						limit: historyLimit,
@@ -439,8 +456,22 @@ const GET_OBSERVATIONAL_MEMORY_ROUTE = require_route_builder.createRoute({
 				throw new require_http_exception.HTTPException(400, { message: "Memory storage is not initialized" });
 			}
 			if (!memoryStore) throw new require_http_exception.HTTPException(400, { message: "Memory storage is not initialized" });
-			const effectiveResourceId = resourceId;
+			const effectiveResourceId = require_utils.getEffectiveResourceId(requestContext, resourceId);
 			if (!effectiveResourceId) throw new require_http_exception.HTTPException(400, { message: "resourceId is required for observational memory lookup" });
+			if (threadId) {
+				const thread = await memory.getThreadById({ threadId });
+				await require_utils.enforceThreadAccess({
+					mastra,
+					requestContext,
+					threadId,
+					thread,
+					effectiveResourceId
+				});
+				if (!thread && omConfig.scope !== "resource") return {
+					record: null,
+					history: void 0
+				};
+			}
 			const omThreadId = omConfig.scope === "resource" ? null : threadId ?? null;
 			const record = await memoryStore.getObservationalMemory(omThreadId, effectiveResourceId);
 			const history = await memoryStore.getObservationalMemoryHistory(omThreadId, effectiveResourceId, historyLimit, historyOptions);
@@ -471,9 +502,9 @@ const AWAIT_BUFFER_STATUS_ROUTE = require_route_builder.createRoute({
 				requestContext
 			});
 			if (!agent) throw new require_http_exception.HTTPException(404, { message: "Agent not found" });
-			if (await require_server_handlers_gateway_memory_client.isGatewayAgentAsync(agent)) {
-				const gwClient = require_server_handlers_gateway_memory_client.getGatewayClient();
-				if (gwClient && resourceId && threadId) {
+			const gwClient = await require_server_handlers_gateway_memory_client.isGatewayAgentAsync(agent) ? require_server_handlers_gateway_memory_client.getGatewayClient() : null;
+			if (gwClient) {
+				if (resourceId && threadId) {
 					const maxWaitMs = 3e4;
 					const pollIntervalMs = 1e3;
 					const deadline = Date.now() + maxWaitMs;
@@ -492,7 +523,6 @@ const AWAIT_BUFFER_STATUS_ROUTE = require_route_builder.createRoute({
 			if (!omConfig?.enabled) throw new require_http_exception.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 require_http_exception.HTTPException(400, { message: "Observational Memory processor not available" });
-			await omProcessor.waitForBuffering(threadId, resourceId);
 			const memory = await getMemoryFromContext({
 				mastra,
 				agentId,
@@ -506,8 +536,20 @@ const AWAIT_BUFFER_STATUS_ROUTE = require_route_builder.createRoute({
 				throw new require_http_exception.HTTPException(400, { message: "Memory storage is not initialized" });
 			}
 			if (!memoryStore) throw new require_http_exception.HTTPException(400, { message: "Memory storage is not initialized" });
-			const effectiveResourceId = resourceId;
+			const effectiveResourceId = require_utils.getEffectiveResourceId(requestContext, resourceId);
 			if (!effectiveResourceId) throw new require_http_exception.HTTPException(400, { message: "resourceId is required" });
+			if (threadId) {
+				const thread = await memory.getThreadById({ threadId });
+				await require_utils.enforceThreadAccess({
+					mastra,
+					requestContext,
+					threadId,
+					thread,
+					effectiveResourceId
+				});
+				if (!thread && omConfig.scope !== "resource") return { record: null };
+			}
+			await omProcessor.waitForBuffering(threadId, effectiveResourceId);
 			const omThreadId = omConfig.scope === "resource" ? null : threadId ?? null;
 			return { record: await memoryStore.getObservationalMemory(omThreadId, effectiveResourceId) ?? null };
 		} catch (error) {
@@ -1901,4 +1943,4 @@ Object.defineProperty(exports, "memory_exports", {
 	}
 });
-//# sourceMappingURL=memory-Dqod_AK9.cjs.map
+//# sourceMappingURL=memory-DIos0BE-.cjs.map