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

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

@@ -56,6 +56,69 @@ declare const paginationInfoSchema: z.ZodObject<{
     perPage: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>;
     hasMore: z.ZodBoolean;
 }, z.core.$strip>;
+/** Opaque cursor used to resume incremental polling for observability list endpoints. */
+declare const deltaCursorSchema: z.ZodString;
+/** Public delta cursor type used across observability list endpoints. */
+type DeltaCursor = z.output<typeof deltaCursorSchema>;
+/** Explicit list mode selector for observability list endpoints. */
+declare const listModeSchema: z.ZodEnum<{
+    page: "page";
+    delta: "delta";
+}>;
+/** Max number of updates returned from a delta poll window. */
+declare const deltaLimitSchema: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+/** Default page-mode pagination used to preserve legacy list arg behavior. */
+declare const defaultPaginationArgs: {
+    readonly page: 0;
+    readonly perPage: 10;
+};
+/** Default number of updates returned when delta mode does not specify a limit. */
+declare const defaultDeltaLimit = 10;
+type ObservabilityListModeValue<TFilters, TOrderBy> = {
+    mode?: z.output<typeof listModeSchema>;
+    filters?: TFilters;
+    pagination?: {
+        page: number;
+        perPage: number;
+    };
+    orderBy?: TOrderBy;
+    after?: DeltaCursor;
+    limit?: number;
+};
+type ObservabilityListDefaults<TOrderBy> = {
+    orderBy: TOrderBy;
+    pagination?: {
+        page: number;
+        perPage: number;
+    };
+    limit?: number;
+};
+type NormalizedObservabilityListArgs<TFilters, TOrderBy> = {
+    mode: 'page' | 'delta';
+    filters: TFilters | undefined;
+    pagination: {
+        page: number;
+        perPage: number;
+    };
+    orderBy: TOrderBy;
+    after: DeltaCursor | undefined;
+    limit: number;
+};
+/**
+ * Enforces the shared page-vs-delta parameter rules for observability list endpoints.
+ * Keeps validation centralized while allowing endpoints to keep their own filters and orderBy schemas.
+ */
+declare function refineObservabilityListMode<TFilters, TOrderBy>(value: ObservabilityListModeValue<TFilters, TOrderBy>, ctx: z.core.$RefinementCtx): void;
+/**
+ * Normalizes observability list args into the legacy-friendly shape expected by existing stores.
+ * Page mode remains the default, and pagination/orderBy/limit are always populated.
+ */
+declare function normalizeObservabilityListArgs<TFilters, TOrderBy>(value: ObservabilityListModeValue<TFilters, TOrderBy>, defaults: ObservabilityListDefaults<TOrderBy>): NormalizedObservabilityListArgs<TFilters, TOrderBy>;
+/** Metadata returned for a delta poll window. */
+declare const deltaInfoSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>;
 /**
  * Date range for filtering by time
  * Uses z.coerce to handle ISO string → Date conversion from query params
@@ -478,7 +541,11 @@ declare const logsOrderBySchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 /** Schema for listLogs operation arguments */
-declare const listLogsArgsSchema: z.ZodObject<{
+declare const listLogsArgsSchema: z.ZodPipe<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        delta: "delta";
+    }>>;
     filters: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
         level: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
@@ -524,11 +591,11 @@ declare const listLogsArgsSchema: z.ZodObject<{
         executionSource: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    pagination: z.ZodDefault<z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         perPage: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
-    orderBy: z.ZodDefault<z.ZodObject<{
+    orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodDefault<z.ZodEnum<{
             timestamp: "timestamp";
         }>>;
@@ -537,17 +604,114 @@ declare const listLogsArgsSchema: z.ZodObject<{
             DESC: "DESC";
         }>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>, z.ZodTransform<{
+    mode: "page" | "delta";
+    filters: {
+        source?: string | undefined;
+        level?: "error" | "debug" | "info" | "warn" | "fatal" | ("error" | "debug" | "info" | "warn" | "fatal")[] | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination: {
+        page: number;
+        perPage: number;
+    };
+    orderBy: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    };
+    after: DeltaCursor | undefined;
+    limit: number;
+}, {
+    mode?: "page" | "delta" | undefined;
+    filters?: {
+        source?: string | undefined;
+        level?: "error" | "debug" | "info" | "warn" | "fatal" | ("error" | "debug" | "info" | "warn" | "fatal")[] | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination?: {
+        page: number;
+        perPage: number;
+    } | undefined;
+    orderBy?: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    } | undefined;
+    after?: string | undefined;
+    limit?: number | undefined;
+}>>;
 /** Arguments for listing logs */
 type ListLogsArgs = z.input<typeof listLogsArgsSchema>;
 /** Schema for listLogs operation response */
 declare const listLogsResponseSchema: z.ZodObject<{
-    pagination: z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         total: z.ZodNumber;
         page: z.ZodNumber;
         perPage: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>;
         hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
+    delta: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>>;
+    deltaCursor: z.ZodOptional<z.ZodString>;
     logs: z.ZodArray<z.ZodObject<{
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -895,8 +1059,11 @@ declare const scoresOrderBySchema: z.ZodObject<{
         DESC: "DESC";
     }>>;
 }, z.core.$strip>;
-/** Schema for listScores operation arguments */
-declare const listScoresArgsSchema: z.ZodObject<{
+declare const listScoresArgsSchema: z.ZodPipe<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        delta: "delta";
+    }>>;
     filters: z.ZodOptional<z.ZodObject<{
         scorerId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         scoreSource: z.ZodOptional<z.ZodString>;
@@ -931,11 +1098,11 @@ declare const listScoresArgsSchema: z.ZodObject<{
         executionSource: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    pagination: z.ZodDefault<z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         perPage: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
-    orderBy: z.ZodDefault<z.ZodObject<{
+    orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodDefault<z.ZodEnum<{
             timestamp: "timestamp";
             score: "score";
@@ -945,17 +1112,116 @@ declare const listScoresArgsSchema: z.ZodObject<{
             DESC: "DESC";
         }>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>, z.ZodTransform<{
+    mode: "page" | "delta";
+    filters: {
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        source?: string | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination: {
+        page: number;
+        perPage: number;
+    };
+    orderBy: {
+        field: "timestamp" | "score";
+        direction: "ASC" | "DESC";
+    };
+    after: DeltaCursor | undefined;
+    limit: number;
+}, {
+    mode?: "page" | "delta" | undefined;
+    filters?: {
+        scorerId?: string | string[] | undefined;
+        scoreSource?: string | undefined;
+        source?: string | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination?: {
+        page: number;
+        perPage: number;
+    } | undefined;
+    orderBy?: {
+        field: "timestamp" | "score";
+        direction: "ASC" | "DESC";
+    } | undefined;
+    after?: string | undefined;
+    limit?: number | undefined;
+}>>;
 /** Arguments for listing scores */
 type ListScoresArgs = z.input<typeof listScoresArgsSchema>;
 /** Schema for listScores operation response */
 declare const listScoresResponseSchema: z.ZodObject<{
-    pagination: z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         total: z.ZodNumber;
         page: z.ZodNumber;
         perPage: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>;
         hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
+    delta: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>>;
+    deltaCursor: z.ZodOptional<z.ZodString>;
     scores: z.ZodArray<z.ZodObject<{
         scoreTraceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -1523,8 +1789,11 @@ declare const feedbackOrderBySchema: z.ZodObject<{
         DESC: "DESC";
     }>>;
 }, z.core.$strip>;
-/** Schema for listFeedback operation arguments */
-declare const listFeedbackArgsSchema: z.ZodObject<{
+declare const listFeedbackArgsSchema: z.ZodPipe<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        delta: "delta";
+    }>>;
     filters: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
         feedbackType: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         feedbackSource: z.ZodOptional<z.ZodString>;
@@ -1560,11 +1829,11 @@ declare const listFeedbackArgsSchema: z.ZodObject<{
         executionSource: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
-    pagination: z.ZodDefault<z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         perPage: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
-    orderBy: z.ZodDefault<z.ZodObject<{
+    orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodDefault<z.ZodEnum<{
             timestamp: "timestamp";
         }>>;
@@ -1573,17 +1842,118 @@ declare const listFeedbackArgsSchema: z.ZodObject<{
             DESC: "DESC";
         }>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>, z.ZodTransform<{
+    mode: "page" | "delta";
+    filters: {
+        feedbackType?: string | string[] | undefined;
+        feedbackSource?: string | undefined;
+        source?: string | undefined;
+        feedbackUserId?: string | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination: {
+        page: number;
+        perPage: number;
+    };
+    orderBy: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    };
+    after: DeltaCursor | undefined;
+    limit: number;
+}, {
+    mode?: "page" | "delta" | undefined;
+    filters?: {
+        feedbackType?: string | string[] | undefined;
+        feedbackSource?: string | undefined;
+        source?: string | undefined;
+        feedbackUserId?: string | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination?: {
+        page: number;
+        perPage: number;
+    } | undefined;
+    orderBy?: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    } | undefined;
+    after?: string | undefined;
+    limit?: number | undefined;
+}>>;
 /** Arguments for listing feedback */
 type ListFeedbackArgs = z.input<typeof listFeedbackArgsSchema>;
 /** Schema for listFeedback operation response */
 declare const listFeedbackResponseSchema: z.ZodObject<{
-    pagination: z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         total: z.ZodNumber;
         page: z.ZodNumber;
         perPage: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>;
         hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
+    delta: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>>;
+    deltaCursor: z.ZodOptional<z.ZodString>;
     feedback: z.ZodArray<z.ZodObject<{
         sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -2102,8 +2472,11 @@ declare const metricsOrderBySchema: z.ZodObject<{
         DESC: "DESC";
     }>>;
 }, z.core.$strip>;
-/** Schema for listMetrics operation arguments */
-declare const listMetricsArgsSchema: z.ZodObject<{
+declare const listMetricsArgsSchema: z.ZodPipe<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        delta: "delta";
+    }>>;
     filters: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodArray<z.ZodString>>;
         source: z.ZodOptional<z.ZodString>;
@@ -2141,11 +2514,11 @@ declare const listMetricsArgsSchema: z.ZodObject<{
         executionSource: z.ZodOptional<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
-    pagination: z.ZodDefault<z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
         perPage: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
-    orderBy: z.ZodDefault<z.ZodObject<{
+    orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodDefault<z.ZodEnum<{
             timestamp: "timestamp";
         }>>;
@@ -2154,17 +2527,122 @@ declare const listMetricsArgsSchema: z.ZodObject<{
             DESC: "DESC";
         }>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>, z.ZodTransform<{
+    mode: "page" | "delta";
+    filters: {
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination: {
+        page: number;
+        perPage: number;
+    };
+    orderBy: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    };
+    after: DeltaCursor | undefined;
+    limit: number;
+}, {
+    mode?: "page" | "delta" | undefined;
+    filters?: {
+        name?: string[] | undefined;
+        source?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        costUnit?: string | undefined;
+        labels?: Record<string, string> | undefined;
+        timestamp?: {
+            start?: Date | undefined;
+            end?: Date | undefined;
+            startExclusive?: boolean | undefined;
+            endExclusive?: boolean | undefined;
+        } | undefined;
+        traceId?: string | undefined;
+        spanId?: string | undefined;
+        entityType?: EntityType | undefined;
+        entityName?: string | undefined;
+        entityVersionId?: string | undefined;
+        parentEntityVersionId?: string | undefined;
+        rootEntityVersionId?: string | undefined;
+        userId?: string | undefined;
+        organizationId?: string | undefined;
+        experimentId?: string | undefined;
+        serviceName?: string | undefined;
+        environment?: string | undefined;
+        parentEntityType?: EntityType | undefined;
+        parentEntityName?: string | undefined;
+        rootEntityType?: EntityType | undefined;
+        rootEntityName?: string | undefined;
+        resourceId?: string | undefined;
+        runId?: string | undefined;
+        sessionId?: string | undefined;
+        threadId?: string | undefined;
+        requestId?: string | undefined;
+        executionSource?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    pagination?: {
+        page: number;
+        perPage: number;
+    } | undefined;
+    orderBy?: {
+        field: "timestamp";
+        direction: "ASC" | "DESC";
+    } | undefined;
+    after?: string | undefined;
+    limit?: number | undefined;
+}>>;
 /** Arguments for listing metrics */
 type ListMetricsArgs = z.input<typeof listMetricsArgsSchema>;
 /** Schema for listMetrics operation response */
 declare const listMetricsResponseSchema: z.ZodObject<{
-    pagination: z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
         total: z.ZodNumber;
         page: z.ZodNumber;
         perPage: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<false>]>;
         hasMore: z.ZodBoolean;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
+    delta: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>>;
+    deltaCursor: z.ZodOptional<z.ZodString>;
     metrics: z.ZodArray<z.ZodObject<{
         source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2605,4 +3083,4 @@ declare const getTagsResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type GetTagsResponse = z.infer<typeof getTagsResponseSchema>;
 
-export { type AggregationInterval, type AggregationType, type BatchCreateFeedbackArgs, type BatchCreateLogsArgs, type BatchCreateMetricsArgs, type BatchCreateScoresArgs, type ComparePeriod, type CreateFeedbackArgs, type CreateFeedbackBody, type CreateFeedbackRecord, type CreateFeedbackResponse, type CreateLogRecord, type CreateMetricRecord, type CreateScoreArgs, type CreateScoreBody, type CreateScoreRecord, type CreateScoreResponse, type DateRange, EntityType, type FeedbackFilter, type FeedbackInput, type FeedbackRecord, type GetEntityNamesArgs, type GetEntityNamesResponse, type GetEntityTypesArgs, type GetEntityTypesResponse, type GetEnvironmentsArgs, type GetEnvironmentsResponse, type GetFeedbackAggregateArgs, type GetFeedbackAggregateResponse, type GetFeedbackBreakdownArgs, type GetFeedbackBreakdownResponse, type GetFeedbackPercentilesArgs, type GetFeedbackPercentilesResponse, type GetFeedbackTimeSeriesArgs, type GetFeedbackTimeSeriesResponse, type GetMetricAggregateArgs, type GetMetricAggregateResponse, type GetMetricBreakdownArgs, type GetMetricBreakdownResponse, type GetMetricLabelKeysArgs, type GetMetricLabelKeysResponse, type GetMetricLabelValuesArgs, type GetMetricLabelValuesResponse, type GetMetricNamesArgs, type GetMetricNamesResponse, type GetMetricPercentilesArgs, type GetMetricPercentilesResponse, type GetMetricTimeSeriesArgs, type GetMetricTimeSeriesResponse, type GetScoreAggregateArgs, type GetScoreAggregateResponse, type GetScoreBreakdownArgs, type GetScoreBreakdownResponse, type GetScorePercentilesArgs, type GetScorePercentilesResponse, type GetScoreTimeSeriesArgs, type GetScoreTimeSeriesResponse, type GetServiceNamesArgs, type GetServiceNamesResponse, type GetTagsArgs, type GetTagsResponse, type GroupBy, type ListFeedbackArgs, type ListFeedbackResponse, type ListLogsArgs, type ListLogsResponse, type ListMetricsArgs, type ListMetricsResponse, type ListScoresArgs, type ListScoresResponse, type LogRecord, type LogRecordInput, type LogsFilter, METRIC_DISTINCT_COLUMNS, type MetricDistinctColumn, type MetricInput, type MetricRecord, type MetricsAggregation, type MetricsFilter, type PaginationArgs, type Percentiles, type ScoreInput, type ScoreRecord, type ScoresFilter, aggregateResponseFields, aggregatedValueField, aggregationIntervalSchema, aggregationTypeSchema, batchCreateFeedbackArgsSchema, batchCreateLogsArgsSchema, batchCreateMetricsArgsSchema, batchCreateScoresArgsSchema, bucketTimestampField, commonFilterFields, comparePeriodSchema, contextFields, createFeedbackArgsSchema, createFeedbackBodySchema, createFeedbackRecordSchema, createFeedbackResponseSchema, createLogRecordSchema, createMetricRecordSchema, createScoreArgsSchema, createScoreBodySchema, createScoreRecordSchema, createScoreResponseSchema, createdAtField, dateRangeSchema, dbTimestamps, dimensionsField, distinctColumnSchema, entityIdField, entityNameField, entityTypeField, entityVersionIdField, environmentField, executionSourceField, experimentIdField, feedbackFilterSchema, feedbackInputSchema, feedbackOrderByFieldSchema, feedbackOrderBySchema, feedbackRecordSchema, getEntityNamesArgsSchema, getEntityNamesResponseSchema, getEntityTypesArgsSchema, getEntityTypesResponseSchema, getEnvironmentsArgsSchema, getEnvironmentsResponseSchema, getFeedbackAggregateArgsSchema, getFeedbackAggregateResponseSchema, getFeedbackBreakdownArgsSchema, getFeedbackBreakdownResponseSchema, getFeedbackPercentilesArgsSchema, getFeedbackPercentilesResponseSchema, getFeedbackTimeSeriesArgsSchema, getFeedbackTimeSeriesResponseSchema, getMetricAggregateArgsSchema, getMetricAggregateResponseSchema, getMetricBreakdownArgsSchema, getMetricBreakdownResponseSchema, getMetricLabelKeysArgsSchema, getMetricLabelKeysResponseSchema, getMetricLabelValuesArgsSchema, getMetricLabelValuesResponseSchema, getMetricNamesArgsSchema, getMetricNamesResponseSchema, getMetricPercentilesArgsSchema, getMetricPercentilesResponseSchema, getMetricTimeSeriesArgsSchema, getMetricTimeSeriesResponseSchema, getScoreAggregateArgsSchema, getScoreAggregateResponseSchema, getScoreBreakdownArgsSchema, getScoreBreakdownResponseSchema, getScorePercentilesArgsSchema, getScorePercentilesResponseSchema, getScoreTimeSeriesArgsSchema, getScoreTimeSeriesResponseSchema, getServiceNamesArgsSchema, getServiceNamesResponseSchema, getTagsArgsSchema, getTagsResponseSchema, groupBySchema, listFeedbackArgsSchema, listFeedbackResponseSchema, listLogsArgsSchema, listLogsResponseSchema, listMetricsArgsSchema, listMetricsResponseSchema, listScoresArgsSchema, listScoresResponseSchema, logLevelSchema, logRecordInputSchema, logRecordSchema, logsFilterSchema, logsOrderByFieldSchema, logsOrderBySchema, metadataField, metricInputSchema, metricRecordSchema, metricTypeSchema, metricsAggregationSchema, metricsFilterSchema, metricsOrderByFieldSchema, metricsOrderBySchema, organizationIdField, paginationArgsSchema, paginationInfoSchema, parentEntityIdField, parentEntityNameField, parentEntityTypeField, parentEntityVersionIdField, percentileBucketValueField, percentileField, percentilesSchema, requestIdField, resourceIdField, rootEntityIdField, rootEntityNameField, rootEntityTypeField, rootEntityVersionIdField, runIdField, scopeField, scoreInputSchema, scoreRecordSchema, scoresFilterSchema, scoresOrderByFieldSchema, scoresOrderBySchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanContextFields, spanIdField, tagsField, threadIdField, traceIdField, updatedAtField, userIdField };
+export { type AggregationInterval, type AggregationType, type BatchCreateFeedbackArgs, type BatchCreateLogsArgs, type BatchCreateMetricsArgs, type BatchCreateScoresArgs, type ComparePeriod, type CreateFeedbackArgs, type CreateFeedbackBody, type CreateFeedbackRecord, type CreateFeedbackResponse, type CreateLogRecord, type CreateMetricRecord, type CreateScoreArgs, type CreateScoreBody, type CreateScoreRecord, type CreateScoreResponse, type DateRange, type DeltaCursor, EntityType, type FeedbackFilter, type FeedbackInput, type FeedbackRecord, type GetEntityNamesArgs, type GetEntityNamesResponse, type GetEntityTypesArgs, type GetEntityTypesResponse, type GetEnvironmentsArgs, type GetEnvironmentsResponse, type GetFeedbackAggregateArgs, type GetFeedbackAggregateResponse, type GetFeedbackBreakdownArgs, type GetFeedbackBreakdownResponse, type GetFeedbackPercentilesArgs, type GetFeedbackPercentilesResponse, type GetFeedbackTimeSeriesArgs, type GetFeedbackTimeSeriesResponse, type GetMetricAggregateArgs, type GetMetricAggregateResponse, type GetMetricBreakdownArgs, type GetMetricBreakdownResponse, type GetMetricLabelKeysArgs, type GetMetricLabelKeysResponse, type GetMetricLabelValuesArgs, type GetMetricLabelValuesResponse, type GetMetricNamesArgs, type GetMetricNamesResponse, type GetMetricPercentilesArgs, type GetMetricPercentilesResponse, type GetMetricTimeSeriesArgs, type GetMetricTimeSeriesResponse, type GetScoreAggregateArgs, type GetScoreAggregateResponse, type GetScoreBreakdownArgs, type GetScoreBreakdownResponse, type GetScorePercentilesArgs, type GetScorePercentilesResponse, type GetScoreTimeSeriesArgs, type GetScoreTimeSeriesResponse, type GetServiceNamesArgs, type GetServiceNamesResponse, type GetTagsArgs, type GetTagsResponse, type GroupBy, type ListFeedbackArgs, type ListFeedbackResponse, type ListLogsArgs, type ListLogsResponse, type ListMetricsArgs, type ListMetricsResponse, type ListScoresArgs, type ListScoresResponse, type LogRecord, type LogRecordInput, type LogsFilter, METRIC_DISTINCT_COLUMNS, type MetricDistinctColumn, type MetricInput, type MetricRecord, type MetricsAggregation, type MetricsFilter, type PaginationArgs, type Percentiles, type ScoreInput, type ScoreRecord, type ScoresFilter, aggregateResponseFields, aggregatedValueField, aggregationIntervalSchema, aggregationTypeSchema, batchCreateFeedbackArgsSchema, batchCreateLogsArgsSchema, batchCreateMetricsArgsSchema, batchCreateScoresArgsSchema, bucketTimestampField, commonFilterFields, comparePeriodSchema, contextFields, createFeedbackArgsSchema, createFeedbackBodySchema, createFeedbackRecordSchema, createFeedbackResponseSchema, createLogRecordSchema, createMetricRecordSchema, createScoreArgsSchema, createScoreBodySchema, createScoreRecordSchema, createScoreResponseSchema, createdAtField, dateRangeSchema, dbTimestamps, defaultDeltaLimit, defaultPaginationArgs, deltaCursorSchema, deltaInfoSchema, deltaLimitSchema, dimensionsField, distinctColumnSchema, entityIdField, entityNameField, entityTypeField, entityVersionIdField, environmentField, executionSourceField, experimentIdField, feedbackFilterSchema, feedbackInputSchema, feedbackOrderByFieldSchema, feedbackOrderBySchema, feedbackRecordSchema, getEntityNamesArgsSchema, getEntityNamesResponseSchema, getEntityTypesArgsSchema, getEntityTypesResponseSchema, getEnvironmentsArgsSchema, getEnvironmentsResponseSchema, getFeedbackAggregateArgsSchema, getFeedbackAggregateResponseSchema, getFeedbackBreakdownArgsSchema, getFeedbackBreakdownResponseSchema, getFeedbackPercentilesArgsSchema, getFeedbackPercentilesResponseSchema, getFeedbackTimeSeriesArgsSchema, getFeedbackTimeSeriesResponseSchema, getMetricAggregateArgsSchema, getMetricAggregateResponseSchema, getMetricBreakdownArgsSchema, getMetricBreakdownResponseSchema, getMetricLabelKeysArgsSchema, getMetricLabelKeysResponseSchema, getMetricLabelValuesArgsSchema, getMetricLabelValuesResponseSchema, getMetricNamesArgsSchema, getMetricNamesResponseSchema, getMetricPercentilesArgsSchema, getMetricPercentilesResponseSchema, getMetricTimeSeriesArgsSchema, getMetricTimeSeriesResponseSchema, getScoreAggregateArgsSchema, getScoreAggregateResponseSchema, getScoreBreakdownArgsSchema, getScoreBreakdownResponseSchema, getScorePercentilesArgsSchema, getScorePercentilesResponseSchema, getScoreTimeSeriesArgsSchema, getScoreTimeSeriesResponseSchema, getServiceNamesArgsSchema, getServiceNamesResponseSchema, getTagsArgsSchema, getTagsResponseSchema, groupBySchema, listFeedbackArgsSchema, listFeedbackResponseSchema, listLogsArgsSchema, listLogsResponseSchema, listMetricsArgsSchema, listMetricsResponseSchema, listModeSchema, listScoresArgsSchema, listScoresResponseSchema, logLevelSchema, logRecordInputSchema, logRecordSchema, logsFilterSchema, logsOrderByFieldSchema, logsOrderBySchema, metadataField, metricInputSchema, metricRecordSchema, metricTypeSchema, metricsAggregationSchema, metricsFilterSchema, metricsOrderByFieldSchema, metricsOrderBySchema, normalizeObservabilityListArgs, organizationIdField, paginationArgsSchema, paginationInfoSchema, parentEntityIdField, parentEntityNameField, parentEntityTypeField, parentEntityVersionIdField, percentileBucketValueField, percentileField, percentilesSchema, refineObservabilityListMode, requestIdField, resourceIdField, rootEntityIdField, rootEntityNameField, rootEntityTypeField, rootEntityVersionIdField, runIdField, scopeField, scoreInputSchema, scoreRecordSchema, scoresFilterSchema, scoresOrderByFieldSchema, scoresOrderBySchema, serviceNameField, sessionIdField, sortDirectionSchema, sourceField, spanContextFields, spanIdField, tagsField, threadIdField, traceIdField, updatedAtField, userIdField };