@mastra/server 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/chunk-S6DFGBDD.cjs

@@ -0,0 +1,211 @@
+'use strict';
+
+var chunkMWQQRVQC_cjs = require('./chunk-MWQQRVQC.cjs');
+var chunkGU4EWMZB_cjs = require('./chunk-GU4EWMZB.cjs');
+var chunk5W4RPVTK_cjs = require('./chunk-5W4RPVTK.cjs');
+var chunk2NW6POYK_cjs = require('./chunk-2NW6POYK.cjs');
+var chunkSAQSK4AG_cjs = require('./chunk-SAQSK4AG.cjs');
+var chunkV5WWQN7P_cjs = require('./chunk-V5WWQN7P.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunkO7I5CWRX_cjs = require('./chunk-O7I5CWRX.cjs');
+var tools = require('@mastra/core/tools');
+var zodToJson = require('@mastra/core/utils/zod-to-json');
+
+// src/server/handlers/tools.ts
+var tools_exports = {};
+chunkO7I5CWRX_cjs.__export(tools_exports, {
+  EXECUTE_AGENT_TOOL_ROUTE: () => EXECUTE_AGENT_TOOL_ROUTE,
+  EXECUTE_TOOL_ROUTE: () => EXECUTE_TOOL_ROUTE,
+  GET_AGENT_TOOL_ROUTE: () => GET_AGENT_TOOL_ROUTE,
+  GET_TOOL_BY_ID_ROUTE: () => GET_TOOL_BY_ID_ROUTE,
+  LIST_TOOLS_ROUTE: () => LIST_TOOLS_ROUTE
+});
+var LIST_TOOLS_ROUTE = chunkSAQSK4AG_cjs.createRoute({
+  method: "GET",
+  path: "/api/tools",
+  responseType: "json",
+  responseSchema: chunkMWQQRVQC_cjs.listToolsResponseSchema,
+  summary: "List all tools",
+  description: "Returns a list of all available tools in the system",
+  tags: ["Tools"],
+  handler: async ({ mastra, tools }) => {
+    try {
+      const allTools = tools || mastra.listTools() || {};
+      const serializedTools = Object.entries(allTools).reduce(
+        (acc, [id, _tool]) => {
+          const tool = _tool;
+          acc[id] = {
+            ...tool,
+            inputSchema: tool.inputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.inputSchema)) : void 0,
+            outputSchema: tool.outputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.outputSchema)) : void 0
+          };
+          return acc;
+        },
+        {}
+      );
+      return serializedTools;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting tools");
+    }
+  }
+});
+var GET_TOOL_BY_ID_ROUTE = chunkSAQSK4AG_cjs.createRoute({
+  method: "GET",
+  path: "/api/tools/:toolId",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.toolIdPathParams,
+  responseSchema: chunkMWQQRVQC_cjs.serializedToolSchema,
+  summary: "Get tool by ID",
+  description: "Returns details for a specific tool including its schema and configuration",
+  tags: ["Tools"],
+  handler: async ({ mastra, tools, toolId }) => {
+    try {
+      let tool;
+      if (tools && Object.keys(tools).length > 0) {
+        tool = Object.values(tools).find((t) => t.id === toolId);
+      } else {
+        tool = mastra.getToolById(toolId);
+      }
+      if (!tool) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Tool not found" });
+      }
+      const serializedTool = {
+        ...tool,
+        inputSchema: tool.inputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.inputSchema)) : void 0,
+        outputSchema: tool.outputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.outputSchema)) : void 0
+      };
+      return serializedTool;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting tool");
+    }
+  }
+});
+var EXECUTE_TOOL_ROUTE = chunkSAQSK4AG_cjs.createRoute({
+  method: "POST",
+  path: "/api/tools/:toolId/execute",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.toolIdPathParams,
+  queryParamSchema: chunk2NW6POYK_cjs.optionalRunIdSchema,
+  bodySchema: chunkMWQQRVQC_cjs.executeToolContextBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.executeToolResponseSchema,
+  summary: "Execute tool",
+  description: "Executes a specific tool with the provided input data",
+  tags: ["Tools"],
+  handler: async ({ mastra, runId, toolId, tools: tools$1, requestContext, ...bodyParams }) => {
+    try {
+      if (!toolId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Tool ID is required" });
+      }
+      let tool;
+      if (tools$1 && Object.keys(tools$1).length > 0) {
+        tool = Object.values(tools$1).find((t) => t.id === toolId);
+      } else {
+        tool = mastra.getToolById(toolId);
+      }
+      if (!tool) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Tool not found" });
+      }
+      if (!tool?.execute) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Tool is not executable" });
+      }
+      const { data } = bodyParams;
+      chunk5W4RPVTK_cjs.validateBody({ data });
+      if (tools.isVercelTool(tool)) {
+        const result2 = await tool.execute(data);
+        return result2;
+      }
+      const result = await tool.execute(data, {
+        mastra,
+        requestContext,
+        // TODO: Pass proper tracing context when server API supports tracing
+        tracingContext: { currentSpan: void 0 },
+        ...runId ? {
+          workflow: {
+            runId,
+            suspend: async () => {
+            }
+          }
+        } : {}
+      });
+      return result;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error executing tool");
+    }
+  }
+});
+var GET_AGENT_TOOL_ROUTE = chunkSAQSK4AG_cjs.createRoute({
+  method: "GET",
+  path: "/api/agents/:agentId/tools/:toolId",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentToolPathParams,
+  responseSchema: chunkMWQQRVQC_cjs.serializedToolSchema,
+  summary: "Get agent tool",
+  description: "Returns details for a specific tool assigned to the agent",
+  tags: ["Agents", "Tools"],
+  handler: async ({ mastra, agentId, toolId, requestContext }) => {
+    try {
+      const agent = agentId ? mastra.getAgentById(agentId) : null;
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Agent not found" });
+      }
+      const agentTools = await agent.listTools({ requestContext });
+      const tool = Object.values(agentTools || {}).find((tool2) => tool2.id === toolId);
+      if (!tool) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Tool not found" });
+      }
+      const serializedTool = {
+        ...tool,
+        inputSchema: tool.inputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.inputSchema)) : void 0,
+        outputSchema: tool.outputSchema ? chunkGU4EWMZB_cjs.stringify(zodToJson.zodToJsonSchema(tool.outputSchema)) : void 0
+      };
+      return serializedTool;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting agent tool");
+    }
+  }
+});
+var EXECUTE_AGENT_TOOL_ROUTE = chunkSAQSK4AG_cjs.createRoute({
+  method: "POST",
+  path: "/api/agents/:agentId/tools/:toolId/execute",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentToolPathParams,
+  bodySchema: chunkMWQQRVQC_cjs.executeToolBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.executeToolResponseSchema,
+  summary: "Execute agent tool",
+  description: "Executes a specific tool assigned to the agent with the provided input data",
+  tags: ["Agents", "Tools"],
+  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {
+    try {
+      const agent = agentId ? mastra.getAgentById(agentId) : null;
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Tool not found" });
+      }
+      const agentTools = await agent.listTools({ requestContext });
+      const tool = Object.values(agentTools || {}).find((tool2) => tool2.id === toolId);
+      if (!tool) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Tool not found" });
+      }
+      if (!tool?.execute) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Tool is not executable" });
+      }
+      const result = await tool.execute(data, {
+        mastra,
+        requestContext,
+        // TODO: Pass proper tracing context when server API supports tracing
+        tracingContext: { currentSpan: void 0 }
+      });
+      return result;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error executing agent tool");
+    }
+  }
+});
+
+exports.EXECUTE_AGENT_TOOL_ROUTE = EXECUTE_AGENT_TOOL_ROUTE;
+exports.EXECUTE_TOOL_ROUTE = EXECUTE_TOOL_ROUTE;
+exports.GET_AGENT_TOOL_ROUTE = GET_AGENT_TOOL_ROUTE;
+exports.GET_TOOL_BY_ID_ROUTE = GET_TOOL_BY_ID_ROUTE;
+exports.LIST_TOOLS_ROUTE = LIST_TOOLS_ROUTE;
+exports.tools_exports = tools_exports;
+//# sourceMappingURL=chunk-S6DFGBDD.cjs.map
+//# sourceMappingURL=chunk-S6DFGBDD.cjs.map

package/dist/chunk-S6DFGBDD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/tools.ts"],"names":["__export","createRoute","listToolsResponseSchema","stringify","zodToJsonSchema","handleError","toolIdPathParams","serializedToolSchema","HTTPException","optionalRunIdSchema","executeToolContextBodySchema","executeToolResponseSchema","tools","validateBody","isVercelTool","result","agentToolPathParams","tool","executeToolBodySchema"],"mappings":"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","file":"chunk-S6DFGBDD.cjs","sourcesContent":["import { isVercelTool } from '@mastra/core/tools';\nimport { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';\nimport { stringify } from 'superjson';\nimport { HTTPException } from '../http-exception';\nimport {\n  executeToolContextBodySchema,\n  executeToolResponseSchema,\n  listToolsResponseSchema,\n  serializedToolSchema,\n  toolIdPathParams,\n  agentToolPathParams,\n  executeToolBodySchema,\n} from '../schemas/agents';\nimport { optionalRunIdSchema } from '../schemas/common';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { handleError } from './error';\nimport { validateBody } from './utils';\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_TOOLS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/tools',\n  responseType: 'json',\n  responseSchema: listToolsResponseSchema,\n  summary: 'List all tools',\n  description: 'Returns a list of all available tools in the system',\n  tags: ['Tools'],\n  handler: async ({ mastra, tools }) => {\n    try {\n      const allTools = tools || mastra.listTools() || {};\n\n      const serializedTools = Object.entries(allTools).reduce(\n        (acc, [id, _tool]) => {\n          const tool = _tool;\n          acc[id] = {\n            ...tool,\n            inputSchema: tool.inputSchema ? stringify(zodToJsonSchema(tool.inputSchema)) : undefined,\n            outputSchema: tool.outputSchema ? stringify(zodToJsonSchema(tool.outputSchema)) : undefined,\n          };\n          return acc;\n        },\n        {} as Record<string, any>,\n      );\n\n      return serializedTools;\n    } catch (error) {\n      return handleError(error, 'Error getting tools');\n    }\n  },\n});\n\nexport const GET_TOOL_BY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get tool by ID',\n  description: 'Returns details for a specific tool including its schema and configuration',\n  tags: ['Tools'],\n  handler: async ({ mastra, tools, toolId }) => {\n    try {\n      let tool: any;\n\n      // Try explicit tools first, then fallback to mastra\n      if (tools && Object.keys(tools).length > 0) {\n        tool = Object.values(tools).find((t: any) => t.id === toolId);\n      } else {\n        tool = mastra.getToolById(toolId);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      const serializedTool = {\n        ...tool,\n        inputSchema: tool.inputSchema ? stringify(zodToJsonSchema(tool.inputSchema)) : undefined,\n        outputSchema: tool.outputSchema ? stringify(zodToJsonSchema(tool.outputSchema)) : undefined,\n      };\n\n      return serializedTool;\n    } catch (error) {\n      return handleError(error, 'Error getting tool');\n    }\n  },\n});\n\nexport const EXECUTE_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: toolIdPathParams,\n  queryParamSchema: optionalRunIdSchema,\n  bodySchema: executeToolContextBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute tool',\n  description: 'Executes a specific tool with the provided input data',\n  tags: ['Tools'],\n  handler: async ({ mastra, runId, toolId, tools, requestContext, ...bodyParams }) => {\n    try {\n      if (!toolId) {\n        throw new HTTPException(400, { message: 'Tool ID is required' });\n      }\n\n      let tool: any;\n\n      // Try explicit tools first, then fallback to mastra\n      if (tools && Object.keys(tools).length > 0) {\n        tool = Object.values(tools).find((t: any) => t.id === toolId);\n      } else {\n        tool = mastra.getToolById(toolId);\n      }\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const { data } = bodyParams;\n\n      validateBody({ data });\n\n      if (isVercelTool(tool)) {\n        const result = await (tool as any).execute(data);\n        return result;\n      }\n\n      const result = await tool.execute(data!, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n        ...(runId\n          ? {\n              workflow: {\n                runId,\n                suspend: async () => {},\n              },\n            }\n          : {}),\n      });\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing tool');\n    }\n  },\n});\n\n// ============================================================================\n// Agent Tool Routes\n// ============================================================================\n\nexport const GET_AGENT_TOOL_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/agents/:agentId/tools/:toolId',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  responseSchema: serializedToolSchema,\n  summary: 'Get agent tool',\n  description: 'Returns details for a specific tool assigned to the agent',\n  tags: ['Agents', 'Tools'],\n  handler: async ({ mastra, agentId, toolId, requestContext }) => {\n    try {\n      const agent = agentId ? mastra.getAgentById(agentId) : null;\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Agent not found' });\n      }\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      const serializedTool = {\n        ...tool,\n        inputSchema: tool.inputSchema ? stringify(zodToJsonSchema(tool.inputSchema)) : undefined,\n        outputSchema: tool.outputSchema ? stringify(zodToJsonSchema(tool.outputSchema)) : undefined,\n      };\n\n      return serializedTool;\n    } catch (error) {\n      return handleError(error, 'Error getting agent tool');\n    }\n  },\n});\n\nexport const EXECUTE_AGENT_TOOL_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/agents/:agentId/tools/:toolId/execute',\n  responseType: 'json',\n  pathParamSchema: agentToolPathParams,\n  bodySchema: executeToolBodySchema,\n  responseSchema: executeToolResponseSchema,\n  summary: 'Execute agent tool',\n  description: 'Executes a specific tool assigned to the agent with the provided input data',\n  tags: ['Agents', 'Tools'],\n  handler: async ({ mastra, agentId, toolId, data, requestContext }) => {\n    try {\n      const agent = agentId ? mastra.getAgentById(agentId) : null;\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      const agentTools = await agent.listTools({ requestContext });\n\n      const tool = Object.values(agentTools || {}).find((tool: any) => tool.id === toolId) as any;\n\n      if (!tool) {\n        throw new HTTPException(404, { message: 'Tool not found' });\n      }\n\n      if (!tool?.execute) {\n        throw new HTTPException(400, { message: 'Tool is not executable' });\n      }\n\n      const result = await tool.execute(data, {\n        mastra,\n        requestContext,\n        // TODO: Pass proper tracing context when server API supports tracing\n        tracingContext: { currentSpan: undefined },\n      });\n\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error executing agent tool');\n    }\n  },\n});\n"]}

package/dist/chunk-SAQSK4AG.cjs

@@ -0,0 +1,167 @@
+'use strict';
+
+var zodToJson = require('@mastra/core/utils/zod-to-json');
+
+// src/server/server-adapter/openapi-utils.ts
+function generateRouteOpenAPI({
+  method,
+  path,
+  summary,
+  description,
+  tags = [],
+  pathParamSchema,
+  queryParamSchema,
+  bodySchema,
+  responseSchema,
+  deprecated
+}) {
+  const route = {
+    summary: summary || `${method} ${path}`,
+    description,
+    tags,
+    deprecated,
+    responses: {
+      200: {
+        description: "Successful response"
+      }
+    }
+  };
+  if (pathParamSchema || queryParamSchema) {
+    route.requestParams = {};
+    if (pathParamSchema) {
+      route.requestParams.path = pathParamSchema;
+    }
+    if (queryParamSchema) {
+      route.requestParams.query = queryParamSchema;
+    }
+  }
+  if (bodySchema) {
+    route.requestBody = {
+      content: {
+        "application/json": {
+          schema: bodySchema
+        }
+      }
+    };
+  }
+  if (responseSchema) {
+    route.responses[200] = {
+      description: "Successful response",
+      content: {
+        "application/json": {
+          schema: responseSchema
+        }
+      }
+    };
+  }
+  return route;
+}
+function convertZodToJsonSchema(spec) {
+  const converted = {
+    summary: spec.summary,
+    description: spec.description,
+    tags: spec.tags,
+    responses: {}
+  };
+  const parameters = [];
+  if (spec.requestParams?.path) {
+    const pathSchema = zodToJson.zodToJsonSchema(spec.requestParams.path, "openApi3", "none");
+    const properties = pathSchema.properties || {};
+    Object.entries(properties).forEach(([name, schema]) => {
+      parameters.push({
+        name,
+        in: "path",
+        required: true,
+        description: schema.description || `The ${name} parameter`,
+        schema
+      });
+    });
+  }
+  if (spec.requestParams?.query) {
+    const querySchema = zodToJson.zodToJsonSchema(spec.requestParams.query, "openApi3", "none");
+    const properties = querySchema.properties || {};
+    const required = querySchema.required || [];
+    Object.entries(properties).forEach(([name, schema]) => {
+      parameters.push({
+        name,
+        in: "query",
+        required: required.includes(name),
+        description: schema.description || `Query parameter: ${name}`,
+        schema
+      });
+    });
+  }
+  if (parameters.length > 0) {
+    converted.parameters = parameters;
+  }
+  if (spec.requestBody?.content?.["application/json"]?.schema) {
+    converted.requestBody = {
+      required: true,
+      content: {
+        "application/json": {
+          schema: zodToJson.zodToJsonSchema(spec.requestBody.content["application/json"].schema, "openApi3", "none")
+        }
+      }
+    };
+  }
+  Object.entries(spec.responses).forEach(([statusCode, response]) => {
+    converted.responses[statusCode] = {
+      description: response.description
+    };
+    if (response.content?.["application/json"]?.schema) {
+      converted.responses[statusCode].content = {
+        "application/json": {
+          schema: zodToJson.zodToJsonSchema(response.content["application/json"].schema, "openApi3", "none")
+        }
+      };
+    }
+  });
+  return converted;
+}
+function generateOpenAPIDocument(routes, info) {
+  const paths = {};
+  routes.forEach((route) => {
+    if (!route.openapi) return;
+    const openapiPath = route.path.replace(/:(\w+)/g, "{$1}");
+    if (!paths[openapiPath]) {
+      paths[openapiPath] = {};
+    }
+    paths[openapiPath][route.method.toLowerCase()] = convertZodToJsonSchema(route.openapi);
+  });
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: info.title,
+      version: info.version,
+      description: info.description
+    },
+    paths
+  };
+}
+
+// src/server/server-adapter/routes/route-builder.ts
+function createRoute(config) {
+  const { summary, description, tags, deprecated, ...baseRoute } = config;
+  const openapi = config.method !== "ALL" ? generateRouteOpenAPI({
+    method: config.method,
+    path: config.path,
+    summary,
+    description,
+    tags,
+    pathParamSchema: config.pathParamSchema,
+    queryParamSchema: config.queryParamSchema,
+    bodySchema: config.bodySchema,
+    responseSchema: config.responseSchema,
+    deprecated
+  }) : void 0;
+  return {
+    ...baseRoute,
+    openapi,
+    deprecated
+  };
+}
+
+exports.createRoute = createRoute;
+exports.generateOpenAPIDocument = generateOpenAPIDocument;
+//# sourceMappingURL=chunk-SAQSK4AG.cjs.map
+//# sourceMappingURL=chunk-SAQSK4AG.cjs.map

package/dist/chunk-SAQSK4AG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/server-adapter/openapi-utils.ts","../src/server/server-adapter/routes/route-builder.ts"],"names":["zodToJsonSchema"],"mappings":"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","file":"chunk-SAQSK4AG.cjs","sourcesContent":["import { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';\nimport type { ZodSchema } from 'zod';\nimport type { ServerRoute } from './routes';\n\ninterface RouteOpenAPIConfig {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  path: string;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  pathParamSchema?: ZodSchema;\n  queryParamSchema?: ZodSchema;\n  bodySchema?: ZodSchema;\n  responseSchema?: ZodSchema;\n  deprecated?: boolean;\n}\n\ninterface OpenAPIRoute {\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  deprecated?: boolean;\n  requestParams?: {\n    path?: ZodSchema;\n    query?: ZodSchema;\n  };\n  requestBody?: {\n    content: {\n      'application/json': {\n        schema: ZodSchema;\n      };\n    };\n  };\n  responses: {\n    [statusCode: string]: {\n      description: string;\n      content?: {\n        'application/json': {\n          schema: ZodSchema;\n        };\n      };\n    };\n  };\n}\n\n/**\n * Generates OpenAPI specification for a single route\n * Extracts path parameters, query parameters, request body, and response schemas\n */\nexport function generateRouteOpenAPI({\n  method,\n  path,\n  summary,\n  description,\n  tags = [],\n  pathParamSchema,\n  queryParamSchema,\n  bodySchema,\n  responseSchema,\n  deprecated,\n}: RouteOpenAPIConfig): OpenAPIRoute {\n  const route: OpenAPIRoute = {\n    summary: summary || `${method} ${path}`,\n    description,\n    tags,\n    deprecated,\n    responses: {\n      200: {\n        description: 'Successful response',\n      },\n    },\n  };\n\n  // Add path and query parameters\n  if (pathParamSchema || queryParamSchema) {\n    route.requestParams = {};\n\n    if (pathParamSchema) {\n      route.requestParams.path = pathParamSchema;\n    }\n\n    if (queryParamSchema) {\n      route.requestParams.query = queryParamSchema;\n    }\n  }\n\n  // Add request body with raw Zod schema\n  if (bodySchema) {\n    route.requestBody = {\n      content: {\n        'application/json': {\n          schema: bodySchema,\n        },\n      },\n    };\n  }\n\n  // Add response schema with raw Zod schema\n  if (responseSchema) {\n    route.responses[200] = {\n      description: 'Successful response',\n      content: {\n        'application/json': {\n          schema: responseSchema,\n        },\n      },\n    };\n  }\n\n  return route;\n}\n\n/**\n * Converts an OpenAPI route spec with Zod schemas to one with JSON Schema\n */\nfunction convertZodToJsonSchema(spec: OpenAPIRoute): any {\n  const converted: any = {\n    summary: spec.summary,\n    description: spec.description,\n    tags: spec.tags,\n    responses: {},\n  };\n\n  const parameters: any[] = [];\n\n  // Convert path parameters\n  if (spec.requestParams?.path) {\n    const pathSchema = zodToJsonSchema(spec.requestParams.path, 'openApi3', 'none') as any;\n    const properties = pathSchema.properties || {};\n\n    Object.entries(properties).forEach(([name, schema]) => {\n      parameters.push({\n        name,\n        in: 'path',\n        required: true,\n        description: (schema as any).description || `The ${name} parameter`,\n        schema,\n      });\n    });\n  }\n\n  // Convert query parameters\n  if (spec.requestParams?.query) {\n    const querySchema = zodToJsonSchema(spec.requestParams.query, 'openApi3', 'none') as any;\n    const properties = querySchema.properties || {};\n    const required = querySchema.required || [];\n\n    Object.entries(properties).forEach(([name, schema]) => {\n      parameters.push({\n        name,\n        in: 'query',\n        required: required.includes(name),\n        description: (schema as any).description || `Query parameter: ${name}`,\n        schema,\n      });\n    });\n  }\n\n  if (parameters.length > 0) {\n    converted.parameters = parameters;\n  }\n\n  // Convert request body\n  if (spec.requestBody?.content?.['application/json']?.schema) {\n    converted.requestBody = {\n      required: true,\n      content: {\n        'application/json': {\n          schema: zodToJsonSchema(spec.requestBody.content['application/json'].schema, 'openApi3', 'none'),\n        },\n      },\n    };\n  }\n\n  // Convert response schemas\n  Object.entries(spec.responses).forEach(([statusCode, response]) => {\n    converted.responses[statusCode] = {\n      description: response.description,\n    };\n\n    if (response.content?.['application/json']?.schema) {\n      converted.responses[statusCode].content = {\n        'application/json': {\n          schema: zodToJsonSchema(response.content['application/json'].schema, 'openApi3', 'none'),\n        },\n      };\n    }\n  });\n\n  return converted;\n}\n\n/**\n * Generates a complete OpenAPI 3.1.0 document from server routes\n * @param routes - Array of ServerRoute objects with OpenAPI specifications\n * @param info - API metadata (title, version, description)\n * @returns Complete OpenAPI 3.1.0 document\n */\nexport function generateOpenAPIDocument(\n  routes: ServerRoute[],\n  info: { title: string; version: string; description?: string },\n): any {\n  const paths: Record<string, any> = {};\n\n  // Build paths object from routes\n  // Convert Express-style :param to OpenAPI-style {param}\n  routes.forEach(route => {\n    if (!route.openapi) return;\n\n    const openapiPath = route.path.replace(/:(\\w+)/g, '{$1}');\n    if (!paths[openapiPath]) {\n      paths[openapiPath] = {};\n    }\n\n    // Convert Zod schemas to JSON Schema\n    paths[openapiPath][route.method.toLowerCase()] = convertZodToJsonSchema(route.openapi);\n  });\n\n  return {\n    openapi: '3.1.0',\n    info: {\n      title: info.title,\n      version: info.version,\n      description: info.description,\n    },\n    paths,\n  };\n}\n","import type z from 'zod';\nimport { generateRouteOpenAPI } from '../openapi-utils';\nimport type { InferParams, ServerRoute, ServerRouteHandler } from './index';\n\ninterface RouteConfig<\n  TPathSchema extends z.ZodTypeAny | undefined = undefined,\n  TQuerySchema extends z.ZodTypeAny | undefined = undefined,\n  TBodySchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseSchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseType extends 'stream' | 'json' | 'datastream-response' = 'json',\n> {\n  method: ServerRoute['method'];\n  path: string;\n  responseType: TResponseType;\n  streamFormat?: 'sse' | 'stream'; // Only used when responseType is 'stream'\n  handler: ServerRouteHandler<\n    InferParams<TPathSchema, TQuerySchema, TBodySchema>,\n    TResponseSchema extends z.ZodTypeAny ? z.infer<TResponseSchema> : unknown,\n    TResponseType\n  >;\n  pathParamSchema?: TPathSchema;\n  queryParamSchema?: TQuerySchema;\n  bodySchema?: TBodySchema;\n  responseSchema?: TResponseSchema;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  deprecated?: boolean;\n  maxBodySize?: number;\n}\n\n/**\n * Creates a server route with auto-generated OpenAPI specification and type-safe handler inference.\n *\n * The handler parameters are automatically inferred from the provided schemas:\n * - pathParamSchema: Infers path parameter types (e.g., :agentId)\n * - queryParamSchema: Infers query parameter types\n * - bodySchema: Infers request body types\n * - Runtime context (mastra, requestContext, tools, taskStore) is always available\n *\n * @param config - Route configuration including schemas, handler, and metadata\n * @returns Complete ServerRoute with OpenAPI spec\n *\n * @example\n * ```typescript\n * export const getAgentRoute = createRoute({\n *   method: 'GET',\n *   path: '/api/agents/:agentId',\n *   responseType: 'json',\n *   pathParamSchema: z.object({ agentId: z.string() }),\n *   responseSchema: serializedAgentSchema,\n *   handler: async ({ agentId, mastra, requestContext }) => {\n *     // agentId is typed as string\n *     // mastra, requestContext, tools, taskStore are always available\n *     return mastra.getAgentById(agentId);\n *   },\n *   summary: 'Get agent by ID',\n *   description: 'Returns details for a specific agent',\n *   tags: ['Agents'],\n * });\n * ```\n */\nexport function createRoute<\n  TPathSchema extends z.ZodTypeAny | undefined = undefined,\n  TQuerySchema extends z.ZodTypeAny | undefined = undefined,\n  TBodySchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseSchema extends z.ZodTypeAny | undefined = undefined,\n  TResponseType extends 'stream' | 'json' | 'datastream-response' = 'json',\n>(\n  config: RouteConfig<TPathSchema, TQuerySchema, TBodySchema, TResponseSchema, TResponseType>,\n): ServerRoute<\n  InferParams<TPathSchema, TQuerySchema, TBodySchema>,\n  TResponseSchema extends z.ZodTypeAny ? z.infer<TResponseSchema> : unknown,\n  TResponseType\n> {\n  const { summary, description, tags, deprecated, ...baseRoute } = config;\n\n  // Generate OpenAPI specification from the route config\n  // Skip OpenAPI generation for 'ALL' method as it doesn't map to OpenAPI\n  const openapi =\n    config.method !== 'ALL'\n      ? generateRouteOpenAPI({\n          method: config.method as 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH',\n          path: config.path,\n          summary,\n          description,\n          tags,\n          pathParamSchema: config.pathParamSchema,\n          queryParamSchema: config.queryParamSchema,\n          bodySchema: config.bodySchema,\n          responseSchema: config.responseSchema,\n          deprecated,\n        })\n      : undefined;\n\n  return {\n    ...baseRoute,\n    openapi: openapi as any,\n    deprecated,\n  };\n}\n"]}