@mastra/server 1.0.4-alpha.1 → 1.0.4

package/dist/chunk-AV3CN5ZR.cjs

@@ -0,0 +1,326 @@
+'use strict';
+
+var chunkMCYD5LW7_cjs = require('./chunk-MCYD5LW7.cjs');
+var chunkAVRO3FIN_cjs = require('./chunk-AVRO3FIN.cjs');
+var chunkSUKFO7UM_cjs = require('./chunk-SUKFO7UM.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunkO7I5CWRX_cjs = require('./chunk-O7I5CWRX.cjs');
+var z = require('zod');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var z__default = /*#__PURE__*/_interopDefault(z);
+
+// src/server/handlers/scores.ts
+var scores_exports = {};
+chunkO7I5CWRX_cjs.__export(scores_exports, {
+  GET_SCORER_ROUTE: () => GET_SCORER_ROUTE,
+  LIST_SCORERS_ROUTE: () => LIST_SCORERS_ROUTE,
+  LIST_SCORES_BY_ENTITY_ID_ROUTE: () => LIST_SCORES_BY_ENTITY_ID_ROUTE,
+  LIST_SCORES_BY_RUN_ID_ROUTE: () => LIST_SCORES_BY_RUN_ID_ROUTE,
+  LIST_SCORES_BY_SCORER_ID_ROUTE: () => LIST_SCORES_BY_SCORER_ID_ROUTE,
+  SAVE_SCORE_ROUTE: () => SAVE_SCORE_ROUTE
+});
+var scoringSamplingConfigSchema = z__default.default.object({});
+var mastraScorerConfigSchema = z__default.default.object({
+  id: z__default.default.string(),
+  name: z__default.default.string().optional(),
+  description: z__default.default.string(),
+  type: z__default.default.unknown().optional(),
+  judge: z__default.default.unknown().optional()
+});
+var mastraScorerSchema = z__default.default.object({
+  config: mastraScorerConfigSchema
+});
+var scorerEntrySchema = z__default.default.object({
+  scorer: mastraScorerSchema,
+  sampling: scoringSamplingConfigSchema.optional(),
+  agentIds: z__default.default.array(z__default.default.string()),
+  agentNames: z__default.default.array(z__default.default.string()),
+  workflowIds: z__default.default.array(z__default.default.string()),
+  isRegistered: z__default.default.boolean()
+});
+var listScorersResponseSchema = z__default.default.record(z__default.default.string(), scorerEntrySchema);
+var scorerIdPathParams = z__default.default.object({
+  scorerId: z__default.default.string().describe("Unique identifier for the scorer")
+});
+var entityPathParams = z__default.default.object({
+  entityType: z__default.default.string().describe("Type of the entity (AGENT or WORKFLOW)"),
+  entityId: z__default.default.string().describe("Unique identifier for the entity")
+});
+var listScoresByRunIdQuerySchema = z__default.default.object({
+  page: z__default.default.coerce.number().optional().default(0),
+  perPage: z__default.default.coerce.number().optional().default(10)
+});
+var listScoresByScorerIdQuerySchema = z__default.default.object({
+  page: z__default.default.coerce.number().optional().default(0),
+  perPage: z__default.default.coerce.number().optional().default(10),
+  entityId: z__default.default.string().optional(),
+  entityType: z__default.default.string().optional()
+});
+var listScoresByEntityIdQuerySchema = z__default.default.object({
+  page: z__default.default.coerce.number().optional().default(0),
+  perPage: z__default.default.coerce.number().optional().default(10)
+});
+var saveScoreBodySchema = z__default.default.object({
+  score: z__default.default.unknown()
+  // ScoreRowData - complex type
+});
+var scoresWithPaginationResponseSchema = z__default.default.object({
+  pagination: chunkMCYD5LW7_cjs.paginationInfoSchema,
+  scores: z__default.default.array(z__default.default.unknown())
+  // Array of score records
+});
+var saveScoreResponseSchema = z__default.default.object({
+  score: z__default.default.unknown()
+  // ScoreRowData
+});
+
+// src/server/handlers/scores.ts
+async function listScorersFromSystem({
+  mastra,
+  requestContext
+}) {
+  const agents = mastra.listAgents();
+  const workflows = mastra.listWorkflows();
+  const scorersMap = /* @__PURE__ */ new Map();
+  for (const [_, agent] of Object.entries(agents)) {
+    const scorers = await agent.listScorers({
+      requestContext
+    }) || {};
+    if (Object.keys(scorers).length > 0) {
+      for (const [_scorerId, scorer] of Object.entries(scorers)) {
+        const scorerId = scorer.scorer.id;
+        if (scorersMap.has(scorerId)) {
+          scorersMap.get(scorerId)?.agentIds.push(agent.id);
+          scorersMap.get(scorerId)?.agentNames.push(agent.name);
+        } else {
+          scorersMap.set(scorerId, {
+            workflowIds: [],
+            ...scorer,
+            agentNames: [agent.name],
+            agentIds: [agent.id],
+            isRegistered: false
+          });
+        }
+      }
+    }
+  }
+  for (const [workflowId, workflow] of Object.entries(workflows)) {
+    const scorers = await workflow.listScorers({
+      requestContext
+    }) || {};
+    if (Object.keys(scorers).length > 0) {
+      for (const [_scorerId, scorer] of Object.entries(scorers)) {
+        const scorerName = scorer.scorer.name;
+        if (scorersMap.has(scorerName)) {
+          scorersMap.get(scorerName)?.workflowIds.push(workflowId);
+        } else {
+          scorersMap.set(scorerName, {
+            agentIds: [],
+            agentNames: [],
+            ...scorer,
+            workflowIds: [workflowId],
+            isRegistered: false
+          });
+        }
+      }
+    }
+  }
+  const registeredScorers = await mastra.listScorers();
+  for (const [_scorerId, scorer] of Object.entries(registeredScorers || {})) {
+    const scorerId = scorer.id;
+    if (scorersMap.has(scorerId)) {
+      scorersMap.get(scorerId).isRegistered = true;
+    } else {
+      scorersMap.set(scorerId, {
+        scorer,
+        agentIds: [],
+        agentNames: [],
+        workflowIds: [],
+        isRegistered: true
+      });
+    }
+  }
+  return Object.fromEntries(scorersMap.entries());
+}
+function getTraceDetails(traceIdWithSpanId) {
+  if (!traceIdWithSpanId) {
+    return {};
+  }
+  const [traceId, spanId] = traceIdWithSpanId.split("-");
+  return {
+    ...traceId ? { traceId } : {},
+    ...spanId ? { spanId } : {}
+  };
+}
+var LIST_SCORERS_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "GET",
+  path: "/api/scores/scorers",
+  responseType: "json",
+  responseSchema: listScorersResponseSchema,
+  summary: "List all scorers",
+  description: "Returns a list of all registered scorers with their configuration and associated agents and workflows",
+  tags: ["Scoring"],
+  handler: async ({ mastra, requestContext }) => {
+    const scorers = await listScorersFromSystem({
+      mastra,
+      requestContext
+    });
+    return scorers;
+  }
+});
+var GET_SCORER_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "GET",
+  path: "/api/scores/scorers/:scorerId",
+  responseType: "json",
+  pathParamSchema: scorerIdPathParams,
+  responseSchema: scorerEntrySchema.nullable(),
+  summary: "Get scorer by ID",
+  description: "Returns details for a specific scorer including its configuration and associations",
+  tags: ["Scoring"],
+  handler: async ({ mastra, scorerId, requestContext }) => {
+    const scorers = await listScorersFromSystem({
+      mastra,
+      requestContext
+    });
+    const scorer = scorers[scorerId];
+    if (!scorer) {
+      return null;
+    }
+    return scorer;
+  }
+});
+var LIST_SCORES_BY_RUN_ID_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "GET",
+  path: "/api/scores/run/:runId",
+  responseType: "json",
+  pathParamSchema: chunkMCYD5LW7_cjs.runIdSchema,
+  queryParamSchema: listScoresByRunIdQuerySchema,
+  responseSchema: scoresWithPaginationResponseSchema,
+  summary: "List scores by run ID",
+  description: "Returns all scores for a specific execution run",
+  tags: ["Scoring"],
+  handler: async ({ mastra, runId, ...params }) => {
+    try {
+      const { page, perPage } = params;
+      const pagination = {
+        page: page ?? 0,
+        perPage: perPage ?? 10
+      };
+      const scores = await mastra.getStorage()?.getStore("scores");
+      const scoreResults = await scores?.listScoresByRunId?.({
+        runId,
+        pagination
+      }) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };
+      return {
+        pagination: scoreResults.pagination,
+        scores: scoreResults.scores.map((score) => ({ ...score, ...getTraceDetails(score.traceId) }))
+      };
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error getting scores by run id");
+    }
+  }
+});
+var LIST_SCORES_BY_SCORER_ID_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "GET",
+  path: "/api/scores/scorer/:scorerId",
+  responseType: "json",
+  pathParamSchema: scorerIdPathParams,
+  queryParamSchema: listScoresByScorerIdQuerySchema,
+  responseSchema: scoresWithPaginationResponseSchema,
+  summary: "List scores by scorer ID",
+  description: "Returns all scores generated by a specific scorer",
+  tags: ["Scoring"],
+  handler: async ({ mastra, scorerId, ...params }) => {
+    try {
+      const { page, perPage, entityId, entityType } = params;
+      const filters = Object.fromEntries(Object.entries({ entityId, entityType }).filter(([_, v]) => v !== void 0));
+      const scores = await mastra.getStorage()?.getStore("scores");
+      const scoreResults = await scores?.listScoresByScorerId?.({
+        scorerId,
+        pagination: { page: page ?? 0, perPage: perPage ?? 10 },
+        ...filters
+      }) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };
+      return {
+        pagination: scoreResults.pagination,
+        scores: scoreResults.scores.map((score) => ({ ...score, ...getTraceDetails(score.traceId) }))
+      };
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error getting scores by scorer id");
+    }
+  }
+});
+var LIST_SCORES_BY_ENTITY_ID_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "GET",
+  path: "/api/scores/entity/:entityType/:entityId",
+  responseType: "json",
+  pathParamSchema: entityPathParams,
+  queryParamSchema: listScoresByEntityIdQuerySchema,
+  responseSchema: scoresWithPaginationResponseSchema,
+  summary: "List scores by entity ID",
+  description: "Returns all scores for a specific entity (agent or workflow)",
+  tags: ["Scoring"],
+  handler: async ({ mastra, entityId, entityType, ...params }) => {
+    try {
+      const { page, perPage } = params;
+      let entityIdToUse = entityId;
+      if (entityType === "AGENT") {
+        const agent = mastra.getAgentById(entityId);
+        entityIdToUse = agent.id;
+      } else if (entityType === "WORKFLOW") {
+        const workflow = mastra.getWorkflowById(entityId);
+        entityIdToUse = workflow.id;
+      }
+      const pagination = {
+        page: page ?? 0,
+        perPage: perPage ?? 10
+      };
+      const scoresStore = await mastra.getStorage()?.getStore("scores");
+      const scoreResults = await scoresStore?.listScoresByEntityId?.({
+        entityId: entityIdToUse,
+        entityType,
+        pagination
+      }) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };
+      return {
+        pagination: scoreResults.pagination,
+        scores: scoreResults.scores.map((score) => ({ ...score, ...getTraceDetails(score.traceId) }))
+      };
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error getting scores by entity id");
+    }
+  }
+});
+var SAVE_SCORE_ROUTE = chunkAVRO3FIN_cjs.createRoute({
+  method: "POST",
+  path: "/api/scores",
+  responseType: "json",
+  bodySchema: saveScoreBodySchema,
+  responseSchema: saveScoreResponseSchema,
+  summary: "Save score",
+  description: "Saves a new score record to storage",
+  tags: ["Scoring"],
+  handler: async ({ mastra, ...params }) => {
+    try {
+      const { score } = params;
+      const scoresStore = await mastra.getStorage()?.getStore("scores");
+      const result = await scoresStore?.saveScore?.(score);
+      if (!result) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Storage not configured" });
+      }
+      return result;
+    } catch (error) {
+      return chunkSUKFO7UM_cjs.handleError(error, "Error saving score");
+    }
+  }
+});
+
+exports.GET_SCORER_ROUTE = GET_SCORER_ROUTE;
+exports.LIST_SCORERS_ROUTE = LIST_SCORERS_ROUTE;
+exports.LIST_SCORES_BY_ENTITY_ID_ROUTE = LIST_SCORES_BY_ENTITY_ID_ROUTE;
+exports.LIST_SCORES_BY_RUN_ID_ROUTE = LIST_SCORES_BY_RUN_ID_ROUTE;
+exports.LIST_SCORES_BY_SCORER_ID_ROUTE = LIST_SCORES_BY_SCORER_ID_ROUTE;
+exports.SAVE_SCORE_ROUTE = SAVE_SCORE_ROUTE;
+exports.scores_exports = scores_exports;
+//# sourceMappingURL=chunk-AV3CN5ZR.cjs.map
+//# sourceMappingURL=chunk-AV3CN5ZR.cjs.map

package/dist/chunk-AV3CN5ZR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/scores.ts","../src/server/schemas/scores.ts"],"names":["__export","z","paginationInfoSchema","createRoute","runIdSchema","handleError","HTTPException"],"mappings":";;;;;;;;;;;;;;AAAA,IAAA,cAAA,GAAA;AAAAA,0BAAA,CAAA,cAAA,EAAA;AAAA,EAAA,gBAAA,EAAA,MAAA,gBAAA;AAAA,EAAA,kBAAA,EAAA,MAAA,kBAAA;AAAA,EAAA,8BAAA,EAAA,MAAA,8BAAA;AAAA,EAAA,2BAAA,EAAA,MAAA,2BAAA;AAAA,EAAA,8BAAA,EAAA,MAAA,8BAAA;AAAA,EAAA,gBAAA,EAAA,MAAA;AAAA,CAAA,CAAA;ACOA,IAAM,2BAAA,GAA8BC,kBAAA,CAAE,MAAA,CAAO,EAAE,CAAA;AAK/C,IAAM,wBAAA,GAA2BA,mBAAE,MAAA,CAAO;AAAA,EACxC,EAAA,EAAIA,mBAAE,MAAA,EAAO;AAAA,EACb,IAAA,EAAMA,kBAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,WAAA,EAAaA,mBAAE,MAAA,EAAO;AAAA,EACtB,IAAA,EAAMA,kBAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC3B,KAAA,EAAOA,kBAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACrB,CAAC,CAAA;AAMD,IAAM,kBAAA,GAAqBA,mBAAE,MAAA,CAAO;AAAA,EAClC,MAAA,EAAQ;AACV,CAAC,CAAA;AAKM,IAAM,iBAAA,GAAoBA,mBAAE,MAAA,CAAO;AAAA,EACxC,MAAA,EAAQ,kBAAA;AAAA,EACR,QAAA,EAAU,4BAA4B,QAAA,EAAS;AAAA,EAC/C,QAAA,EAAUA,kBAAA,CAAE,KAAA,CAAMA,kBAAA,CAAE,QAAQ,CAAA;AAAA,EAC5B,UAAA,EAAYA,kBAAA,CAAE,KAAA,CAAMA,kBAAA,CAAE,QAAQ,CAAA;AAAA,EAC9B,WAAA,EAAaA,kBAAA,CAAE,KAAA,CAAMA,kBAAA,CAAE,QAAQ,CAAA;AAAA,EAC/B,YAAA,EAAcA,mBAAE,OAAA;AAClB,CAAC,CAAA;AAMM,IAAM,4BAA4BA,kBAAA,CAAE,MAAA,CAAOA,kBAAA,CAAE,MAAA,IAAU,iBAAiB,CAAA;AAGxE,IAAM,kBAAA,GAAqBA,mBAAE,MAAA,CAAO;AAAA,EACzC,QAAA,EAAUA,kBAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kCAAkC;AAClE,CAAC,CAAA;AAEM,IAAM,gBAAA,GAAmBA,mBAAE,MAAA,CAAO;AAAA,EACvC,UAAA,EAAYA,kBAAA,CAAE,MAAA,EAAO,CAAE,SAAS,wCAAwC,CAAA;AAAA,EACxE,QAAA,EAAUA,kBAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kCAAkC;AAClE,CAAC,CAAA;AAMM,IAAM,4BAAA,GAA+BA,mBAAE,MAAA,CAAO;AAAA,EACnD,IAAA,EAAMA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,CAAC,CAAA;AAAA,EAC5C,OAAA,EAASA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,EAAE;AAClD,CAAC,CAAA;AAEM,IAAM,+BAAA,GAAkCA,mBAAE,MAAA,CAAO;AAAA,EACtD,IAAA,EAAMA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,CAAC,CAAA;AAAA,EAC5C,OAAA,EAASA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,EAAE,CAAA;AAAA,EAChD,QAAA,EAAUA,kBAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC9B,UAAA,EAAYA,kBAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACzB,CAAC,CAAA;AAEM,IAAM,+BAAA,GAAkCA,mBAAE,MAAA,CAAO;AAAA,EACtD,IAAA,EAAMA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,CAAC,CAAA;AAAA,EAC5C,OAAA,EAASA,mBAAE,MAAA,CAAO,MAAA,GAAS,QAAA,EAAS,CAAE,QAAQ,EAAE;AAClD,CAAC,CAAA;AAGM,IAAM,mBAAA,GAAsBA,mBAAE,MAAA,CAAO;AAAA,EAC1C,KAAA,EAAOA,mBAAE,OAAA;AAAQ;AACnB,CAAC,CAAA;AAGM,IAAM,kCAAA,GAAqCA,mBAAE,MAAA,CAAO;AAAA,EACzD,UAAA,EAAYC,sCAAA;AAAA,EACZ,MAAA,EAAQD,kBAAA,CAAE,KAAA,CAAMA,kBAAA,CAAE,SAAS;AAAA;AAC7B,CAAC,CAAA;AAEM,IAAM,uBAAA,GAA0BA,mBAAE,MAAA,CAAO;AAAA,EAC9C,KAAA,EAAOA,mBAAE,OAAA;AAAQ;AACnB,CAAC,CAAA;;;ADrED,eAAe,qBAAA,CAAsB;AAAA,EACnC,MAAA;AAAA,EACA;AACF,CAAA,EAEG;AACD,EAAA,MAAM,MAAA,GAAS,OAAO,UAAA,EAAW;AACjC,EAAA,MAAM,SAAA,GAAY,OAAO,aAAA,EAAc;AAEvC,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAGrB;AAEF,EAAA,KAAA,MAAW,CAAC,CAAA,EAAG,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC/C,IAAA,MAAM,OAAA,GACH,MAAM,KAAA,CAAM,WAAA,CAAY;AAAA,MACvB;AAAA,KACD,KAAM,EAAC;AAEV,IAAA,IAAI,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,CAAE,SAAS,CAAA,EAAG;AACnC,MAAA,KAAA,MAAW,CAAC,SAAA,EAAW,MAAM,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACzD,QAAA,MAAM,QAAA,GAAW,OAAO,MAAA,CAAO,EAAA;AAC/B,QAAA,IAAI,UAAA,CAAW,GAAA,CAAI,QAAQ,CAAA,EAAG;AAC5B,UAAA,UAAA,CAAW,IAAI,QAAQ,CAAA,EAAG,QAAA,CAAS,IAAA,CAAK,MAAM,EAAE,CAAA;AAChD,UAAA,UAAA,CAAW,IAAI,QAAQ,CAAA,EAAG,UAAA,CAAW,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,QACtD,CAAA,MAAO;AACL,UAAA,UAAA,CAAW,IAAI,QAAA,EAAU;AAAA,YACvB,aAAa,EAAC;AAAA,YACd,GAAG,MAAA;AAAA,YACH,UAAA,EAAY,CAAC,KAAA,CAAM,IAAI,CAAA;AAAA,YACvB,QAAA,EAAU,CAAC,KAAA,CAAM,EAAE,CAAA;AAAA,YACnB,YAAA,EAAc;AAAA,WACf,CAAA;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,KAAA,MAAW,CAAC,UAAA,EAAY,QAAQ,KAAK,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AAC9D,IAAA,MAAM,OAAA,GACH,MAAM,QAAA,CAAS,WAAA,CAAY;AAAA,MAC1B;AAAA,KACD,KAAM,EAAC;AAEV,IAAA,IAAI,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,CAAE,SAAS,CAAA,EAAG;AACnC,MAAA,KAAA,MAAW,CAAC,SAAA,EAAW,MAAM,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACzD,QAAA,MAAM,UAAA,GAAa,OAAO,MAAA,CAAO,IAAA;AACjC,QAAA,IAAI,UAAA,CAAW,GAAA,CAAI,UAAU,CAAA,EAAG;AAC9B,UAAA,UAAA,CAAW,GAAA,CAAI,UAAU,CAAA,EAAG,WAAA,CAAY,KAAK,UAAU,CAAA;AAAA,QACzD,CAAA,MAAO;AACL,UAAA,UAAA,CAAW,IAAI,UAAA,EAAY;AAAA,YACzB,UAAU,EAAC;AAAA,YACX,YAAY,EAAC;AAAA,YACb,GAAG,MAAA;AAAA,YACH,WAAA,EAAa,CAAC,UAAU,CAAA;AAAA,YACxB,YAAA,EAAc;AAAA,WACf,CAAA;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,iBAAA,GAAoB,MAAM,MAAA,CAAO,WAAA,EAAY;AACnD,EAAA,KAAA,MAAW,CAAC,WAAW,MAAM,CAAA,IAAK,OAAO,OAAA,CAAQ,iBAAA,IAAqB,EAAE,CAAA,EAAG;AACzE,IAAA,MAAM,WAAW,MAAA,CAAO,EAAA;AACxB,IAAA,IAAI,UAAA,CAAW,GAAA,CAAI,QAAQ,CAAA,EAAG;AAC5B,MAAA,UAAA,CAAW,GAAA,CAAI,QAAQ,CAAA,CAAG,YAAA,GAAe,IAAA;AAAA,IAC3C,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,IAAI,QAAA,EAAU;AAAA,QACvB,MAAA;AAAA,QACA,UAAU,EAAC;AAAA,QACX,YAAY,EAAC;AAAA,QACb,aAAa,EAAC;AAAA,QACd,YAAA,EAAc;AAAA,OACf,CAAA;AAAA,IACH;AAAA,EACF;AAEA,EAAA,OAAO,MAAA,CAAO,WAAA,CAAY,UAAA,CAAW,OAAA,EAAS,CAAA;AAChD;AAGA,SAAS,gBAAgB,iBAAA,EAA4B;AACnD,EAAA,IAAI,CAAC,iBAAA,EAAmB;AACtB,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,CAAC,OAAA,EAAS,MAAM,CAAA,GAAI,iBAAA,CAAkB,MAAM,GAAG,CAAA;AAErD,EAAA,OAAO;AAAA,IACL,GAAI,OAAA,GAAU,EAAE,OAAA,KAAY,EAAC;AAAA,IAC7B,GAAI,MAAA,GAAS,EAAE,MAAA,KAAW;AAAC,GAC7B;AACF;AAMO,IAAM,qBAAqBE,6BAAA,CAAY;AAAA,EAC5C,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,qBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgB,yBAAA;AAAA,EAChB,OAAA,EAAS,kBAAA;AAAA,EACT,WAAA,EAAa,uGAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,OAAA,EAAS,OAAO,EAAE,MAAA,EAAQ,gBAAe,KAAM;AAC7C,IAAA,MAAM,OAAA,GAAU,MAAM,qBAAA,CAAsB;AAAA,MAC1C,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,OAAO,OAAA;AAAA,EACT;AACF,CAAC;AAEM,IAAM,mBAAmBA,6BAAA,CAAY;AAAA,EAC1C,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,+BAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,eAAA,EAAiB,kBAAA;AAAA,EACjB,cAAA,EAAgB,kBAAkB,QAAA,EAAS;AAAA,EAC3C,OAAA,EAAS,kBAAA;AAAA,EACT,WAAA,EAAa,oFAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,SAAS,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,gBAAe,KAAM;AACvD,IAAA,MAAM,OAAA,GAAU,MAAM,qBAAA,CAAsB;AAAA,MAC1C,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AAED,IAAA,MAAM,MAAA,GAAS,QAAQ,QAAQ,CAAA;AAE/B,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AACF,CAAC;AAEM,IAAM,8BAA8BA,6BAAA,CAAY;AAAA,EACrD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,wBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,eAAA,EAAiBC,6BAAA;AAAA,EACjB,gBAAA,EAAkB,4BAAA;AAAA,EAClB,cAAA,EAAgB,kCAAA;AAAA,EAChB,OAAA,EAAS,uBAAA;AAAA,EACT,WAAA,EAAa,iDAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,SAAS,OAAO,EAAE,QAAQ,KAAA,EAAO,GAAG,QAAO,KAAM;AAC/C,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAQ,GAAI,MAAA;AAC1B,MAAA,MAAM,UAAA,GAAgC;AAAA,QACpC,MAAM,IAAA,IAAQ,CAAA;AAAA,QACd,SAAS,OAAA,IAAW;AAAA,OACtB;AACA,MAAA,MAAM,SAAS,MAAM,MAAA,CAAO,UAAA,EAAW,EAAG,SAAS,QAAQ,CAAA;AAC3D,MAAA,MAAM,YAAA,GAAgB,MAAM,MAAA,EAAQ,iBAAA,GAAoB;AAAA,QACtD,KAAA;AAAA,QACA;AAAA,OACD,CAAA,IAAM,EAAE,UAAA,EAAY,EAAE,OAAO,CAAA,EAAG,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,GAAG,OAAA,EAAS,KAAA,EAAM,EAAG,MAAA,EAAQ,EAAC,EAAE;AACnF,MAAA,OAAO;AAAA,QACL,YAAY,YAAA,CAAa,UAAA;AAAA,QACzB,MAAA,EAAQ,YAAA,CAAa,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,MAAyB,EAAE,GAAG,KAAA,EAAO,GAAG,eAAA,CAAgB,KAAA,CAAM,OAAO,GAAE,CAAE;AAAA,OAC5G;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAOC,6BAAA,CAAY,OAAO,gCAAgC,CAAA;AAAA,IAC5D;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iCAAiCF,6BAAA,CAAY;AAAA,EACxD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,8BAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,eAAA,EAAiB,kBAAA;AAAA,EACjB,gBAAA,EAAkB,+BAAA;AAAA,EAClB,cAAA,EAAgB,kCAAA;AAAA,EAChB,OAAA,EAAS,0BAAA;AAAA,EACT,WAAA,EAAa,mDAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,SAAS,OAAO,EAAE,QAAQ,QAAA,EAAU,GAAG,QAAO,KAAM;AAClD,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,QAAA,EAAU,YAAW,GAAI,MAAA;AAChD,MAAA,MAAM,UAAU,MAAA,CAAO,WAAA,CAAY,OAAO,OAAA,CAAQ,EAAE,UAAU,UAAA,EAAY,CAAA,CAAE,MAAA,CAAO,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAA,KAAM,MAAS,CAAC,CAAA;AAC/G,MAAA,MAAM,SAAS,MAAM,MAAA,CAAO,UAAA,EAAW,EAAG,SAAS,QAAQ,CAAA;AAC3D,MAAA,MAAM,YAAA,GAAgB,MAAM,MAAA,EAAQ,oBAAA,GAAuB;AAAA,QACzD,QAAA;AAAA,QACA,YAAY,EAAE,IAAA,EAAM,QAAQ,CAAA,EAAG,OAAA,EAAS,WAAW,EAAA,EAAG;AAAA,QACtD,GAAG;AAAA,OACJ,CAAA,IAAM,EAAE,UAAA,EAAY,EAAE,OAAO,CAAA,EAAG,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,GAAG,OAAA,EAAS,KAAA,EAAM,EAAG,MAAA,EAAQ,EAAC,EAAE;AACnF,MAAA,OAAO;AAAA,QACL,YAAY,YAAA,CAAa,UAAA;AAAA,QACzB,MAAA,EAAQ,YAAA,CAAa,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,MAAyB,EAAE,GAAG,KAAA,EAAO,GAAG,eAAA,CAAgB,KAAA,CAAM,OAAO,GAAE,CAAE;AAAA,OAC5G;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAOE,6BAAA,CAAY,OAAO,mCAAmC,CAAA;AAAA,IAC/D;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iCAAiCF,6BAAA,CAAY;AAAA,EACxD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,0CAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,eAAA,EAAiB,gBAAA;AAAA,EACjB,gBAAA,EAAkB,+BAAA;AAAA,EAClB,cAAA,EAAgB,kCAAA;AAAA,EAChB,OAAA,EAAS,0BAAA;AAAA,EACT,WAAA,EAAa,8DAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,OAAA,EAAS,OAAO,EAAE,MAAA,EAAQ,UAAU,UAAA,EAAY,GAAG,QAAO,KAAM;AAC9D,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAQ,GAAI,MAAA;AAC1B,MAAA,IAAI,aAAA,GAAgB,QAAA;AAEpB,MAAA,IAAI,eAAe,OAAA,EAAS;AAC1B,QAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,YAAA,CAAa,QAAQ,CAAA;AAC1C,QAAA,aAAA,GAAgB,KAAA,CAAM,EAAA;AAAA,MACxB,CAAA,MAAA,IAAW,eAAe,UAAA,EAAY;AACpC,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,eAAA,CAAgB,QAAQ,CAAA;AAChD,QAAA,aAAA,GAAgB,QAAA,CAAS,EAAA;AAAA,MAC3B;AAEA,MAAA,MAAM,UAAA,GAAgC;AAAA,QACpC,MAAM,IAAA,IAAQ,CAAA;AAAA,QACd,SAAS,OAAA,IAAW;AAAA,OACtB;AAEA,MAAA,MAAM,cAAc,MAAM,MAAA,CAAO,UAAA,EAAW,EAAG,SAAS,QAAQ,CAAA;AAChE,MAAA,MAAM,YAAA,GAAgB,MAAM,WAAA,EAAa,oBAAA,GAAuB;AAAA,QAC9D,QAAA,EAAU,aAAA;AAAA,QACV,UAAA;AAAA,QACA;AAAA,OACD,CAAA,IAAM,EAAE,UAAA,EAAY,EAAE,OAAO,CAAA,EAAG,IAAA,EAAM,CAAA,EAAG,OAAA,EAAS,GAAG,OAAA,EAAS,KAAA,EAAM,EAAG,MAAA,EAAQ,EAAC,EAAE;AAEnF,MAAA,OAAO;AAAA,QACL,YAAY,YAAA,CAAa,UAAA;AAAA,QACzB,MAAA,EAAQ,YAAA,CAAa,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,MAAyB,EAAE,GAAG,KAAA,EAAO,GAAG,eAAA,CAAgB,KAAA,CAAM,OAAO,GAAE,CAAE;AAAA,OAC5G;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAOE,6BAAA,CAAY,OAAO,mCAAmC,CAAA;AAAA,IAC/D;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmBF,6BAAA,CAAY;AAAA,EAC1C,MAAA,EAAQ,MAAA;AAAA,EACR,IAAA,EAAM,aAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,UAAA,EAAY,mBAAA;AAAA,EACZ,cAAA,EAAgB,uBAAA;AAAA,EAChB,OAAA,EAAS,YAAA;AAAA,EACT,WAAA,EAAa,qCAAA;AAAA,EACb,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,EAChB,SAAS,OAAO,EAAE,MAAA,EAAQ,GAAG,QAAO,KAAM;AACxC,IAAA,IAAI;AACF,MAAA,MAAM,EAAE,OAAM,GAAI,MAAA;AAClB,MAAA,MAAM,cAAc,MAAM,MAAA,CAAO,UAAA,EAAW,EAAG,SAAS,QAAQ,CAAA;AAChE,MAAA,MAAM,MAAA,GAAS,MAAM,WAAA,EAAa,SAAA,GAAY,KAAK,CAAA;AACnD,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,MAAM,IAAIG,+BAAA,CAAc,GAAA,EAAK,EAAE,OAAA,EAAS,0BAA0B,CAAA;AAAA,MACpE;AACA,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,OAAOD,6BAAA,CAAY,OAAO,oBAAoB,CAAA;AAAA,IAChD;AAAA,EACF;AACF,CAAC","file":"chunk-AV3CN5ZR.cjs","sourcesContent":["import type { MastraScorerEntry, ScoreRowData } from '@mastra/core/evals';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { StoragePagination } from '@mastra/core/storage';\nimport { HTTPException } from '../http-exception';\nimport { runIdSchema } from '../schemas/common';\nimport {\n  listScorersResponseSchema,\n  scorerEntrySchema,\n  scorerIdPathParams,\n  entityPathParams,\n  listScoresByRunIdQuerySchema,\n  listScoresByScorerIdQuerySchema,\n  listScoresByEntityIdQuerySchema,\n  saveScoreBodySchema,\n  scoresWithPaginationResponseSchema,\n  saveScoreResponseSchema,\n} from '../schemas/scores';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport type { Context } from '../types';\nimport { handleError } from './error';\n\nasync function listScorersFromSystem({\n  mastra,\n  requestContext,\n}: Context & {\n  requestContext: RequestContext;\n}) {\n  const agents = mastra.listAgents();\n  const workflows = mastra.listWorkflows();\n\n  const scorersMap = new Map<\n    string,\n    MastraScorerEntry & { agentIds: string[]; agentNames: string[]; workflowIds: string[]; isRegistered: boolean }\n  >();\n\n  for (const [_, agent] of Object.entries(agents)) {\n    const scorers =\n      (await agent.listScorers({\n        requestContext,\n      })) || {};\n\n    if (Object.keys(scorers).length > 0) {\n      for (const [_scorerId, scorer] of Object.entries(scorers)) {\n        const scorerId = scorer.scorer.id;\n        if (scorersMap.has(scorerId)) {\n          scorersMap.get(scorerId)?.agentIds.push(agent.id);\n          scorersMap.get(scorerId)?.agentNames.push(agent.name);\n        } else {\n          scorersMap.set(scorerId, {\n            workflowIds: [],\n            ...scorer,\n            agentNames: [agent.name],\n            agentIds: [agent.id],\n            isRegistered: false,\n          });\n        }\n      }\n    }\n  }\n\n  for (const [workflowId, workflow] of Object.entries(workflows)) {\n    const scorers =\n      (await workflow.listScorers({\n        requestContext,\n      })) || {};\n\n    if (Object.keys(scorers).length > 0) {\n      for (const [_scorerId, scorer] of Object.entries(scorers)) {\n        const scorerName = scorer.scorer.name;\n        if (scorersMap.has(scorerName)) {\n          scorersMap.get(scorerName)?.workflowIds.push(workflowId);\n        } else {\n          scorersMap.set(scorerName, {\n            agentIds: [],\n            agentNames: [],\n            ...scorer,\n            workflowIds: [workflowId],\n            isRegistered: false,\n          });\n        }\n      }\n    }\n  }\n\n  const registeredScorers = await mastra.listScorers();\n  for (const [_scorerId, scorer] of Object.entries(registeredScorers || {})) {\n    const scorerId = scorer.id;\n    if (scorersMap.has(scorerId)) {\n      scorersMap.get(scorerId)!.isRegistered = true;\n    } else {\n      scorersMap.set(scorerId, {\n        scorer: scorer,\n        agentIds: [],\n        agentNames: [],\n        workflowIds: [],\n        isRegistered: true,\n      });\n    }\n  }\n\n  return Object.fromEntries(scorersMap.entries());\n}\n\n// Legacy function to get trace and span details\nfunction getTraceDetails(traceIdWithSpanId?: string) {\n  if (!traceIdWithSpanId) {\n    return {};\n  }\n\n  const [traceId, spanId] = traceIdWithSpanId.split('-');\n\n  return {\n    ...(traceId ? { traceId } : {}),\n    ...(spanId ? { spanId } : {}),\n  };\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nexport const LIST_SCORERS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/scores/scorers',\n  responseType: 'json',\n  responseSchema: listScorersResponseSchema,\n  summary: 'List all scorers',\n  description: 'Returns a list of all registered scorers with their configuration and associated agents and workflows',\n  tags: ['Scoring'],\n  handler: async ({ mastra, requestContext }) => {\n    const scorers = await listScorersFromSystem({\n      mastra,\n      requestContext,\n    });\n    return scorers;\n  },\n});\n\nexport const GET_SCORER_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/scores/scorers/:scorerId',\n  responseType: 'json',\n  pathParamSchema: scorerIdPathParams,\n  responseSchema: scorerEntrySchema.nullable(),\n  summary: 'Get scorer by ID',\n  description: 'Returns details for a specific scorer including its configuration and associations',\n  tags: ['Scoring'],\n  handler: async ({ mastra, scorerId, requestContext }) => {\n    const scorers = await listScorersFromSystem({\n      mastra,\n      requestContext,\n    });\n\n    const scorer = scorers[scorerId];\n\n    if (!scorer) {\n      return null;\n    }\n\n    return scorer;\n  },\n});\n\nexport const LIST_SCORES_BY_RUN_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/scores/run/:runId',\n  responseType: 'json',\n  pathParamSchema: runIdSchema,\n  queryParamSchema: listScoresByRunIdQuerySchema,\n  responseSchema: scoresWithPaginationResponseSchema,\n  summary: 'List scores by run ID',\n  description: 'Returns all scores for a specific execution run',\n  tags: ['Scoring'],\n  handler: async ({ mastra, runId, ...params }) => {\n    try {\n      const { page, perPage } = params;\n      const pagination: StoragePagination = {\n        page: page ?? 0,\n        perPage: perPage ?? 10,\n      };\n      const scores = await mastra.getStorage()?.getStore('scores');\n      const scoreResults = (await scores?.listScoresByRunId?.({\n        runId,\n        pagination,\n      })) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };\n      return {\n        pagination: scoreResults.pagination,\n        scores: scoreResults.scores.map((score: ScoreRowData) => ({ ...score, ...getTraceDetails(score.traceId) })),\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting scores by run id');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_SCORER_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/scores/scorer/:scorerId',\n  responseType: 'json',\n  pathParamSchema: scorerIdPathParams,\n  queryParamSchema: listScoresByScorerIdQuerySchema,\n  responseSchema: scoresWithPaginationResponseSchema,\n  summary: 'List scores by scorer ID',\n  description: 'Returns all scores generated by a specific scorer',\n  tags: ['Scoring'],\n  handler: async ({ mastra, scorerId, ...params }) => {\n    try {\n      const { page, perPage, entityId, entityType } = params;\n      const filters = Object.fromEntries(Object.entries({ entityId, entityType }).filter(([_, v]) => v !== undefined));\n      const scores = await mastra.getStorage()?.getStore('scores');\n      const scoreResults = (await scores?.listScoresByScorerId?.({\n        scorerId,\n        pagination: { page: page ?? 0, perPage: perPage ?? 10 },\n        ...filters,\n      })) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };\n      return {\n        pagination: scoreResults.pagination,\n        scores: scoreResults.scores.map((score: ScoreRowData) => ({ ...score, ...getTraceDetails(score.traceId) })),\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting scores by scorer id');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_ENTITY_ID_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/scores/entity/:entityType/:entityId',\n  responseType: 'json',\n  pathParamSchema: entityPathParams,\n  queryParamSchema: listScoresByEntityIdQuerySchema,\n  responseSchema: scoresWithPaginationResponseSchema,\n  summary: 'List scores by entity ID',\n  description: 'Returns all scores for a specific entity (agent or workflow)',\n  tags: ['Scoring'],\n  handler: async ({ mastra, entityId, entityType, ...params }) => {\n    try {\n      const { page, perPage } = params;\n      let entityIdToUse = entityId;\n\n      if (entityType === 'AGENT') {\n        const agent = mastra.getAgentById(entityId);\n        entityIdToUse = agent.id;\n      } else if (entityType === 'WORKFLOW') {\n        const workflow = mastra.getWorkflowById(entityId);\n        entityIdToUse = workflow.id;\n      }\n\n      const pagination: StoragePagination = {\n        page: page ?? 0,\n        perPage: perPage ?? 10,\n      };\n\n      const scoresStore = await mastra.getStorage()?.getStore('scores');\n      const scoreResults = (await scoresStore?.listScoresByEntityId?.({\n        entityId: entityIdToUse,\n        entityType,\n        pagination,\n      })) || { pagination: { total: 0, page: 0, perPage: 0, hasMore: false }, scores: [] };\n\n      return {\n        pagination: scoreResults.pagination,\n        scores: scoreResults.scores.map((score: ScoreRowData) => ({ ...score, ...getTraceDetails(score.traceId) })),\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting scores by entity id');\n    }\n  },\n});\n\nexport const SAVE_SCORE_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/scores',\n  responseType: 'json',\n  bodySchema: saveScoreBodySchema,\n  responseSchema: saveScoreResponseSchema,\n  summary: 'Save score',\n  description: 'Saves a new score record to storage',\n  tags: ['Scoring'],\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const { score } = params as { score: ScoreRowData };\n      const scoresStore = await mastra.getStorage()?.getStore('scores');\n      const result = await scoresStore?.saveScore?.(score);\n      if (!result) {\n        throw new HTTPException(500, { message: 'Storage not configured' });\n      }\n      return result;\n    } catch (error) {\n      return handleError(error, 'Error saving score');\n    }\n  },\n});\n","import z from 'zod';\nimport { paginationInfoSchema } from './common';\n\n/**\n * Schema for sampling configuration\n * Using passthrough to allow various sampling config shapes\n */\nconst scoringSamplingConfigSchema = z.object({});\n\n/**\n * Schema for MastraScorer config object\n */\nconst mastraScorerConfigSchema = z.object({\n  id: z.string(),\n  name: z.string().optional(),\n  description: z.string(),\n  type: z.unknown().optional(),\n  judge: z.unknown().optional(),\n});\n\n/**\n * Schema for MastraScorer\n * Only validates public config property, uses passthrough to allow class instance\n */\nconst mastraScorerSchema = z.object({\n  config: mastraScorerConfigSchema,\n});\n\n/**\n * Schema for scorer entry with associations to agents and workflows\n */\nexport const scorerEntrySchema = z.object({\n  scorer: mastraScorerSchema,\n  sampling: scoringSamplingConfigSchema.optional(),\n  agentIds: z.array(z.string()),\n  agentNames: z.array(z.string()),\n  workflowIds: z.array(z.string()),\n  isRegistered: z.boolean(),\n});\n\n/**\n * Response schema for list scorers endpoint\n * Returns a record of scorer ID to scorer entry with associations\n */\nexport const listScorersResponseSchema = z.record(z.string(), scorerEntrySchema);\n\n// Path parameter schemas\nexport const scorerIdPathParams = z.object({\n  scorerId: z.string().describe('Unique identifier for the scorer'),\n});\n\nexport const entityPathParams = z.object({\n  entityType: z.string().describe('Type of the entity (AGENT or WORKFLOW)'),\n  entityId: z.string().describe('Unique identifier for the entity'),\n});\n\n// Query parameter schemas\n// HTTP query params must be flat (e.g., ?page=0&perPage=10)\n// Adapters should transform these into nested pagination objects for handlers if needed\n\nexport const listScoresByRunIdQuerySchema = z.object({\n  page: z.coerce.number().optional().default(0),\n  perPage: z.coerce.number().optional().default(10),\n});\n\nexport const listScoresByScorerIdQuerySchema = z.object({\n  page: z.coerce.number().optional().default(0),\n  perPage: z.coerce.number().optional().default(10),\n  entityId: z.string().optional(),\n  entityType: z.string().optional(),\n});\n\nexport const listScoresByEntityIdQuerySchema = z.object({\n  page: z.coerce.number().optional().default(0),\n  perPage: z.coerce.number().optional().default(10),\n});\n\n// Body schema for saving scores\nexport const saveScoreBodySchema = z.object({\n  score: z.unknown(), // ScoreRowData - complex type\n});\n\n// Response schemas\nexport const scoresWithPaginationResponseSchema = z.object({\n  pagination: paginationInfoSchema,\n  scores: z.array(z.unknown()), // Array of score records\n});\n\nexport const saveScoreResponseSchema = z.object({\n  score: z.unknown(), // ScoreRowData\n});\n"]}

package/dist/chunk-AVRO3FIN.cjs

@@ -0,0 +1,231 @@
+'use strict';
+
+var zodToJson = require('@mastra/core/utils/zod-to-json');
+var zod = require('zod');
+
+// 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
+  };
+}
+function pickParams(schema, params) {
+  const keys = Object.keys(schema.shape);
+  const result = {};
+  for (const key of keys) {
+    if (key in params) {
+      result[key] = params[key];
+    }
+  }
+  return result;
+}
+function jsonQueryParam(schema) {
+  return zod.z.union([
+    schema,
+    // Already the expected type (non-string input)
+    zod.z.string().transform((val, ctx) => {
+      try {
+        const parsed = JSON.parse(val);
+        const result = schema.safeParse(parsed);
+        if (!result.success) {
+          for (const issue of result.error.issues) {
+            ctx.addIssue({
+              code: zod.z.ZodIssueCode.custom,
+              message: issue.message,
+              path: issue.path
+            });
+          }
+          return zod.z.NEVER;
+        }
+        return result.data;
+      } catch (e) {
+        ctx.addIssue({
+          code: zod.z.ZodIssueCode.custom,
+          message: `Invalid JSON: ${e instanceof Error ? e.message : "parse error"}`
+        });
+        return zod.z.NEVER;
+      }
+    })
+  ]);
+}
+function getZodTypeName(schema) {
+  return schema?._def?.typeName;
+}
+function isComplexType(schema) {
+  let inner = schema;
+  let typeName = getZodTypeName(inner);
+  while (typeName === "ZodOptional" || typeName === "ZodNullable") {
+    inner = inner._def.innerType;
+    typeName = getZodTypeName(inner);
+  }
+  return typeName === "ZodArray" || typeName === "ZodRecord" || typeName === "ZodObject";
+}
+function wrapSchemaForQueryParams(schema) {
+  const newShape = {};
+  for (const [key, fieldSchema] of Object.entries(schema.shape)) {
+    if (isComplexType(fieldSchema)) {
+      newShape[key] = jsonQueryParam(fieldSchema);
+    } else {
+      newShape[key] = fieldSchema;
+    }
+  }
+  return zod.z.object(newShape);
+}
+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;
+exports.jsonQueryParam = jsonQueryParam;
+exports.pickParams = pickParams;
+exports.wrapSchemaForQueryParams = wrapSchemaForQueryParams;
+//# sourceMappingURL=chunk-AVRO3FIN.cjs.map
+//# sourceMappingURL=chunk-AVRO3FIN.cjs.map

package/dist/chunk-AVRO3FIN.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","z"],"mappings":"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","file":"chunk-AVRO3FIN.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 { z } from 'zod';\nimport type { ZodObject, ZodRawShape, ZodTypeAny } from 'zod';\nimport { generateRouteOpenAPI } from '../openapi-utils';\nimport type { InferParams, ResponseType, ServerRoute, ServerRouteHandler } from './index';\n\n/**\n * Extracts parameters matching a Zod schema's shape from a params object.\n * Useful for separating schema-defined params from ServerContext in handlers.\n *\n * @example\n * ```typescript\n * const querySchema = z.object({ page: z.number(), name: z.string() });\n *\n * handler: async (params) => {\n *   const query = pickParams(querySchema, params);\n *   // query is typed as { page: number, name: string }\n * }\n * ```\n */\nexport function pickParams<T extends z.ZodRawShape, P extends Record<string, unknown>>(\n  schema: z.ZodObject<T>,\n  params: P,\n): z.infer<z.ZodObject<T>> {\n  const keys = Object.keys(schema.shape);\n  const result = {} as z.infer<z.ZodObject<T>>;\n  for (const key of keys) {\n    if (key in params) {\n      (result as any)[key] = params[key];\n    }\n  }\n  return result;\n}\n\n/**\n * Wraps a Zod schema to accept either the expected type OR a JSON string.\n * Used for complex query parameters (arrays, objects) that are serialized as JSON in URLs.\n *\n * - If input is already the expected type, passes through to schema validation\n * - If input is a string, attempts JSON.parse then validates\n * - Provides clear error messages for JSON parse failures\n *\n * @example\n * ```typescript\n * const tagsSchema = jsonQueryParam(z.array(z.string()));\n * // Accepts: [\"tag1\", \"tag2\"] OR '[\"tag1\", \"tag2\"]'\n *\n * const dateRangeSchema = jsonQueryParam(z.object({ gte: z.coerce.date() }));\n * // Accepts: { gte: \"2024-01-01\" } OR '{\"gte\": \"2024-01-01\"}'\n * ```\n */\nexport function jsonQueryParam<T extends ZodTypeAny>(schema: T): z.ZodType<z.infer<T>> {\n  return z.union([\n    schema, // Already the expected type (non-string input)\n    z.string().transform((val, ctx) => {\n      try {\n        const parsed = JSON.parse(val);\n        const result = schema.safeParse(parsed);\n        if (!result.success) {\n          for (const issue of result.error.issues) {\n            ctx.addIssue({\n              code: z.ZodIssueCode.custom,\n              message: issue.message,\n              path: issue.path,\n            });\n          }\n          return z.NEVER;\n        }\n        return result.data;\n      } catch (e) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: `Invalid JSON: ${e instanceof Error ? e.message : 'parse error'}`,\n        });\n        return z.NEVER;\n      }\n    }),\n  ]) as z.ZodType<z.infer<T>>;\n}\n\n/**\n * Gets the type name from a Zod schema's internal definition.\n * Works across zod v3 and v4 by checking _def.typeName.\n */\nfunction getZodTypeName(schema: ZodTypeAny): string | undefined {\n  return (schema as any)?._def?.typeName;\n}\n\n/**\n * Checks if a Zod schema represents a complex type that needs JSON parsing from query strings.\n * Complex types: arrays, objects, records (these can't be represented as simple strings)\n * Simple types: strings, numbers, booleans, enums (can use z.coerce for conversion)\n *\n * Uses _def.typeName string comparison instead of instanceof to support both zod v3 and v4,\n * since instanceof checks fail across different zod versions in bundled code.\n */\nfunction isComplexType(schema: ZodTypeAny): boolean {\n  // Unwrap all optional/nullable layers to check the inner type\n  // Note: .partial() can create nested optionals (e.g., ZodOptional<ZodOptional<ZodObject>>)\n  let inner: ZodTypeAny = schema;\n  let typeName = getZodTypeName(inner);\n\n  while (typeName === 'ZodOptional' || typeName === 'ZodNullable') {\n    // Access innerType directly from _def to avoid version-specific method differences\n    inner = (inner as any)._def.innerType;\n    typeName = getZodTypeName(inner);\n  }\n\n  // Complex types that need JSON parsing\n  return typeName === 'ZodArray' || typeName === 'ZodRecord' || typeName === 'ZodObject';\n}\n\n/**\n * Wraps a Zod object schema for HTTP query parameter handling.\n * Automatically detects complex fields (arrays, objects, records) and wraps them\n * with jsonQueryParam() to accept JSON strings from query parameters.\n *\n * Simple fields (strings, numbers, booleans, enums) are left unchanged and should\n * use z.coerce for string-to-type conversion.\n *\n * @example\n * ```typescript\n * // Base schema (for internal/storage use)\n * const tracesFilterSchema = z.object({\n *   tags: z.array(z.string()).optional(),\n *   startedAt: dateRangeSchema.optional(),\n *   perPage: z.coerce.number().optional(),\n * });\n *\n * // HTTP schema (accepts JSON strings for complex fields)\n * const httpTracesFilterSchema = wrapSchemaForQueryParams(tracesFilterSchema);\n *\n * // Now accepts:\n * // ?tags=[\"tag1\",\"tag2\"]&startedAt={\"gte\":\"2024-01-01\"}&perPage=10\n * ```\n */\nexport function wrapSchemaForQueryParams<T extends ZodRawShape>(schema: ZodObject<T>): ZodObject<ZodRawShape> {\n  const newShape: ZodRawShape = {};\n\n  for (const [key, fieldSchema] of Object.entries(schema.shape)) {\n    if (isComplexType(fieldSchema as ZodTypeAny)) {\n      // Wrap complex types to accept JSON strings\n      newShape[key] = jsonQueryParam(fieldSchema as ZodTypeAny);\n    } else {\n      // Keep simple types as-is\n      newShape[key] = fieldSchema as ZodTypeAny;\n    }\n  }\n\n  return z.object(newShape);\n}\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"]}