@mastra/server 0.0.0-new-scorer-api-20250801075530 → 0.0.0-new-button-export-20251219130424

package/dist/chunk-GFF2I6UD.js

@@ -0,0 +1,354 @@
+import { paginationInfoSchema, createPagePaginationSchema } from './chunk-HT4LP3BO.js';
+import { createRoute } from './chunk-SXVANU23.js';
+import { handleError } from './chunk-UXGQZUYZ.js';
+import { HTTPException } from './chunk-6QWQZI4Q.js';
+import { __export } from './chunk-PR4QN5HX.js';
+import { scoreTraces } from '@mastra/core/evals/scoreTraces';
+import z from 'zod';
+
+// src/server/handlers/observability.ts
+var observability_exports = {};
+__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.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.object({
+  traceId: z.string(),
+  spanId: z.string(),
+  parentSpanId: z.string().nullable(),
+  name: z.string(),
+  scope: z.record(z.string(), z.any()).nullable(),
+  spanType: aiSpanTypeSchema,
+  attributes: z.record(z.string(), z.any()).nullable(),
+  metadata: z.record(z.string(), z.any()).nullable(),
+  links: z.any(),
+  startedAt: z.coerce.date(),
+  endedAt: z.coerce.date().nullable(),
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date().nullable(),
+  input: z.any(),
+  output: z.any(),
+  error: z.any(),
+  isEvent: z.boolean()
+});
+var getAITracesPaginatedResponseSchema = z.object({
+  pagination: paginationInfoSchema,
+  spans: z.array(aiSpanRecordSchema)
+});
+var traceIdPathParams = z.object({
+  traceId: z.string().describe("Unique identifier for the trace")
+});
+var traceSpanPathParams = traceIdPathParams.extend({
+  spanId: z.string().describe("Unique identifier for the span")
+});
+var scoreTracesBodySchema = z.object({
+  scorerName: z.string(),
+  targets: z.array(
+    z.object({
+      traceId: z.string(),
+      spanId: z.string().optional()
+    })
+  )
+});
+var getAITraceResponseSchema = z.object({
+  spans: z.array(aiSpanRecordSchema)
+});
+var scoreTracesResponseSchema = z.object({
+  status: z.string(),
+  message: z.string(),
+  traceCount: z.number()
+});
+var listScoresBySpanResponseSchema = z.object({
+  pagination: paginationInfoSchema,
+  scores: z.array(z.unknown())
+});
+var listScoresBySpanQuerySchema = createPagePaginationSchema(10);
+
+// src/server/handlers/observability.ts
+async function getTraceHandler({ mastra, traceId }) {
+  try {
+    if (!traceId) {
+      throw new HTTPException(400, { message: "Trace ID is required" });
+    }
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new HTTPException(500, { message: "Storage is not available" });
+    }
+    const trace = await storage.getTrace(traceId);
+    if (!trace) {
+      throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });
+    }
+    return trace;
+  } catch (error) {
+    handleError(error, "Error getting trace");
+  }
+}
+async function getTracesPaginatedHandler({ mastra, pagination, filters }) {
+  try {
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new HTTPException(500, { message: "Storage is not available" });
+    }
+    if (pagination?.page && pagination.page < 0) {
+      throw new HTTPException(400, { message: "Page must be a non-negative integer" });
+    }
+    if (pagination?.perPage && pagination.perPage < 0) {
+      throw new 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 HTTPException(400, { message: "Invalid date format in date range" });
+      }
+      if (end && !(end instanceof Date)) {
+        throw new HTTPException(400, { message: "Invalid date format in date range" });
+      }
+    }
+    return storage.getTracesPaginated({
+      pagination,
+      filters
+    });
+  } catch (error) {
+    handleError(error, "Error getting traces paginated");
+  }
+}
+async function scoreTracesHandler({ mastra, scorerName, targets }) {
+  try {
+    if (!scorerName) {
+      throw new HTTPException(400, { message: "Scorer ID is required" });
+    }
+    if (!targets || targets.length === 0) {
+      throw new HTTPException(400, { message: "At least one target is required" });
+    }
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new HTTPException(500, { message: "Storage is not available" });
+    }
+    const scorer = mastra.getScorerById(scorerName);
+    if (!scorer) {
+      throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });
+    }
+    const logger = mastra.getLogger();
+    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) {
+    handleError(error, "Error processing trace scoring");
+  }
+}
+async function listScoresBySpan({
+  mastra,
+  traceId,
+  spanId,
+  page,
+  perPage
+}) {
+  try {
+    const storage = mastra.getStorage();
+    if (!storage) {
+      throw new HTTPException(500, { message: "Storage is not available" });
+    }
+    if (!traceId || !spanId) {
+      throw new HTTPException(400, { message: "Trace ID and span ID are required" });
+    }
+    return await storage.listScoresBySpan({ traceId, spanId, pagination: { page, perPage } });
+  } catch (error) {
+    return handleError(error, "Error getting scores by span");
+  }
+}
+var GET_TRACES_PAGINATED_ROUTE = createRoute({
+  method: "GET",
+  path: "/api/observability/traces",
+  responseType: "json",
+  queryParamSchema: z.object({
+    page: z.coerce.number().optional().default(0),
+    perPage: z.coerce.number().optional().default(10),
+    name: z.string().optional(),
+    spanType: z.string().optional(),
+    dateRange: z.string().optional(),
+    entityId: z.string().optional(),
+    entityType: z.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 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 HTTPException(400, { message: "Page must be a non-negative integer" });
+      }
+      if (pagination?.perPage && pagination.perPage < 0) {
+        throw new 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 HTTPException(400, { message: "Invalid date format in date range" });
+        }
+        if (end && !(end instanceof Date)) {
+          throw new HTTPException(400, { message: "Invalid date format in date range" });
+        }
+      }
+      return storage.getTracesPaginated({ pagination, filters });
+    } catch (error) {
+      handleError(error, "Error getting traces paginated");
+    }
+  }
+});
+var GET_TRACE_ROUTE = 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 HTTPException(400, { message: "Trace ID is required" });
+      }
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new HTTPException(500, { message: "Storage is not available" });
+      }
+      const trace = await storage.getTrace(traceId);
+      if (!trace) {
+        throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });
+      }
+      return trace;
+    } catch (error) {
+      handleError(error, "Error getting trace");
+    }
+  }
+});
+var SCORE_TRACES_ROUTE = 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 HTTPException(400, { message: "Scorer ID is required" });
+      }
+      if (!targets || targets.length === 0) {
+        throw new HTTPException(400, { message: "At least one target is required" });
+      }
+      const storage = mastra.getStorage();
+      if (!storage) {
+        throw new HTTPException(500, { message: "Storage is not available" });
+      }
+      const scorer = mastra.getScorerById(scorerName);
+      if (!scorer) {
+        throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });
+      }
+      const logger = mastra.getLogger();
+      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) {
+      handleError(error, "Error processing trace scoring");
+    }
+  }
+});
+var LIST_SCORES_BY_SPAN_ROUTE = 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 HTTPException(500, { message: "Storage is not available" });
+      }
+      if (!traceId || !spanId) {
+        throw new 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 handleError(error, "Error getting scores by span");
+    }
+  }
+});
+
+export { GET_TRACES_PAGINATED_ROUTE, GET_TRACE_ROUTE, LIST_SCORES_BY_SPAN_ROUTE, SCORE_TRACES_ROUTE, getTraceHandler, getTracesPaginatedHandler, listScoresBySpan, observability_exports, scoreTracesHandler };
+//# sourceMappingURL=chunk-GFF2I6UD.js.map
+//# sourceMappingURL=chunk-GFF2I6UD.js.map

package/dist/chunk-GFF2I6UD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability.ts","../src/server/schemas/observability.ts"],"names":["z"],"mappings":"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","file":"chunk-GFF2I6UD.js","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"]}