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

package/dist/chunk-TT25WHVT.cjs

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

package/dist/chunk-TT25WHVT.cjs.map

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

package/dist/chunk-UPY7WWRA.cjs

@@ -0,0 +1,205 @@
+'use strict';
+
+var chunk5W4RPVTK_cjs = require('./chunk-5W4RPVTK.cjs');
+var chunkMWQQRVQC_cjs = require('./chunk-MWQQRVQC.cjs');
+var chunkH2RMXG2Q_cjs = require('./chunk-H2RMXG2Q.cjs');
+var chunkV5WWQN7P_cjs = require('./chunk-V5WWQN7P.cjs');
+var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var chunkO7I5CWRX_cjs = require('./chunk-O7I5CWRX.cjs');
+var stream = require('stream');
+var error = require('@mastra/core/error');
+
+// src/server/handlers/voice.ts
+var voice_exports = {};
+chunkO7I5CWRX_cjs.__export(voice_exports, {
+  GENERATE_SPEECH_DEPRECATED_ROUTE: () => GENERATE_SPEECH_DEPRECATED_ROUTE,
+  GENERATE_SPEECH_ROUTE: () => GENERATE_SPEECH_ROUTE,
+  GET_LISTENER_ROUTE: () => GET_LISTENER_ROUTE,
+  GET_SPEAKERS_DEPRECATED_ROUTE: () => GET_SPEAKERS_DEPRECATED_ROUTE,
+  GET_SPEAKERS_ROUTE: () => GET_SPEAKERS_ROUTE,
+  TRANSCRIBE_SPEECH_DEPRECATED_ROUTE: () => TRANSCRIBE_SPEECH_DEPRECATED_ROUTE,
+  TRANSCRIBE_SPEECH_ROUTE: () => TRANSCRIBE_SPEECH_ROUTE
+});
+var GET_SPEAKERS_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/agents/:agentId/voice/speakers",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  responseSchema: chunkMWQQRVQC_cjs.voiceSpeakersResponseSchema,
+  summary: "Get voice speakers",
+  description: "Returns available voice speakers for the specified agent",
+  tags: ["Agents", "Voice"],
+  handler: async ({ mastra, agentId, requestContext }) => {
+    try {
+      if (!agentId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent ID is required" });
+      }
+      const agent = mastra.getAgentById(agentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Agent not found" });
+      }
+      const voice = await agent.getVoice({ requestContext });
+      const speakers = await Promise.resolve().then(() => voice.getSpeakers()).catch((err) => {
+        if (err instanceof error.MastraError) {
+          return [];
+        }
+        throw err;
+      });
+      return speakers;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting speakers");
+    }
+  }
+});
+var GET_SPEAKERS_DEPRECATED_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/agents/:agentId/speakers",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  responseSchema: chunkMWQQRVQC_cjs.voiceSpeakersResponseSchema,
+  summary: "Get available speakers for an agent",
+  description: "[DEPRECATED] Use /api/agents/:agentId/voice/speakers instead. Get available speakers for an agent",
+  tags: ["Agents", "Voice"],
+  handler: GET_SPEAKERS_ROUTE.handler
+});
+var GENERATE_SPEECH_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "POST",
+  path: "/api/agents/:agentId/voice/speak",
+  responseType: "stream",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  bodySchema: chunkMWQQRVQC_cjs.generateSpeechBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.speakResponseSchema,
+  summary: "Generate speech",
+  description: "Generates speech audio from text using the agent voice configuration",
+  tags: ["Agents", "Voice"],
+  handler: async ({ mastra, agentId, text, speakerId, requestContext }) => {
+    try {
+      if (!agentId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent ID is required" });
+      }
+      chunk5W4RPVTK_cjs.validateBody({ text });
+      const agent = mastra.getAgentById(agentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Agent not found" });
+      }
+      const voice = await agent.getVoice({ requestContext });
+      if (!voice) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent does not have voice capabilities" });
+      }
+      const audioStream = await Promise.resolve().then(() => voice.speak(text, { speaker: speakerId })).catch((err) => {
+        if (err instanceof error.MastraError) {
+          throw new chunk64ITUOXI_cjs.HTTPException(400, { message: err.message });
+        }
+        throw err;
+      });
+      if (!audioStream) {
+        throw new chunk64ITUOXI_cjs.HTTPException(500, { message: "Failed to generate speech" });
+      }
+      return audioStream;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error generating speech");
+    }
+  }
+});
+var GENERATE_SPEECH_DEPRECATED_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "POST",
+  path: "/api/agents/:agentId/speak",
+  responseType: "stream",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  bodySchema: chunkMWQQRVQC_cjs.generateSpeechBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.speakResponseSchema,
+  summary: "Convert text to speech",
+  description: "[DEPRECATED] Use /api/agents/:agentId/voice/speak instead. Convert text to speech using the agent's voice provider",
+  tags: ["Agents", "Voice"],
+  handler: GENERATE_SPEECH_ROUTE.handler
+});
+var TRANSCRIBE_SPEECH_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "POST",
+  path: "/api/agents/:agentId/voice/listen",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  bodySchema: chunkMWQQRVQC_cjs.transcribeSpeechBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.transcribeSpeechResponseSchema,
+  summary: "Transcribe speech",
+  description: "Transcribes speech audio to text using the agent voice configuration",
+  tags: ["Agents", "Voice"],
+  handler: async ({ mastra, agentId, audioData, options, requestContext }) => {
+    try {
+      if (!agentId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent ID is required" });
+      }
+      if (!audioData) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Audio data is required" });
+      }
+      const agent = mastra.getAgentById(agentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Agent not found" });
+      }
+      const voice = await agent.getVoice({ requestContext });
+      if (!voice) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent does not have voice capabilities" });
+      }
+      const audioStream = new stream.Readable();
+      audioStream.push(audioData);
+      audioStream.push(null);
+      const text = await voice.listen(audioStream, options);
+      return { text };
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error transcribing speech");
+    }
+  }
+});
+var TRANSCRIBE_SPEECH_DEPRECATED_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "POST",
+  path: "/api/agents/:agentId/listen",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  bodySchema: chunkMWQQRVQC_cjs.transcribeSpeechBodySchema,
+  responseSchema: chunkMWQQRVQC_cjs.transcribeSpeechResponseSchema,
+  summary: "Convert speech to text",
+  description: "[DEPRECATED] Use /api/agents/:agentId/voice/listen instead. Convert speech to text using the agent's voice provider. Additional provider-specific options can be passed as query parameters.",
+  tags: ["Agents", "Voice"],
+  handler: TRANSCRIBE_SPEECH_ROUTE.handler
+});
+var GET_LISTENER_ROUTE = chunkH2RMXG2Q_cjs.createRoute({
+  method: "GET",
+  path: "/api/agents/:agentId/voice/listener",
+  responseType: "json",
+  pathParamSchema: chunkMWQQRVQC_cjs.agentIdPathParams,
+  responseSchema: chunkMWQQRVQC_cjs.getListenerResponseSchema,
+  summary: "Get voice listener",
+  description: "Returns the voice listener configuration for the agent",
+  tags: ["Agents", "Voice"],
+  handler: async ({ mastra, agentId, requestContext }) => {
+    try {
+      if (!agentId) {
+        throw new chunk64ITUOXI_cjs.HTTPException(400, { message: "Agent ID is required" });
+      }
+      const agent = mastra.getAgentById(agentId);
+      if (!agent) {
+        throw new chunk64ITUOXI_cjs.HTTPException(404, { message: "Agent not found" });
+      }
+      const voice = await agent.getVoice({ requestContext });
+      const listeners = await Promise.resolve().then(() => voice.getListener()).catch((err) => {
+        if (err instanceof error.MastraError) {
+          return { enabled: false };
+        }
+        throw err;
+      });
+      return listeners;
+    } catch (error) {
+      return chunkV5WWQN7P_cjs.handleError(error, "Error getting listeners");
+    }
+  }
+});
+
+exports.GENERATE_SPEECH_DEPRECATED_ROUTE = GENERATE_SPEECH_DEPRECATED_ROUTE;
+exports.GENERATE_SPEECH_ROUTE = GENERATE_SPEECH_ROUTE;
+exports.GET_LISTENER_ROUTE = GET_LISTENER_ROUTE;
+exports.GET_SPEAKERS_DEPRECATED_ROUTE = GET_SPEAKERS_DEPRECATED_ROUTE;
+exports.GET_SPEAKERS_ROUTE = GET_SPEAKERS_ROUTE;
+exports.TRANSCRIBE_SPEECH_DEPRECATED_ROUTE = TRANSCRIBE_SPEECH_DEPRECATED_ROUTE;
+exports.TRANSCRIBE_SPEECH_ROUTE = TRANSCRIBE_SPEECH_ROUTE;
+exports.voice_exports = voice_exports;
+//# sourceMappingURL=chunk-UPY7WWRA.cjs.map
+//# sourceMappingURL=chunk-UPY7WWRA.cjs.map

package/dist/chunk-UPY7WWRA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/voice.ts"],"names":["__export","createRoute","agentIdPathParams","voiceSpeakersResponseSchema","HTTPException","MastraError","handleError","generateSpeechBodySchema","speakResponseSchema","validateBody","transcribeSpeechBodySchema","transcribeSpeechResponseSchema","Readable","getListenerResponseSchema"],"mappings":"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","file":"chunk-UPY7WWRA.cjs","sourcesContent":["import { Readable } from 'node:stream';\nimport { MastraError } from '@mastra/core/error';\nimport { HTTPException } from '../http-exception';\nimport {\n  agentIdPathParams,\n  voiceSpeakersResponseSchema,\n  generateSpeechBodySchema,\n  speakResponseSchema,\n  transcribeSpeechBodySchema,\n  transcribeSpeechResponseSchema,\n  getListenerResponseSchema,\n} from '../schemas/agents';\nimport { createRoute } from '../server-adapter/routes/route-builder';\n\nimport { handleError } from './error';\nimport { validateBody } from './utils';\n\n// ============================================================================\n// Route Objects\n// ============================================================================\n\nexport const GET_SPEAKERS_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/agents/:agentId/voice/speakers',\n  responseType: 'json',\n  pathParamSchema: agentIdPathParams,\n  responseSchema: voiceSpeakersResponseSchema,\n  summary: 'Get voice speakers',\n  description: 'Returns available voice speakers for the specified agent',\n  tags: ['Agents', 'Voice'],\n  handler: async ({ mastra, agentId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n\n      const agent = mastra.getAgentById(agentId);\n\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Agent not found' });\n      }\n\n      const voice = await agent.getVoice({ requestContext });\n\n      const speakers = await Promise.resolve()\n        .then(() => voice.getSpeakers())\n        .catch(err => {\n          if (err instanceof MastraError) {\n            // No voice provider configured, return empty array\n            return [];\n          }\n          throw err;\n        });\n\n      return speakers;\n    } catch (error) {\n      return handleError(error, 'Error getting speakers');\n    }\n  },\n});\n\nexport const GET_SPEAKERS_DEPRECATED_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/agents/:agentId/speakers',\n  responseType: 'json',\n  pathParamSchema: agentIdPathParams,\n  responseSchema: voiceSpeakersResponseSchema,\n  summary: 'Get available speakers for an agent',\n  description: '[DEPRECATED] Use /api/agents/:agentId/voice/speakers instead. Get available speakers for an agent',\n  tags: ['Agents', 'Voice'],\n  handler: GET_SPEAKERS_ROUTE.handler,\n});\n\nexport const GENERATE_SPEECH_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/agents/:agentId/voice/speak',\n  responseType: 'stream',\n  pathParamSchema: agentIdPathParams,\n  bodySchema: generateSpeechBodySchema,\n  responseSchema: speakResponseSchema,\n  summary: 'Generate speech',\n  description: 'Generates speech audio from text using the agent voice configuration',\n  tags: ['Agents', 'Voice'],\n  handler: async ({ mastra, agentId, text, speakerId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n\n      validateBody({ text });\n\n      const agent = mastra.getAgentById(agentId);\n\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Agent not found' });\n      }\n\n      const voice = await agent.getVoice({ requestContext });\n\n      if (!voice) {\n        throw new HTTPException(400, { message: 'Agent does not have voice capabilities' });\n      }\n\n      const audioStream = await Promise.resolve()\n        .then(() => voice.speak(text!, { speaker: speakerId! }))\n        .catch(err => {\n          if (err instanceof MastraError) {\n            throw new HTTPException(400, { message: err.message });\n          }\n\n          throw err;\n        });\n\n      if (!audioStream) {\n        throw new HTTPException(500, { message: 'Failed to generate speech' });\n      }\n\n      return audioStream as unknown as ReadableStream<any>;\n    } catch (error) {\n      return handleError(error, 'Error generating speech');\n    }\n  },\n});\n\nexport const GENERATE_SPEECH_DEPRECATED_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/agents/:agentId/speak',\n  responseType: 'stream',\n  pathParamSchema: agentIdPathParams,\n  bodySchema: generateSpeechBodySchema,\n  responseSchema: speakResponseSchema,\n  summary: 'Convert text to speech',\n  description:\n    \"[DEPRECATED] Use /api/agents/:agentId/voice/speak instead. Convert text to speech using the agent's voice provider\",\n  tags: ['Agents', 'Voice'],\n  handler: GENERATE_SPEECH_ROUTE.handler,\n});\n\nexport const TRANSCRIBE_SPEECH_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/agents/:agentId/voice/listen',\n  responseType: 'json',\n  pathParamSchema: agentIdPathParams,\n  bodySchema: transcribeSpeechBodySchema,\n  responseSchema: transcribeSpeechResponseSchema,\n  summary: 'Transcribe speech',\n  description: 'Transcribes speech audio to text using the agent voice configuration',\n  tags: ['Agents', 'Voice'],\n  handler: async ({ mastra, agentId, audioData, options, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n\n      if (!audioData) {\n        throw new HTTPException(400, { message: 'Audio data is required' });\n      }\n\n      const agent = mastra.getAgentById(agentId);\n\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Agent not found' });\n      }\n\n      const voice = await agent.getVoice({ requestContext });\n\n      if (!voice) {\n        throw new HTTPException(400, { message: 'Agent does not have voice capabilities' });\n      }\n\n      const audioStream = new Readable();\n      audioStream.push(audioData);\n      audioStream.push(null);\n\n      const text = await voice.listen(audioStream, options);\n      return { text: text as string };\n    } catch (error) {\n      return handleError(error, 'Error transcribing speech');\n    }\n  },\n});\n\nexport const TRANSCRIBE_SPEECH_DEPRECATED_ROUTE = createRoute({\n  method: 'POST',\n  path: '/api/agents/:agentId/listen',\n  responseType: 'json',\n  pathParamSchema: agentIdPathParams,\n  bodySchema: transcribeSpeechBodySchema,\n  responseSchema: transcribeSpeechResponseSchema,\n  summary: 'Convert speech to text',\n  description:\n    \"[DEPRECATED] Use /api/agents/:agentId/voice/listen instead. Convert speech to text using the agent's voice provider. Additional provider-specific options can be passed as query parameters.\",\n  tags: ['Agents', 'Voice'],\n  handler: TRANSCRIBE_SPEECH_ROUTE.handler,\n});\n\nexport const GET_LISTENER_ROUTE = createRoute({\n  method: 'GET',\n  path: '/api/agents/:agentId/voice/listener',\n  responseType: 'json',\n  pathParamSchema: agentIdPathParams,\n  responseSchema: getListenerResponseSchema,\n  summary: 'Get voice listener',\n  description: 'Returns the voice listener configuration for the agent',\n  tags: ['Agents', 'Voice'],\n  handler: async ({ mastra, agentId, requestContext }) => {\n    try {\n      if (!agentId) {\n        throw new HTTPException(400, { message: 'Agent ID is required' });\n      }\n\n      const agent = mastra.getAgentById(agentId);\n\n      if (!agent) {\n        throw new HTTPException(404, { message: 'Agent not found' });\n      }\n\n      const voice = await agent.getVoice({ requestContext });\n\n      const listeners = await Promise.resolve()\n        .then(() => voice.getListener())\n        .catch(err => {\n          if (err instanceof MastraError) {\n            // No voice provider configured\n            return { enabled: false };\n          }\n          throw err;\n        });\n\n      return listeners;\n    } catch (error) {\n      return handleError(error, 'Error getting listeners');\n    }\n  },\n});\n"]}