@mastra/server 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/chunk-SXVANU23.js

@@ -0,0 +1,164 @@
+import { zodToJsonSchema } from '@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 = 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 = 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: 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: 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
+  };
+}
+
+export { createRoute, generateOpenAPIDocument };
+//# sourceMappingURL=chunk-SXVANU23.js.map
+//# sourceMappingURL=chunk-SXVANU23.js.map

package/dist/chunk-SXVANU23.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/server-adapter/openapi-utils.ts","../src/server/server-adapter/routes/route-builder.ts"],"names":[],"mappings":";;;AAiDO,SAAS,oBAAA,CAAqB;AAAA,EACnC,MAAA;AAAA,EACA,IAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,OAAO,EAAC;AAAA,EACR,eAAA;AAAA,EACA,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA;AACF,CAAA,EAAqC;AACnC,EAAA,MAAM,KAAA,GAAsB;AAAA,IAC1B,OAAA,EAAS,OAAA,IAAW,CAAA,EAAG,MAAM,IAAI,IAAI,CAAA,CAAA;AAAA,IACrC,WAAA;AAAA,IACA,IAAA;AAAA,IACA,UAAA;AAAA,IACA,SAAA,EAAW;AAAA,MACT,GAAA,EAAK;AAAA,QACH,WAAA,EAAa;AAAA;AACf;AACF,GACF;AAGA,EAAA,IAAI,mBAAmB,gBAAA,EAAkB;AACvC,IAAA,KAAA,CAAM,gBAAgB,EAAC;AAEvB,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,KAAA,CAAM,cAAc,IAAA,GAAO,eAAA;AAAA,IAC7B;AAEA,IAAA,IAAI,gBAAA,EAAkB;AACpB,MAAA,KAAA,CAAM,cAAc,KAAA,GAAQ,gBAAA;AAAA,IAC9B;AAAA,EACF;AAGA,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,KAAA,CAAM,WAAA,GAAc;AAAA,MAClB,OAAA,EAAS;AAAA,QACP,kBAAA,EAAoB;AAAA,UAClB,MAAA,EAAQ;AAAA;AACV;AACF,KACF;AAAA,EACF;AAGA,EAAA,IAAI,cAAA,EAAgB;AAClB,IAAA,KAAA,CAAM,SAAA,CAAU,GAAG,CAAA,GAAI;AAAA,MACrB,WAAA,EAAa,qBAAA;AAAA,MACb,OAAA,EAAS;AAAA,QACP,kBAAA,EAAoB;AAAA,UAClB,MAAA,EAAQ;AAAA;AACV;AACF,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT;AAKA,SAAS,uBAAuB,IAAA,EAAyB;AACvD,EAAA,MAAM,SAAA,GAAiB;AAAA,IACrB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAW;AAAC,GACd;AAEA,EAAA,MAAM,aAAoB,EAAC;AAG3B,EAAA,IAAI,IAAA,CAAK,eAAe,IAAA,EAAM;AAC5B,IAAA,MAAM,aAAa,eAAA,CAAgB,IAAA,CAAK,aAAA,CAAc,IAAA,EAAM,YAAY,MAAM,CAAA;AAC9E,IAAA,MAAM,UAAA,GAAa,UAAA,CAAW,UAAA,IAAc,EAAC;AAE7C,IAAA,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AACrD,MAAA,UAAA,CAAW,IAAA,CAAK;AAAA,QACd,IAAA;AAAA,QACA,EAAA,EAAI,MAAA;AAAA,QACJ,QAAA,EAAU,IAAA;AAAA,QACV,WAAA,EAAc,MAAA,CAAe,WAAA,IAAe,CAAA,IAAA,EAAO,IAAI,CAAA,UAAA,CAAA;AAAA,QACvD;AAAA,OACD,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,IAAA,CAAK,eAAe,KAAA,EAAO;AAC7B,IAAA,MAAM,cAAc,eAAA,CAAgB,IAAA,CAAK,aAAA,CAAc,KAAA,EAAO,YAAY,MAAM,CAAA;AAChF,IAAA,MAAM,UAAA,GAAa,WAAA,CAAY,UAAA,IAAc,EAAC;AAC9C,IAAA,MAAM,QAAA,GAAW,WAAA,CAAY,QAAA,IAAY,EAAC;AAE1C,IAAA,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM;AACrD,MAAA,UAAA,CAAW,IAAA,CAAK;AAAA,QACd,IAAA;AAAA,QACA,EAAA,EAAI,OAAA;AAAA,QACJ,QAAA,EAAU,QAAA,CAAS,QAAA,CAAS,IAAI,CAAA;AAAA,QAChC,WAAA,EAAc,MAAA,CAAe,WAAA,IAAe,CAAA,iBAAA,EAAoB,IAAI,CAAA,CAAA;AAAA,QACpE;AAAA,OACD,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,IAAI,UAAA,CAAW,SAAS,CAAA,EAAG;AACzB,IAAA,SAAA,CAAU,UAAA,GAAa,UAAA;AAAA,EACzB;AAGA,EAAA,IAAI,IAAA,CAAK,WAAA,EAAa,OAAA,GAAU,kBAAkB,GAAG,MAAA,EAAQ;AAC3D,IAAA,SAAA,CAAU,WAAA,GAAc;AAAA,MACtB,QAAA,EAAU,IAAA;AAAA,MACV,OAAA,EAAS;AAAA,QACP,kBAAA,EAAoB;AAAA,UAClB,MAAA,EAAQ,gBAAgB,IAAA,CAAK,WAAA,CAAY,QAAQ,kBAAkB,CAAA,CAAE,MAAA,EAAQ,UAAA,EAAY,MAAM;AAAA;AACjG;AACF,KACF;AAAA,EACF;AAGA,EAAA,MAAA,CAAO,OAAA,CAAQ,KAAK,SAAS,CAAA,CAAE,QAAQ,CAAC,CAAC,UAAA,EAAY,QAAQ,CAAA,KAAM;AACjE,IAAA,SAAA,CAAU,SAAA,CAAU,UAAU,CAAA,GAAI;AAAA,MAChC,aAAa,QAAA,CAAS;AAAA,KACxB;AAEA,IAAA,IAAI,QAAA,CAAS,OAAA,GAAU,kBAAkB,CAAA,EAAG,MAAA,EAAQ;AAClD,MAAA,SAAA,CAAU,SAAA,CAAU,UAAU,CAAA,CAAE,OAAA,GAAU;AAAA,QACxC,kBAAA,EAAoB;AAAA,UAClB,MAAA,EAAQ,gBAAgB,QAAA,CAAS,OAAA,CAAQ,kBAAkB,CAAA,CAAE,MAAA,EAAQ,YAAY,MAAM;AAAA;AACzF,OACF;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,SAAA;AACT;AAQO,SAAS,uBAAA,CACd,QACA,IAAA,EACK;AACL,EAAA,MAAM,QAA6B,EAAC;AAIpC,EAAA,MAAA,CAAO,QAAQ,CAAA,KAAA,KAAS;AACtB,IAAA,IAAI,CAAC,MAAM,OAAA,EAAS;AAEpB,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,WAAW,MAAM,CAAA;AACxD,IAAA,IAAI,CAAC,KAAA,CAAM,WAAW,CAAA,EAAG;AACvB,MAAA,KAAA,CAAM,WAAW,IAAI,EAAC;AAAA,IACxB;AAGA,IAAA,KAAA,CAAM,WAAW,EAAE,KAAA,CAAM,MAAA,CAAO,aAAa,CAAA,GAAI,sBAAA,CAAuB,KAAA,CAAM,OAAO,CAAA;AAAA,EACvF,CAAC,CAAA;AAED,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,OAAA;AAAA,IACT,IAAA,EAAM;AAAA,MACJ,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,aAAa,IAAA,CAAK;AAAA,KACpB;AAAA,IACA;AAAA,GACF;AACF;;;ACrKO,SAAS,YAOd,MAAA,EAKA;AACA,EAAA,MAAM,EAAE,OAAA,EAAS,WAAA,EAAa,MAAM,UAAA,EAAY,GAAG,WAAU,GAAI,MAAA;AAIjE,EAAA,MAAM,OAAA,GACJ,MAAA,CAAO,MAAA,KAAW,KAAA,GACd,oBAAA,CAAqB;AAAA,IACnB,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,MAAM,MAAA,CAAO,IAAA;AAAA,IACb,OAAA;AAAA,IACA,WAAA;AAAA,IACA,IAAA;AAAA,IACA,iBAAiB,MAAA,CAAO,eAAA;AAAA,IACxB,kBAAkB,MAAA,CAAO,gBAAA;AAAA,IACzB,YAAY,MAAA,CAAO,UAAA;AAAA,IACnB,gBAAgB,MAAA,CAAO,cAAA;AAAA,IACvB;AAAA,GACD,CAAA,GACD,MAAA;AAEN,EAAA,OAAO;AAAA,IACL,GAAG,SAAA;AAAA,IACH,OAAA;AAAA,IACA;AAAA,GACF;AACF","file":"chunk-SXVANU23.js","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, ResponseType, 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 ResponseType = '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 ResponseType = '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"]}

package/dist/chunk-TYZ6ZISQ.cjs

@@ -0,0 +1,368 @@
+'use strict';
+
+var chunkMCYD5LW7_cjs = require('./chunk-MCYD5LW7.cjs');
+var chunkH2RMXG2Q_cjs = require('./chunk-H2RMXG2Q.cjs');
+var chunkV5WWQN7P_cjs = require('./chunk-V5WWQN7P.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunkO7I5CWRX_cjs = require('./chunk-O7I5CWRX.cjs');
+var scoreTraces = require('@mastra/core/evals/scoreTraces');
+var z = require('zod');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var z__default = /*#__PURE__*/_interopDefault(z);
+
+// src/server/handlers/observability.ts
+var observability_exports = {};
+chunkO7I5CWRX_cjs.__export(observability_exports, {
+  GET_TRACES_PAGINATED_ROUTE: () => GET_TRACES_PAGINATED_ROUTE,
+  GET_TRACE_ROUTE: () => GET_TRACE_ROUTE,
+  LIST_SCORES_BY_SPAN_ROUTE: () => LIST_SCORES_BY_SPAN_ROUTE,
+  SCORE_TRACES_ROUTE: () => SCORE_TRACES_ROUTE,
+  getTraceHandler: () => getTraceHandler,
+  getTracesPaginatedHandler: () => getTracesPaginatedHandler,
+  listScoresBySpan: () => listScoresBySpan,
+  scoreTracesHandler: () => scoreTracesHandler
+});
+var aiSpanTypeSchema = z__default.default.enum([
+  "agent_run",
+  "generic",
+  "model_generation",
+  "model_step",
+  "model_chunk",
+  "mcp_tool_call",
+  "processor_run",
+  "tool_call",
+  "workflow_run",
+  "workflow_step",
+  "workflow_conditional",
+  "workflow_conditional_eval",
+  "workflow_parallel",
+  "workflow_loop",
+  "workflow_sleep",
+  "workflow_wait_event"
+]);
+var aiSpanRecordSchema = z__default.default.object({
+  traceId: z__default.default.string(),
+  spanId: z__default.default.string(),
+  parentSpanId: z__default.default.string().nullable(),
+  name: z__default.default.string(),
+  scope: z__default.default.record(z__default.default.string(), z__default.default.any()).nullable(),
+  spanType: aiSpanTypeSchema,
+  attributes: z__default.default.record(z__default.default.string(), z__default.default.any()).nullable(),
+  metadata: z__default.default.record(z__default.default.string(), z__default.default.any()).nullable(),
+  links: z__default.default.any(),
+  startedAt: z__default.default.coerce.date(),
+  endedAt: z__default.default.coerce.date().nullable(),
+  createdAt: z__default.default.coerce.date(),
+  updatedAt: z__default.default.coerce.date().nullable(),
+  input: z__default.default.any(),
+  output: z__default.default.any(),
+  error: z__default.default.any(),
+  isEvent: z__default.default.boolean()
+});
+var getAITracesPaginatedResponseSchema = z__default.default.object({
+  pagination: chunkMCYD5LW7_cjs.paginationInfoSchema,
+  spans: z__default.default.array(aiSpanRecordSchema)
+});
+var traceIdPathParams = z__default.default.object({
+  traceId: z__default.default.string().describe("Unique identifier for the trace")
+});
+var traceSpanPathParams = traceIdPathParams.extend({
+  spanId: z__default.default.string().describe("Unique identifier for the span")
+});
+var scoreTracesBodySchema = z__default.default.object({
+  scorerName: z__default.default.string(),
+  targets: z__default.default.array(
+    z__default.default.object({
+      traceId: z__default.default.string(),
+      spanId: z__default.default.string().optional()
+    })
+  )
+});
+var getAITraceResponseSchema = z__default.default.object({
+  spans: z__default.default.array(aiSpanRecordSchema)
+});
+var scoreTracesResponseSchema = z__default.default.object({
+  status: z__default.default.string(),
+  message: z__default.default.string(),
+  traceCount: z__default.default.number()
+});
+var listScoresBySpanResponseSchema = z__default.default.object({
+  pagination: chunkMCYD5LW7_cjs.paginationInfoSchema,
+  scores: z__default.default.array(z__default.default.unknown())
+});
+var listScoresBySpanQuerySchema = chunkMCYD5LW7_cjs.createPagePaginationSchema(10);
+
+// src/server/handlers/observability.ts
+async function getTraceHandler({ mastra, traceId }) {
+  try {
+    if (!traceId) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Trace ID is required" });
+    }
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+    }
+    const trace = await storage.getTrace(traceId);
+    if (!trace) {
+      throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Trace with ID '${traceId}' not found` });
+    }
+    return trace;
+  } catch (error) {
+    chunkV5WWQN7P_cjs.handleError(error, "Error getting trace");
+  }
+}
+async function getTracesPaginatedHandler({ mastra, pagination, filters }) {
+  try {
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+    }
+    if (pagination?.page && pagination.page < 0) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Page must be a non-negative integer" });
+    }
+    if (pagination?.perPage && pagination.perPage < 0) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Per page must be a non-negative integer" });
+    }
+    if (pagination?.dateRange) {
+      const { start, end } = pagination.dateRange;
+      if (start && !(start instanceof Date)) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Invalid date format in date range" });
+      }
+      if (end && !(end instanceof Date)) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Invalid date format in date range" });
+      }
+    }
+    return storage.getTracesPaginated({
+      pagination,
+      filters
+    });
+  } catch (error) {
+    chunkV5WWQN7P_cjs.handleError(error, "Error getting traces paginated");
+  }
+}
+async function scoreTracesHandler({ mastra, scorerName, targets }) {
+  try {
+    if (!scorerName) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Scorer ID is required" });
+    }
+    if (!targets || targets.length === 0) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "At least one target is required" });
+    }
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+    }
+    const scorer = mastra.getScorerById(scorerName);
+    if (!scorer) {
+      throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Scorer '${scorerName}' not found` });
+    }
+    const logger = mastra.getLogger();
+    scoreTraces.scoreTraces({
+      scorerId: scorer.config.id || scorer.config.name,
+      targets,
+      mastra
+    }).catch((error) => {
+      logger?.error(`Background trace scoring failed: ${error.message}`, error);
+    });
+    return {
+      status: "success",
+      message: `Scoring started for ${targets.length} ${targets.length === 1 ? "trace" : "traces"}`,
+      traceCount: targets.length
+    };
+  } catch (error) {
+    chunkV5WWQN7P_cjs.handleError(error, "Error processing trace scoring");
+  }
+}
+async function listScoresBySpan({
+  mastra,
+  traceId,
+  spanId,
+  page,
+  perPage
+}) {
+  try {
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+    }
+    if (!traceId || !spanId) {
+      throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Trace ID and span ID are required" });
+    }
+    return await storage.listScoresBySpan({ traceId, spanId, pagination: { page, perPage } });
+  } catch (error) {
+    return chunkV5WWQN7P_cjs.handleError(error, "Error getting scores by span");
+  }
+}
+var GET_TRACES_PAGINATED_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/observability/traces",
+  responseType: "json",
+  queryParamSchema: z__default.default.object({
+    page: z__default.default.coerce.number().optional().default(0),
+    perPage: z__default.default.coerce.number().optional().default(10),
+    name: z__default.default.string().optional(),
+    spanType: z__default.default.string().optional(),
+    dateRange: z__default.default.string().optional(),
+    entityId: z__default.default.string().optional(),
+    entityType: z__default.default.string().optional()
+  }),
+  responseSchema: getAITracesPaginatedResponseSchema,
+  summary: "Get AI traces",
+  description: "Returns a paginated list of AI execution traces with optional filtering by name, type, date range, and entity",
+  tags: ["Observability"],
+  handler: async ({ mastra, ...params }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+      }
+      const { page, perPage, name, spanType, dateRange, entityId, entityType } = params;
+      const rawDateRange = dateRange ? JSON.parse(dateRange) : void 0;
+      const pagination = {
+        page,
+        perPage,
+        dateRange: rawDateRange ? {
+          start: rawDateRange.start ? new Date(rawDateRange.start) : void 0,
+          end: rawDateRange.end ? new Date(rawDateRange.end) : void 0
+        } : void 0
+      };
+      const filters = Object.fromEntries(
+        Object.entries({ name, spanType, entityId, entityType }).filter(([_, v]) => v !== void 0)
+      );
+      if (pagination?.page && pagination.page < 0) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Page must be a non-negative integer" });
+      }
+      if (pagination?.perPage && pagination.perPage < 0) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Per page must be a non-negative integer" });
+      }
+      if (pagination?.dateRange) {
+        const { start, end } = pagination.dateRange;
+        if (start && !(start instanceof Date)) {
+          throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Invalid date format in date range" });
+        }
+        if (end && !(end instanceof Date)) {
+          throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Invalid date format in date range" });
+        }
+      }
+      return storage.getTracesPaginated({ pagination, filters });
+    } catch (error) {
+      chunkV5WWQN7P_cjs.handleError(error, "Error getting traces paginated");
+    }
+  }
+});
+var GET_TRACE_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/observability/traces/:traceId",
+  responseType: "json",
+  pathParamSchema: traceIdPathParams,
+  responseSchema: getAITraceResponseSchema,
+  summary: "Get AI trace by ID",
+  description: "Returns a complete AI trace with all spans by trace ID",
+  tags: ["Observability"],
+  handler: async ({ mastra, traceId }) => {
+    try {
+      if (!traceId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Trace ID is required" });
+      }
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+      }
+      const trace = await storage.getTrace(traceId);
+      if (!trace) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Trace with ID '${traceId}' not found` });
+      }
+      return trace;
+    } catch (error) {
+      chunkV5WWQN7P_cjs.handleError(error, "Error getting trace");
+    }
+  }
+});
+var SCORE_TRACES_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "POST",
+  path: "/api/observability/traces/score",
+  responseType: "json",
+  bodySchema: scoreTracesBodySchema,
+  responseSchema: scoreTracesResponseSchema,
+  summary: "Score traces",
+  description: "Scores one or more traces using a specified scorer (fire-and-forget)",
+  tags: ["Observability"],
+  handler: async ({ mastra, ...params }) => {
+    try {
+      const { scorerName, targets } = params;
+      if (!scorerName) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Scorer ID is required" });
+      }
+      if (!targets || targets.length === 0) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "At least one target is required" });
+      }
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+      }
+      const scorer = mastra.getScorerById(scorerName);
+      if (!scorer) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Scorer '${scorerName}' not found` });
+      }
+      const logger = mastra.getLogger();
+      scoreTraces.scoreTraces({
+        scorerId: scorer.config.id || scorer.config.name,
+        targets,
+        mastra
+      }).catch((error) => {
+        logger?.error(`Background trace scoring failed: ${error.message}`, error);
+      });
+      return {
+        status: "success",
+        message: `Scoring started for ${targets.length} ${targets.length === 1 ? "trace" : "traces"}`,
+        traceCount: targets.length
+      };
+    } catch (error) {
+      chunkV5WWQN7P_cjs.handleError(error, "Error processing trace scoring");
+    }
+  }
+});
+var LIST_SCORES_BY_SPAN_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/observability/traces/:traceId/:spanId/scores",
+  responseType: "json",
+  pathParamSchema: traceSpanPathParams,
+  queryParamSchema: listScoresBySpanQuerySchema,
+  responseSchema: listScoresBySpanResponseSchema,
+  summary: "List scores by span",
+  description: "Returns all scores for a specific span within a trace",
+  tags: ["Observability"],
+  handler: async ({ mastra, traceId, spanId, ...params }) => {
+    try {
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+      }
+      if (!traceId || !spanId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Trace ID and span ID are required" });
+      }
+      const { page, perPage } = params;
+      return await storage.listScoresBySpan({
+        traceId,
+        spanId,
+        pagination: { page: page ?? 0, perPage: perPage ?? 10 }
+      });
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting scores by span");
+    }
+  }
+});
+
+exports.GET_TRACES_PAGINATED_ROUTE = GET_TRACES_PAGINATED_ROUTE;
+exports.GET_TRACE_ROUTE = GET_TRACE_ROUTE;
+exports.LIST_SCORES_BY_SPAN_ROUTE = LIST_SCORES_BY_SPAN_ROUTE;
+exports.SCORE_TRACES_ROUTE = SCORE_TRACES_ROUTE;
+exports.getTraceHandler = getTraceHandler;
+exports.getTracesPaginatedHandler = getTracesPaginatedHandler;
+exports.listScoresBySpan = listScoresBySpan;
+exports.observability_exports = observability_exports;
+exports.scoreTracesHandler = scoreTracesHandler;
+//# sourceMappingURL=chunk-TYZ6ZISQ.cjs.map
+//# sourceMappingURL=chunk-TYZ6ZISQ.cjs.map

package/dist/chunk-TYZ6ZISQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability.ts","../src/server/schemas/observability.ts"],"names":["__export","z","paginationInfoSchema","createPagePaginationSchema","HTTPException","handleError","scoreTraces","createRoute"],"mappings":"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","file":"chunk-TYZ6ZISQ.cjs","sourcesContent":["import { scoreTraces } from '@mastra/core/evals/scoreTraces';\nimport type { TracesPaginatedArg, StoragePagination } from '@mastra/core/storage';\nimport z from 'zod';\nimport { HTTPException } from '../http-exception';\nimport {\n  getAITracesPaginatedResponseSchema,\n  getAITraceResponseSchema,\n  scoreTracesBodySchema,\n  scoreTracesResponseSchema,\n  listScoresBySpanResponseSchema,\n  traceIdPathParams,\n  traceSpanPathParams,\n  listScoresBySpanQuerySchema,\n} from '../schemas/observability';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport type { Context } from '../types';\nimport { handleError } from './error';\n\ninterface ObservabilityContext extends Context {\n  traceId?: string;\n  pagination?: TracesPaginatedArg['pagination'];\n  filters?: TracesPaginatedArg['filters'];\n}\n\ninterface ScoreTracesContext extends Context {\n  // scorer.id\n  scorerName?: string;\n  targets?: Array<{\n    traceId: string;\n    spanId?: string;\n  }>;\n}\n\n/**\n * Get a complete trace by trace ID\n * Returns all spans in the trace with their parent-child relationships\n */\nexport async function getTraceHandler({ mastra, traceId }: ObservabilityContext & { traceId: string }) {\n  try {\n    if (!traceId) {\n      throw new HTTPException(400, { message: 'Trace ID is required' });\n    }\n\n    const storage = mastra.getStorage();\n    if (!storage) {\n      throw new HTTPException(500, { message: 'Storage is not available' });\n    }\n\n    const trace = await storage.getTrace(traceId);\n\n    if (!trace) {\n      throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });\n    }\n\n    return trace;\n  } catch (error) {\n    handleError(error, 'Error getting trace');\n  }\n}\n\n/**\n * Get paginated traces with filtering and pagination\n * Returns only root spans (parent spans) for pagination, not child spans\n */\nexport async function getTracesPaginatedHandler({ mastra, pagination, filters }: ObservabilityContext) {\n  try {\n    const storage = mastra.getStorage();\n    if (!storage) {\n      throw new HTTPException(500, { message: 'Storage is not available' });\n    }\n\n    if (pagination?.page && pagination.page < 0) {\n      throw new HTTPException(400, { message: 'Page must be a non-negative integer' });\n    }\n\n    if (pagination?.perPage && pagination.perPage < 0) {\n      throw new HTTPException(400, { message: 'Per page must be a non-negative integer' });\n    }\n\n    if (pagination?.dateRange) {\n      const { start, end } = pagination.dateRange;\n\n      if (start && !(start instanceof Date)) {\n        throw new HTTPException(400, { message: 'Invalid date format in date range' });\n      }\n\n      if (end && !(end instanceof Date)) {\n        throw new HTTPException(400, { message: 'Invalid date format in date range' });\n      }\n    }\n\n    return storage.getTracesPaginated({\n      pagination,\n      filters,\n    });\n  } catch (error) {\n    handleError(error, 'Error getting traces paginated');\n  }\n}\n\n/**\n * Score traces using a specified scorer\n * Fire-and-forget approach - returns immediately while scoring runs in background\n */\nexport async function scoreTracesHandler({ mastra, scorerName, targets }: ScoreTracesContext) {\n  try {\n    if (!scorerName) {\n      throw new HTTPException(400, { message: 'Scorer ID is required' });\n    }\n\n    if (!targets || targets.length === 0) {\n      throw new HTTPException(400, { message: 'At least one target is required' });\n    }\n\n    const storage = mastra.getStorage();\n    if (!storage) {\n      throw new HTTPException(500, { message: 'Storage is not available' });\n    }\n\n    const scorer = mastra.getScorerById(scorerName);\n    if (!scorer) {\n      throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });\n    }\n\n    const logger = mastra.getLogger();\n\n    scoreTraces({\n      scorerId: scorer.config.id || scorer.config.name,\n      targets,\n      mastra,\n    }).catch(error => {\n      logger?.error(`Background trace scoring failed: ${error.message}`, error);\n    });\n\n    // Return immediate response\n    return {\n      status: 'success',\n      message: `Scoring started for ${targets.length} ${targets.length === 1 ? 'trace' : 'traces'}`,\n      traceCount: targets.length,\n    };\n  } catch (error) {\n    handleError(error, 'Error processing trace scoring');\n  }\n}\n\nexport async function listScoresBySpan({\n  mastra,\n  traceId,\n  spanId,\n  page,\n  perPage,\n}: Context & {\n  traceId: string;\n  spanId: string;\n  page: StoragePagination['page'];\n  perPage: StoragePagination['perPage'];\n}) {\n  try {\n    const storage = mastra.getStorage();\n    if (!storage) {\n      throw new HTTPException(500, { message: 'Storage is not available' });\n    }\n\n    if (!traceId || !spanId) {\n      throw new HTTPException(400, { message: 'Trace ID and span ID are required' });\n    }\n\n    return await storage.listScoresBySpan({ traceId, spanId, pagination: { page, perPage } });\n  } catch (error) {\n    return handleError(error, 'Error getting scores by span');\n  }\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const GET_TRACES_PAGINATED_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/observability/traces',\n  responseType: 'json',\n  queryParamSchema: z.object({\n    page: z.coerce.number().optional().default(0),\n    perPage: z.coerce.number().optional().default(10),\n    name: z.string().optional(),\n    spanType: z.string().optional(),\n    dateRange: z.string().optional(),\n    entityId: z.string().optional(),\n    entityType: z.string().optional(),\n  }),\n  responseSchema: getAITracesPaginatedResponseSchema,\n  summary: 'Get AI traces',\n  description:\n    'Returns a paginated list of AI execution traces with optional filtering by name, type, date range, and entity',\n  tags: ['Observability'],\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not available' });\n      }\n\n      const { page, perPage, name, spanType, dateRange, entityId, entityType } = params;\n\n      // Parse and convert dateRange to Date objects\n      const rawDateRange = dateRange ? JSON.parse(dateRange) : undefined;\n      const pagination = {\n        page,\n        perPage,\n        dateRange: rawDateRange\n          ? {\n              start: rawDateRange.start ? new Date(rawDateRange.start) : undefined,\n              end: rawDateRange.end ? new Date(rawDateRange.end) : undefined,\n            }\n          : undefined,\n      };\n\n      const filters = Object.fromEntries(\n        Object.entries({ name, spanType, entityId, entityType }).filter(([_, v]) => v !== undefined),\n      );\n\n      if (pagination?.page && pagination.page < 0) {\n        throw new HTTPException(400, { message: 'Page must be a non-negative integer' });\n      }\n\n      if (pagination?.perPage && pagination.perPage < 0) {\n        throw new HTTPException(400, { message: 'Per page must be a non-negative integer' });\n      }\n\n      if (pagination?.dateRange) {\n        const { start, end } = pagination.dateRange;\n\n        if (start && !(start instanceof Date)) {\n          throw new HTTPException(400, { message: 'Invalid date format in date range' });\n        }\n\n        if (end && !(end instanceof Date)) {\n          throw new HTTPException(400, { message: 'Invalid date format in date range' });\n        }\n      }\n\n      return storage.getTracesPaginated({ pagination, filters });\n    } catch (error) {\n      handleError(error, 'Error getting traces paginated');\n    }\n  },\n});\n\nexport const GET_TRACE_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/observability/traces/:traceId',\n  responseType: 'json',\n  pathParamSchema: traceIdPathParams,\n  responseSchema: getAITraceResponseSchema,\n  summary: 'Get AI trace by ID',\n  description: 'Returns a complete AI trace with all spans by trace ID',\n  tags: ['Observability'],\n  handler: async ({ mastra, traceId }) => {\n    try {\n      if (!traceId) {\n        throw new HTTPException(400, { message: 'Trace ID is required' });\n      }\n\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not available' });\n      }\n\n      const trace = await storage.getTrace(traceId);\n\n      if (!trace) {\n        throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });\n      }\n\n      return trace;\n    } catch (error) {\n      handleError(error, 'Error getting trace');\n    }\n  },\n});\n\nexport const SCORE_TRACES_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/observability/traces/score',\n  responseType: 'json',\n  bodySchema: scoreTracesBodySchema,\n  responseSchema: scoreTracesResponseSchema,\n  summary: 'Score traces',\n  description: 'Scores one or more traces using a specified scorer (fire-and-forget)',\n  tags: ['Observability'],\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const { scorerName, targets } = params;\n\n      if (!scorerName) {\n        throw new HTTPException(400, { message: 'Scorer ID is required' });\n      }\n\n      if (!targets || targets.length === 0) {\n        throw new HTTPException(400, { message: 'At least one target is required' });\n      }\n\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not available' });\n      }\n\n      const scorer = mastra.getScorerById(scorerName);\n      if (!scorer) {\n        throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });\n      }\n\n      const logger = mastra.getLogger();\n\n      scoreTraces({\n        scorerId: scorer.config.id || scorer.config.name,\n        targets,\n        mastra,\n      }).catch(error => {\n        logger?.error(`Background trace scoring failed: ${error.message}`, error);\n      });\n\n      return {\n        status: 'success',\n        message: `Scoring started for ${targets.length} ${targets.length === 1 ? 'trace' : 'traces'}`,\n        traceCount: targets.length,\n      };\n    } catch (error) {\n      handleError(error, 'Error processing trace scoring');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_SPAN_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/observability/traces/:traceId/:spanId/scores',\n  responseType: 'json',\n  pathParamSchema: traceSpanPathParams,\n  queryParamSchema: listScoresBySpanQuerySchema,\n  responseSchema: listScoresBySpanResponseSchema,\n  summary: 'List scores by span',\n  description: 'Returns all scores for a specific span within a trace',\n  tags: ['Observability'],\n  handler: async ({ mastra, traceId, spanId, ...params }) => {\n    try {\n      const storage = mastra.getStorage();\n      if (!storage) {\n        throw new HTTPException(500, { message: 'Storage is not available' });\n      }\n\n      if (!traceId || !spanId) {\n        throw new HTTPException(400, { message: 'Trace ID and span ID are required' });\n      }\n\n      const { page, perPage } = params;\n      return await storage.listScoresBySpan({\n        traceId,\n        spanId,\n        pagination: { page: page ?? 0, perPage: perPage ?? 10 },\n      });\n    } catch (error) {\n      return handleError(error, 'Error getting scores by span');\n    }\n  },\n});\n","import z from 'zod';\nimport { createPagePaginationSchema, paginationInfoSchema } from './common';\n\n/**\n * Schema for AI span types\n * Defines all possible span types in the observability system\n */\nexport const aiSpanTypeSchema = z.enum([\n  'agent_run',\n  'generic',\n  'model_generation',\n  'model_step',\n  'model_chunk',\n  'mcp_tool_call',\n  'processor_run',\n  'tool_call',\n  'workflow_run',\n  'workflow_step',\n  'workflow_conditional',\n  'workflow_conditional_eval',\n  'workflow_parallel',\n  'workflow_loop',\n  'workflow_sleep',\n  'workflow_wait_event',\n]);\n\n/**\n * Schema for AI span record\n * Represents a single trace span with all its metadata\n */\nexport const aiSpanRecordSchema = z.object({\n  traceId: z.string(),\n  spanId: z.string(),\n  parentSpanId: z.string().nullable(),\n  name: z.string(),\n  scope: z.record(z.string(), z.any()).nullable(),\n  spanType: aiSpanTypeSchema,\n  attributes: z.record(z.string(), z.any()).nullable(),\n  metadata: z.record(z.string(), z.any()).nullable(),\n  links: z.any(),\n  startedAt: z.coerce.date(),\n  endedAt: z.coerce.date().nullable(),\n  createdAt: z.coerce.date(),\n  updatedAt: z.coerce.date().nullable(),\n  input: z.any(),\n  output: z.any(),\n  error: z.any(),\n  isEvent: z.boolean(),\n});\n\n/**\n * Schema for paginated AI traces response\n * Returns pagination info and array of trace spans\n */\nexport const getAITracesPaginatedResponseSchema = z.object({\n  pagination: paginationInfoSchema,\n  spans: z.array(aiSpanRecordSchema),\n});\n\n// Path parameter schemas\nexport const traceIdPathParams = z.object({\n  traceId: z.string().describe('Unique identifier for the trace'),\n});\n\nexport const traceSpanPathParams = traceIdPathParams.extend({\n  spanId: z.string().describe('Unique identifier for the span'),\n});\n\n// Body schema for scoring traces\nexport const scoreTracesBodySchema = z.object({\n  scorerName: z.string(),\n  targets: z.array(\n    z.object({\n      traceId: z.string(),\n      spanId: z.string().optional(),\n    }),\n  ),\n});\n\n// Response schemas\nexport const getAITraceResponseSchema = z.object({\n  spans: z.array(aiSpanRecordSchema),\n});\n\nexport const scoreTracesResponseSchema = z.object({\n  status: z.string(),\n  message: z.string(),\n  traceCount: z.number(),\n});\n\nexport const listScoresBySpanResponseSchema = z.object({\n  pagination: paginationInfoSchema,\n  scores: z.array(z.unknown()),\n});\n\n// Query schema for list scores by span\nexport const listScoresBySpanQuerySchema = createPagePaginationSchema(10);\n"]}