@mastra/server 1.36.0-alpha.2 → 1.36.0-alpha.4

package/dist/{chunk-4L2UVFJO.js → chunk-WYP25ZMM.js}

@@ -1,7 +1,24 @@
+import { deltaLimitSchema, deltaCursorSchema, listModeSchema, paginationArgsSchema } from './chunk-YRLCLLKR.js';
+import { wrapSchemaForQueryParams } from './chunk-F2FAL5CZ.js';
 import { HTTPException } from './chunk-6QWQZI4Q.js';
+import { coreFeatures } from '@mastra/core/features';
+import { z } from 'zod/v4';
 
-// src/server/handlers/observability-shared.ts
-var NEW_OBSERVABILITY_UPGRADE_MESSAGE = "New observability endpoints require a newer @mastra/core. Please upgrade.";
+var OBSERVABILITY_DELTA_POLLING_FEATURE = "observability-delta-polling";
+var OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = "Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.";
+var OBSERVABILITY_LIST_ENDPOINTS = {
+  traces: "traces",
+  branches: "branches",
+  logs: "logs",
+  metrics: "metrics",
+  scores: "scores",
+  feedback: "feedback"
+};
+var OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = "delta-polling";
+function getFeatures(observabilityStore) {
+  const candidate = observabilityStore;
+  return candidate.getFeatures?.();
+}
 function getStorage(mastra) {
   const storage = mastra.getStorage();
   if (!storage) {
@@ -17,7 +34,26 @@ async function getObservabilityStore(mastra) {
   }
   return observability;
 }
+function assertObservabilityDeltaSupported(observabilityStore, endpoint) {
+  if (!coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {
+    throw new HTTPException(501, {
+      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`
+    });
+  }
+  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {
+    return;
+  }
+  throw new HTTPException(501, {
+    message: `Delta polling is not supported by the configured observability store for ${endpoint}`
+  });
+}
 var NEW_ROUTE_DEFS = {
+  LIST_METRICS: {
+    method: "GET",
+    path: "/observability/metrics",
+    summary: "List metrics",
+    description: "Returns a paginated list of metrics with optional filtering and sorting"
+  },
   LIST_LOGS: {
     method: "GET",
     path: "/observability/logs",
@@ -187,7 +223,86 @@ var NEW_ROUTE_DEFS = {
     description: "Returns distinct tags with optional entity type filtering"
   }
 };
+function createObservabilityListQuerySchema(filterSchema, orderBySchema) {
+  const unwrapDefault = (schema) => {
+    const zodSchema = schema;
+    return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;
+  };
+  const paginationShape = paginationArgsSchema.shape;
+  const orderByShape = orderBySchema.shape;
+  const pageSchema = unwrapDefault(paginationShape.page);
+  const perPageSchema = unwrapDefault(paginationShape.perPage);
+  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();
+  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();
+  return wrapSchemaForQueryParams(
+    z.object({
+      ...filterSchema.shape,
+      page: pageSchema,
+      perPage: perPageSchema,
+      field: fieldSchema,
+      direction: directionSchema,
+      mode: listModeSchema.optional(),
+      after: deltaCursorSchema.optional(),
+      limit: deltaLimitSchema
+    }).partial()
+  ).superRefine((value, ctx) => {
+    const isDelta = value.mode === "delta";
+    const hasPagination = value.page !== void 0 || value.perPage !== void 0;
+    const hasOrderBy = value.field !== void 0 || value.direction !== void 0;
+    const hasAfter = value.after !== void 0;
+    const hasLimit = value.limit !== void 0;
+    if (isDelta) {
+      if (hasPagination) {
+        if (value.page !== void 0) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["page"],
+            message: "`page` is not allowed when `mode=delta`"
+          });
+        }
+        if (value.perPage !== void 0) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["perPage"],
+            message: "`perPage` is not allowed when `mode=delta`"
+          });
+        }
+      }
+      if (hasOrderBy) {
+        if (value.field !== void 0) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["field"],
+            message: "`field` is not allowed when `mode=delta`"
+          });
+        }
+        if (value.direction !== void 0) {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["direction"],
+            message: "`direction` is not allowed when `mode=delta`"
+          });
+        }
+      }
+      return;
+    }
+    if (hasAfter) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["after"],
+        message: "`after` is only allowed when `mode=delta`"
+      });
+    }
+    if (hasLimit) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["limit"],
+        message: "`limit` is only allowed when `mode=delta`"
+      });
+    }
+  });
+}
 
-export { NEW_OBSERVABILITY_UPGRADE_MESSAGE, NEW_ROUTE_DEFS, getObservabilityStore, getStorage };
-//# sourceMappingURL=chunk-4L2UVFJO.js.map
-//# sourceMappingURL=chunk-4L2UVFJO.js.map
+export { NEW_ROUTE_DEFS, OBSERVABILITY_DELTA_POLLING_FEATURE, OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE, OBSERVABILITY_LIST_ENDPOINTS, assertObservabilityDeltaSupported, createObservabilityListQuerySchema, getObservabilityStore, getStorage };
+//# sourceMappingURL=chunk-WYP25ZMM.js.map
+//# sourceMappingURL=chunk-WYP25ZMM.js.map

package/dist/chunk-WYP25ZMM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability-shared.ts"],"names":[],"mappings":";;;;;;AAcO,IAAM,mCAAA,GAAsC;AAC5C,IAAM,2CAAA,GACX;AAEK,IAAM,4BAAA,GAA+B;AAAA,EAC1C,MAAA,EAAQ,QAAA;AAAA,EACR,QAAA,EAAU,UAAA;AAAA,EACV,IAAA,EAAM,MAAA;AAAA,EACN,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ,QAAA;AAAA,EACR,QAAA,EAAU;AACZ;AAIA,IAAM,2CAAA,GAA8C,eAAA;AAEpD,SAAS,YAAY,kBAAA,EAAyE;AAC5F,EAAA,MAAM,SAAA,GAAY,kBAAA;AAGlB,EAAA,OAAO,UAAU,WAAA,IAAc;AACjC;AAGO,SAAS,WAAW,MAAA,EAAsC;AAC/D,EAAA,MAAM,OAAA,GAAU,OAAO,UAAA,EAAW;AAClC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,aAAA,CAAc,GAAA,EAAK,EAAE,OAAA,EAAS,4BAA4B,CAAA;AAAA,EACtE;AACA,EAAA,OAAO,OAAA;AACT;AAGA,eAAsB,sBAAsB,MAAA,EAA+C;AACzF,EAAA,MAAM,OAAA,GAAU,WAAW,MAAM,CAAA;AACjC,EAAA,MAAM,aAAA,GAAgB,MAAM,OAAA,CAAQ,QAAA,CAAS,eAAe,CAAA;AAC5D,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,MAAM,IAAI,aAAA,CAAc,GAAA,EAAK,EAAE,OAAA,EAAS,iDAAiD,CAAA;AAAA,EAC3F;AACA,EAAA,OAAO,aAAA;AACT;AAEO,SAAS,iCAAA,CACd,oBACA,QAAA,EACA;AACA,EAAA,IAAI,CAAC,YAAA,CAAa,GAAA,CAAI,mCAAmC,CAAA,EAAG;AAC1D,IAAA,MAAM,IAAI,cAAc,GAAA,EAAK;AAAA,MAC3B,OAAA,EAAS,CAAA,EAAG,2CAA2C,CAAA,YAAA,EAAe,QAAQ,CAAA,CAAA;AAAA,KAC/E,CAAA;AAAA,EACH;AAEA,EAAA,IAAI,WAAA,CAAY,kBAAkB,CAAA,EAAG,QAAA,CAAS,2CAA2C,CAAA,EAAG;AAC1F,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,IAAI,cAAc,GAAA,EAAK;AAAA,IAC3B,OAAA,EAAS,4EAA4E,QAAQ,CAAA;AAAA,GAC9F,CAAA;AACH;AAUO,IAAM,cAAA,GAAiB;AAAA,EAC5B,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,wBAAA;AAAA,IACN,OAAA,EAAS,cAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,qBAAA;AAAA,IACN,OAAA,EAAS,WAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,WAAA,EAAa;AAAA,IACX,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,uBAAA;AAAA,IACN,OAAA,EAAS,aAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,uBAAA;AAAA,IACN,OAAA,EAAS,gBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,gCAAA;AAAA,IACN,OAAA,EAAS,WAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,iCAAA;AAAA,IACN,OAAA,EAAS,qBAAA;AAAA,IACT,WAAA,EAAa,+EAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,iCAAA;AAAA,IACN,OAAA,EAAS,qBAAA;AAAA,IACT,WAAA,EAAa,sDAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,kCAAA;AAAA,IACN,OAAA,EAAS,uBAAA;AAAA,IACT,WAAA,EAAa,uEAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,mCAAA;AAAA,IACN,OAAA,EAAS,uBAAA;AAAA,IACT,WAAA,EAAa,iEAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,aAAA,EAAe;AAAA,IACb,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,yBAAA;AAAA,IACN,OAAA,EAAS,eAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,yBAAA;AAAA,IACN,OAAA,EAAS,iBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,sBAAA,EAAwB;AAAA,IACtB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,mCAAA;AAAA,IACN,OAAA,EAAS,wBAAA;AAAA,IACT,WAAA,EAAa,0FAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,sBAAA,EAAwB;AAAA,IACtB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,mCAAA;AAAA,IACN,OAAA,EAAS,wBAAA;AAAA,IACT,WAAA,EAAa,iEAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,wBAAA,EAA0B;AAAA,IACxB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,oCAAA;AAAA,IACN,OAAA,EAAS,0BAAA;AAAA,IACT,WAAA,EAAa,kFAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,wBAAA,EAA0B;AAAA,IACxB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,qCAAA;AAAA,IACN,OAAA,EAAS,0BAAA;AAAA,IACT,WAAA,EAAa,0EAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,oBAAA,EAAsB;AAAA,IACpB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,kCAAA;AAAA,IACN,OAAA,EAAS,sBAAA;AAAA,IACT,WAAA,EAAa,gFAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,oBAAA,EAAsB;AAAA,IACpB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,kCAAA;AAAA,IACN,OAAA,EAAS,sBAAA;AAAA,IACT,WAAA,EAAa,uDAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,sBAAA,EAAwB;AAAA,IACtB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,mCAAA;AAAA,IACN,OAAA,EAAS,wBAAA;AAAA,IACT,WAAA,EAAa,wEAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,sBAAA,EAAwB;AAAA,IACtB,MAAA,EAAQ,MAAA;AAAA,IACR,IAAA,EAAM,oCAAA;AAAA,IACN,OAAA,EAAS,wBAAA;AAAA,IACT,WAAA,EAAa,kEAAA;AAAA,IACb,kBAAA,EAAoB;AAAA,GACtB;AAAA,EAEA,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,uCAAA;AAAA,IACN,OAAA,EAAS,kBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,4CAAA;AAAA,IACN,OAAA,EAAS,uBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,uBAAA,EAAyB;AAAA,IACvB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,8CAAA;AAAA,IACN,OAAA,EAAS,kBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,uCAAA;AAAA,IACN,OAAA,EAAS,kBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,uCAAA;AAAA,IACN,OAAA,EAAS,kBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,iBAAA,EAAmB;AAAA,IACjB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,wCAAA;AAAA,IACN,OAAA,EAAS,mBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,uCAAA;AAAA,IACN,OAAA,EAAS,kBAAA;AAAA,IACT,WAAA,EAAa;AAAA,GACf;AAAA,EAEA,QAAA,EAAU;AAAA,IACR,MAAA,EAAQ,KAAA;AAAA,IACR,IAAA,EAAM,+BAAA;AAAA,IACN,OAAA,EAAS,UAAA;AAAA,IACT,WAAA,EAAa;AAAA;AAEjB;AAKO,SAAS,kCAAA,CAGd,cAAuB,aAAA,EAAyB;AAChD,EAAA,MAAM,aAAA,GAAgB,CAAC,MAAA,KAAoB;AACzC,IAAA,MAAM,SAAA,GAAY,MAAA;AAClB,IAAA,OAAO,SAAA,YAAqB,CAAA,CAAE,UAAA,GAAa,SAAA,CAAU,QAAO,GAAI,SAAA;AAAA,EAClE,CAAA;AACA,EAAA,MAAM,kBAAkB,oBAAA,CAAqB,KAAA;AAC7C,EAAA,MAAM,eAAe,aAAA,CAAc,KAAA;AAEnC,EAAA,MAAM,UAAA,GAAa,aAAA,CAAc,eAAA,CAAgB,IAAI,CAAA;AACrD,EAAA,MAAM,aAAA,GAAgB,aAAA,CAAc,eAAA,CAAgB,OAAO,CAAA;AAC3D,EAAA,MAAM,WAAA,GAAc,YAAA,CAAa,KAAA,GAAQ,aAAA,CAAc,YAAA,CAAa,KAAK,CAAA,GAAI,CAAA,CAAE,KAAA,EAAM,CAAE,QAAA,EAAS;AAChG,EAAA,MAAM,eAAA,GAAkB,YAAA,CAAa,SAAA,GAAY,aAAA,CAAc,YAAA,CAAa,SAAS,CAAA,GAAI,CAAA,CAAE,KAAA,EAAM,CAAE,QAAA,EAAS;AAE5G,EAAA,OAAO,wBAAA;AAAA,IACL,EACG,MAAA,CAAO;AAAA,MACN,GAAG,YAAA,CAAa,KAAA;AAAA,MAChB,IAAA,EAAM,UAAA;AAAA,MACN,OAAA,EAAS,aAAA;AAAA,MACT,KAAA,EAAO,WAAA;AAAA,MACP,SAAA,EAAW,eAAA;AAAA,MACX,IAAA,EAAM,eAAe,QAAA,EAAS;AAAA,MAC9B,KAAA,EAAO,kBAAkB,QAAA,EAAS;AAAA,MAClC,KAAA,EAAO;AAAA,KACR,EACA,OAAA;AAAQ,GACb,CAAE,WAAA,CAAY,CAAC,KAAA,EAAO,GAAA,KAAQ;AAC5B,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,KAAS,OAAA;AAC/B,IAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,IAAA,KAAS,MAAA,IAAa,MAAM,OAAA,KAAY,MAAA;AACpE,IAAA,MAAM,UAAA,GAAa,KAAA,CAAM,KAAA,KAAU,MAAA,IAAa,MAAM,SAAA,KAAc,MAAA;AACpE,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,KAAU,MAAA;AACjC,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,KAAU,MAAA;AAEjC,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,IAAI,aAAA,EAAe;AACjB,QAAA,IAAI,KAAA,CAAM,SAAS,MAAA,EAAW;AAC5B,UAAA,GAAA,CAAI,QAAA,CAAS;AAAA,YACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,YACrB,IAAA,EAAM,CAAC,MAAM,CAAA;AAAA,YACb,OAAA,EAAS;AAAA,WACV,CAAA;AAAA,QACH;AACA,QAAA,IAAI,KAAA,CAAM,YAAY,MAAA,EAAW;AAC/B,UAAA,GAAA,CAAI,QAAA,CAAS;AAAA,YACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,YACrB,IAAA,EAAM,CAAC,SAAS,CAAA;AAAA,YAChB,OAAA,EAAS;AAAA,WACV,CAAA;AAAA,QACH;AAAA,MACF;AACA,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,IAAI,KAAA,CAAM,UAAU,MAAA,EAAW;AAC7B,UAAA,GAAA,CAAI,QAAA,CAAS;AAAA,YACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,YACrB,IAAA,EAAM,CAAC,OAAO,CAAA;AAAA,YACd,OAAA,EAAS;AAAA,WACV,CAAA;AAAA,QACH;AACA,QAAA,IAAI,KAAA,CAAM,cAAc,MAAA,EAAW;AACjC,UAAA,GAAA,CAAI,QAAA,CAAS;AAAA,YACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,YACrB,IAAA,EAAM,CAAC,WAAW,CAAA;AAAA,YAClB,OAAA,EAAS;AAAA,WACV,CAAA;AAAA,QACH;AAAA,MACF;AACA,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,GAAA,CAAI,QAAA,CAAS;AAAA,QACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,QACrB,IAAA,EAAM,CAAC,OAAO,CAAA;AAAA,QACd,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AACA,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,GAAA,CAAI,QAAA,CAAS;AAAA,QACX,IAAA,EAAM,EAAE,YAAA,CAAa,MAAA;AAAA,QACrB,IAAA,EAAM,CAAC,OAAO,CAAA;AAAA,QACd,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAAA,EACF,CAAC,CAAA;AACH","file":"chunk-WYP25ZMM.js","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { coreFeatures } from '@mastra/core/features';\nimport type { MastraCompositeStore, ObservabilityStorage } from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport type { ServerRoute } from '../server-adapter/routes';\nimport { wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport {\n  deltaCursorSchema,\n  deltaLimitSchema,\n  listModeSchema,\n  paginationArgsSchema,\n} from './observability-list-query-schemas';\n\nexport const OBSERVABILITY_DELTA_POLLING_FEATURE = 'observability-delta-polling';\nexport const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE =\n  'Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.';\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n  traces: 'traces',\n  branches: 'branches',\n  logs: 'logs',\n  metrics: 'metrics',\n  scores: 'scores',\n  feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n  (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n  const candidate = observabilityStore as ObservabilityStorage & {\n    getFeatures?: () => readonly string[] | undefined;\n  };\n  return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not available' });\n  }\n  return storage;\n}\n\n/** Retrieves the observability storage domain or throws 500 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n  const storage = getStorage(mastra);\n  const observability = await storage.getStore('observability');\n  if (!observability) {\n    throw new HTTPException(500, { message: 'Observability storage domain is not available' });\n  }\n  return observability;\n}\n\nexport function assertObservabilityDeltaSupported(\n  observabilityStore: ObservabilityStorage,\n  endpoint: ObservabilityListEndpoint,\n) {\n  if (!coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {\n    throw new HTTPException(501, {\n      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`,\n    });\n  }\n\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: `Delta polling is not supported by the configured observability store for ${endpoint}`,\n  });\n}\n\nexport interface RouteDetails {\n  method: ServerRoute['method'];\n  path: `/${string}`;\n  summary: string;\n  description: string;\n  requiresPermission?: ServerRoute['requiresPermission'];\n}\n\nexport const NEW_ROUTE_DEFS = {\n  LIST_METRICS: {\n    method: 'GET',\n    path: '/observability/metrics',\n    summary: 'List metrics',\n    description: 'Returns a paginated list of metrics with optional filtering and sorting',\n  },\n\n  LIST_LOGS: {\n    method: 'GET',\n    path: '/observability/logs',\n    summary: 'List logs',\n    description: 'Returns a paginated list of logs with optional filtering and sorting',\n  },\n\n  LIST_SCORES: {\n    method: 'GET',\n    path: '/observability/scores',\n    summary: 'List scores',\n    description: 'Returns a paginated list of scores with optional filtering and sorting',\n  },\n\n  CREATE_SCORE: {\n    method: 'POST',\n    path: '/observability/scores',\n    summary: 'Create a score',\n    description: 'Creates a single score record in the observability store',\n  },\n\n  GET_SCORE: {\n    method: 'GET',\n    path: '/observability/scores/:scoreId',\n    summary: 'Get score',\n    description: 'Returns a single score by scoreId',\n  },\n\n  GET_SCORE_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/scores/aggregate',\n    summary: 'Get score aggregate',\n    description: 'Returns an aggregated score value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/scores/breakdown',\n    summary: 'Get score breakdown',\n    description: 'Returns score values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/scores/timeseries',\n    summary: 'Get score time series',\n    description: 'Returns score values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/scores/percentiles',\n    summary: 'Get score percentiles',\n    description: 'Returns percentile values for a score bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_FEEDBACK: {\n    method: 'GET',\n    path: '/observability/feedback',\n    summary: 'List feedback',\n    description: 'Returns a paginated list of feedback with optional filtering and sorting',\n  },\n\n  CREATE_FEEDBACK: {\n    method: 'POST',\n    path: '/observability/feedback',\n    summary: 'Create feedback',\n    description: 'Creates a single feedback record in the observability store',\n  },\n\n  GET_FEEDBACK_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/feedback/aggregate',\n    summary: 'Get feedback aggregate',\n    description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/feedback/breakdown',\n    summary: 'Get feedback breakdown',\n    description: 'Returns numeric feedback values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/feedback/timeseries',\n    summary: 'Get feedback time series',\n    description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/feedback/percentiles',\n    summary: 'Get feedback percentiles',\n    description: 'Returns percentile values for numeric feedback bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/metrics/aggregate',\n    summary: 'Get metric aggregate',\n    description: 'Returns an aggregated metric value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/metrics/breakdown',\n    summary: 'Get metric breakdown',\n    description: 'Returns metric values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/metrics/timeseries',\n    summary: 'Get metric time series',\n    description: 'Returns metric values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/metrics/percentiles',\n    summary: 'Get metric percentiles',\n    description: 'Returns percentile values for a metric bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-names',\n    summary: 'Get metric names',\n    description: 'Returns distinct metric names with optional prefix filtering',\n  },\n\n  GET_METRIC_LABEL_KEYS: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-keys',\n    summary: 'Get metric label keys',\n    description: 'Returns distinct label keys for a given metric',\n  },\n\n  GET_METRIC_LABEL_VALUES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-values',\n    summary: 'Get label values',\n    description: 'Returns distinct values for a given metric label key',\n  },\n\n  GET_ENTITY_TYPES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-types',\n    summary: 'Get entity types',\n    description: 'Returns distinct entity types from observability data',\n  },\n\n  GET_ENTITY_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-names',\n    summary: 'Get entity names',\n    description: 'Returns distinct entity names with optional type filtering',\n  },\n\n  GET_SERVICE_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/service-names',\n    summary: 'Get service names',\n    description: 'Returns distinct service names from observability data',\n  },\n\n  GET_ENVIRONMENTS: {\n    method: 'GET',\n    path: '/observability/discovery/environments',\n    summary: 'Get environments',\n    description: 'Returns distinct environments from observability data',\n  },\n\n  GET_TAGS: {\n    method: 'GET',\n    path: '/observability/discovery/tags',\n    summary: 'Get tags',\n    description: 'Returns distinct tags with optional entity type filtering',\n  },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n  TFilter extends z.ZodObject<z.ZodRawShape>,\n  TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n  const unwrapDefault = (schema: unknown) => {\n    const zodSchema = schema as z.ZodTypeAny;\n    return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n  };\n  const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n  const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n  const pageSchema = unwrapDefault(paginationShape.page);\n  const perPageSchema = unwrapDefault(paginationShape.perPage);\n  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n  return wrapSchemaForQueryParams(\n    z\n      .object({\n        ...filterSchema.shape,\n        page: pageSchema,\n        perPage: perPageSchema,\n        field: fieldSchema,\n        direction: directionSchema,\n        mode: listModeSchema.optional(),\n        after: deltaCursorSchema.optional(),\n        limit: deltaLimitSchema,\n      })\n      .partial(),\n  ).superRefine((value, ctx) => {\n    const isDelta = value.mode === 'delta';\n    const hasPagination = value.page !== undefined || value.perPage !== undefined;\n    const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n    const hasAfter = value.after !== undefined;\n    const hasLimit = value.limit !== undefined;\n\n    if (isDelta) {\n      if (hasPagination) {\n        if (value.page !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['page'],\n            message: '`page` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.perPage !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['perPage'],\n            message: '`perPage` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      if (hasOrderBy) {\n        if (value.field !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['field'],\n            message: '`field` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.direction !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['direction'],\n            message: '`direction` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      return;\n    }\n\n    if (hasAfter) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['after'],\n        message: '`after` is only allowed when `mode=delta`',\n      });\n    }\n    if (hasLimit) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['limit'],\n        message: '`limit` is only allowed when `mode=delta`',\n      });\n    }\n  });\n}\n"]}

package/dist/{chunk-WD2L3ZU3.js → chunk-XM54QZ3G.js}

@@ -13,7 +13,7 @@ var GET_API_SCHEMA_ROUTE = createRoute({
   tags: ["System"],
   requiresAuth: true,
   handler: async () => {
-    const { buildApiSchemaManifest } = await import('./api-schema-manifest-YS3FEIFG.js');
+    const { buildApiSchemaManifest } = await import('./api-schema-manifest-WY623UST.js');
     return buildApiSchemaManifest();
   }
 });
@@ -60,5 +60,5 @@ var GET_SYSTEM_PACKAGES_ROUTE = createRoute({
 });
 
 export { GET_API_SCHEMA_ROUTE, GET_SYSTEM_PACKAGES_ROUTE };
-//# sourceMappingURL=chunk-WD2L3ZU3.js.map
-//# sourceMappingURL=chunk-WD2L3ZU3.js.map
+//# sourceMappingURL=chunk-XM54QZ3G.js.map
+//# sourceMappingURL=chunk-XM54QZ3G.js.map

package/dist/{chunk-WD2L3ZU3.js.map → chunk-XM54QZ3G.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/handlers/system.ts"],"names":[],"mappings":";;;;;AAOO,IAAM,uBAAuB,WAAA,CAAY;AAAA,EAC9C,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,oBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgB,+BAAA;AAAA,EAChB,OAAA,EAAS,yBAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,SAAS,YAAY;AAEnB,IAAA,MAAM,EAAE,sBAAA,EAAuB,GAAI,MAAM,OAAO,mCAAuC,CAAA;AACvF,IAAA,OAAO,sBAAA,EAAuB;AAAA,EAChC;AACF,CAAC;AAEM,IAAM,4BAA4B,WAAA,CAAY;AAAA,EACnD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgB,4BAAA;AAAA,EAChB,OAAA,EAAS,+BAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAM;AAC7B,IAAA,IAAI;AACF,MAAA,MAAM,gBAAA,GAAmB,QAAQ,GAAA,CAAI,oBAAA;AAErC,MAAA,IAAI,WAA4B,EAAC;AAEjC,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,IAAI;AACF,UAAA,MAAM,WAAA,GAAc,YAAA,CAAa,gBAAA,EAAkB,OAAO,CAAA;AAC1D,UAAA,QAAA,GAAW,IAAA,CAAK,MAAM,WAAW,CAAA;AAAA,QACnC,CAAA,CAAA,MAAQ;AACN,UAAA,QAAA,GAAW,EAAC;AAAA,QACd;AAAA,MACF;AAEA,MAAA,MAAM,OAAA,GAAU,OAAO,UAAA,EAAW;AAClC,MAAA,MAAM,cAAc,OAAA,EAAS,IAAA;AAC7B,MAAA,MAAM,oBAAA,GAAuB,SAAS,MAAA,EAAQ,aAAA;AAC9C,MAAA,MAAM,wBAAA,GAA2B,sBAAsB,WAAA,CAAY,IAAA;AACnE,MAAA,MAAM,+BAA+B,oBAAA,EAAsB,sBAAA;AAC3D,MAAA,MAAM,oBAAA,GAAuB,CAAC,CAAC,MAAA,CAAO,cAAc,kBAAA,EAAmB;AAEvE,MAAA,OAAO;AAAA,QACL,QAAA;AAAA,QACA,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,UAAA,KAAe,MAAA;AAAA,QAClC,UAAA,EAAY,CAAC,CAAC,MAAA,CAAO,SAAA,EAAU;AAAA,QAC/B,oBAAA;AAAA,QACA,WAAA;AAAA,QACA,wBAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAO,WAAA,CAAY,OAAO,+BAA+B,CAAA;AAAA,IAC3D;AAAA,EACF;AACF,CAAC","file":"chunk-WD2L3ZU3.js","sourcesContent":["import { readFileSync } from 'node:fs';\n\nimport type { MastraPackage } from '../schemas/system';\nimport { apiSchemaManifestResponseSchema, systemPackagesResponseSchema } from '../schemas/system';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\n\nexport const GET_API_SCHEMA_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/api-schema',\n  responseType: 'json',\n  responseSchema: apiSchemaManifestResponseSchema,\n  summary: 'Get API schema manifest',\n  description: 'Returns the route-contract-derived API schema manifest for the machine-readable CLI',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async () => {\n    // Dynamic import to avoid circular dependency issues\n    const { buildApiSchemaManifest } = await import('../server-adapter/api-schema-manifest');\n    return buildApiSchemaManifest();\n  },\n});\n\nexport const GET_SYSTEM_PACKAGES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/packages',\n  responseType: 'json',\n  responseSchema: systemPackagesResponseSchema,\n  summary: 'Get installed Mastra packages',\n  description: 'Returns a list of all installed Mastra packages and their versions from the project',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const packagesFilePath = process.env.MASTRA_PACKAGES_FILE;\n\n      let packages: MastraPackage[] = [];\n\n      if (packagesFilePath) {\n        try {\n          const fileContent = readFileSync(packagesFilePath, 'utf-8');\n          packages = JSON.parse(fileContent);\n        } catch {\n          packages = [];\n        }\n      }\n\n      const storage = mastra.getStorage();\n      const storageType = storage?.name;\n      const observabilityStorage = storage?.stores?.observability;\n      const observabilityStorageType = observabilityStorage?.constructor.name;\n      const observabilityRuntimeStrategy = observabilityStorage?.runtimeTracingStrategy;\n      const observabilityEnabled = !!mastra.observability.getDefaultInstance();\n\n      return {\n        packages,\n        isDev: process.env.MASTRA_DEV === 'true',\n        cmsEnabled: !!mastra.getEditor(),\n        observabilityEnabled,\n        storageType,\n        observabilityStorageType,\n        observabilityRuntimeStrategy,\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting system packages');\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../src/server/handlers/system.ts"],"names":[],"mappings":";;;;;AAOO,IAAM,uBAAuB,WAAA,CAAY;AAAA,EAC9C,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,oBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgB,+BAAA;AAAA,EAChB,OAAA,EAAS,yBAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,SAAS,YAAY;AAEnB,IAAA,MAAM,EAAE,sBAAA,EAAuB,GAAI,MAAM,OAAO,mCAAuC,CAAA;AACvF,IAAA,OAAO,sBAAA,EAAuB;AAAA,EAChC;AACF,CAAC;AAEM,IAAM,4BAA4B,WAAA,CAAY;AAAA,EACnD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgB,4BAAA;AAAA,EAChB,OAAA,EAAS,+BAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAM;AAC7B,IAAA,IAAI;AACF,MAAA,MAAM,gBAAA,GAAmB,QAAQ,GAAA,CAAI,oBAAA;AAErC,MAAA,IAAI,WAA4B,EAAC;AAEjC,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,IAAI;AACF,UAAA,MAAM,WAAA,GAAc,YAAA,CAAa,gBAAA,EAAkB,OAAO,CAAA;AAC1D,UAAA,QAAA,GAAW,IAAA,CAAK,MAAM,WAAW,CAAA;AAAA,QACnC,CAAA,CAAA,MAAQ;AACN,UAAA,QAAA,GAAW,EAAC;AAAA,QACd;AAAA,MACF;AAEA,MAAA,MAAM,OAAA,GAAU,OAAO,UAAA,EAAW;AAClC,MAAA,MAAM,cAAc,OAAA,EAAS,IAAA;AAC7B,MAAA,MAAM,oBAAA,GAAuB,SAAS,MAAA,EAAQ,aAAA;AAC9C,MAAA,MAAM,wBAAA,GAA2B,sBAAsB,WAAA,CAAY,IAAA;AACnE,MAAA,MAAM,+BAA+B,oBAAA,EAAsB,sBAAA;AAC3D,MAAA,MAAM,oBAAA,GAAuB,CAAC,CAAC,MAAA,CAAO,cAAc,kBAAA,EAAmB;AAEvE,MAAA,OAAO;AAAA,QACL,QAAA;AAAA,QACA,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,UAAA,KAAe,MAAA;AAAA,QAClC,UAAA,EAAY,CAAC,CAAC,MAAA,CAAO,SAAA,EAAU;AAAA,QAC/B,oBAAA;AAAA,QACA,WAAA;AAAA,QACA,wBAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAO,WAAA,CAAY,OAAO,+BAA+B,CAAA;AAAA,IAC3D;AAAA,EACF;AACF,CAAC","file":"chunk-XM54QZ3G.js","sourcesContent":["import { readFileSync } from 'node:fs';\n\nimport type { MastraPackage } from '../schemas/system';\nimport { apiSchemaManifestResponseSchema, systemPackagesResponseSchema } from '../schemas/system';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\n\nexport const GET_API_SCHEMA_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/api-schema',\n  responseType: 'json',\n  responseSchema: apiSchemaManifestResponseSchema,\n  summary: 'Get API schema manifest',\n  description: 'Returns the route-contract-derived API schema manifest for the machine-readable CLI',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async () => {\n    // Dynamic import to avoid circular dependency issues\n    const { buildApiSchemaManifest } = await import('../server-adapter/api-schema-manifest');\n    return buildApiSchemaManifest();\n  },\n});\n\nexport const GET_SYSTEM_PACKAGES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/packages',\n  responseType: 'json',\n  responseSchema: systemPackagesResponseSchema,\n  summary: 'Get installed Mastra packages',\n  description: 'Returns a list of all installed Mastra packages and their versions from the project',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const packagesFilePath = process.env.MASTRA_PACKAGES_FILE;\n\n      let packages: MastraPackage[] = [];\n\n      if (packagesFilePath) {\n        try {\n          const fileContent = readFileSync(packagesFilePath, 'utf-8');\n          packages = JSON.parse(fileContent);\n        } catch {\n          packages = [];\n        }\n      }\n\n      const storage = mastra.getStorage();\n      const storageType = storage?.name;\n      const observabilityStorage = storage?.stores?.observability;\n      const observabilityStorageType = observabilityStorage?.constructor.name;\n      const observabilityRuntimeStrategy = observabilityStorage?.runtimeTracingStrategy;\n      const observabilityEnabled = !!mastra.observability.getDefaultInstance();\n\n      return {\n        packages,\n        isDev: process.env.MASTRA_DEV === 'true',\n        cmsEnabled: !!mastra.getEditor(),\n        observabilityEnabled,\n        storageType,\n        observabilityStorageType,\n        observabilityRuntimeStrategy,\n      };\n    } catch (error) {\n      return handleError(error, 'Error getting system packages');\n    }\n  },\n});\n"]}

package/dist/chunk-YRLCLLKR.js

@@ -0,0 +1,14 @@
+import { z } from 'zod/v4';
+
+// src/server/handlers/observability-list-query-schemas.ts
+var paginationArgsSchema = 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");
+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");
+
+export { deltaCursorSchema, deltaLimitSchema, listModeSchema, paginationArgsSchema };
+//# sourceMappingURL=chunk-YRLCLLKR.js.map
+//# sourceMappingURL=chunk-YRLCLLKR.js.map

package/dist/chunk-YRLCLLKR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability-list-query-schemas.ts"],"names":[],"mappings":";;;AAoBO,IAAM,oBAAA,GAAuB,EACjC,MAAA,CAAO;AAAA,EACN,MAAM,CAAA,CAAE,MAAA,CAAO,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,UAAS,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,SAAS,0BAA0B,CAAA;AAAA,EAC9F,SAAS,CAAA,CAAE,MAAA,CAAO,QAAO,CAAE,GAAA,GAAM,GAAA,CAAI,CAAC,EAAE,GAAA,CAAI,GAAG,EAAE,QAAA,EAAS,CAAE,QAAQ,EAAE,CAAA,CAAE,SAAS,0BAA0B;AAC7G,CAAC,CAAA,CACA,SAAS,qCAAqC;AAE1C,IAAM,iBAAA,GAAoB,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,6CAA6C;AAElG,IAAM,cAAA,GAAiB,EAC3B,IAAA,CAAK,CAAC,QAAQ,OAAO,CAAC,CAAA,CACtB,QAAA,CAAS,+DAA+D;AAEpE,IAAM,mBAAmB,CAAA,CAAE,MAAA,CAC/B,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,GAAG,CAAA,CACP,QAAA,EAAS,CACT,SAAS,uDAAuD","file":"chunk-YRLCLLKR.js","sourcesContent":["import { z } from 'zod/v4';\n\n/**\n * Server-local route-layer query schemas for observability list endpoints.\n *\n * Why these live in @mastra/server instead of importing the newer shared core\n * exports directly:\n * - `mode`, `after`, and `limit` were added after older @mastra/core versions\n *   that @mastra/server still needs to tolerate at runtime.\n * - Direct named imports of newly-added schema exports create module-link-time\n *   failures when a newer server is paired with an older core.\n * - These are route parsing concerns, so mirroring the current core schema\n *   semantics here keeps the server backward-compatible without forcing a peer\n *   dependency lockstep upgrade.\n *\n * TODO(Mastra 2.0): remove this shim and import the shared observability list\n * query schemas directly once server/core no longer need to tolerate older\n * mixed-version pairings.\n */\n\nexport const paginationArgsSchema = z\n  .object({\n    page: z.coerce.number().int().min(0).optional().default(0).describe('Zero-indexed page number'),\n    perPage: z.coerce.number().int().min(1).max(100).optional().default(10).describe('Number of items per page'),\n  })\n  .describe('Pagination options for list queries');\n\nexport const deltaCursorSchema = z.string().min(1).describe('Opaque cursor value for incremental polling');\n\nexport const listModeSchema = z\n  .enum(['page', 'delta'])\n  .describe(\"List mode: 'page' | 'delta', defaults to 'page' when omitted.\");\n\nexport const deltaLimitSchema = z.coerce\n  .number()\n  .int()\n  .min(1)\n  .max(100)\n  .optional()\n  .describe('Maximum number of updates to return in one delta poll');\n"]}

package/dist/{chunk-SUT6SU4I.cjs → chunk-Z4PDJRZT.cjs}

@@ -1,9 +1,26 @@
 'use strict';
 
+var chunkZNP74O27_cjs = require('./chunk-ZNP74O27.cjs');
+var chunkXTFWFQZ7_cjs = require('./chunk-XTFWFQZ7.cjs');
 var chunk64ITUOXI_cjs = require('./chunk-64ITUOXI.cjs');
+var features = require('@mastra/core/features');
+var v4 = require('zod/v4');
 
-// src/server/handlers/observability-shared.ts
-var NEW_OBSERVABILITY_UPGRADE_MESSAGE = "New observability endpoints require a newer @mastra/core. Please upgrade.";
+var OBSERVABILITY_DELTA_POLLING_FEATURE = "observability-delta-polling";
+var OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = "Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.";
+var OBSERVABILITY_LIST_ENDPOINTS = {
+  traces: "traces",
+  branches: "branches",
+  logs: "logs",
+  metrics: "metrics",
+  scores: "scores",
+  feedback: "feedback"
+};
+var OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = "delta-polling";
+function getFeatures(observabilityStore) {
+  const candidate = observabilityStore;
+  return candidate.getFeatures?.();
+}
 function getStorage(mastra) {
   const storage = mastra.getStorage();
   if (!storage) {
@@ -19,7 +36,26 @@ async function getObservabilityStore(mastra) {
   }
   return observability;
 }
+function assertObservabilityDeltaSupported(observabilityStore, endpoint) {
+  if (!features.coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {
+    throw new chunk64ITUOXI_cjs.HTTPException(501, {
+      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`
+    });
+  }
+  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {
+    return;
+  }
+  throw new chunk64ITUOXI_cjs.HTTPException(501, {
+    message: `Delta polling is not supported by the configured observability store for ${endpoint}`
+  });
+}
 var NEW_ROUTE_DEFS = {
+  LIST_METRICS: {
+    method: "GET",
+    path: "/observability/metrics",
+    summary: "List metrics",
+    description: "Returns a paginated list of metrics with optional filtering and sorting"
+  },
   LIST_LOGS: {
     method: "GET",
     path: "/observability/logs",
@@ -189,10 +225,93 @@ var NEW_ROUTE_DEFS = {
     description: "Returns distinct tags with optional entity type filtering"
   }
 };
+function createObservabilityListQuerySchema(filterSchema, orderBySchema) {
+  const unwrapDefault = (schema) => {
+    const zodSchema = schema;
+    return zodSchema instanceof v4.z.ZodDefault ? zodSchema.unwrap() : zodSchema;
+  };
+  const paginationShape = chunkZNP74O27_cjs.paginationArgsSchema.shape;
+  const orderByShape = orderBySchema.shape;
+  const pageSchema = unwrapDefault(paginationShape.page);
+  const perPageSchema = unwrapDefault(paginationShape.perPage);
+  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : v4.z.never().optional();
+  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : v4.z.never().optional();
+  return chunkXTFWFQZ7_cjs.wrapSchemaForQueryParams(
+    v4.z.object({
+      ...filterSchema.shape,
+      page: pageSchema,
+      perPage: perPageSchema,
+      field: fieldSchema,
+      direction: directionSchema,
+      mode: chunkZNP74O27_cjs.listModeSchema.optional(),
+      after: chunkZNP74O27_cjs.deltaCursorSchema.optional(),
+      limit: chunkZNP74O27_cjs.deltaLimitSchema
+    }).partial()
+  ).superRefine((value, ctx) => {
+    const isDelta = value.mode === "delta";
+    const hasPagination = value.page !== void 0 || value.perPage !== void 0;
+    const hasOrderBy = value.field !== void 0 || value.direction !== void 0;
+    const hasAfter = value.after !== void 0;
+    const hasLimit = value.limit !== void 0;
+    if (isDelta) {
+      if (hasPagination) {
+        if (value.page !== void 0) {
+          ctx.addIssue({
+            code: v4.z.ZodIssueCode.custom,
+            path: ["page"],
+            message: "`page` is not allowed when `mode=delta`"
+          });
+        }
+        if (value.perPage !== void 0) {
+          ctx.addIssue({
+            code: v4.z.ZodIssueCode.custom,
+            path: ["perPage"],
+            message: "`perPage` is not allowed when `mode=delta`"
+          });
+        }
+      }
+      if (hasOrderBy) {
+        if (value.field !== void 0) {
+          ctx.addIssue({
+            code: v4.z.ZodIssueCode.custom,
+            path: ["field"],
+            message: "`field` is not allowed when `mode=delta`"
+          });
+        }
+        if (value.direction !== void 0) {
+          ctx.addIssue({
+            code: v4.z.ZodIssueCode.custom,
+            path: ["direction"],
+            message: "`direction` is not allowed when `mode=delta`"
+          });
+        }
+      }
+      return;
+    }
+    if (hasAfter) {
+      ctx.addIssue({
+        code: v4.z.ZodIssueCode.custom,
+        path: ["after"],
+        message: "`after` is only allowed when `mode=delta`"
+      });
+    }
+    if (hasLimit) {
+      ctx.addIssue({
+        code: v4.z.ZodIssueCode.custom,
+        path: ["limit"],
+        message: "`limit` is only allowed when `mode=delta`"
+      });
+    }
+  });
+}
 
-exports.NEW_OBSERVABILITY_UPGRADE_MESSAGE = NEW_OBSERVABILITY_UPGRADE_MESSAGE;
 exports.NEW_ROUTE_DEFS = NEW_ROUTE_DEFS;
+exports.OBSERVABILITY_DELTA_POLLING_FEATURE = OBSERVABILITY_DELTA_POLLING_FEATURE;
+exports.OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE = OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE;
+exports.OBSERVABILITY_LIST_ENDPOINTS = OBSERVABILITY_LIST_ENDPOINTS;
+exports.assertObservabilityDeltaSupported = assertObservabilityDeltaSupported;
+exports.createObservabilityListQuerySchema = createObservabilityListQuerySchema;
 exports.getObservabilityStore = getObservabilityStore;
 exports.getStorage = getStorage;
-//# sourceMappingURL=chunk-SUT6SU4I.cjs.map
-//# sourceMappingURL=chunk-SUT6SU4I.cjs.map
+//# sourceMappingURL=chunk-Z4PDJRZT.cjs.map
+//# sourceMappingURL=chunk-Z4PDJRZT.cjs.map

package/dist/chunk-Z4PDJRZT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/handlers/observability-shared.ts"],"names":["HTTPException","coreFeatures","z","paginationArgsSchema","wrapSchemaForQueryParams","listModeSchema","deltaCursorSchema","deltaLimitSchema"],"mappings":"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","file":"chunk-Z4PDJRZT.cjs","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport { coreFeatures } from '@mastra/core/features';\nimport type { MastraCompositeStore, ObservabilityStorage } from '@mastra/core/storage';\nimport { z } from 'zod/v4';\nimport { HTTPException } from '../http-exception';\nimport type { ServerRoute } from '../server-adapter/routes';\nimport { wrapSchemaForQueryParams } from '../server-adapter/routes/route-builder';\nimport {\n  deltaCursorSchema,\n  deltaLimitSchema,\n  listModeSchema,\n  paginationArgsSchema,\n} from './observability-list-query-schemas';\n\nexport const OBSERVABILITY_DELTA_POLLING_FEATURE = 'observability-delta-polling';\nexport const OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE =\n  'Delta polling requires a newer @mastra/core with observability delta polling support. Please upgrade.';\n\nexport const OBSERVABILITY_LIST_ENDPOINTS = {\n  traces: 'traces',\n  branches: 'branches',\n  logs: 'logs',\n  metrics: 'metrics',\n  scores: 'scores',\n  feedback: 'feedback',\n} as const;\n\nexport type ObservabilityListEndpoint =\n  (typeof OBSERVABILITY_LIST_ENDPOINTS)[keyof typeof OBSERVABILITY_LIST_ENDPOINTS];\nconst OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE = 'delta-polling';\n\nfunction getFeatures(observabilityStore: ObservabilityStorage): readonly string[] | undefined {\n  const candidate = observabilityStore as ObservabilityStorage & {\n    getFeatures?: () => readonly string[] | undefined;\n  };\n  return candidate.getFeatures?.();\n}\n\n/** Retrieves MastraCompositeStore or throws 500 if unavailable. */\nexport function getStorage(mastra: Mastra): MastraCompositeStore {\n  const storage = mastra.getStorage();\n  if (!storage) {\n    throw new HTTPException(500, { message: 'Storage is not available' });\n  }\n  return storage;\n}\n\n/** Retrieves the observability storage domain or throws 500 if unavailable. */\nexport async function getObservabilityStore(mastra: Mastra): Promise<ObservabilityStorage> {\n  const storage = getStorage(mastra);\n  const observability = await storage.getStore('observability');\n  if (!observability) {\n    throw new HTTPException(500, { message: 'Observability storage domain is not available' });\n  }\n  return observability;\n}\n\nexport function assertObservabilityDeltaSupported(\n  observabilityStore: ObservabilityStorage,\n  endpoint: ObservabilityListEndpoint,\n) {\n  if (!coreFeatures.has(OBSERVABILITY_DELTA_POLLING_FEATURE)) {\n    throw new HTTPException(501, {\n      message: `${OBSERVABILITY_DELTA_POLLING_UPGRADE_MESSAGE} (endpoint: ${endpoint})`,\n    });\n  }\n\n  if (getFeatures(observabilityStore)?.includes(OBSERVABILITY_DELTA_POLLING_STORAGE_FEATURE)) {\n    return;\n  }\n\n  throw new HTTPException(501, {\n    message: `Delta polling is not supported by the configured observability store for ${endpoint}`,\n  });\n}\n\nexport interface RouteDetails {\n  method: ServerRoute['method'];\n  path: `/${string}`;\n  summary: string;\n  description: string;\n  requiresPermission?: ServerRoute['requiresPermission'];\n}\n\nexport const NEW_ROUTE_DEFS = {\n  LIST_METRICS: {\n    method: 'GET',\n    path: '/observability/metrics',\n    summary: 'List metrics',\n    description: 'Returns a paginated list of metrics with optional filtering and sorting',\n  },\n\n  LIST_LOGS: {\n    method: 'GET',\n    path: '/observability/logs',\n    summary: 'List logs',\n    description: 'Returns a paginated list of logs with optional filtering and sorting',\n  },\n\n  LIST_SCORES: {\n    method: 'GET',\n    path: '/observability/scores',\n    summary: 'List scores',\n    description: 'Returns a paginated list of scores with optional filtering and sorting',\n  },\n\n  CREATE_SCORE: {\n    method: 'POST',\n    path: '/observability/scores',\n    summary: 'Create a score',\n    description: 'Creates a single score record in the observability store',\n  },\n\n  GET_SCORE: {\n    method: 'GET',\n    path: '/observability/scores/:scoreId',\n    summary: 'Get score',\n    description: 'Returns a single score by scoreId',\n  },\n\n  GET_SCORE_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/scores/aggregate',\n    summary: 'Get score aggregate',\n    description: 'Returns an aggregated score value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/scores/breakdown',\n    summary: 'Get score breakdown',\n    description: 'Returns score values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/scores/timeseries',\n    summary: 'Get score time series',\n    description: 'Returns score values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_SCORE_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/scores/percentiles',\n    summary: 'Get score percentiles',\n    description: 'Returns percentile values for a score bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  LIST_FEEDBACK: {\n    method: 'GET',\n    path: '/observability/feedback',\n    summary: 'List feedback',\n    description: 'Returns a paginated list of feedback with optional filtering and sorting',\n  },\n\n  CREATE_FEEDBACK: {\n    method: 'POST',\n    path: '/observability/feedback',\n    summary: 'Create feedback',\n    description: 'Creates a single feedback record in the observability store',\n  },\n\n  GET_FEEDBACK_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/feedback/aggregate',\n    summary: 'Get feedback aggregate',\n    description: 'Returns an aggregated numeric feedback value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/feedback/breakdown',\n    summary: 'Get feedback breakdown',\n    description: 'Returns numeric feedback values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/feedback/timeseries',\n    summary: 'Get feedback time series',\n    description: 'Returns numeric feedback values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_FEEDBACK_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/feedback/percentiles',\n    summary: 'Get feedback percentiles',\n    description: 'Returns percentile values for numeric feedback bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_AGGREGATE: {\n    method: 'POST',\n    path: '/observability/metrics/aggregate',\n    summary: 'Get metric aggregate',\n    description: 'Returns an aggregated metric value with optional period-over-period comparison',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_BREAKDOWN: {\n    method: 'POST',\n    path: '/observability/metrics/breakdown',\n    summary: 'Get metric breakdown',\n    description: 'Returns metric values grouped by specified dimensions',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_TIME_SERIES: {\n    method: 'POST',\n    path: '/observability/metrics/timeseries',\n    summary: 'Get metric time series',\n    description: 'Returns metric values bucketed by time interval with optional grouping',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_PERCENTILES: {\n    method: 'POST',\n    path: '/observability/metrics/percentiles',\n    summary: 'Get metric percentiles',\n    description: 'Returns percentile values for a metric bucketed by time interval',\n    requiresPermission: 'observability:read',\n  },\n\n  GET_METRIC_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-names',\n    summary: 'Get metric names',\n    description: 'Returns distinct metric names with optional prefix filtering',\n  },\n\n  GET_METRIC_LABEL_KEYS: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-keys',\n    summary: 'Get metric label keys',\n    description: 'Returns distinct label keys for a given metric',\n  },\n\n  GET_METRIC_LABEL_VALUES: {\n    method: 'GET',\n    path: '/observability/discovery/metric-label-values',\n    summary: 'Get label values',\n    description: 'Returns distinct values for a given metric label key',\n  },\n\n  GET_ENTITY_TYPES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-types',\n    summary: 'Get entity types',\n    description: 'Returns distinct entity types from observability data',\n  },\n\n  GET_ENTITY_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/entity-names',\n    summary: 'Get entity names',\n    description: 'Returns distinct entity names with optional type filtering',\n  },\n\n  GET_SERVICE_NAMES: {\n    method: 'GET',\n    path: '/observability/discovery/service-names',\n    summary: 'Get service names',\n    description: 'Returns distinct service names from observability data',\n  },\n\n  GET_ENVIRONMENTS: {\n    method: 'GET',\n    path: '/observability/discovery/environments',\n    summary: 'Get environments',\n    description: 'Returns distinct environments from observability data',\n  },\n\n  GET_TAGS: {\n    method: 'GET',\n    path: '/observability/discovery/tags',\n    summary: 'Get tags',\n    description: 'Returns distinct tags with optional entity type filtering',\n  },\n} as const satisfies Record<string, RouteDetails>;\n\nexport type NewRoutesKey = keyof typeof NEW_ROUTE_DEFS;\nexport type NewRoutesDefinitions = (typeof NEW_ROUTE_DEFS)[NewRoutesKey];\n\nexport function createObservabilityListQuerySchema<\n  TFilter extends z.ZodObject<z.ZodRawShape>,\n  TOrderBy extends z.ZodObject<z.ZodRawShape>,\n>(filterSchema: TFilter, orderBySchema: TOrderBy) {\n  const unwrapDefault = (schema: unknown) => {\n    const zodSchema = schema as z.ZodTypeAny;\n    return zodSchema instanceof z.ZodDefault ? zodSchema.unwrap() : zodSchema;\n  };\n  const paginationShape = paginationArgsSchema.shape as unknown as Record<string, z.ZodTypeAny>;\n  const orderByShape = orderBySchema.shape as unknown as Record<string, z.ZodTypeAny>;\n\n  const pageSchema = unwrapDefault(paginationShape.page);\n  const perPageSchema = unwrapDefault(paginationShape.perPage);\n  const fieldSchema = orderByShape.field ? unwrapDefault(orderByShape.field) : z.never().optional();\n  const directionSchema = orderByShape.direction ? unwrapDefault(orderByShape.direction) : z.never().optional();\n\n  return wrapSchemaForQueryParams(\n    z\n      .object({\n        ...filterSchema.shape,\n        page: pageSchema,\n        perPage: perPageSchema,\n        field: fieldSchema,\n        direction: directionSchema,\n        mode: listModeSchema.optional(),\n        after: deltaCursorSchema.optional(),\n        limit: deltaLimitSchema,\n      })\n      .partial(),\n  ).superRefine((value, ctx) => {\n    const isDelta = value.mode === 'delta';\n    const hasPagination = value.page !== undefined || value.perPage !== undefined;\n    const hasOrderBy = value.field !== undefined || value.direction !== undefined;\n    const hasAfter = value.after !== undefined;\n    const hasLimit = value.limit !== undefined;\n\n    if (isDelta) {\n      if (hasPagination) {\n        if (value.page !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['page'],\n            message: '`page` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.perPage !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['perPage'],\n            message: '`perPage` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      if (hasOrderBy) {\n        if (value.field !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['field'],\n            message: '`field` is not allowed when `mode=delta`',\n          });\n        }\n        if (value.direction !== undefined) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['direction'],\n            message: '`direction` is not allowed when `mode=delta`',\n          });\n        }\n      }\n      return;\n    }\n\n    if (hasAfter) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['after'],\n        message: '`after` is only allowed when `mode=delta`',\n      });\n    }\n    if (hasLimit) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        path: ['limit'],\n        message: '`limit` is only allowed when `mode=delta`',\n      });\n    }\n  });\n}\n"]}