@mastra/core 1.18.0-alpha.3 → 1.18.0-alpha.5

package/dist/{chunk-CX5I6VS4.js → chunk-KRFGPA2H.js}

@@ -43,6 +43,21 @@ var dateRangeSchema = z.object({
   endExclusive: z.boolean().optional().describe("When true, excludes the end date from results (uses < instead of <=)")
 }).describe("Date range filter for timestamps");
 var sortDirectionSchema = z.enum(["ASC", "DESC"]).describe("Sort direction: 'ASC' | 'DESC'");
+var aggregationTypeSchema = z.enum(["sum", "avg", "min", "max", "count", "last"]).describe("Aggregation function");
+var aggregationIntervalSchema = z.enum(["1m", "5m", "15m", "1h", "1d"]).describe("Time bucket interval");
+var comparePeriodSchema = z.enum(["previous_period", "previous_day", "previous_week"]).describe("Comparison period for aggregate queries");
+var groupBySchema = z.array(z.string()).min(1).describe("Fields to group by");
+var percentilesSchema = z.array(z.number().min(0).max(1)).min(1).describe("Percentile values (0-1)");
+var aggregateResponseFields = {
+  value: z.number().nullable().describe("Aggregated value"),
+  previousValue: z.number().nullable().optional().describe("Value from comparison period"),
+  changePercent: z.number().nullable().optional().describe("Percentage change from comparison period")
+};
+var dimensionsField = z.record(z.string(), z.string().nullable()).describe("Dimension values for this group");
+var aggregatedValueField = z.number().describe("Aggregated value");
+var bucketTimestampField = z.date().describe("Bucket timestamp");
+var percentileField = z.number().describe("Percentile value");
+var percentileBucketValueField = z.number().describe("Percentile value at this bucket");
 var entityTypeField = z.nativeEnum(EntityType).describe(`Entity type (e.g., 'agent' | 'processor' | 'tool' | 'workflow')`);
 var entityIdField = z.string().describe('ID of the entity (e.g., "weatherAgent", "orderWorkflow")');
 var entityNameField = z.string().describe("Name of the entity");
@@ -55,6 +70,7 @@ var threadIdField = z.string().describe("Conversation thread identifier");
 var requestIdField = z.string().describe("HTTP request ID for log correlation");
 var environmentField = z.string().describe(`Environment (e.g., "production" | "staging" | "development")`);
 var sourceField = z.string().describe(`Source of execution (e.g., "local" | "cloud" | "ci")`);
+var executionSourceField = z.string().describe(`Source of execution (e.g., "local" | "cloud" | "ci")`);
 var serviceNameField = z.string().describe("Name of the service");
 var parentEntityTypeField = z.nativeEnum(EntityType).describe("Entity type of the parent entity");
 var parentEntityIdField = z.string().describe("ID of the parent entity");
@@ -66,7 +82,7 @@ var experimentIdField = z.string().describe("Experiment or eval run identifier")
 var scopeField = z.record(z.string(), z.unknown()).describe('Arbitrary package/app version info (e.g., {"core": "1.0.0", "memory": "1.0.0", "gitSha": "abcd1234"})');
 var metadataField = z.record(z.string(), z.unknown()).describe("User-defined metadata for custom filtering");
 var tagsField = z.array(z.string()).describe("Labels for filtering");
-var contextFields = {
+var contextFieldsBase = {
   // Entity identification
   entityType: entityTypeField.nullish(),
   entityId: entityIdField.nullish(),
@@ -90,12 +106,20 @@ var contextFields = {
   requestId: requestIdField.nullish(),
   // Deployment context
   environment: environmentField.nullish(),
-  source: sourceField.nullish(),
   serviceName: serviceNameField.nullish(),
   scope: scopeField.nullish(),
   // Experimentation
   experimentId: experimentIdField.nullish()
 };
+var contextFields = {
+  ...contextFieldsBase,
+  executionSource: executionSourceField.nullish(),
+  tags: tagsField.nullish()
+};
+var spanContextFields = {
+  ...contextFieldsBase,
+  source: sourceField.nullish()
+};
 var commonFilterFields = {
   timestamp: dateRangeSchema.optional().describe("Filter by timestamp range"),
   traceId: z.string().optional().describe("Filter by trace ID"),
@@ -106,9 +130,7 @@ var commonFilterFields = {
   organizationId: organizationIdField.optional(),
   experimentId: experimentIdField.optional(),
   serviceName: serviceNameField.optional(),
-  environment: environmentField.optional()
-};
-var observabilitySignalFilterFields = {
+  environment: environmentField.optional(),
   parentEntityType: parentEntityTypeField.optional(),
   parentEntityName: parentEntityNameField.optional(),
   rootEntityType: rootEntityTypeField.optional(),
@@ -118,7 +140,7 @@ var observabilitySignalFilterFields = {
   sessionId: sessionIdField.optional(),
   threadId: threadIdField.optional(),
   requestId: requestIdField.optional(),
-  source: sourceField.optional(),
+  executionSource: executionSourceField.optional(),
   tags: z.array(z.string()).optional().describe("Filter by tags (must have all specified tags)")
 };
 var traceIdField = z.string().describe("Unique trace identifier");
@@ -134,10 +156,12 @@ var logRecordSchema = z.object({
   // Correlation
   traceId: traceIdField.nullish(),
   spanId: spanIdField.nullish(),
-  // Context fields (same as tracing)
+  // Context fields
   ...contextFields,
-  // Filtering
-  tags: tagsField.nullish(),
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: z.string().nullish().describe("Execution source"),
   metadata: metadataField.nullish()
 }).describe("Log record as stored in the database");
 var logRecordInputSchema = z.object({
@@ -152,8 +176,11 @@ var batchCreateLogsArgsSchema = z.object({
 }).describe("Arguments for batch creating logs");
 var logsFilterSchema = z.object({
   ...commonFilterFields,
-  ...observabilitySignalFilterFields,
   // Log-specific filters
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: z.string().optional().describe("Filter by execution source"),
   level: z.union([logLevelSchema, z.array(logLevelSchema)]).optional().describe("Filter by log level(s)")
 }).describe("Filters for querying logs");
 var logsOrderByFieldSchema = z.enum(["timestamp"]).describe("Field to order by: 'timestamp'");
@@ -172,7 +199,7 @@ var listLogsResponseSchema = z.object({
 });
 var scorerIdField = z.string().describe("Identifier of the scorer (e.g., relevance, accuracy)");
 var scorerVersionField = z.string().describe("Version of the scorer");
-var sourceField2 = z.string().describe("Source of the score (e.g., manual, automated, experiment)");
+var scoreSourceField = z.string().describe("Source of the score (e.g., manual, automated, experiment)");
 var scoreValueField = z.number().describe("Score value (range defined by scorer)");
 var scoreReasonField = z.string().describe("Explanation for the score");
 var scoreRecordSchema = z.object({
@@ -183,10 +210,15 @@ var scoreRecordSchema = z.object({
   // Score data
   scorerId: scorerIdField,
   scorerVersion: scorerVersionField.nullish(),
-  source: sourceField2.nullish(),
+  scoreSource: scoreSourceField.nullish(),
+  /**
+   * @deprecated Use `scoreSource` instead.
+   */
+  source: scoreSourceField.nullish(),
   score: scoreValueField,
   reason: scoreReasonField.nullish(),
-  experimentId: experimentIdField.nullish(),
+  // Context (entity hierarchy, identity, correlation, deployment, experimentation)
+  ...contextFields,
   /** Trace ID of the scoring run (links to trace that generated this score) */
   scoreTraceId: z.string().nullish().describe("Trace ID of the scoring run for debugging score generation"),
   // User-defined metadata (context fields stored here)
@@ -195,7 +227,11 @@ var scoreRecordSchema = z.object({
 var scoreInputSchema = z.object({
   scorerId: scorerIdField,
   scorerVersion: scorerVersionField.optional(),
-  source: sourceField2.optional(),
+  scoreSource: scoreSourceField.optional(),
+  /**
+   * @deprecated Use `scoreSource` instead.
+   */
+  source: scoreSourceField.optional(),
   score: scoreValueField,
   reason: scoreReasonField.optional(),
   metadata: z.record(z.string(), z.unknown()).optional().describe("Additional scorer-specific metadata"),
@@ -216,7 +252,12 @@ var batchCreateScoresArgsSchema = z.object({
 var scoresFilterSchema = z.object({
   ...commonFilterFields,
   // Score-specific filters
-  scorerId: z.union([z.string(), z.array(z.string())]).optional().describe("Filter by scorer ID(s)")
+  scorerId: z.union([z.string(), z.array(z.string())]).optional().describe("Filter by scorer ID(s)"),
+  scoreSource: scoreSourceField.optional().describe("Filter by score source"),
+  /**
+   * @deprecated Use `scoreSource` instead.
+   */
+  source: scoreSourceField.optional().describe("Filter by score source")
 }).describe("Filters for querying scores");
 var scoresOrderByFieldSchema = z.enum(["timestamp", "score"]).describe("Field to order by: 'timestamp' | 'score'");
 var scoresOrderBySchema = z.object({
@@ -224,7 +265,7 @@ var scoresOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listScoresArgsSchema = z.object({
-  filters: scoresFilterSchema.optional().describe("Optional filters to apply"),
+  filters: scoresFilterSchema.optional(),
   pagination: paginationArgsSchema.default({ page: 0, perPage: 10 }).describe("Pagination settings"),
   orderBy: scoresOrderBySchema.default({ field: "timestamp", direction: "DESC" }).describe("Ordering configuration (defaults to timestamp desc)")
 }).describe("Arguments for listing scores");
@@ -232,62 +273,159 @@ var listScoresResponseSchema = z.object({
   pagination: paginationInfoSchema,
   scores: z.array(scoreRecordSchema)
 });
+var getScoreAggregateArgsSchema = z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  aggregation: aggregationTypeSchema,
+  filters: scoresFilterSchema.optional(),
+  comparePeriod: comparePeriodSchema.optional()
+}).describe("Arguments for getting a score aggregate");
+var getScoreAggregateResponseSchema = z.object(aggregateResponseFields);
+var getScoreBreakdownArgsSchema = z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  groupBy: groupBySchema,
+  aggregation: aggregationTypeSchema,
+  filters: scoresFilterSchema.optional()
+}).describe("Arguments for getting a score breakdown");
+var getScoreBreakdownResponseSchema = z.object({
+  groups: z.array(
+    z.object({
+      dimensions: dimensionsField,
+      value: aggregatedValueField
+    })
+  )
+});
+var getScoreTimeSeriesArgsSchema = z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  interval: aggregationIntervalSchema,
+  aggregation: aggregationTypeSchema,
+  filters: scoresFilterSchema.optional(),
+  groupBy: groupBySchema.optional()
+}).describe("Arguments for getting score time series");
+var getScoreTimeSeriesResponseSchema = z.object({
+  series: z.array(
+    z.object({
+      name: z.string().describe("Series name (scorer ID or group key)"),
+      points: z.array(
+        z.object({
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField
+        })
+      )
+    })
+  )
+});
+var getScorePercentilesArgsSchema = z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  percentiles: percentilesSchema,
+  interval: aggregationIntervalSchema,
+  filters: scoresFilterSchema.optional()
+}).describe("Arguments for getting score percentiles");
+var getScorePercentilesResponseSchema = z.object({
+  series: z.array(
+    z.object({
+      percentile: percentileField,
+      points: z.array(
+        z.object({
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
+        })
+      )
+    })
+  )
+});
 var feedbackSourceField = z.string().describe("Source of feedback (e.g., 'user', 'system', 'manual')");
 var feedbackTypeField = z.string().describe("Type of feedback (e.g., 'thumbs', 'rating', 'correction')");
 var feedbackValueField = z.union([z.number(), z.string()]).describe("Feedback value (rating number or correction text)");
 var feedbackCommentField = z.string().describe("Additional comment or context");
-var feedbackRecordSchema = z.object({
+var feedbackUserIdField = z.string().describe("User who provided the feedback");
+function normalizeLegacyFeedbackActor(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    return input;
+  }
+  const record = { ...input };
+  if (typeof record.userId === "string" && record.feedbackUserId == null) {
+    record.feedbackUserId = record.userId;
+    delete record.userId;
+  }
+  return record;
+}
+var feedbackRecordObjectSchema = z.object({
   timestamp: z.date().describe("When the feedback was recorded"),
   // Target
   traceId: traceIdField,
   spanId: spanIdField.nullish().describe("Span ID this feedback applies to"),
   // Feedback data
-  source: feedbackSourceField,
+  feedbackSource: feedbackSourceField.nullish(),
+  /**
+   * @deprecated Use `feedbackSource` instead.
+   */
+  source: feedbackSourceField.nullish(),
   feedbackType: feedbackTypeField,
   value: feedbackValueField,
   comment: feedbackCommentField.nullish(),
-  experimentId: experimentIdField.nullish(),
-  // Identity
-  userId: userIdField.nullish(),
+  // Feedback actor identity
+  feedbackUserId: feedbackUserIdField.nullish(),
+  // Context (entity hierarchy, identity, correlation, deployment, experimentation)
+  ...contextFields,
   // Source linkage (e.g. dataset item result ID)
   sourceId: z.string().nullish().describe("ID of the source record this feedback is linked to (e.g. experiment result ID)"),
   // User-defined metadata (context fields stored here)
   metadata: z.record(z.string(), z.unknown()).nullish().describe("User-defined metadata")
-}).describe("Feedback record as stored in the database");
-var feedbackInputSchema = z.object({
-  source: feedbackSourceField,
+});
+var feedbackRecordSchema = z.object(feedbackRecordObjectSchema.shape).describe("Feedback record as stored in the database");
+var feedbackInputObjectSchema = z.object({
+  feedbackSource: feedbackSourceField.optional(),
+  /**
+   * @deprecated Use `feedbackSource` instead.
+   */
+  source: feedbackSourceField.optional(),
   feedbackType: feedbackTypeField,
   value: feedbackValueField,
   comment: feedbackCommentField.optional(),
-  userId: userIdField.optional(),
+  feedbackUserId: feedbackUserIdField.optional(),
+  /**
+   * @deprecated Use `feedbackUserId` instead.
+   */
+  userId: feedbackUserIdField.optional(),
   metadata: z.record(z.string(), z.unknown()).optional().describe("Additional feedback-specific metadata"),
   experimentId: experimentIdField.optional(),
   sourceId: z.string().optional().describe("ID of the source record this feedback is linked to")
-}).describe("User-provided feedback input");
+});
+var feedbackInputSchema = z.object(feedbackInputObjectSchema.shape).describe("User-provided feedback input");
 var createFeedbackRecordSchema = feedbackRecordSchema;
 var createFeedbackArgsSchema = z.object({
-  feedback: createFeedbackRecordSchema
+  feedback: z.preprocess(normalizeLegacyFeedbackActor, feedbackRecordObjectSchema)
 }).describe("Arguments for creating feedback");
 var createFeedbackBodySchema = z.object({
-  feedback: createFeedbackRecordSchema.omit({ timestamp: true })
+  feedback: feedbackRecordObjectSchema.omit({ timestamp: true })
 }).describe("Arguments for creating feedback");
 var createFeedbackResponseSchema = z.object({ success: z.boolean() }).describe("Response from creating feedback");
 var batchCreateFeedbackArgsSchema = z.object({
-  feedbacks: z.array(createFeedbackRecordSchema)
+  feedbacks: z.array(z.preprocess(normalizeLegacyFeedbackActor, feedbackRecordObjectSchema))
 }).describe("Arguments for batch recording feedback");
-var feedbackFilterSchema = z.object({
+var feedbackFilterObjectSchema = z.object({
   ...commonFilterFields,
   // Feedback-specific filters
   feedbackType: z.union([z.string(), z.array(z.string())]).optional().describe("Filter by feedback type(s)"),
-  source: z.string().optional().describe("Filter by feedback source (e.g., user, system, manual)")
-}).describe("Filters for querying feedback");
+  feedbackSource: feedbackSourceField.optional(),
+  /**
+   * @deprecated Use `feedbackSource` instead.
+   */
+  source: feedbackSourceField.optional(),
+  feedbackUserId: feedbackUserIdField.optional()
+});
+var feedbackFilterSchema = z.object(feedbackFilterObjectSchema.shape).describe("Filters for querying feedback");
 var feedbackOrderByFieldSchema = z.enum(["timestamp"]).describe("Field to order by: 'timestamp'");
 var feedbackOrderBySchema = z.object({
   field: feedbackOrderByFieldSchema.default("timestamp").describe("Field to order by"),
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listFeedbackArgsSchema = z.object({
-  filters: feedbackFilterSchema.optional().describe("Optional filters to apply"),
+  filters: z.preprocess(normalizeLegacyFeedbackActor, feedbackFilterObjectSchema).optional().describe("Optional filters to apply"),
   pagination: paginationArgsSchema.default({ page: 0, perPage: 10 }).describe("Pagination settings"),
   orderBy: feedbackOrderBySchema.default({ field: "timestamp", direction: "DESC" }).describe("Ordering configuration (defaults to timestamp desc)")
 }).describe("Arguments for listing feedback");
@@ -295,6 +433,70 @@ var listFeedbackResponseSchema = z.object({
   pagination: paginationInfoSchema,
   feedback: z.array(feedbackRecordSchema)
 });
+var getFeedbackAggregateArgsSchema = z.object({
+  feedbackType: feedbackTypeField,
+  feedbackSource: feedbackSourceField.optional(),
+  aggregation: aggregationTypeSchema,
+  filters: feedbackFilterSchema.optional(),
+  comparePeriod: comparePeriodSchema.optional()
+}).describe("Arguments for getting a feedback aggregate over numeric values");
+var getFeedbackAggregateResponseSchema = z.object(aggregateResponseFields);
+var getFeedbackBreakdownArgsSchema = z.object({
+  feedbackType: feedbackTypeField,
+  feedbackSource: feedbackSourceField.optional(),
+  groupBy: groupBySchema,
+  aggregation: aggregationTypeSchema,
+  filters: feedbackFilterSchema.optional()
+}).describe("Arguments for getting a feedback breakdown over numeric values");
+var getFeedbackBreakdownResponseSchema = z.object({
+  groups: z.array(
+    z.object({
+      dimensions: dimensionsField,
+      value: aggregatedValueField
+    })
+  )
+});
+var getFeedbackTimeSeriesArgsSchema = z.object({
+  feedbackType: feedbackTypeField,
+  feedbackSource: feedbackSourceField.optional(),
+  interval: aggregationIntervalSchema,
+  aggregation: aggregationTypeSchema,
+  filters: feedbackFilterSchema.optional(),
+  groupBy: groupBySchema.optional()
+}).describe("Arguments for getting feedback time series over numeric values");
+var getFeedbackTimeSeriesResponseSchema = z.object({
+  series: z.array(
+    z.object({
+      name: z.string().describe("Series name (feedback type or group key)"),
+      points: z.array(
+        z.object({
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField
+        })
+      )
+    })
+  )
+});
+var getFeedbackPercentilesArgsSchema = z.object({
+  feedbackType: feedbackTypeField,
+  feedbackSource: feedbackSourceField.optional(),
+  percentiles: percentilesSchema,
+  interval: aggregationIntervalSchema,
+  filters: feedbackFilterSchema.optional()
+}).describe("Arguments for getting feedback percentiles over numeric values");
+var getFeedbackPercentilesResponseSchema = z.object({
+  series: z.array(
+    z.object({
+      percentile: percentileField,
+      points: z.array(
+        z.object({
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
+        })
+      )
+    })
+  )
+});
 var metricTypeSchema = z.enum(["counter", "gauge", "histogram"]);
 var metricNameField = z.string().describe("Metric name (e.g., mastra_agent_duration_ms)");
 var metricValueField = z.number().describe("Metric value");
@@ -313,6 +515,10 @@ var metricRecordSchema = z.object({
   spanId: spanIdField.nullish(),
   // Context (entity hierarchy, identity, correlation, deployment, experimentation)
   ...contextFields,
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: z.string().nullish().describe("Execution source"),
   // Canonical costing fields
   provider: providerField.nullish(),
   model: modelField.nullish(),
@@ -320,8 +526,6 @@ var metricRecordSchema = z.object({
   estimatedCost: estimatedCostField.nullish(),
   costUnit: costUnitField.nullish(),
   costMetadata: costMetadField.nullish(),
-  // Filtering
-  tags: tagsField.nullish(),
   // User-defined labels used for filtering
   labels: labelsField.default({}),
   // User-defined metadata
@@ -336,18 +540,19 @@ var createMetricRecordSchema = metricRecordSchema;
 var batchCreateMetricsArgsSchema = z.object({
   metrics: z.array(createMetricRecordSchema)
 }).describe("Arguments for batch recording metrics");
-var aggregationTypeSchema = z.enum(["sum", "avg", "min", "max", "count", "last"]);
-var aggregationIntervalSchema = z.enum(["1m", "5m", "15m", "1h", "1d"]);
 var metricsAggregationSchema = z.object({
-  type: aggregationTypeSchema.describe("Aggregation function"),
-  interval: aggregationIntervalSchema.optional().describe("Time bucket interval"),
-  groupBy: z.array(z.string()).optional().describe("Label keys to group by")
+  type: aggregationTypeSchema,
+  interval: aggregationIntervalSchema.optional(),
+  groupBy: groupBySchema.optional()
 }).describe("Metrics aggregation configuration");
 var metricsFilterSchema = z.object({
   ...commonFilterFields,
-  ...observabilitySignalFilterFields,
   // Metric identification
   name: z.array(z.string()).nonempty().optional().describe("Filter by metric name(s)"),
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: z.string().optional().describe("Filter by execution source"),
   // Canonical costing filters
   provider: providerField.optional(),
   model: modelField.optional(),
@@ -361,7 +566,7 @@ var metricsOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listMetricsArgsSchema = z.object({
-  filters: metricsFilterSchema.optional().describe("Optional filters to apply"),
+  filters: metricsFilterSchema.optional(),
   pagination: paginationArgsSchema.default({ page: 0, perPage: 10 }).describe("Pagination settings"),
   orderBy: metricsOrderBySchema.default({ field: "timestamp", direction: "DESC" }).describe("Ordering configuration (defaults to timestamp desc)")
 }).describe("Arguments for listing metrics");
@@ -369,33 +574,30 @@ var listMetricsResponseSchema = z.object({
   pagination: paginationInfoSchema,
   metrics: z.array(metricRecordSchema)
 });
-var comparePeriodSchema = z.enum(["previous_period", "previous_day", "previous_week"]).describe("Comparison period for aggregate queries");
 var getMetricAggregateArgsSchema = z.object({
   name: z.array(z.string()).nonempty().describe("Metric name(s) to aggregate"),
-  aggregation: aggregationTypeSchema.describe("Aggregation function"),
-  filters: metricsFilterSchema.optional().describe("Optional filters"),
-  comparePeriod: comparePeriodSchema.optional().describe("Optional comparison period")
+  aggregation: aggregationTypeSchema,
+  filters: metricsFilterSchema.optional(),
+  comparePeriod: comparePeriodSchema.optional()
 }).describe("Arguments for getting a metric aggregate");
 var getMetricAggregateResponseSchema = z.object({
-  value: z.number().nullable().describe("Aggregated value"),
+  ...aggregateResponseFields,
   estimatedCost: z.number().nullable().optional().describe("Aggregated estimated cost from the same filtered row set"),
   costUnit: z.string().nullable().optional().describe("Shared cost unit for the aggregated rows, or null when mixed/unknown"),
-  previousValue: z.number().nullable().optional().describe("Value from comparison period"),
   previousEstimatedCost: z.number().nullable().optional().describe("Aggregated estimated cost from the comparison period"),
-  changePercent: z.number().nullable().optional().describe("Percentage change from comparison period"),
   costChangePercent: z.number().nullable().optional().describe("Percentage change in estimated cost from comparison period")
 });
 var getMetricBreakdownArgsSchema = z.object({
   name: z.array(z.string()).nonempty().describe("Metric name(s) to break down"),
-  groupBy: z.array(z.string()).min(1).describe("Fields to group by"),
-  aggregation: aggregationTypeSchema.describe("Aggregation function"),
-  filters: metricsFilterSchema.optional().describe("Optional filters")
+  groupBy: groupBySchema,
+  aggregation: aggregationTypeSchema,
+  filters: metricsFilterSchema.optional()
 }).describe("Arguments for getting a metric breakdown");
 var getMetricBreakdownResponseSchema = z.object({
   groups: z.array(
     z.object({
-      dimensions: z.record(z.string(), z.string().nullable()).describe("Dimension values for this group"),
-      value: z.number().describe("Aggregated value for this group"),
+      dimensions: dimensionsField,
+      value: aggregatedValueField,
       estimatedCost: z.number().nullable().optional().describe("Summed estimated cost for this group"),
       costUnit: z.string().nullable().optional().describe("Shared cost unit for this group, or null when mixed/unknown")
     })
@@ -403,10 +605,10 @@ var getMetricBreakdownResponseSchema = z.object({
 });
 var getMetricTimeSeriesArgsSchema = z.object({
   name: z.array(z.string()).nonempty().describe("Metric name(s)"),
-  interval: aggregationIntervalSchema.describe("Time bucket interval"),
-  aggregation: aggregationTypeSchema.describe("Aggregation function"),
-  filters: metricsFilterSchema.optional().describe("Optional filters"),
-  groupBy: z.array(z.string()).optional().describe("Optional fields to group by")
+  interval: aggregationIntervalSchema,
+  aggregation: aggregationTypeSchema,
+  filters: metricsFilterSchema.optional(),
+  groupBy: groupBySchema.optional()
 }).describe("Arguments for getting metric time series");
 var getMetricTimeSeriesResponseSchema = z.object({
   series: z.array(
@@ -415,8 +617,8 @@ var getMetricTimeSeriesResponseSchema = z.object({
       costUnit: z.string().nullable().optional().describe("Shared cost unit for this series, or null when mixed/unknown"),
       points: z.array(
         z.object({
-          timestamp: z.date().describe("Bucket timestamp"),
-          value: z.number().describe("Aggregated value"),
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField,
           estimatedCost: z.number().nullable().optional().describe("Summed estimated cost in this bucket")
         })
       )
@@ -425,18 +627,18 @@ var getMetricTimeSeriesResponseSchema = z.object({
 });
 var getMetricPercentilesArgsSchema = z.object({
   name: z.string().describe("Metric name"),
-  percentiles: z.array(z.number().min(0).max(1)).describe("Percentile values (0-1)"),
-  interval: aggregationIntervalSchema.describe("Time bucket interval"),
-  filters: metricsFilterSchema.optional().describe("Optional filters")
+  percentiles: percentilesSchema,
+  interval: aggregationIntervalSchema,
+  filters: metricsFilterSchema.optional()
 }).describe("Arguments for getting metric percentiles");
 var getMetricPercentilesResponseSchema = z.object({
   series: z.array(
     z.object({
-      percentile: z.number().describe("Percentile value"),
+      percentile: percentileField,
       points: z.array(
         z.object({
-          timestamp: z.date().describe("Bucket timestamp"),
-          value: z.number().describe("Percentile value at this bucket")
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
         })
       )
     })
@@ -588,6 +790,15 @@ var NoOpObservability = class {
   getSelectedInstance(_options) {
     return;
   }
+  async getRecordedTrace(_args) {
+    return null;
+  }
+  async addScore(_args) {
+    return;
+  }
+  async addFeedback(_args) {
+    return;
+  }
   registerInstance(_name, _instance, _isDefault = false) {
     return;
   }
@@ -855,6 +1066,6 @@ function wrapRun(run, tracingContext) {
   }
 }
 
-export { DEFAULT_BLOCKED_LABELS, EntityType, InternalSpans, NoOpObservability, SamplingStrategyType, SpanType, TracingEventType, aggregationIntervalSchema, aggregationTypeSchema, batchCreateFeedbackArgsSchema, batchCreateLogsArgsSchema, batchCreateMetricsArgsSchema, batchCreateScoresArgsSchema, commonFilterFields, comparePeriodSchema, contextFields, createFeedbackArgsSchema, createFeedbackBodySchema, createFeedbackRecordSchema, createFeedbackResponseSchema, createLogRecordSchema, createMetricRecordSchema, createObservabilityContext, createScoreArgsSchema, createScoreBodySchema, createScoreRecordSchema, createScoreResponseSchema, createdAtField, dateRangeSchema, dbTimestamps, entityIdField, entityNameField, entityTypeField, environmentField, executeWithContext, executeWithContextSync, experimentIdField, feedbackFilterSchema, feedbackInputSchema, feedbackOrderByFieldSchema, feedbackOrderBySchema, feedbackRecordSchema, getEntityNamesArgsSchema, getEntityNamesResponseSchema, getEntityTypesArgsSchema, getEntityTypesResponseSchema, getEnvironmentsArgsSchema, getEnvironmentsResponseSchema, getMetricAggregateArgsSchema, getMetricAggregateResponseSchema, getMetricBreakdownArgsSchema, getMetricBreakdownResponseSchema, getMetricLabelKeysArgsSchema, getMetricLabelKeysResponseSchema, getMetricLabelValuesArgsSchema, getMetricLabelValuesResponseSchema, getMetricNamesArgsSchema, getMetricNamesResponseSchema, getMetricPercentilesArgsSchema, getMetricPercentilesResponseSchema, getMetricTimeSeriesArgsSchema, getMetricTimeSeriesResponseSchema, getOrCreateSpan, getRootExportSpan, getServiceNamesArgsSchema, getServiceNamesResponseSchema, getTagsArgsSchema, getTagsResponseSchema, listFeedbackArgsSchema, listFeedbackResponseSchema, listLogsArgsSchema, listLogsResponseSchema, listMetricsArgsSchema, listMetricsResponseSchema, listScoresArgsSchema, listScoresResponseSchema, logLevelSchema, logRecordInputSchema, logRecordSchema, logsFilterSchema, logsOrderByFieldSchema, logsOrderBySchema, metadataField, metricInputSchema, metricRecordSchema, metricTypeSchema, metricsAggregationSchema, metricsFilterSchema, metricsOrderByFieldSchema, metricsOrderBySchema, noOpLoggerContext, noOpMetricsContext, noOpTracingContext, organizationIdField, paginationArgsSchema, paginationInfoSchema, parentEntityIdField, parentEntityNameField, parentEntityTypeField, requestIdField, resolveObservabilityContext, resourceIdField, rootEntityIdField, rootEntityNameField, rootEntityTypeField, runIdField, scopeField, scoreInputSchema, scoreRecordSchema, scoresFilterSchema, scoresOrderByFieldSchema, scoresOrderBySchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanIdField, tagsField, threadIdField, traceIdField, updatedAtField, userIdField, wrapMastra };
-//# sourceMappingURL=chunk-CX5I6VS4.js.map
-//# sourceMappingURL=chunk-CX5I6VS4.js.map
+export { DEFAULT_BLOCKED_LABELS, EntityType, InternalSpans, NoOpObservability, SamplingStrategyType, SpanType, TracingEventType, aggregationIntervalSchema, aggregationTypeSchema, batchCreateFeedbackArgsSchema, batchCreateLogsArgsSchema, batchCreateMetricsArgsSchema, batchCreateScoresArgsSchema, commonFilterFields, comparePeriodSchema, contextFields, createFeedbackArgsSchema, createFeedbackBodySchema, createFeedbackRecordSchema, createFeedbackResponseSchema, createLogRecordSchema, createMetricRecordSchema, createObservabilityContext, createScoreArgsSchema, createScoreBodySchema, createScoreRecordSchema, createScoreResponseSchema, createdAtField, dateRangeSchema, dbTimestamps, entityIdField, entityNameField, entityTypeField, environmentField, executeWithContext, executeWithContextSync, executionSourceField, experimentIdField, feedbackFilterSchema, feedbackInputSchema, feedbackOrderByFieldSchema, feedbackOrderBySchema, feedbackRecordSchema, getEntityNamesArgsSchema, getEntityNamesResponseSchema, getEntityTypesArgsSchema, getEntityTypesResponseSchema, getEnvironmentsArgsSchema, getEnvironmentsResponseSchema, getFeedbackAggregateArgsSchema, getFeedbackAggregateResponseSchema, getFeedbackBreakdownArgsSchema, getFeedbackBreakdownResponseSchema, getFeedbackPercentilesArgsSchema, getFeedbackPercentilesResponseSchema, getFeedbackTimeSeriesArgsSchema, getFeedbackTimeSeriesResponseSchema, getMetricAggregateArgsSchema, getMetricAggregateResponseSchema, getMetricBreakdownArgsSchema, getMetricBreakdownResponseSchema, getMetricLabelKeysArgsSchema, getMetricLabelKeysResponseSchema, getMetricLabelValuesArgsSchema, getMetricLabelValuesResponseSchema, getMetricNamesArgsSchema, getMetricNamesResponseSchema, getMetricPercentilesArgsSchema, getMetricPercentilesResponseSchema, getMetricTimeSeriesArgsSchema, getMetricTimeSeriesResponseSchema, getOrCreateSpan, getRootExportSpan, getScoreAggregateArgsSchema, getScoreAggregateResponseSchema, getScoreBreakdownArgsSchema, getScoreBreakdownResponseSchema, getScorePercentilesArgsSchema, getScorePercentilesResponseSchema, getScoreTimeSeriesArgsSchema, getScoreTimeSeriesResponseSchema, getServiceNamesArgsSchema, getServiceNamesResponseSchema, getTagsArgsSchema, getTagsResponseSchema, listFeedbackArgsSchema, listFeedbackResponseSchema, listLogsArgsSchema, listLogsResponseSchema, listMetricsArgsSchema, listMetricsResponseSchema, listScoresArgsSchema, listScoresResponseSchema, logLevelSchema, logRecordInputSchema, logRecordSchema, logsFilterSchema, logsOrderByFieldSchema, logsOrderBySchema, metadataField, metricInputSchema, metricRecordSchema, metricTypeSchema, metricsAggregationSchema, metricsFilterSchema, metricsOrderByFieldSchema, metricsOrderBySchema, noOpLoggerContext, noOpMetricsContext, noOpTracingContext, organizationIdField, paginationArgsSchema, paginationInfoSchema, parentEntityIdField, parentEntityNameField, parentEntityTypeField, requestIdField, resolveObservabilityContext, resourceIdField, rootEntityIdField, rootEntityNameField, rootEntityTypeField, runIdField, scopeField, scoreInputSchema, scoreRecordSchema, scoresFilterSchema, scoresOrderByFieldSchema, scoresOrderBySchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanContextFields, spanIdField, tagsField, threadIdField, traceIdField, updatedAtField, userIdField, wrapMastra };
+//# sourceMappingURL=chunk-KRFGPA2H.js.map
+//# sourceMappingURL=chunk-KRFGPA2H.js.map