@mastra/server 1.21.0-alpha.1 → 1.21.0

package/CHANGELOG.md

@@ -1,5 +1,101 @@
 # @mastra/server
 
+## 1.21.0
+
+### Minor Changes
+
+- **Added Responses API support for local Mastra apps** ([#14339](https://github.com/mastra-ai/mastra/pull/14339))
+
+  You can now call Mastra through a Responses API flow and continue stored turns with
+  `previous_response_id`, while keeping `model` as a Mastra model string and using
+  `agent_id` to target the registered Mastra agent that handles the request. This API acts as an agent-backed
+  adapter layer on top of Mastra memory and storage. Advanced provider-native settings can
+  also be passed through with `providerOptions`, and provider-returned continuation state
+  is surfaced back on the response under the same `providerOptions` field. Stored
+  response IDs now map directly to the persisted assistant turn ID in Mastra memory.
+  Configured tool definitions are returned under `tools`, while executed tool activity
+  is surfaced through `output` items such as `function_call`, `function_call_output`,
+  and the final assistant message. Stored responses also return `conversation_id`, which
+  maps directly to the underlying Mastra memory thread ID. You can create a conversation
+  explicitly with `client.conversations.create()` or let the first stored response create
+  it implicitly, inspect the stored item history with `client.conversations.items.list()`,
+  retrieve the conversation with `client.conversations.retrieve()`, or remove it with
+  `client.conversations.delete()`. Responses requests also support
+  `text.format`, including `json_object` for JSON mode and `json_schema` for
+  schema-constrained structured output, through the same agent-backed route.
+
+  ```ts
+  import { MastraClient } from '@mastra/client-js';
+
+  const client = new MastraClient({
+    baseUrl: 'http://localhost:4111',
+  });
+
+  const first = await client.responses.create({
+    model: 'openai/gpt-5',
+    agent_id: 'support-agent',
+    input: 'Write a short bedtime story.',
+    store: true,
+  });
+
+  const second = await client.responses.create({
+    model: 'openai/gpt-5',
+    agent_id: 'support-agent',
+    input: 'Make it funnier.',
+    store: true,
+    previous_response_id: first.id,
+  });
+
+  const items = await client.conversations.items.list(first.conversation_id!);
+
+  const jsonResponse = await client.responses.create({
+    model: 'openai/gpt-5',
+    agent_id: 'support-agent',
+    input: 'Return a JSON object with a title and summary.',
+    text: {
+      format: {
+        type: 'json_object',
+      },
+    },
+  });
+
+  const structuredResponse = await client.responses.create({
+    model: 'openai/gpt-5',
+    agent_id: 'support-agent',
+    input: 'Return a structured support ticket summary.',
+    text: {
+      format: {
+        type: 'json_schema',
+        name: 'ticket_summary',
+        strict: true,
+        schema: {
+          type: 'object',
+          properties: {
+            summary: { type: 'string' },
+            priority: { type: 'string' },
+          },
+          required: ['summary', 'priority'],
+          additionalProperties: false,
+        },
+      },
+    },
+  });
+  ```
+
+### Patch Changes
+
+- Fixed OpenAI Responses API json_object mode so agent-backed responses return JSON output correctly. ([#14935](https://github.com/mastra-ai/mastra/pull/14935))
+
+- Updated dependencies [[`9a43b47`](https://github.com/mastra-ai/mastra/commit/9a43b476465e86c9aca381c2831066b5c33c999a), [`ec5c319`](https://github.com/mastra-ai/mastra/commit/ec5c3197a50d034cb8e9cc494eebfddc684b5d81), [`6517789`](https://github.com/mastra-ai/mastra/commit/65177895b74b5471fe2245c7292f0176d9b3385d), [`13f4327`](https://github.com/mastra-ai/mastra/commit/13f4327f052faebe199cefbe906d33bf90238767), [`9ad6aa6`](https://github.com/mastra-ai/mastra/commit/9ad6aa6dfe858afc6955d1df5f3f78c40bb96b9c), [`2862127`](https://github.com/mastra-ai/mastra/commit/2862127d0a7cbd28523120ad64fea067a95838e6), [`3d16814`](https://github.com/mastra-ai/mastra/commit/3d16814c395931373543728994ff45ac98093074), [`7f498d0`](https://github.com/mastra-ai/mastra/commit/7f498d099eacef64fd43ee412e3bd6f87965a8a6), [`8cf8a67`](https://github.com/mastra-ai/mastra/commit/8cf8a67b061b737cb06d501fb8c1967a98bbf3cb), [`d7827e3`](https://github.com/mastra-ai/mastra/commit/d7827e393937c6cb0c7a744dde4d31538cb542b7)]:
+  - @mastra/core@1.21.0
+
+## 1.21.0-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`ec5c319`](https://github.com/mastra-ai/mastra/commit/ec5c3197a50d034cb8e9cc494eebfddc684b5d81), [`6517789`](https://github.com/mastra-ai/mastra/commit/65177895b74b5471fe2245c7292f0176d9b3385d), [`9ad6aa6`](https://github.com/mastra-ai/mastra/commit/9ad6aa6dfe858afc6955d1df5f3f78c40bb96b9c), [`2862127`](https://github.com/mastra-ai/mastra/commit/2862127d0a7cbd28523120ad64fea067a95838e6), [`3d16814`](https://github.com/mastra-ai/mastra/commit/3d16814c395931373543728994ff45ac98093074), [`7f498d0`](https://github.com/mastra-ai/mastra/commit/7f498d099eacef64fd43ee412e3bd6f87965a8a6), [`8cf8a67`](https://github.com/mastra-ai/mastra/commit/8cf8a67b061b737cb06d501fb8c1967a98bbf3cb), [`d7827e3`](https://github.com/mastra-ai/mastra/commit/d7827e393937c6cb0c7a744dde4d31538cb542b7)]:
+  - @mastra/core@1.21.0-alpha.2
+
 ## 1.21.0-alpha.1
 
 ### Patch Changes

package/dist/_types/@internal_core/dist/index.d.ts

@@ -585,7 +585,7 @@ declare const scoreRecordSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     timestamp: z.ZodDate;
-    traceId: z.ZodString;
+    traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     scorerId: z.ZodString;
     scorerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -643,7 +643,7 @@ declare const createScoreRecordSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     timestamp: z.ZodDate;
-    traceId: z.ZodString;
+    traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     scorerId: z.ZodString;
     scorerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -683,7 +683,7 @@ declare const createScoreArgsSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         scorerId: z.ZodString;
         scorerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -699,7 +699,7 @@ type CreateScoreArgs = z.infer<typeof createScoreArgsSchema>;
 /** Schema for createScore operation body in client/server */
 declare const createScoreBodySchema: z.ZodObject<{
     score: z.ZodObject<{
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -770,7 +770,7 @@ declare const batchCreateScoresArgsSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         scorerId: z.ZodString;
         scorerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -917,7 +917,7 @@ declare const listScoresResponseSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         scorerId: z.ZodString;
         scorerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1180,7 +1180,7 @@ declare const feedbackRecordSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     timestamp: z.ZodDate;
-    traceId: z.ZodString;
+    traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     feedbackSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1232,7 +1232,7 @@ declare const createFeedbackRecordSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     timestamp: z.ZodDate;
-    traceId: z.ZodString;
+    traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     feedbackSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1271,7 +1271,7 @@ declare const createFeedbackArgsSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         feedbackSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1287,7 +1287,7 @@ type CreateFeedbackArgs = z.infer<typeof createFeedbackArgsSchema>;
 declare const createFeedbackBodySchema: z.ZodObject<{
     feedback: z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -1356,7 +1356,7 @@ declare const batchCreateFeedbackArgsSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         feedbackSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1500,7 +1500,7 @@ declare const listFeedbackResponseSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         experimentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         timestamp: z.ZodDate;
-        traceId: z.ZodString;
+        traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         feedbackSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/{chunk-FGXFUFWK.cjs → chunk-JMOCVI6W.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGLB2TK6A_cjs = require('./chunk-GLB2TK6A.cjs');
+var chunkVUW7PJZC_cjs = require('./chunk-VUW7PJZC.cjs');
 var chunkTU7U5XUE_cjs = require('./chunk-TU7U5XUE.cjs');
 var chunkB34S64RC_cjs = require('./chunk-B34S64RC.cjs');
 var chunkEGSCXVMR_cjs = require('./chunk-EGSCXVMR.cjs');
@@ -14,35 +14,35 @@ var v4 = require('zod/v4');
 // src/server/handlers/observability.ts
 var observability_exports = {};
 chunkO7I5CWRX_cjs.__export(observability_exports, {
-  CREATE_FEEDBACK: () => chunkGLB2TK6A_cjs.CREATE_FEEDBACK,
-  CREATE_SCORE: () => chunkGLB2TK6A_cjs.CREATE_SCORE,
-  GET_ENTITY_NAMES: () => chunkGLB2TK6A_cjs.GET_ENTITY_NAMES,
-  GET_ENTITY_TYPES: () => chunkGLB2TK6A_cjs.GET_ENTITY_TYPES,
-  GET_ENVIRONMENTS: () => chunkGLB2TK6A_cjs.GET_ENVIRONMENTS,
-  GET_FEEDBACK_AGGREGATE: () => chunkGLB2TK6A_cjs.GET_FEEDBACK_AGGREGATE,
-  GET_FEEDBACK_BREAKDOWN: () => chunkGLB2TK6A_cjs.GET_FEEDBACK_BREAKDOWN,
-  GET_FEEDBACK_PERCENTILES: () => chunkGLB2TK6A_cjs.GET_FEEDBACK_PERCENTILES,
-  GET_FEEDBACK_TIME_SERIES: () => chunkGLB2TK6A_cjs.GET_FEEDBACK_TIME_SERIES,
-  GET_METRIC_AGGREGATE: () => chunkGLB2TK6A_cjs.GET_METRIC_AGGREGATE,
-  GET_METRIC_BREAKDOWN: () => chunkGLB2TK6A_cjs.GET_METRIC_BREAKDOWN,
-  GET_METRIC_LABEL_KEYS: () => chunkGLB2TK6A_cjs.GET_METRIC_LABEL_KEYS,
-  GET_METRIC_LABEL_VALUES: () => chunkGLB2TK6A_cjs.GET_METRIC_LABEL_VALUES,
-  GET_METRIC_NAMES: () => chunkGLB2TK6A_cjs.GET_METRIC_NAMES,
-  GET_METRIC_PERCENTILES: () => chunkGLB2TK6A_cjs.GET_METRIC_PERCENTILES,
-  GET_METRIC_TIME_SERIES: () => chunkGLB2TK6A_cjs.GET_METRIC_TIME_SERIES,
-  GET_SCORE_AGGREGATE: () => chunkGLB2TK6A_cjs.GET_SCORE_AGGREGATE,
-  GET_SCORE_BREAKDOWN: () => chunkGLB2TK6A_cjs.GET_SCORE_BREAKDOWN,
-  GET_SCORE_PERCENTILES: () => chunkGLB2TK6A_cjs.GET_SCORE_PERCENTILES,
-  GET_SCORE_TIME_SERIES: () => chunkGLB2TK6A_cjs.GET_SCORE_TIME_SERIES,
-  GET_SERVICE_NAMES: () => chunkGLB2TK6A_cjs.GET_SERVICE_NAMES,
-  GET_TAGS: () => chunkGLB2TK6A_cjs.GET_TAGS,
+  CREATE_FEEDBACK: () => chunkVUW7PJZC_cjs.CREATE_FEEDBACK,
+  CREATE_SCORE: () => chunkVUW7PJZC_cjs.CREATE_SCORE,
+  GET_ENTITY_NAMES: () => chunkVUW7PJZC_cjs.GET_ENTITY_NAMES,
+  GET_ENTITY_TYPES: () => chunkVUW7PJZC_cjs.GET_ENTITY_TYPES,
+  GET_ENVIRONMENTS: () => chunkVUW7PJZC_cjs.GET_ENVIRONMENTS,
+  GET_FEEDBACK_AGGREGATE: () => chunkVUW7PJZC_cjs.GET_FEEDBACK_AGGREGATE,
+  GET_FEEDBACK_BREAKDOWN: () => chunkVUW7PJZC_cjs.GET_FEEDBACK_BREAKDOWN,
+  GET_FEEDBACK_PERCENTILES: () => chunkVUW7PJZC_cjs.GET_FEEDBACK_PERCENTILES,
+  GET_FEEDBACK_TIME_SERIES: () => chunkVUW7PJZC_cjs.GET_FEEDBACK_TIME_SERIES,
+  GET_METRIC_AGGREGATE: () => chunkVUW7PJZC_cjs.GET_METRIC_AGGREGATE,
+  GET_METRIC_BREAKDOWN: () => chunkVUW7PJZC_cjs.GET_METRIC_BREAKDOWN,
+  GET_METRIC_LABEL_KEYS: () => chunkVUW7PJZC_cjs.GET_METRIC_LABEL_KEYS,
+  GET_METRIC_LABEL_VALUES: () => chunkVUW7PJZC_cjs.GET_METRIC_LABEL_VALUES,
+  GET_METRIC_NAMES: () => chunkVUW7PJZC_cjs.GET_METRIC_NAMES,
+  GET_METRIC_PERCENTILES: () => chunkVUW7PJZC_cjs.GET_METRIC_PERCENTILES,
+  GET_METRIC_TIME_SERIES: () => chunkVUW7PJZC_cjs.GET_METRIC_TIME_SERIES,
+  GET_SCORE_AGGREGATE: () => chunkVUW7PJZC_cjs.GET_SCORE_AGGREGATE,
+  GET_SCORE_BREAKDOWN: () => chunkVUW7PJZC_cjs.GET_SCORE_BREAKDOWN,
+  GET_SCORE_PERCENTILES: () => chunkVUW7PJZC_cjs.GET_SCORE_PERCENTILES,
+  GET_SCORE_TIME_SERIES: () => chunkVUW7PJZC_cjs.GET_SCORE_TIME_SERIES,
+  GET_SERVICE_NAMES: () => chunkVUW7PJZC_cjs.GET_SERVICE_NAMES,
+  GET_TAGS: () => chunkVUW7PJZC_cjs.GET_TAGS,
   GET_TRACE_ROUTE: () => GET_TRACE_ROUTE,
-  LIST_FEEDBACK: () => chunkGLB2TK6A_cjs.LIST_FEEDBACK,
-  LIST_LOGS: () => chunkGLB2TK6A_cjs.LIST_LOGS,
-  LIST_SCORES: () => chunkGLB2TK6A_cjs.LIST_SCORES,
+  LIST_FEEDBACK: () => chunkVUW7PJZC_cjs.LIST_FEEDBACK,
+  LIST_LOGS: () => chunkVUW7PJZC_cjs.LIST_LOGS,
+  LIST_SCORES: () => chunkVUW7PJZC_cjs.LIST_SCORES,
   LIST_SCORES_BY_SPAN_ROUTE: () => LIST_SCORES_BY_SPAN_ROUTE,
   LIST_TRACES_ROUTE: () => LIST_TRACES_ROUTE,
-  NEW_ROUTES: () => chunkGLB2TK6A_cjs.NEW_ROUTES,
+  NEW_ROUTES: () => chunkVUW7PJZC_cjs.NEW_ROUTES,
   SCORE_TRACES_ROUTE: () => SCORE_TRACES_ROUTE
 });
 var legacyQueryParamsSchema = v4.z.object({
@@ -200,5 +200,5 @@ exports.LIST_SCORES_BY_SPAN_ROUTE = LIST_SCORES_BY_SPAN_ROUTE;
 exports.LIST_TRACES_ROUTE = LIST_TRACES_ROUTE;
 exports.SCORE_TRACES_ROUTE = SCORE_TRACES_ROUTE;
 exports.observability_exports = observability_exports;
-//# sourceMappingURL=chunk-FGXFUFWK.cjs.map
-//# sourceMappingURL=chunk-FGXFUFWK.cjs.map
+//# sourceMappingURL=chunk-JMOCVI6W.cjs.map
+//# sourceMappingURL=chunk-JMOCVI6W.cjs.map

package/dist/{chunk-FGXFUFWK.cjs.map → chunk-JMOCVI6W.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/handlers/observability.ts"],"names":["__export","CREATE_FEEDBACK","CREATE_SCORE","GET_ENTITY_NAMES","GET_ENTITY_TYPES","GET_ENVIRONMENTS","GET_FEEDBACK_AGGREGATE","GET_FEEDBACK_BREAKDOWN","GET_FEEDBACK_PERCENTILES","GET_FEEDBACK_TIME_SERIES","GET_METRIC_AGGREGATE","GET_METRIC_BREAKDOWN","GET_METRIC_LABEL_KEYS","GET_METRIC_LABEL_VALUES","GET_METRIC_NAMES","GET_METRIC_PERCENTILES","GET_METRIC_TIME_SERIES","GET_SCORE_AGGREGATE","GET_SCORE_BREAKDOWN","GET_SCORE_PERCENTILES","GET_SCORE_TIME_SERIES","GET_SERVICE_NAMES","GET_TAGS","LIST_FEEDBACK","LIST_LOGS","LIST_SCORES","NEW_ROUTES","z","dateRangeSchema","getStorage","HTTPException","createRoute","wrapSchemaForQueryParams","tracesFilterSchema","paginationArgsSchema","tracesOrderBySchema","listTracesResponseSchema","pickParams","getObservabilityStore","handleError","getTraceArgsSchema","getTraceResponseSchema","scoreTracesRequestSchema","scoreTracesResponseSchema","scoreTraces","spanIdsSchema","listScoresResponseSchema"],"mappings":"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","file":"chunk-FGXFUFWK.cjs","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { listScoresResponseSchema } from '@mastra/core/evals';\nimport { scoreTraces } from '@mastra/core/evals/scoreTraces';\nimport type { ScoresStorage } from '@mastra/core/storage';\nimport {\n  tracesFilterSchema,\n  tracesOrderBySchema,\n  paginationArgsSchema,\n  spanIdsSchema,\n  listTracesResponseSchema,\n  scoreTracesRequestSchema,\n  scoreTracesResponseSchema,\n  getTraceArgsSchema,\n  getTraceResponseSchema,\n  dateRangeSchema,\n} from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport { createRoute, pickParams, wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\nimport { getObservabilityStore, getStorage } from './observability-shared';\n\nexport * from './observability-new-endpoints';\n\n// ============================================================================\n// Legacy Parameter Support (backward compatibility with main branch API)\n// ============================================================================\n\n/**\n * Legacy query parameters from the old API (main branch).\n * These are accepted for backward compatibility and transformed to new format.\n */\nconst legacyQueryParamsSchema = z.object({\n  // Old: dateRange was in pagination, now it's startedAt in filters\n  dateRange: dateRangeSchema.optional(),\n  // Old: name matched span names like \"agent run: 'myAgent'\"\n  name: z.string().optional(),\n  // entityType needs preprocessing to handle legacy 'workflow' value\n  entityType: z.preprocess(val => (val === 'workflow' ? 'workflow_run' : val), z.string().optional()),\n});\n\n/**\n * Transforms legacy query parameters to the new format.\n * - dateRange -> startedAt (if startedAt not already set)\n * - name=\"agent run: 'x'\" -> entityId='x', entityType='agent'\n * - name=\"workflow run: 'x'\" -> entityId='x', entityType='workflow_run'\n * - entityType='workflow' -> entityType='workflow_run' (enum value fix)\n */\nfunction transformLegacyParams(params: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...params };\n\n  // Transform old entityType='workflow' -> 'workflow_run' to support direct handler usage in tests\n  if (result.entityType === 'workflow') {\n    result.entityType = 'workflow_run';\n  }\n\n  // Transform old dateRange -> new startedAt\n  if (params.dateRange && !params.startedAt) {\n    result.startedAt = params.dateRange;\n    delete result.dateRange;\n  }\n\n  // Transform old name -> entityId + entityType\n  // Old format: name matched span names like \"agent run: 'myAgent'\" or \"workflow run: 'myWorkflow'\"\n  if (typeof params.name === 'string' && !params.entityId) {\n    const agentMatch = params.name.match(/^agent run: '([^']+)'$/);\n    const workflowMatch = params.name.match(/^workflow run: '([^']+)'$/);\n\n    if (agentMatch) {\n      result.entityId = agentMatch[1];\n      result.entityType = 'agent';\n    } else if (workflowMatch) {\n      result.entityId = workflowMatch[1];\n      result.entityType = 'workflow_run';\n    }\n    delete result.name;\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nasync function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n  const storage = getStorage(mastra);\n  const scores = await storage.getStore('scores');\n  if (!scores) {\n    throw new HTTPException(500, { message: 'Scores storage domain is not available' });\n  }\n  return scores;\n}\n\n/** Route: GET /observability/traces - paginated trace listing with filtering and sorting. */\nexport const LIST_TRACES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces',\n  responseType: 'json',\n  queryParamSchema: wrapSchemaForQueryParams(\n    tracesFilterSchema\n      .extend(paginationArgsSchema.shape)\n      .extend(tracesOrderBySchema.shape)\n      .extend(legacyQueryParamsSchema.shape) // Accept legacy params for backward compatibility\n      .partial(),\n  ),\n  responseSchema: listTracesResponseSchema,\n  summary: 'List traces',\n  description: 'Returns a paginated list of traces with optional filtering and sorting',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Transform legacy params to new format before processing\n      const transformedParams = transformLegacyParams(params);\n\n      const filters = pickParams(tracesFilterSchema, transformedParams);\n      const pagination = pickParams(paginationArgsSchema, transformedParams);\n      const orderBy = pickParams(tracesOrderBySchema, transformedParams);\n\n      const observabilityStore = await getObservabilityStore(mastra);\n      return await observabilityStore.listTraces({ filters, pagination, orderBy });\n    } catch (error) {\n      return handleError(error, 'Error listing traces');\n    }\n  },\n});\n\n/** Route: GET /observability/traces/:traceId - retrieve a single trace with all spans. */\nexport const GET_TRACE_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId',\n  responseType: 'json',\n  pathParamSchema: getTraceArgsSchema,\n  responseSchema: getTraceResponseSchema,\n  summary: 'Get AI trace by ID',\n  description: 'Returns a complete AI trace with all spans by trace ID',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, traceId }) => {\n    try {\n      const observabilityStore = await getObservabilityStore(mastra);\n      const trace = await observabilityStore.getTrace({ traceId });\n\n      if (!trace) {\n        throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });\n      }\n\n      return trace;\n    } catch (error) {\n      return handleError(error, 'Error getting trace');\n    }\n  },\n});\n\n/** Route: POST /observability/traces/score - score traces using a specified scorer (fire-and-forget). */\nexport const SCORE_TRACES_ROUTE = createRoute({\n  method: 'POST',\n  path: '/observability/traces/score',\n  responseType: 'json',\n  bodySchema: scoreTracesRequestSchema,\n  responseSchema: scoreTracesResponseSchema,\n  summary: 'Score traces',\n  description: 'Scores one or more traces using a specified scorer (fire-and-forget)',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Validate storage exists before starting background task\n      getStorage(mastra);\n\n      const { scorerName, targets } = params;\n\n      const scorer = mastra.getScorerById(scorerName);\n      if (!scorer) {\n        throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });\n      }\n\n      scoreTraces({\n        scorerId: scorer.config.id || scorer.config.name,\n        targets,\n        mastra,\n      }).catch(error => {\n        const logger = mastra.getLogger();\n        logger?.error(`Background trace scoring failed: ${error.message}`, error);\n      });\n\n      return {\n        status: 'success',\n        message: `Scoring started for ${targets.length} ${targets.length === 1 ? 'trace' : 'traces'}`,\n        traceCount: targets.length,\n      };\n    } catch (error) {\n      return handleError(error, 'Error processing trace scoring');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_SPAN_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId/:spanId/scores',\n  responseType: 'json',\n  pathParamSchema: spanIdsSchema,\n  // List endpoints accept optional query params; use partial() to allow empty queries.\n  queryParamSchema: wrapSchemaForQueryParams(paginationArgsSchema.partial()),\n  responseSchema: listScoresResponseSchema,\n  summary: 'List scores by span',\n  description: 'Returns all scores for a specific span within a trace',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const pagination = pickParams(paginationArgsSchema, params);\n      const spanIds = pickParams(spanIdsSchema, params);\n\n      const scoresStore = await getScoresStore(mastra);\n\n      return await scoresStore.listScoresBySpan({\n        ...spanIds,\n        pagination,\n      });\n    } catch (error) {\n      return handleError(error, 'Error getting scores by span');\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../src/server/handlers/observability.ts"],"names":["__export","CREATE_FEEDBACK","CREATE_SCORE","GET_ENTITY_NAMES","GET_ENTITY_TYPES","GET_ENVIRONMENTS","GET_FEEDBACK_AGGREGATE","GET_FEEDBACK_BREAKDOWN","GET_FEEDBACK_PERCENTILES","GET_FEEDBACK_TIME_SERIES","GET_METRIC_AGGREGATE","GET_METRIC_BREAKDOWN","GET_METRIC_LABEL_KEYS","GET_METRIC_LABEL_VALUES","GET_METRIC_NAMES","GET_METRIC_PERCENTILES","GET_METRIC_TIME_SERIES","GET_SCORE_AGGREGATE","GET_SCORE_BREAKDOWN","GET_SCORE_PERCENTILES","GET_SCORE_TIME_SERIES","GET_SERVICE_NAMES","GET_TAGS","LIST_FEEDBACK","LIST_LOGS","LIST_SCORES","NEW_ROUTES","z","dateRangeSchema","getStorage","HTTPException","createRoute","wrapSchemaForQueryParams","tracesFilterSchema","paginationArgsSchema","tracesOrderBySchema","listTracesResponseSchema","pickParams","getObservabilityStore","handleError","getTraceArgsSchema","getTraceResponseSchema","scoreTracesRequestSchema","scoreTracesResponseSchema","scoreTraces","spanIdsSchema","listScoresResponseSchema"],"mappings":"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","file":"chunk-JMOCVI6W.cjs","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { listScoresResponseSchema } from '@mastra/core/evals';\nimport { scoreTraces } from '@mastra/core/evals/scoreTraces';\nimport type { ScoresStorage } from '@mastra/core/storage';\nimport {\n  tracesFilterSchema,\n  tracesOrderBySchema,\n  paginationArgsSchema,\n  spanIdsSchema,\n  listTracesResponseSchema,\n  scoreTracesRequestSchema,\n  scoreTracesResponseSchema,\n  getTraceArgsSchema,\n  getTraceResponseSchema,\n  dateRangeSchema,\n} from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport { createRoute, pickParams, wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\nimport { getObservabilityStore, getStorage } from './observability-shared';\n\nexport * from './observability-new-endpoints';\n\n// ============================================================================\n// Legacy Parameter Support (backward compatibility with main branch API)\n// ============================================================================\n\n/**\n * Legacy query parameters from the old API (main branch).\n * These are accepted for backward compatibility and transformed to new format.\n */\nconst legacyQueryParamsSchema = z.object({\n  // Old: dateRange was in pagination, now it's startedAt in filters\n  dateRange: dateRangeSchema.optional(),\n  // Old: name matched span names like \"agent run: 'myAgent'\"\n  name: z.string().optional(),\n  // entityType needs preprocessing to handle legacy 'workflow' value\n  entityType: z.preprocess(val => (val === 'workflow' ? 'workflow_run' : val), z.string().optional()),\n});\n\n/**\n * Transforms legacy query parameters to the new format.\n * - dateRange -> startedAt (if startedAt not already set)\n * - name=\"agent run: 'x'\" -> entityId='x', entityType='agent'\n * - name=\"workflow run: 'x'\" -> entityId='x', entityType='workflow_run'\n * - entityType='workflow' -> entityType='workflow_run' (enum value fix)\n */\nfunction transformLegacyParams(params: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...params };\n\n  // Transform old entityType='workflow' -> 'workflow_run' to support direct handler usage in tests\n  if (result.entityType === 'workflow') {\n    result.entityType = 'workflow_run';\n  }\n\n  // Transform old dateRange -> new startedAt\n  if (params.dateRange && !params.startedAt) {\n    result.startedAt = params.dateRange;\n    delete result.dateRange;\n  }\n\n  // Transform old name -> entityId + entityType\n  // Old format: name matched span names like \"agent run: 'myAgent'\" or \"workflow run: 'myWorkflow'\"\n  if (typeof params.name === 'string' && !params.entityId) {\n    const agentMatch = params.name.match(/^agent run: '([^']+)'$/);\n    const workflowMatch = params.name.match(/^workflow run: '([^']+)'$/);\n\n    if (agentMatch) {\n      result.entityId = agentMatch[1];\n      result.entityType = 'agent';\n    } else if (workflowMatch) {\n      result.entityId = workflowMatch[1];\n      result.entityType = 'workflow_run';\n    }\n    delete result.name;\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Route Definitions (new pattern - handlers defined inline with createRoute)\n// ============================================================================\n\nasync function getScoresStore(mastra: Mastra): Promise<ScoresStorage> {\n  const storage = getStorage(mastra);\n  const scores = await storage.getStore('scores');\n  if (!scores) {\n    throw new HTTPException(500, { message: 'Scores storage domain is not available' });\n  }\n  return scores;\n}\n\n/** Route: GET /observability/traces - paginated trace listing with filtering and sorting. */\nexport const LIST_TRACES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces',\n  responseType: 'json',\n  queryParamSchema: wrapSchemaForQueryParams(\n    tracesFilterSchema\n      .extend(paginationArgsSchema.shape)\n      .extend(tracesOrderBySchema.shape)\n      .extend(legacyQueryParamsSchema.shape) // Accept legacy params for backward compatibility\n      .partial(),\n  ),\n  responseSchema: listTracesResponseSchema,\n  summary: 'List traces',\n  description: 'Returns a paginated list of traces with optional filtering and sorting',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Transform legacy params to new format before processing\n      const transformedParams = transformLegacyParams(params);\n\n      const filters = pickParams(tracesFilterSchema, transformedParams);\n      const pagination = pickParams(paginationArgsSchema, transformedParams);\n      const orderBy = pickParams(tracesOrderBySchema, transformedParams);\n\n      const observabilityStore = await getObservabilityStore(mastra);\n      return await observabilityStore.listTraces({ filters, pagination, orderBy });\n    } catch (error) {\n      return handleError(error, 'Error listing traces');\n    }\n  },\n});\n\n/** Route: GET /observability/traces/:traceId - retrieve a single trace with all spans. */\nexport const GET_TRACE_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId',\n  responseType: 'json',\n  pathParamSchema: getTraceArgsSchema,\n  responseSchema: getTraceResponseSchema,\n  summary: 'Get AI trace by ID',\n  description: 'Returns a complete AI trace with all spans by trace ID',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, traceId }) => {\n    try {\n      const observabilityStore = await getObservabilityStore(mastra);\n      const trace = await observabilityStore.getTrace({ traceId });\n\n      if (!trace) {\n        throw new HTTPException(404, { message: `Trace with ID '${traceId}' not found` });\n      }\n\n      return trace;\n    } catch (error) {\n      return handleError(error, 'Error getting trace');\n    }\n  },\n});\n\n/** Route: POST /observability/traces/score - score traces using a specified scorer (fire-and-forget). */\nexport const SCORE_TRACES_ROUTE = createRoute({\n  method: 'POST',\n  path: '/observability/traces/score',\n  responseType: 'json',\n  bodySchema: scoreTracesRequestSchema,\n  responseSchema: scoreTracesResponseSchema,\n  summary: 'Score traces',\n  description: 'Scores one or more traces using a specified scorer (fire-and-forget)',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      // Validate storage exists before starting background task\n      getStorage(mastra);\n\n      const { scorerName, targets } = params;\n\n      const scorer = mastra.getScorerById(scorerName);\n      if (!scorer) {\n        throw new HTTPException(404, { message: `Scorer '${scorerName}' not found` });\n      }\n\n      scoreTraces({\n        scorerId: scorer.config.id || scorer.config.name,\n        targets,\n        mastra,\n      }).catch(error => {\n        const logger = mastra.getLogger();\n        logger?.error(`Background trace scoring failed: ${error.message}`, error);\n      });\n\n      return {\n        status: 'success',\n        message: `Scoring started for ${targets.length} ${targets.length === 1 ? 'trace' : 'traces'}`,\n        traceCount: targets.length,\n      };\n    } catch (error) {\n      return handleError(error, 'Error processing trace scoring');\n    }\n  },\n});\n\nexport const LIST_SCORES_BY_SPAN_ROUTE = createRoute({\n  method: 'GET',\n  path: '/observability/traces/:traceId/:spanId/scores',\n  responseType: 'json',\n  pathParamSchema: spanIdsSchema,\n  // List endpoints accept optional query params; use partial() to allow empty queries.\n  queryParamSchema: wrapSchemaForQueryParams(paginationArgsSchema.partial()),\n  responseSchema: listScoresResponseSchema,\n  summary: 'List scores by span',\n  description: 'Returns all scores for a specific span within a trace',\n  tags: ['Observability'],\n  requiresAuth: true,\n  handler: async ({ mastra, ...params }) => {\n    try {\n      const pagination = pickParams(paginationArgsSchema, params);\n      const spanIds = pickParams(spanIdsSchema, params);\n\n      const scoresStore = await getScoresStore(mastra);\n\n      return await scoresStore.listScoresBySpan({\n        ...spanIds,\n        pagination,\n      });\n    } catch (error) {\n      return handleError(error, 'Error getting scores by span');\n    }\n  },\n});\n"]}

package/dist/{chunk-WO7BJJIB.js → chunk-M7MFCJT4.js}

@@ -202,7 +202,7 @@ var scoreReasonField = z.string().describe("Explanation for the score");
 var scoreRecordSchema = z.object({
   timestamp: z.date().describe("When the score was recorded"),
   // Target
-  traceId: traceIdField,
+  traceId: traceIdField.nullish().describe("Trace that anchors the scored target when available"),
   spanId: spanIdField.nullish().describe("Span ID this score applies to"),
   // Score data
   scorerId: scorerIdField,
@@ -356,7 +356,7 @@ function normalizeLegacyFeedbackActor(input) {
 var feedbackRecordObjectSchema = z.object({
   timestamp: z.date().describe("When the feedback was recorded"),
   // Target
-  traceId: traceIdField,
+  traceId: traceIdField.nullish().describe("Trace that anchors the feedback target when available"),
   spanId: spanIdField.nullish().describe("Span ID this feedback applies to"),
   // Feedback data
   feedbackSource: feedbackSourceField.nullish(),
@@ -978,5 +978,5 @@ var NEW_ROUTES = {
 };
 
 export { CREATE_FEEDBACK, CREATE_SCORE, GET_ENTITY_NAMES, GET_ENTITY_TYPES, GET_ENVIRONMENTS, GET_FEEDBACK_AGGREGATE, GET_FEEDBACK_BREAKDOWN, GET_FEEDBACK_PERCENTILES, GET_FEEDBACK_TIME_SERIES, GET_METRIC_AGGREGATE, GET_METRIC_BREAKDOWN, GET_METRIC_LABEL_KEYS, GET_METRIC_LABEL_VALUES, GET_METRIC_NAMES, GET_METRIC_PERCENTILES, GET_METRIC_TIME_SERIES, GET_SCORE_AGGREGATE, GET_SCORE_BREAKDOWN, GET_SCORE_PERCENTILES, GET_SCORE_TIME_SERIES, GET_SERVICE_NAMES, GET_TAGS, LIST_FEEDBACK, LIST_LOGS, LIST_SCORES, NEW_ROUTES };
-//# sourceMappingURL=chunk-WO7BJJIB.js.map
-//# sourceMappingURL=chunk-WO7BJJIB.js.map
+//# sourceMappingURL=chunk-M7MFCJT4.js.map
+//# sourceMappingURL=chunk-M7MFCJT4.js.map