@mastra/server 1.36.0-alpha.1 → 1.36.0-alpha.10

package/dist/{chunk-AY5TY4EN.js → chunk-QUVYOHFH.js}

@@ -1,6 +1,7 @@
-import { NEW_ROUTE_DEFS, getObservabilityStore } from './chunk-4L2UVFJO.js';
-import { wrapSchemaForQueryParams, createRoute, pickParams } from './chunk-E53AJNZB.js';
-import { handleError } from './chunk-P23KBWKB.js';
+import { createObservabilityListQuerySchema, NEW_ROUTE_DEFS, getObservabilityStore, assertObservabilityDeltaSupported, OBSERVABILITY_LIST_ENDPOINTS } from './chunk-WYP25ZMM.js';
+import { paginationArgsSchema } from './chunk-YRLCLLKR.js';
+import { handleError } from './chunk-GA4BG5JK.js';
+import { wrapSchemaForQueryParams, createRoute, pickParams } from './chunk-F2FAL5CZ.js';
 import { HTTPException } from './chunk-6QWQZI4Q.js';
 import { z } from 'zod/v4';
 import { coreFeatures } from '@mastra/core/features';
@@ -26,7 +27,7 @@ var updatedAtField = z.date().describe("Database record last update time");
 ({
   updatedAt: updatedAtField.nullable()
 });
-var paginationArgsSchema = z.object({
+var paginationArgsSchema2 = z.object({
   page: z.coerce.number().int().min(0).optional().default(0).describe("Zero-indexed page number"),
   perPage: z.coerce.number().int().min(1).max(100).optional().default(10).describe("Number of items per page")
 }).describe("Pagination options for list queries");
@@ -36,6 +37,45 @@ var paginationInfoSchema = z.object({
   perPage: z.union([z.number(), z.literal(false)]).describe("Number of items per page, or false if pagination is disabled"),
   hasMore: z.boolean().describe("True if more pages are available")
 });
+var deltaCursorSchema = z.string().min(1).describe("Opaque cursor value for incremental polling");
+var listModeSchema = z.enum(["page", "delta"]).describe("List mode: 'page' | 'delta', defaults to 'page' when omitted.");
+var deltaLimitSchema = z.coerce.number().int().min(1).max(100).optional().describe("Maximum number of updates to return in one delta poll");
+var defaultPaginationArgs = {
+  page: 0,
+  perPage: 10
+};
+var defaultDeltaLimit = 10;
+function refineObservabilityListMode(value, ctx) {
+  if (value.mode === "delta") {
+    if (value.pagination !== void 0) {
+      ctx.addIssue({ code: "custom", path: ["pagination"], message: "pagination is not allowed in delta mode" });
+    }
+    if (value.orderBy !== void 0) {
+      ctx.addIssue({ code: "custom", path: ["orderBy"], message: "orderBy is not allowed in delta mode" });
+    }
+    return;
+  }
+  if (value.after !== void 0) {
+    ctx.addIssue({ code: "custom", path: ["after"], message: "after is only allowed in delta mode" });
+  }
+  if (value.limit !== void 0) {
+    ctx.addIssue({ code: "custom", path: ["limit"], message: "limit is only allowed in delta mode" });
+  }
+}
+function normalizeObservabilityListArgs(value, defaults) {
+  return {
+    mode: value.mode === "delta" ? "delta" : "page",
+    filters: value.filters,
+    pagination: value.pagination ?? defaults.pagination ?? defaultPaginationArgs,
+    orderBy: value.orderBy ?? defaults.orderBy,
+    after: value.after,
+    limit: value.limit ?? defaults.limit ?? defaultDeltaLimit
+  };
+}
+var deltaInfoSchema = z.object({
+  limit: z.number().describe("Maximum number of updates requested for this delta poll"),
+  hasMore: z.boolean().describe("True when more matching updates remain after this response")
+}).describe("Incremental polling metadata");
 var dateRangeSchema = z.object({
   start: z.coerce.date().optional().describe("Start of date range (inclusive by default)"),
   end: z.coerce.date().optional().describe("End of date range (inclusive by default)"),
@@ -199,14 +239,23 @@ var logsOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 z.object({
+  mode: listModeSchema.optional(),
   filters: logsFilterSchema.optional().describe("Optional filters to apply"),
-  pagination: paginationArgsSchema.default({ page: 0, perPage: 10 }).describe("Pagination settings"),
-  orderBy: logsOrderBySchema.default({ field: "timestamp", direction: "DESC" }).describe("Ordering configuration (defaults to timestamp desc)")
-}).describe("Arguments for listing logs");
+  pagination: paginationArgsSchema2.optional(),
+  orderBy: logsOrderBySchema.optional(),
+  after: deltaCursorSchema.optional(),
+  limit: deltaLimitSchema
+}).strict().superRefine(refineObservabilityListMode).transform(
+  (value) => normalizeObservabilityListArgs(value, {
+    orderBy: { field: "timestamp", direction: "DESC" }
+  })
+).describe("Arguments for listing logs");
 var listLogsResponseSchema = z.object({
-  pagination: paginationInfoSchema,
+  pagination: paginationInfoSchema.optional(),
+  delta: deltaInfoSchema.optional(),
+  deltaCursor: deltaCursorSchema.optional(),
   logs: z.array(logRecordSchema)
-});
+}).describe("Response from listing logs");
 var scorerIdField = z.string().describe("Identifier of the scorer (e.g., relevance, accuracy)");
 var scorerNameField = z.string().describe("Display name of the scorer");
 var scorerVersionField = z.string().describe("Version of the scorer");
@@ -280,14 +329,23 @@ var scoresOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 z.object({
+  mode: listModeSchema.optional(),
   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");
+  pagination: paginationArgsSchema2.optional(),
+  orderBy: scoresOrderBySchema.optional(),
+  after: deltaCursorSchema.optional(),
+  limit: deltaLimitSchema
+}).strict().superRefine(refineObservabilityListMode).transform(
+  (value) => normalizeObservabilityListArgs(value, {
+    orderBy: { field: "timestamp", direction: "DESC" }
+  })
+).describe("Arguments for listing scores");
 var listScoresResponseSchema = z.object({
-  pagination: paginationInfoSchema,
+  pagination: paginationInfoSchema.optional(),
+  delta: deltaInfoSchema.optional(),
+  deltaCursor: deltaCursorSchema.optional(),
   scores: z.array(scoreRecordSchema)
-});
+}).describe("Response from listing scores");
 var getScoreAggregateArgsSchema = z.object({
   scorerId: scorerIdField,
   scoreSource: scoreSourceField.optional(),
@@ -440,14 +498,23 @@ var feedbackOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 z.object({
-  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");
+  mode: listModeSchema.optional(),
+  filters: z.preprocess(normalizeLegacyFeedbackActor, feedbackFilterObjectSchema).optional(),
+  pagination: paginationArgsSchema2.optional(),
+  orderBy: feedbackOrderBySchema.optional(),
+  after: deltaCursorSchema.optional(),
+  limit: deltaLimitSchema
+}).strict().superRefine(refineObservabilityListMode).transform(
+  (value) => normalizeObservabilityListArgs(value, {
+    orderBy: { field: "timestamp", direction: "DESC" }
+  })
+).describe("Arguments for listing feedback");
 var listFeedbackResponseSchema = z.object({
-  pagination: paginationInfoSchema,
+  pagination: paginationInfoSchema.optional(),
+  delta: deltaInfoSchema.optional(),
+  deltaCursor: deltaCursorSchema.optional(),
   feedback: z.array(feedbackRecordSchema)
-});
+}).describe("Response from listing feedback");
 var getFeedbackAggregateArgsSchema = z.object({
   feedbackType: feedbackTypeField,
   feedbackSource: feedbackSourceField.optional(),
@@ -582,14 +649,23 @@ var metricsOrderBySchema = z.object({
   direction: sortDirectionSchema.default("DESC").describe("Sort direction")
 }).describe("Order by configuration");
 z.object({
+  mode: listModeSchema.optional(),
   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");
-z.object({
-  pagination: paginationInfoSchema,
+  pagination: paginationArgsSchema2.optional(),
+  orderBy: metricsOrderBySchema.optional(),
+  after: deltaCursorSchema.optional(),
+  limit: deltaLimitSchema
+}).strict().superRefine(refineObservabilityListMode).transform(
+  (value) => normalizeObservabilityListArgs(value, {
+    orderBy: { field: "timestamp", direction: "DESC" }
+  })
+).describe("Arguments for listing metrics");
+var listMetricsResponseSchema = z.object({
+  pagination: paginationInfoSchema.optional(),
+  delta: deltaInfoSchema.optional(),
+  deltaCursor: deltaCursorSchema.optional(),
   metrics: z.array(metricRecordSchema)
-});
+}).describe("Response from listing metrics");
 var METRIC_DISTINCT_COLUMNS = [
   "entityType",
   "entityName",
@@ -748,12 +824,12 @@ function createNewRoute(def, config) {
     tags: ["Observability"],
     requiresAuth: true,
     handler: (async (params) => {
-      if (!coreFeatures.has("observability:v1.13.2")) {
-        throw new HTTPException(501, {
-          message: "New observability endpoints require @mastra/core >= 1.13.2, please upgrade."
-        });
-      }
       try {
+        if (!coreFeatures.has("observability:v1.13.2")) {
+          throw new HTTPException(501, {
+            message: "New observability endpoints require @mastra/core >= 1.13.2, please upgrade."
+          });
+        }
         return await handler(params);
       } catch (error) {
         return handleError(error, `Error calling: '${def.summary.toLocaleLowerCase()}'`);
@@ -762,29 +838,47 @@ function createNewRoute(def, config) {
   });
 }
 var LIST_LOGS = createNewRoute(NEW_ROUTE_DEFS.LIST_LOGS, {
-  queryParamSchema: wrapSchemaForQueryParams(
-    logsFilterSchema.extend(paginationArgsSchema.shape).extend(logsOrderBySchema.shape).partial()
-  ),
+  queryParamSchema: createObservabilityListQuerySchema(logsFilterSchema, logsOrderBySchema),
   responseSchema: listLogsResponseSchema,
-  handler: async ({ mastra, ...params }) => {
+  handler: async ({ mastra, mode, after, limit, ...params }) => {
     const filters = pickParams(logsFilterSchema, params);
+    const observabilityStore = await getObservabilityStore(mastra);
+    if (mode === "delta") {
+      assertObservabilityDeltaSupported(observabilityStore, OBSERVABILITY_LIST_ENDPOINTS.logs);
+      return await observabilityStore.listLogs({
+        mode,
+        filters,
+        after: typeof after === "string" ? after : void 0,
+        limit
+      });
+    }
     const pagination = pickParams(paginationArgsSchema, params);
     const orderBy = pickParams(logsOrderBySchema, params);
-    const observabilityStore = await getObservabilityStore(mastra);
-    return await observabilityStore.listLogs({ filters, pagination, orderBy });
+    return await observabilityStore.listLogs(
+      mode === "page" ? { mode, filters, pagination, orderBy } : { filters, pagination, orderBy }
+    );
   }
 });
 var LIST_SCORES = createNewRoute(NEW_ROUTE_DEFS.LIST_SCORES, {
-  queryParamSchema: wrapSchemaForQueryParams(
-    scoresFilterSchema.extend(paginationArgsSchema.shape).extend(scoresOrderBySchema.shape).partial()
-  ),
+  queryParamSchema: createObservabilityListQuerySchema(scoresFilterSchema, scoresOrderBySchema),
   responseSchema: listScoresResponseSchema,
-  handler: async ({ mastra, ...params }) => {
+  handler: async ({ mastra, mode, after, limit, ...params }) => {
     const filters = pickParams(scoresFilterSchema, params);
+    const observabilityStore = await getObservabilityStore(mastra);
+    if (mode === "delta") {
+      assertObservabilityDeltaSupported(observabilityStore, OBSERVABILITY_LIST_ENDPOINTS.scores);
+      return await observabilityStore.listScores({
+        mode,
+        filters,
+        after: typeof after === "string" ? after : void 0,
+        limit
+      });
+    }
     const pagination = pickParams(paginationArgsSchema, params);
     const orderBy = pickParams(scoresOrderBySchema, params);
-    const observabilityStore = await getObservabilityStore(mastra);
-    return await observabilityStore.listScores({ filters, pagination, orderBy });
+    return await observabilityStore.listScores(
+      mode === "page" ? { mode, filters, pagination, orderBy } : { filters, pagination, orderBy }
+    );
   }
 });
 var CREATE_SCORE = createNewRoute(NEW_ROUTE_DEFS.CREATE_SCORE, {
@@ -844,16 +938,25 @@ var GET_SCORE_PERCENTILES = createNewRoute(NEW_ROUTE_DEFS.GET_SCORE_PERCENTILES,
   }
 });
 var LIST_FEEDBACK = createNewRoute(NEW_ROUTE_DEFS.LIST_FEEDBACK, {
-  queryParamSchema: wrapSchemaForQueryParams(
-    feedbackFilterSchema.extend(paginationArgsSchema.shape).extend(feedbackOrderBySchema.shape).partial()
-  ),
+  queryParamSchema: createObservabilityListQuerySchema(feedbackFilterSchema, feedbackOrderBySchema),
   responseSchema: listFeedbackResponseSchema,
-  handler: async ({ mastra, ...params }) => {
+  handler: async ({ mastra, mode, after, limit, ...params }) => {
     const filters = pickParams(feedbackFilterSchema, params);
+    const observabilityStore = await getObservabilityStore(mastra);
+    if (mode === "delta") {
+      assertObservabilityDeltaSupported(observabilityStore, OBSERVABILITY_LIST_ENDPOINTS.feedback);
+      return await observabilityStore.listFeedback({
+        mode,
+        filters,
+        after: typeof after === "string" ? after : void 0,
+        limit
+      });
+    }
     const pagination = pickParams(paginationArgsSchema, params);
     const orderBy = pickParams(feedbackOrderBySchema, params);
-    const observabilityStore = await getObservabilityStore(mastra);
-    return await observabilityStore.listFeedback({ filters, pagination, orderBy });
+    return await observabilityStore.listFeedback(
+      mode === "page" ? { mode, filters, pagination, orderBy } : { filters, pagination, orderBy }
+    );
   }
 });
 var CREATE_FEEDBACK = createNewRoute(NEW_ROUTE_DEFS.CREATE_FEEDBACK, {
@@ -903,6 +1006,28 @@ var GET_FEEDBACK_PERCENTILES = createNewRoute(NEW_ROUTE_DEFS.GET_FEEDBACK_PERCEN
     return await observabilityStore.getFeedbackPercentiles(args);
   }
 });
+var LIST_METRICS = createNewRoute(NEW_ROUTE_DEFS.LIST_METRICS, {
+  queryParamSchema: createObservabilityListQuerySchema(metricsFilterSchema, metricsOrderBySchema),
+  responseSchema: listMetricsResponseSchema,
+  handler: async ({ mastra, mode, after, limit, ...params }) => {
+    const filters = pickParams(metricsFilterSchema, params);
+    const observabilityStore = await getObservabilityStore(mastra);
+    if (mode === "delta") {
+      assertObservabilityDeltaSupported(observabilityStore, OBSERVABILITY_LIST_ENDPOINTS.metrics);
+      return await observabilityStore.listMetrics({
+        mode,
+        filters,
+        after: typeof after === "string" ? after : void 0,
+        limit
+      });
+    }
+    const pagination = pickParams(paginationArgsSchema, params);
+    const orderBy = pickParams(metricsOrderBySchema, params);
+    return await observabilityStore.listMetrics(
+      mode === "page" ? { mode, filters, pagination, orderBy } : { filters, pagination, orderBy }
+    );
+  }
+});
 var GET_METRIC_AGGREGATE = createNewRoute(NEW_ROUTE_DEFS.GET_METRIC_AGGREGATE, {
   bodySchema: getMetricAggregateArgsSchema,
   responseSchema: getMetricAggregateResponseSchema,
@@ -1027,6 +1152,7 @@ var NEW_ROUTES = {
   GET_FEEDBACK_BREAKDOWN,
   GET_FEEDBACK_TIME_SERIES,
   GET_FEEDBACK_PERCENTILES,
+  LIST_METRICS,
   GET_METRIC_AGGREGATE,
   GET_METRIC_BREAKDOWN,
   GET_METRIC_TIME_SERIES,
@@ -1041,6 +1167,6 @@ var NEW_ROUTES = {
   GET_TAGS
 };
 
-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, 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-AY5TY4EN.js.map
-//# sourceMappingURL=chunk-AY5TY4EN.js.map
+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, GET_SCORE_AGGREGATE, GET_SCORE_BREAKDOWN, GET_SCORE_PERCENTILES, GET_SCORE_TIME_SERIES, GET_SERVICE_NAMES, GET_TAGS, LIST_FEEDBACK, LIST_LOGS, LIST_METRICS, LIST_SCORES, NEW_ROUTES };
+//# sourceMappingURL=chunk-QUVYOHFH.js.map
+//# sourceMappingURL=chunk-QUVYOHFH.js.map