@mastra/server 1.0.4-alpha.2 → 1.1.0-alpha.0

package/dist/chunk-AV3VZ6S3.cjs

@@ -0,0 +1,190 @@
+'use strict';
+
+var chunkSUKFO7UM_cjs = require('./chunk-SUKFO7UM.cjs');
+var chunk4LVJBXI2_cjs = require('./chunk-4LVJBXI2.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunkO7I5CWRX_cjs = require('./chunk-O7I5CWRX.cjs');
+var evals = require('@mastra/core/evals');
+var scoreTraces = require('@mastra/core/evals/scoreTraces');
+var storage = require('@mastra/core/storage');
+var zod = require('zod');
+
+// src/server/handlers/observability.ts
+var observability_exports = {};
+chunkO7I5CWRX_cjs.__export(observability_exports, {
+  GET_TRACE_ROUTE: () => GET_TRACE_ROUTE,
+  LIST_SCORES_BY_SPAN_ROUTE: () => LIST_SCORES_BY_SPAN_ROUTE,
+  LIST_TRACES_ROUTE: () => LIST_TRACES_ROUTE,
+  SCORE_TRACES_ROUTE: () => SCORE_TRACES_ROUTE
+});
+var legacyQueryParamsSchema = zod.z.object({
+  // Old: dateRange was in pagination, now it's startedAt in filters
+  dateRange: storage.dateRangeSchema.optional(),
+  // Old: name matched span names like "agent run: 'myAgent'"
+  name: zod.z.string().optional(),
+  // entityType needs preprocessing to handle legacy 'workflow' value
+  entityType: zod.z.preprocess((val) => val === "workflow" ? "workflow_run" : val, zod.z.string().optional())
+});
+function transformLegacyParams(params) {
+  const result = { ...params };
+  if (result.entityType === "workflow") {
+    result.entityType = "workflow_run";
+  }
+  if (params.dateRange && !params.startedAt) {
+    result.startedAt = params.dateRange;
+    delete result.dateRange;
+  }
+  if (typeof params.name === "string" && !params.entityId) {
+    const agentMatch = params.name.match(/^agent run: '([^']+)'$/);
+    const workflowMatch = params.name.match(/^workflow run: '([^']+)'$/);
+    if (agentMatch) {
+      result.entityId = agentMatch[1];
+      result.entityType = "agent";
+    } else if (workflowMatch) {
+      result.entityId = workflowMatch[1];
+      result.entityType = "workflow_run";
+    }
+    delete result.name;
+  }
+  return result;
+}
+function getStorage(mastra) {
+  const storage = mastra.getStorage();
+  if (!storage) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage is not available" });
+  }
+  return storage;
+}
+async function getObservabilityStore(mastra) {
+  const storage = getStorage(mastra);
+  const observability = await storage.getStore("observability");
+  if (!observability) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Observability storage domain is not available" });
+  }
+  return observability;
+}
+async function getScoresStore(mastra) {
+  const storage = getStorage(mastra);
+  const scores = await storage.getStore("scores");
+  if (!scores) {
+    throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Scores storage domain is not available" });
+  }
+  return scores;
+}
+var LIST_TRACES_ROUTE = chunk4LVJBXI2_cjs.createRoute({
+  method: "GET",
+  path: "/observability/traces",
+  responseType: "json",
+  queryParamSchema: chunk4LVJBXI2_cjs.wrapSchemaForQueryParams(
+    storage.tracesFilterSchema.merge(storage.paginationArgsSchema).merge(storage.tracesOrderBySchema).merge(legacyQueryParamsSchema).partial()
+  ),
+  responseSchema: storage.listTracesResponseSchema,
+  summary: "List traces",
+  description: "Returns a paginated list of traces with optional filtering and sorting",
+  tags: ["Observability"],
+  requiresAuth: true,
+  handler: async ({ mastra, ...params }) => {
+    try {
+      const transformedParams = transformLegacyParams(params);
+      const filters = chunk4LVJBXI2_cjs.pickParams(storage.tracesFilterSchema, transformedParams);
+      const pagination = chunk4LVJBXI2_cjs.pickParams(storage.paginationArgsSchema, transformedParams);
+      const orderBy = chunk4LVJBXI2_cjs.pickParams(storage.tracesOrderBySchema, transformedParams);
+      const observabilityStore = await getObservabilityStore(mastra);
+      return await observabilityStore.listTraces({ filters, pagination, orderBy });
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error listing traces");
+    }
+  }
+});
+var GET_TRACE_ROUTE = chunk4LVJBXI2_cjs.createRoute({
+  method: "GET",
+  path: "/observability/traces/:traceId",
+  responseType: "json",
+  pathParamSchema: storage.getTraceArgsSchema,
+  responseSchema: storage.getTraceResponseSchema,
+  summary: "Get AI trace by ID",
+  description: "Returns a complete AI trace with all spans by trace ID",
+  tags: ["Observability"],
+  requiresAuth: true,
+  handler: async ({ mastra, traceId }) => {
+    try {
+      const observabilityStore = await getObservabilityStore(mastra);
+      const trace = await observabilityStore.getTrace({ traceId });
+      if (!trace) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Trace with ID '${traceId}' not found` });
+      }
+      return trace;
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error getting trace");
+    }
+  }
+});
+var SCORE_TRACES_ROUTE = chunk4LVJBXI2_cjs.createRoute({
+  method: "POST",
+  path: "/observability/traces/score",
+  responseType: "json",
+  bodySchema: storage.scoreTracesRequestSchema,
+  responseSchema: storage.scoreTracesResponseSchema,
+  summary: "Score traces",
+  description: "Scores one or more traces using a specified scorer (fire-and-forget)",
+  tags: ["Observability"],
+  requiresAuth: true,
+  handler: async ({ mastra, ...params }) => {
+    try {
+      getStorage(mastra);
+      const { scorerName, targets } = params;
+      const scorer = mastra.getScorerById(scorerName);
+      if (!scorer) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: `Scorer '${scorerName}' not found` });
+      }
+      scoreTraces.scoreTraces({
+        scorerId: scorer.config.id || scorer.config.name,
+        targets,
+        mastra
+      }).catch((error) => {
+        const logger = mastra.getLogger();
+        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) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error processing trace scoring");
+    }
+  }
+});
+var LIST_SCORES_BY_SPAN_ROUTE = chunk4LVJBXI2_cjs.createRoute({
+  method: "GET",
+  path: "/observability/traces/:traceId/:spanId/scores",
+  responseType: "json",
+  pathParamSchema: storage.spanIdsSchema,
+  queryParamSchema: storage.paginationArgsSchema,
+  responseSchema: evals.listScoresResponseSchema,
+  summary: "List scores by span",
+  description: "Returns all scores for a specific span within a trace",
+  tags: ["Observability"],
+  requiresAuth: true,
+  handler: async ({ mastra, ...params }) => {
+    try {
+      const pagination = chunk4LVJBXI2_cjs.pickParams(storage.paginationArgsSchema, params);
+      const spanIds = chunk4LVJBXI2_cjs.pickParams(storage.spanIdsSchema, params);
+      const scoresStore = await getScoresStore(mastra);
+      return await scoresStore.listScoresBySpan({
+        ...spanIds,
+        pagination
+      });
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error getting scores by span");
+    }
+  }
+});
+
+exports.GET_TRACE_ROUTE = GET_TRACE_ROUTE;
+exports.LIST_SCORES_BY_SPAN_ROUTE = LIST_SCORES_BY_SPAN_ROUTE;
+exports.LIST_TRACES_ROUTE = LIST_TRACES_ROUTE;
+exports.SCORE_TRACES_ROUTE = SCORE_TRACES_ROUTE;
+exports.observability_exports = observability_exports;
+//# sourceMappingURL=chunk-AV3VZ6S3.cjs.map
+//# sourceMappingURL=chunk-AV3VZ6S3.cjs.map

package/dist/chunk-AV3VZ6S3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability.ts"],"names":["__export","z","dateRangeSchema","HTTPException","createRoute","wrapSchemaForQueryParams","tracesFilterSchema","paginationArgsSchema","tracesOrderBySchema","listTracesResponseSchema","pickParams","handleError","getTraceArgsSchema","getTraceResponseSchema","scoreTracesRequestSchema","scoreTracesResponseSchema","scoreTraces","spanIdsSchema","listScoresResponseSchema"],"mappings":"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","file":"chunk-AV3VZ6S3.cjs","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { listScoresResponseSchema } from '@mastra/core/evals';\nimport { scoreTraces } from '@mastra/core/evals/scoreTraces';\nimport type { MastraStorage, ScoresStorage, ObservabilityStorage } from '@mastra/core/storage';\nimport {\n  tracesFilterSchema,\n  tracesOrderBySchema,\n  paginationArgsSchema,\n  spanIdsSchema,\n  listTracesResponseSchema,\n  scoreTracesRequestSchema,\n  scoreTracesResponseSchema,\n  getTraceArgsSchema,\n  getTraceResponseSchema,\n  dateRangeSchema,\n} from '@mastra/core/storage';\nimport { z } from 'zod';\nimport { HTTPException } from '../http-exception';\nimport { createRoute, pickParams, wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\n\n// ============================================================================\n// Legacy Parameter Support (backward compatibility with main branch API)\n// ============================================================================\n\n/**\n * Legacy query parameters from the old API (main branch).\n * These are accepted for backward compatibility and transformed to new format.\n */\nconst legacyQueryParamsSchema = z.object({\n  // Old: dateRange was in pagination, now it's startedAt in filters\n  dateRange: dateRangeSchema.optional(),\n  // Old: name matched span names like \"agent run: 'myAgent'\"\n  name: z.string().optional(),\n  // entityType needs preprocessing to handle legacy 'workflow' value\n  entityType: z.preprocess(val => (val === 'workflow' ? 'workflow_run' : val), z.string().optional()),\n});\n\n/**\n * Transforms legacy query parameters to the new format.\n * - dateRange -> startedAt (if startedAt not already set)\n * - name=\"agent run: 'x'\" -> entityId='x', entityType='agent'\n * - name=\"workflow run: 'x'\" -> entityId='x', entityType='workflow_run'\n * - entityType='workflow' -> entityType='workflow_run' (enum value fix)\n */\nfunction transformLegacyParams(params: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...params };\n\n  // Transform old entityType='workflow' -> 'workflow_run' (the Zod validation would have already transformed this)\n  if (result.entityType === 'workflow') {\n    result.entityType = 'workflow_run';\n  }\n\n  // Transform old dateRange -> new startedAt\n  if (params.dateRange && !params.startedAt) {\n    result.startedAt = params.dateRange;\n    delete result.dateRange;\n  }\n\n  // Transform old name -> entityId + entityType\n  // Old format: name matched span names like \"agent run: 'myAgent'\" or \"workflow run: 'myWorkflow'\"\n  if (typeof params.name === 'string' && !params.entityId) {\n    const agentMatch = params.name.match(/^agent run: '([^']+)'$/);\n    const workflowMatch = params.name.match(/^workflow run: '([^']+)'$/);\n\n    if (agentMatch) {\n      result.entityId = agentMatch[1];\n      result.entityType = 'agent';\n    } else if (workflowMatch) {\n      result.entityId = workflowMatch[1];\n      result.entityType = 'workflow_run';\n    }\n    delete result.name;\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nfunction getStorage(mastra: Mastra): MastraStorage {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not available' });\n  }\n  return storage;\n}\n\nasync function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n  const storage = getStorage(mastra);\n  const observability = await storage.getStore('observability');\n  if (!observability) {\n    throw new HTTPException(500, { message: 'Observability storage domain is not available' });\n  }\n  return observability;\n}\n\nasync function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n  const storage = getStorage(mastra);\n  const scores = await storage.getStore('scores');\n  if (!scores) {\n    throw new HTTPException(500, { message: 'Scores storage domain is not available' });\n  }\n  return scores;\n}\n\nexport const LIST_TRACES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces',\n  responseType: 'json',\n  queryParamSchema: wrapSchemaForQueryParams(\n    tracesFilterSchema\n      .merge(paginationArgsSchema)\n      .merge(tracesOrderBySchema)\n      .merge(legacyQueryParamsSchema) // Accept legacy params for backward compatibility\n      .partial(),\n  ),\n  responseSchema: listTracesResponseSchema,\n  summary: 'List traces',\n  description: 'Returns a paginated list of traces with optional filtering and sorting',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Transform legacy params to new format before processing\n      const transformedParams = transformLegacyParams(params);\n\n      const filters = pickParams(tracesFilterSchema, transformedParams);\n      const pagination = pickParams(paginationArgsSchema, transformedParams);\n      const orderBy = pickParams(tracesOrderBySchema, transformedParams);\n\n      const observabilityStore = await getObservabilityStore(mastra);\n      return await observabilityStore.listTraces({ filters, pagination, orderBy });\n    } catch (error) {\n      return handleError(error, 'Error listing traces');\n    }\n  },\n});\n\nexport const GET_TRACE_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId',\n  responseType: 'json',\n  pathParamSchema: getTraceArgsSchema,\n  responseSchema: getTraceResponseSchema,\n  summary: 'Get AI trace by ID',\n  description: 'Returns a complete AI trace with all spans by trace ID',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, traceId }) => {\n    try {\n      const observabilityStore = await getObservabilityStore(mastra);\n      const trace = await observabilityStore.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      return handleError(error, 'Error getting trace');\n    }\n  },\n});\n\nexport const SCORE_TRACES_ROUTE = createRoute({\n  method: 'POST',\n  path: '/observability/traces/score',\n  responseType: 'json',\n  bodySchema: scoreTracesRequestSchema,\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  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Validate storage exists before starting background task\n      getStorage(mastra);\n\n      const { scorerName, targets } = params;\n\n      const scorer = mastra.getScorerById(scorerName);\n      if (!scorer) {\n        throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });\n      }\n\n      scoreTraces({\n        scorerId: scorer.config.id || scorer.config.name,\n        targets,\n        mastra,\n      }).catch(error => {\n        const logger = mastra.getLogger();\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      return handleError(error, 'Error processing trace scoring');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_SPAN_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId/:spanId/scores',\n  responseType: 'json',\n  pathParamSchema: spanIdsSchema,\n  queryParamSchema: paginationArgsSchema,\n  responseSchema: listScoresResponseSchema,\n  summary: 'List scores by span',\n  description: 'Returns all scores for a specific span within a trace',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const pagination = pickParams(paginationArgsSchema, params);\n      const spanIds = pickParams(spanIdsSchema, params);\n\n      const scoresStore = await getScoresStore(mastra);\n\n      return await scoresStore.listScoresBySpan({\n        ...spanIds,\n        pagination,\n      });\n    } catch (error) {\n      return handleError(error, 'Error getting scores by span');\n    }\n  },\n});\n"]}