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

package/dist/{chunk-B6D4D2CY.cjs → chunk-BF7IH4JU.cjs}

@@ -45,6 +45,21 @@ var dateRangeSchema = v4.z.object({
   endExclusive: v4.z.boolean().optional().describe("When true, excludes the end date from results (uses < instead of <=)")
 }).describe("Date range filter for timestamps");
 var sortDirectionSchema = v4.z.enum(["ASC", "DESC"]).describe("Sort direction: 'ASC' | 'DESC'");
+var aggregationTypeSchema = v4.z.enum(["sum", "avg", "min", "max", "count", "last"]).describe("Aggregation function");
+var aggregationIntervalSchema = v4.z.enum(["1m", "5m", "15m", "1h", "1d"]).describe("Time bucket interval");
+var comparePeriodSchema = v4.z.enum(["previous_period", "previous_day", "previous_week"]).describe("Comparison period for aggregate queries");
+var groupBySchema = v4.z.array(v4.z.string()).min(1).describe("Fields to group by");
+var percentilesSchema = v4.z.array(v4.z.number().min(0).max(1)).min(1).describe("Percentile values (0-1)");
+var aggregateResponseFields = {
+  value: v4.z.number().nullable().describe("Aggregated value"),
+  previousValue: v4.z.number().nullable().optional().describe("Value from comparison period"),
+  changePercent: v4.z.number().nullable().optional().describe("Percentage change from comparison period")
+};
+var dimensionsField = v4.z.record(v4.z.string(), v4.z.string().nullable()).describe("Dimension values for this group");
+var aggregatedValueField = v4.z.number().describe("Aggregated value");
+var bucketTimestampField = v4.z.date().describe("Bucket timestamp");
+var percentileField = v4.z.number().describe("Percentile value");
+var percentileBucketValueField = v4.z.number().describe("Percentile value at this bucket");
 var entityTypeField = v4.z.nativeEnum(EntityType).describe(`Entity type (e.g., 'agent' | 'processor' | 'tool' | 'workflow')`);
 var entityIdField = v4.z.string().describe('ID of the entity (e.g., "weatherAgent", "orderWorkflow")');
 var entityNameField = v4.z.string().describe("Name of the entity");
@@ -57,6 +72,7 @@ var threadIdField = v4.z.string().describe("Conversation thread identifier");
 var requestIdField = v4.z.string().describe("HTTP request ID for log correlation");
 var environmentField = v4.z.string().describe(`Environment (e.g., "production" | "staging" | "development")`);
 var sourceField = v4.z.string().describe(`Source of execution (e.g., "local" | "cloud" | "ci")`);
+var executionSourceField = v4.z.string().describe(`Source of execution (e.g., "local" | "cloud" | "ci")`);
 var serviceNameField = v4.z.string().describe("Name of the service");
 var parentEntityTypeField = v4.z.nativeEnum(EntityType).describe("Entity type of the parent entity");
 var parentEntityIdField = v4.z.string().describe("ID of the parent entity");
@@ -68,7 +84,7 @@ var experimentIdField = v4.z.string().describe("Experiment or eval run identifie
 var scopeField = v4.z.record(v4.z.string(), v4.z.unknown()).describe('Arbitrary package/app version info (e.g., {"core": "1.0.0", "memory": "1.0.0", "gitSha": "abcd1234"})');
 var metadataField = v4.z.record(v4.z.string(), v4.z.unknown()).describe("User-defined metadata for custom filtering");
 var tagsField = v4.z.array(v4.z.string()).describe("Labels for filtering");
-var contextFields = {
+var contextFieldsBase = {
   // Entity identification
   entityType: entityTypeField.nullish(),
   entityId: entityIdField.nullish(),
@@ -92,12 +108,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: v4.z.string().optional().describe("Filter by trace ID"),
@@ -108,9 +132,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(),
@@ -120,7 +142,7 @@ var observabilitySignalFilterFields = {
   sessionId: sessionIdField.optional(),
   threadId: threadIdField.optional(),
   requestId: requestIdField.optional(),
-  source: sourceField.optional(),
+  executionSource: executionSourceField.optional(),
   tags: v4.z.array(v4.z.string()).optional().describe("Filter by tags (must have all specified tags)")
 };
 var traceIdField = v4.z.string().describe("Unique trace identifier");
@@ -136,10 +158,12 @@ var logRecordSchema = v4.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: v4.z.string().nullish().describe("Execution source"),
   metadata: metadataField.nullish()
 }).describe("Log record as stored in the database");
 var logRecordInputSchema = v4.z.object({
@@ -154,8 +178,11 @@ var batchCreateLogsArgsSchema = v4.z.object({
 }).describe("Arguments for batch creating logs");
 var logsFilterSchema = v4.z.object({
   ...commonFilterFields,
-  ...observabilitySignalFilterFields,
   // Log-specific filters
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: v4.z.string().optional().describe("Filter by execution source"),
   level: v4.z.union([logLevelSchema, v4.z.array(logLevelSchema)]).optional().describe("Filter by log level(s)")
 }).describe("Filters for querying logs");
 var logsOrderByFieldSchema = v4.z.enum(["timestamp"]).describe("Field to order by: 'timestamp'");
@@ -174,7 +201,7 @@ var listLogsResponseSchema = v4.z.object({
 });
 var scorerIdField = v4.z.string().describe("Identifier of the scorer (e.g., relevance, accuracy)");
 var scorerVersionField = v4.z.string().describe("Version of the scorer");
-var sourceField2 = v4.z.string().describe("Source of the score (e.g., manual, automated, experiment)");
+var scoreSourceField = v4.z.string().describe("Source of the score (e.g., manual, automated, experiment)");
 var scoreValueField = v4.z.number().describe("Score value (range defined by scorer)");
 var scoreReasonField = v4.z.string().describe("Explanation for the score");
 var scoreRecordSchema = v4.z.object({
@@ -185,10 +212,15 @@ var scoreRecordSchema = v4.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: v4.z.string().nullish().describe("Trace ID of the scoring run for debugging score generation"),
   // User-defined metadata (context fields stored here)
@@ -197,7 +229,11 @@ var scoreRecordSchema = v4.z.object({
 var scoreInputSchema = v4.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: v4.z.record(v4.z.string(), v4.z.unknown()).optional().describe("Additional scorer-specific metadata"),
@@ -218,7 +254,12 @@ var batchCreateScoresArgsSchema = v4.z.object({
 var scoresFilterSchema = v4.z.object({
   ...commonFilterFields,
   // Score-specific filters
-  scorerId: v4.z.union([v4.z.string(), v4.z.array(v4.z.string())]).optional().describe("Filter by scorer ID(s)")
+  scorerId: v4.z.union([v4.z.string(), v4.z.array(v4.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 = v4.z.enum(["timestamp", "score"]).describe("Field to order by: 'timestamp' | 'score'");
 var scoresOrderBySchema = v4.z.object({
@@ -226,7 +267,7 @@ var scoresOrderBySchema = v4.z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listScoresArgsSchema = v4.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");
@@ -234,62 +275,159 @@ var listScoresResponseSchema = v4.z.object({
   pagination: paginationInfoSchema,
   scores: v4.z.array(scoreRecordSchema)
 });
+var getScoreAggregateArgsSchema = v4.z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  aggregation: aggregationTypeSchema,
+  filters: scoresFilterSchema.optional(),
+  comparePeriod: comparePeriodSchema.optional()
+}).describe("Arguments for getting a score aggregate");
+var getScoreAggregateResponseSchema = v4.z.object(aggregateResponseFields);
+var getScoreBreakdownArgsSchema = v4.z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  groupBy: groupBySchema,
+  aggregation: aggregationTypeSchema,
+  filters: scoresFilterSchema.optional()
+}).describe("Arguments for getting a score breakdown");
+var getScoreBreakdownResponseSchema = v4.z.object({
+  groups: v4.z.array(
+    v4.z.object({
+      dimensions: dimensionsField,
+      value: aggregatedValueField
+    })
+  )
+});
+var getScoreTimeSeriesArgsSchema = v4.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 = v4.z.object({
+  series: v4.z.array(
+    v4.z.object({
+      name: v4.z.string().describe("Series name (scorer ID or group key)"),
+      points: v4.z.array(
+        v4.z.object({
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField
+        })
+      )
+    })
+  )
+});
+var getScorePercentilesArgsSchema = v4.z.object({
+  scorerId: scorerIdField,
+  scoreSource: scoreSourceField.optional(),
+  percentiles: percentilesSchema,
+  interval: aggregationIntervalSchema,
+  filters: scoresFilterSchema.optional()
+}).describe("Arguments for getting score percentiles");
+var getScorePercentilesResponseSchema = v4.z.object({
+  series: v4.z.array(
+    v4.z.object({
+      percentile: percentileField,
+      points: v4.z.array(
+        v4.z.object({
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
+        })
+      )
+    })
+  )
+});
 var feedbackSourceField = v4.z.string().describe("Source of feedback (e.g., 'user', 'system', 'manual')");
 var feedbackTypeField = v4.z.string().describe("Type of feedback (e.g., 'thumbs', 'rating', 'correction')");
 var feedbackValueField = v4.z.union([v4.z.number(), v4.z.string()]).describe("Feedback value (rating number or correction text)");
 var feedbackCommentField = v4.z.string().describe("Additional comment or context");
-var feedbackRecordSchema = v4.z.object({
+var feedbackUserIdField = v4.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 = v4.z.object({
   timestamp: v4.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: v4.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: v4.z.record(v4.z.string(), v4.z.unknown()).nullish().describe("User-defined metadata")
-}).describe("Feedback record as stored in the database");
-var feedbackInputSchema = v4.z.object({
-  source: feedbackSourceField,
+});
+var feedbackRecordSchema = v4.z.object(feedbackRecordObjectSchema.shape).describe("Feedback record as stored in the database");
+var feedbackInputObjectSchema = v4.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: v4.z.record(v4.z.string(), v4.z.unknown()).optional().describe("Additional feedback-specific metadata"),
   experimentId: experimentIdField.optional(),
   sourceId: v4.z.string().optional().describe("ID of the source record this feedback is linked to")
-}).describe("User-provided feedback input");
+});
+var feedbackInputSchema = v4.z.object(feedbackInputObjectSchema.shape).describe("User-provided feedback input");
 var createFeedbackRecordSchema = feedbackRecordSchema;
 var createFeedbackArgsSchema = v4.z.object({
-  feedback: createFeedbackRecordSchema
+  feedback: v4.z.preprocess(normalizeLegacyFeedbackActor, feedbackRecordObjectSchema)
 }).describe("Arguments for creating feedback");
 var createFeedbackBodySchema = v4.z.object({
-  feedback: createFeedbackRecordSchema.omit({ timestamp: true })
+  feedback: feedbackRecordObjectSchema.omit({ timestamp: true })
 }).describe("Arguments for creating feedback");
 var createFeedbackResponseSchema = v4.z.object({ success: v4.z.boolean() }).describe("Response from creating feedback");
 var batchCreateFeedbackArgsSchema = v4.z.object({
-  feedbacks: v4.z.array(createFeedbackRecordSchema)
+  feedbacks: v4.z.array(v4.z.preprocess(normalizeLegacyFeedbackActor, feedbackRecordObjectSchema))
 }).describe("Arguments for batch recording feedback");
-var feedbackFilterSchema = v4.z.object({
+var feedbackFilterObjectSchema = v4.z.object({
   ...commonFilterFields,
   // Feedback-specific filters
   feedbackType: v4.z.union([v4.z.string(), v4.z.array(v4.z.string())]).optional().describe("Filter by feedback type(s)"),
-  source: v4.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 = v4.z.object(feedbackFilterObjectSchema.shape).describe("Filters for querying feedback");
 var feedbackOrderByFieldSchema = v4.z.enum(["timestamp"]).describe("Field to order by: 'timestamp'");
 var feedbackOrderBySchema = v4.z.object({
   field: feedbackOrderByFieldSchema.default("timestamp").describe("Field to order by"),
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listFeedbackArgsSchema = v4.z.object({
-  filters: feedbackFilterSchema.optional().describe("Optional filters to apply"),
+  filters: v4.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");
@@ -297,6 +435,70 @@ var listFeedbackResponseSchema = v4.z.object({
   pagination: paginationInfoSchema,
   feedback: v4.z.array(feedbackRecordSchema)
 });
+var getFeedbackAggregateArgsSchema = v4.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 = v4.z.object(aggregateResponseFields);
+var getFeedbackBreakdownArgsSchema = v4.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 = v4.z.object({
+  groups: v4.z.array(
+    v4.z.object({
+      dimensions: dimensionsField,
+      value: aggregatedValueField
+    })
+  )
+});
+var getFeedbackTimeSeriesArgsSchema = v4.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 = v4.z.object({
+  series: v4.z.array(
+    v4.z.object({
+      name: v4.z.string().describe("Series name (feedback type or group key)"),
+      points: v4.z.array(
+        v4.z.object({
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField
+        })
+      )
+    })
+  )
+});
+var getFeedbackPercentilesArgsSchema = v4.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 = v4.z.object({
+  series: v4.z.array(
+    v4.z.object({
+      percentile: percentileField,
+      points: v4.z.array(
+        v4.z.object({
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
+        })
+      )
+    })
+  )
+});
 var metricTypeSchema = v4.z.enum(["counter", "gauge", "histogram"]);
 var metricNameField = v4.z.string().describe("Metric name (e.g., mastra_agent_duration_ms)");
 var metricValueField = v4.z.number().describe("Metric value");
@@ -315,6 +517,10 @@ var metricRecordSchema = v4.z.object({
   spanId: spanIdField.nullish(),
   // Context (entity hierarchy, identity, correlation, deployment, experimentation)
   ...contextFields,
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: v4.z.string().nullish().describe("Execution source"),
   // Canonical costing fields
   provider: providerField.nullish(),
   model: modelField.nullish(),
@@ -322,8 +528,6 @@ var metricRecordSchema = v4.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
@@ -338,18 +542,19 @@ var createMetricRecordSchema = metricRecordSchema;
 var batchCreateMetricsArgsSchema = v4.z.object({
   metrics: v4.z.array(createMetricRecordSchema)
 }).describe("Arguments for batch recording metrics");
-var aggregationTypeSchema = v4.z.enum(["sum", "avg", "min", "max", "count", "last"]);
-var aggregationIntervalSchema = v4.z.enum(["1m", "5m", "15m", "1h", "1d"]);
 var metricsAggregationSchema = v4.z.object({
-  type: aggregationTypeSchema.describe("Aggregation function"),
-  interval: aggregationIntervalSchema.optional().describe("Time bucket interval"),
-  groupBy: v4.z.array(v4.z.string()).optional().describe("Label keys to group by")
+  type: aggregationTypeSchema,
+  interval: aggregationIntervalSchema.optional(),
+  groupBy: groupBySchema.optional()
 }).describe("Metrics aggregation configuration");
 var metricsFilterSchema = v4.z.object({
   ...commonFilterFields,
-  ...observabilitySignalFilterFields,
   // Metric identification
   name: v4.z.array(v4.z.string()).nonempty().optional().describe("Filter by metric name(s)"),
+  /**
+   * @deprecated Use `executionSource` instead.
+   */
+  source: v4.z.string().optional().describe("Filter by execution source"),
   // Canonical costing filters
   provider: providerField.optional(),
   model: modelField.optional(),
@@ -363,7 +568,7 @@ var metricsOrderBySchema = v4.z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 var listMetricsArgsSchema = v4.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");
@@ -371,33 +576,30 @@ var listMetricsResponseSchema = v4.z.object({
   pagination: paginationInfoSchema,
   metrics: v4.z.array(metricRecordSchema)
 });
-var comparePeriodSchema = v4.z.enum(["previous_period", "previous_day", "previous_week"]).describe("Comparison period for aggregate queries");
 var getMetricAggregateArgsSchema = v4.z.object({
   name: v4.z.array(v4.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 = v4.z.object({
-  value: v4.z.number().nullable().describe("Aggregated value"),
+  ...aggregateResponseFields,
   estimatedCost: v4.z.number().nullable().optional().describe("Aggregated estimated cost from the same filtered row set"),
   costUnit: v4.z.string().nullable().optional().describe("Shared cost unit for the aggregated rows, or null when mixed/unknown"),
-  previousValue: v4.z.number().nullable().optional().describe("Value from comparison period"),
   previousEstimatedCost: v4.z.number().nullable().optional().describe("Aggregated estimated cost from the comparison period"),
-  changePercent: v4.z.number().nullable().optional().describe("Percentage change from comparison period"),
   costChangePercent: v4.z.number().nullable().optional().describe("Percentage change in estimated cost from comparison period")
 });
 var getMetricBreakdownArgsSchema = v4.z.object({
   name: v4.z.array(v4.z.string()).nonempty().describe("Metric name(s) to break down"),
-  groupBy: v4.z.array(v4.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 = v4.z.object({
   groups: v4.z.array(
     v4.z.object({
-      dimensions: v4.z.record(v4.z.string(), v4.z.string().nullable()).describe("Dimension values for this group"),
-      value: v4.z.number().describe("Aggregated value for this group"),
+      dimensions: dimensionsField,
+      value: aggregatedValueField,
       estimatedCost: v4.z.number().nullable().optional().describe("Summed estimated cost for this group"),
       costUnit: v4.z.string().nullable().optional().describe("Shared cost unit for this group, or null when mixed/unknown")
     })
@@ -405,10 +607,10 @@ var getMetricBreakdownResponseSchema = v4.z.object({
 });
 var getMetricTimeSeriesArgsSchema = v4.z.object({
   name: v4.z.array(v4.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: v4.z.array(v4.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 = v4.z.object({
   series: v4.z.array(
@@ -417,8 +619,8 @@ var getMetricTimeSeriesResponseSchema = v4.z.object({
       costUnit: v4.z.string().nullable().optional().describe("Shared cost unit for this series, or null when mixed/unknown"),
       points: v4.z.array(
         v4.z.object({
-          timestamp: v4.z.date().describe("Bucket timestamp"),
-          value: v4.z.number().describe("Aggregated value"),
+          timestamp: bucketTimestampField,
+          value: aggregatedValueField,
           estimatedCost: v4.z.number().nullable().optional().describe("Summed estimated cost in this bucket")
         })
       )
@@ -427,18 +629,18 @@ var getMetricTimeSeriesResponseSchema = v4.z.object({
 });
 var getMetricPercentilesArgsSchema = v4.z.object({
   name: v4.z.string().describe("Metric name"),
-  percentiles: v4.z.array(v4.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 = v4.z.object({
   series: v4.z.array(
     v4.z.object({
-      percentile: v4.z.number().describe("Percentile value"),
+      percentile: percentileField,
       points: v4.z.array(
         v4.z.object({
-          timestamp: v4.z.date().describe("Bucket timestamp"),
-          value: v4.z.number().describe("Percentile value at this bucket")
+          timestamp: bucketTimestampField,
+          value: percentileBucketValueField
         })
       )
     })
@@ -590,6 +792,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;
   }
@@ -893,6 +1104,7 @@ exports.entityTypeField = entityTypeField;
 exports.environmentField = environmentField;
 exports.executeWithContext = executeWithContext;
 exports.executeWithContextSync = executeWithContextSync;
+exports.executionSourceField = executionSourceField;
 exports.experimentIdField = experimentIdField;
 exports.feedbackFilterSchema = feedbackFilterSchema;
 exports.feedbackInputSchema = feedbackInputSchema;
@@ -905,6 +1117,14 @@ exports.getEntityTypesArgsSchema = getEntityTypesArgsSchema;
 exports.getEntityTypesResponseSchema = getEntityTypesResponseSchema;
 exports.getEnvironmentsArgsSchema = getEnvironmentsArgsSchema;
 exports.getEnvironmentsResponseSchema = getEnvironmentsResponseSchema;
+exports.getFeedbackAggregateArgsSchema = getFeedbackAggregateArgsSchema;
+exports.getFeedbackAggregateResponseSchema = getFeedbackAggregateResponseSchema;
+exports.getFeedbackBreakdownArgsSchema = getFeedbackBreakdownArgsSchema;
+exports.getFeedbackBreakdownResponseSchema = getFeedbackBreakdownResponseSchema;
+exports.getFeedbackPercentilesArgsSchema = getFeedbackPercentilesArgsSchema;
+exports.getFeedbackPercentilesResponseSchema = getFeedbackPercentilesResponseSchema;
+exports.getFeedbackTimeSeriesArgsSchema = getFeedbackTimeSeriesArgsSchema;
+exports.getFeedbackTimeSeriesResponseSchema = getFeedbackTimeSeriesResponseSchema;
 exports.getMetricAggregateArgsSchema = getMetricAggregateArgsSchema;
 exports.getMetricAggregateResponseSchema = getMetricAggregateResponseSchema;
 exports.getMetricBreakdownArgsSchema = getMetricBreakdownArgsSchema;
@@ -921,6 +1141,14 @@ exports.getMetricTimeSeriesArgsSchema = getMetricTimeSeriesArgsSchema;
 exports.getMetricTimeSeriesResponseSchema = getMetricTimeSeriesResponseSchema;
 exports.getOrCreateSpan = getOrCreateSpan;
 exports.getRootExportSpan = getRootExportSpan;
+exports.getScoreAggregateArgsSchema = getScoreAggregateArgsSchema;
+exports.getScoreAggregateResponseSchema = getScoreAggregateResponseSchema;
+exports.getScoreBreakdownArgsSchema = getScoreBreakdownArgsSchema;
+exports.getScoreBreakdownResponseSchema = getScoreBreakdownResponseSchema;
+exports.getScorePercentilesArgsSchema = getScorePercentilesArgsSchema;
+exports.getScorePercentilesResponseSchema = getScorePercentilesResponseSchema;
+exports.getScoreTimeSeriesArgsSchema = getScoreTimeSeriesArgsSchema;
+exports.getScoreTimeSeriesResponseSchema = getScoreTimeSeriesResponseSchema;
 exports.getServiceNamesArgsSchema = getServiceNamesArgsSchema;
 exports.getServiceNamesResponseSchema = getServiceNamesResponseSchema;
 exports.getTagsArgsSchema = getTagsArgsSchema;
@@ -973,6 +1201,7 @@ exports.serviceNameField = serviceNameField;
 exports.sessionIdField = sessionIdField;
 exports.sortDirectionSchema = sortDirectionSchema;
 exports.sourceField = sourceField;
+exports.spanContextFields = spanContextFields;
 exports.spanIdField = spanIdField;
 exports.tagsField = tagsField;
 exports.threadIdField = threadIdField;
@@ -980,5 +1209,5 @@ exports.traceIdField = traceIdField;
 exports.updatedAtField = updatedAtField;
 exports.userIdField = userIdField;
 exports.wrapMastra = wrapMastra;
-//# sourceMappingURL=chunk-B6D4D2CY.cjs.map
-//# sourceMappingURL=chunk-B6D4D2CY.cjs.map
+//# sourceMappingURL=chunk-BF7IH4JU.cjs.map
+//# sourceMappingURL=chunk-BF7IH4JU.cjs.map