@trigger.dev/core 0.0.0-prerelease-20260909071038 → 0.0.0-prerelease-streamfix-20260909094302

package/dist/esm/v3/schemas/reports.d.ts

@@ -1,26 +1,13 @@
-import { z } from "zod/v4";
+import { z } from "zod";
 /** A positive integer plus `m`, `h`, `d` or `w`, capped at 90d. Reports bucket by whole minutes. */
-export declare const ReportPeriodSchema: z.ZodString;
+export declare const ReportPeriodSchema: z.ZodEffects<z.ZodString, string, string>;
 export type ReportPeriod = z.infer<typeof ReportPeriodSchema>;
 /** The response encodings the endpoint can render. `json` returns a `ReportViewModel`. */
-export declare const ReportFormatSchema: z.ZodEnum<{
-    ansi: "ansi";
-    json: "json";
-    markdown: "markdown";
-}>;
+export declare const ReportFormatSchema: z.ZodEnum<["markdown", "json", "ansi"]>;
 export type ReportFormat = z.infer<typeof ReportFormatSchema>;
-export declare const ReportSeveritySchema: z.ZodEnum<{
-    crit: "crit";
-    ok: "ok";
-    warn: "warn";
-}>;
+export declare const ReportSeveritySchema: z.ZodEnum<["ok", "warn", "crit"]>;
 export type ReportSeverity = z.infer<typeof ReportSeveritySchema>;
-export declare const ReportUnitSchema: z.ZodEnum<{
-    count: "count";
-    ms: "ms";
-    perMin: "perMin";
-    ratio: "ratio";
-}>;
+export declare const ReportUnitSchema: z.ZodEnum<["ms", "count", "ratio", "perMin"]>;
 export type ReportUnit = z.infer<typeof ReportUnitSchema>;
 /** A code resolved to a human string by the renderer's message table. */
 export declare const ReportReasonCodeSchema: z.ZodString;
@@ -29,263 +16,818 @@ export type ReportReasonCode = z.infer<typeof ReportReasonCodeSchema>;
 export declare const ReportLinkKeySchema: z.ZodString;
 export type ReportLinkKey = z.infer<typeof ReportLinkKeySchema>;
 export declare const ReportDeltaSchema: z.ZodObject<{
-    dir: z.ZodEnum<{
-        down: "down";
-        flat: "flat";
-        up: "up";
-    }>;
+    dir: z.ZodEnum<["up", "down", "flat"]>;
+    /** rounded value/normal multiplier; renderer decides whether to print "6×". */
     mult: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    dir: "down" | "flat" | "up";
+    mult?: number | undefined;
+}, {
+    dir: "down" | "flat" | "up";
+    mult?: number | undefined;
+}>;
 export type ReportDelta = z.infer<typeof ReportDeltaSchema>;
 export declare const ReportMetricSeriesSchema: z.ZodObject<{
-    points: z.ZodArray<z.ZodNumber>;
-    kind: z.ZodEnum<{
-        estimated: "estimated";
-        measured: "measured";
-    }>;
-}, z.core.$strip>;
+    points: z.ZodArray<z.ZodNumber, "many">;
+    /** "estimated" = a proxy (e.g. pending backlog), shown informational-only. */
+    kind: z.ZodEnum<["measured", "estimated"]>;
+}, "strip", z.ZodTypeAny, {
+    points: number[];
+    kind: "estimated" | "measured";
+}, {
+    points: number[];
+    kind: "estimated" | "measured";
+}>;
 export type ReportMetricSeries = z.infer<typeof ReportMetricSeriesSchema>;
 export declare const ReportMetricSchema: z.ZodObject<{
+    /** A code, e.g. "start_latency_p95"; the messages map turns it into the label. */
     id: z.ZodString;
     value: z.ZodNumber;
-    unit: z.ZodEnum<{
-        count: "count";
-        ms: "ms";
-        perMin: "perMin";
-        ratio: "ratio";
-    }>;
-    aggregation: z.ZodOptional<z.ZodEnum<{
-        count: "count";
-        p95: "p95";
-        rate: "rate";
-        ratio: "ratio";
-    }>>;
+    unit: z.ZodEnum<["ms", "count", "ratio", "perMin"]>;
+    aggregation: z.ZodOptional<z.ZodEnum<["p95", "rate", "ratio", "count"]>>;
+    /** baseline; renderer formats "(normal ~7s)". */
     normal: z.ZodOptional<z.ZodNumber>;
     delta: z.ZodOptional<z.ZodObject<{
-        dir: z.ZodEnum<{
-            down: "down";
-            flat: "flat";
-            up: "up";
-        }>;
+        dir: z.ZodEnum<["up", "down", "flat"]>;
+        /** rounded value/normal multiplier; renderer decides whether to print "6×". */
         mult: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: "down" | "flat" | "up";
+        mult?: number | undefined;
+    }, {
+        dir: "down" | "flat" | "up";
+        mult?: number | undefined;
+    }>>;
     series: z.ZodOptional<z.ZodObject<{
-        points: z.ZodArray<z.ZodNumber>;
-        kind: z.ZodEnum<{
-            estimated: "estimated";
-            measured: "measured";
-        }>;
-    }, z.core.$strip>>;
+        points: z.ZodArray<z.ZodNumber, "many">;
+        /** "estimated" = a proxy (e.g. pending backlog), shown informational-only. */
+        kind: z.ZodEnum<["measured", "estimated"]>;
+    }, "strip", z.ZodTypeAny, {
+        points: number[];
+        kind: "estimated" | "measured";
+    }, {
+        points: number[];
+        kind: "estimated" | "measured";
+    }>>;
+    /** named sub-values for composite metrics (e.g. throughput { done, triggered }). */
     breakdown: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    /** shown on a cause line INSTEAD of "(normal ~x)", e.g. "pinned 40 of last 60 min". */
     annotation: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         value: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    availability: z.ZodOptional<z.ZodEnum<{
-        measured: "measured";
-        unknown: "unknown";
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        value?: number | undefined;
+    }, {
+        code: string;
+        value?: number | undefined;
     }>>;
-    severity: z.ZodEnum<{
-        crit: "crit";
-        ok: "ok";
-        warn: "warn";
-    }>;
-}, z.core.$strip>;
+    /** "unknown" means `value` is a placeholder a consumer must not read as real. Absent = measured. */
+    availability: z.ZodOptional<z.ZodEnum<["measured", "unknown"]>>;
+    severity: z.ZodEnum<["ok", "warn", "crit"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    value: number;
+    unit: "count" | "ms" | "perMin" | "ratio";
+    aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+    normal?: number | undefined;
+    delta?: {
+        dir: "down" | "flat" | "up";
+        mult?: number | undefined;
+    } | undefined;
+    series?: {
+        points: number[];
+        kind: "estimated" | "measured";
+    } | undefined;
+    breakdown?: Record<string, number> | undefined;
+    annotation?: {
+        code: string;
+        value?: number | undefined;
+    } | undefined;
+    availability?: "measured" | "unknown" | undefined;
+    severity: "crit" | "ok" | "warn";
+}, {
+    id: string;
+    value: number;
+    unit: "count" | "ms" | "perMin" | "ratio";
+    aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+    normal?: number | undefined;
+    delta?: {
+        dir: "down" | "flat" | "up";
+        mult?: number | undefined;
+    } | undefined;
+    series?: {
+        points: number[];
+        kind: "estimated" | "measured";
+    } | undefined;
+    breakdown?: Record<string, number> | undefined;
+    annotation?: {
+        code: string;
+        value?: number | undefined;
+    } | undefined;
+    availability?: "measured" | "unknown" | undefined;
+    severity: "crit" | "ok" | "warn";
+}>;
 export type ReportMetric = z.infer<typeof ReportMetricSchema>;
 export declare const ReportRecommendationSchema: z.ZodObject<{
     code: z.ZodString;
     link: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    link?: string | undefined;
+}, {
+    code: string;
+    link?: string | undefined;
+}>;
 export type ReportRecommendation = z.infer<typeof ReportRecommendationSchema>;
 /** A footer line: an action, or the "do nothing" option (carries value). */
 export declare const ReportFooterEntrySchema: z.ZodObject<{
     code: z.ZodString;
     link: z.ZodOptional<z.ZodString>;
+    /** a computed fact (e.g. drainMinutes), never invented. */
     value: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    link?: string | undefined;
+    value?: number | undefined;
+}, {
+    code: string;
+    link?: string | undefined;
+    value?: number | undefined;
+}>;
 export type ReportFooterEntry = z.infer<typeof ReportFooterEntrySchema>;
 /** A ruled-out cause + its evidence, e.g. "not your code" (never emitted without evidence). */
 export declare const ReportExclusionSchema: z.ZodObject<{
     code: z.ZodString;
     evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    evidence?: Record<string, number> | undefined;
+}, {
+    code: string;
+    evidence?: Record<string, number> | undefined;
+}>;
 export type ReportExclusion = z.infer<typeof ReportExclusionSchema>;
 /** A measured fact backing the verdict. `ReportExclusion` states what the problem isn't. */
 export declare const ReportObservationSchema: z.ZodObject<{
     code: z.ZodString;
     evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    evidence?: Record<string, number> | undefined;
+}, {
+    code: string;
+    evidence?: Record<string, number> | undefined;
+}>;
 export type ReportObservation = z.infer<typeof ReportObservationSchema>;
 export declare const ReportFindingSchema: z.ZodObject<{
+    /** "flow" | "execution" | "liveness" | future "infrastructure" | "billing" */
     type: z.ZodString;
-    severity: z.ZodEnum<{
-        crit: "crit";
-        ok: "ok";
-        warn: "warn";
-    }>;
+    severity: z.ZodEnum<["ok", "warn", "crit"]>;
+    /** Code for the state or cause, e.g. "env_limit_saturation" | "healthy". */
     reason: z.ZodString;
+    /** Code for the "read:" line. Built last, may span findings. */
     read: z.ZodOptional<z.ZodString>;
-    metricIds: z.ZodArray<z.ZodString>;
+    /** metric ids this finding covers, in causal order when degraded. */
+    metricIds: z.ZodArray<z.ZodString, "many">;
+    /** A single primary action. */
     recommendation: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         link: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        link?: string | undefined;
+    }, {
+        code: string;
+        link?: string | undefined;
+    }>>;
+    /** optional parenthetical — same shape as recommendation. */
     hedge: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
         link: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        link?: string | undefined;
+    }, {
+        code: string;
+        link?: string | undefined;
+    }>>;
+    /** contiguous breach window of the driving metric -> "(last 40 min)". */
     anomalyWindow: z.ZodOptional<z.ZodObject<{
         minutes: z.ZodNumber;
         touchesEnd: z.ZodBoolean;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        minutes: number;
+        touchesEnd: boolean;
+    }, {
+        minutes: number;
+        touchesEnd: boolean;
+    }>>;
+    /** Which dimension and key own the problem. `of` is the denominator label the renderer prints. */
     attribution: z.ZodOptional<z.ZodObject<{
         dim: z.ZodString;
         key: z.ZodString;
         share: z.ZodNumber;
         of: z.ZodString;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        dim: string;
+        key: string;
+        share: number;
+        of: string;
+    }, {
+        dim: string;
+        key: string;
+        share: number;
+        of: string;
+    }>>;
+    /** Ruled-out causes and evidence, rendered under the `read:` line. */
     exclusions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    }, z.core.$strip>>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }, {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }>, "many">>;
+    /** Supporting facts, rendered under the `read:` line after the exclusions. */
     observations: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }, {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    severity: "crit" | "ok" | "warn";
+    reason: string;
+    read?: string | undefined;
+    metricIds: string[];
+    recommendation?: {
+        code: string;
+        link?: string | undefined;
+    } | undefined;
+    hedge?: {
+        code: string;
+        link?: string | undefined;
+    } | undefined;
+    anomalyWindow?: {
+        minutes: number;
+        touchesEnd: boolean;
+    } | undefined;
+    attribution?: {
+        dim: string;
+        key: string;
+        share: number;
+        of: string;
+    } | undefined;
+    exclusions?: {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }[] | undefined;
+    observations?: {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }[] | undefined;
+}, {
+    type: string;
+    severity: "crit" | "ok" | "warn";
+    reason: string;
+    read?: string | undefined;
+    metricIds: string[];
+    recommendation?: {
+        code: string;
+        link?: string | undefined;
+    } | undefined;
+    hedge?: {
+        code: string;
+        link?: string | undefined;
+    } | undefined;
+    anomalyWindow?: {
+        minutes: number;
+        touchesEnd: boolean;
+    } | undefined;
+    attribution?: {
+        dim: string;
+        key: string;
+        share: number;
+        of: string;
+    } | undefined;
+    exclusions?: {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }[] | undefined;
+    observations?: {
+        code: string;
+        evidence?: Record<string, number> | undefined;
+    }[] | undefined;
+}>;
 export type ReportFinding = z.infer<typeof ReportFindingSchema>;
 export declare const ReportSummaryStatementSchema: z.ZodObject<{
     findingType: z.ZodString;
-    severity: z.ZodEnum<{
-        crit: "crit";
-        ok: "ok";
-        warn: "warn";
-    }>;
+    severity: z.ZodEnum<["ok", "warn", "crit"]>;
+    /** Renders from (findingType, severity) unless a reason is present. */
     reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    findingType: string;
+    severity: "crit" | "ok" | "warn";
+    reason?: string | undefined;
+}, {
+    findingType: string;
+    severity: "crit" | "ok" | "warn";
+    reason?: string | undefined;
+}>;
 export type ReportSummaryStatement = z.infer<typeof ReportSummaryStatementSchema>;
 export declare const ReportLinkSchema: z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     url: z.ZodString;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    label: string;
+    url: string;
+}, {
+    key: string;
+    label: string;
+    url: string;
+}>;
 export type ReportLink = z.infer<typeof ReportLinkSchema>;
 export declare const ReportViewModelSchema: z.ZodObject<{
+    /** "health" | "cost" | … */
     title: z.ZodString;
+    /** "prod" */
     scope: z.ZodString;
+    /** "last 1h" */
     period: z.ZodString;
+    /** "vs your 7d normal" */
     baselineLabel: z.ZodOptional<z.ZodString>;
+    /** ISO string. Passed in, never read from the clock inside interpret. */
     generatedAt: z.ZodString;
+    /** live window length in minutes — lets the renderer say "of last 60 min". */
     windowMinutes: z.ZodNumber;
     summary: z.ZodObject<{
-        severity: z.ZodEnum<{
-            crit: "crit";
-            ok: "ok";
-            warn: "warn";
-        }>;
+        severity: z.ZodEnum<["ok", "warn", "crit"]>;
         statements: z.ZodArray<z.ZodObject<{
             findingType: z.ZodString;
-            severity: z.ZodEnum<{
-                crit: "crit";
-                ok: "ok";
-                warn: "warn";
-            }>;
+            severity: z.ZodEnum<["ok", "warn", "crit"]>;
+            /** Renders from (findingType, severity) unless a reason is present. */
             reason: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
+        }, "strip", z.ZodTypeAny, {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }, {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        severity: "crit" | "ok" | "warn";
+        statements: {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }[];
+    }, {
+        severity: "crit" | "ok" | "warn";
+        statements: {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }[];
+    }>;
     findings: z.ZodArray<z.ZodObject<{
+        /** "flow" | "execution" | "liveness" | future "infrastructure" | "billing" */
         type: z.ZodString;
-        severity: z.ZodEnum<{
-            crit: "crit";
-            ok: "ok";
-            warn: "warn";
-        }>;
+        severity: z.ZodEnum<["ok", "warn", "crit"]>;
+        /** Code for the state or cause, e.g. "env_limit_saturation" | "healthy". */
         reason: z.ZodString;
+        /** Code for the "read:" line. Built last, may span findings. */
         read: z.ZodOptional<z.ZodString>;
-        metricIds: z.ZodArray<z.ZodString>;
+        /** metric ids this finding covers, in causal order when degraded. */
+        metricIds: z.ZodArray<z.ZodString, "many">;
+        /** A single primary action. */
         recommendation: z.ZodOptional<z.ZodObject<{
             code: z.ZodString;
             link: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            link?: string | undefined;
+        }, {
+            code: string;
+            link?: string | undefined;
+        }>>;
+        /** optional parenthetical — same shape as recommendation. */
         hedge: z.ZodOptional<z.ZodObject<{
             code: z.ZodString;
             link: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            link?: string | undefined;
+        }, {
+            code: string;
+            link?: string | undefined;
+        }>>;
+        /** contiguous breach window of the driving metric -> "(last 40 min)". */
         anomalyWindow: z.ZodOptional<z.ZodObject<{
             minutes: z.ZodNumber;
             touchesEnd: z.ZodBoolean;
-        }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            minutes: number;
+            touchesEnd: boolean;
+        }, {
+            minutes: number;
+            touchesEnd: boolean;
+        }>>;
+        /** Which dimension and key own the problem. `of` is the denominator label the renderer prints. */
         attribution: z.ZodOptional<z.ZodObject<{
             dim: z.ZodString;
             key: z.ZodString;
             share: z.ZodNumber;
             of: z.ZodString;
-        }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        }, {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        }>>;
+        /** Ruled-out causes and evidence, rendered under the `read:` line. */
         exclusions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        }, z.core.$strip>>>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }, {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }>, "many">>;
+        /** Supporting facts, rendered under the `read:` line after the exclusions. */
         observations: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }, {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        severity: "crit" | "ok" | "warn";
+        reason: string;
+        read?: string | undefined;
+        metricIds: string[];
+        recommendation?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        hedge?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        anomalyWindow?: {
+            minutes: number;
+            touchesEnd: boolean;
+        } | undefined;
+        attribution?: {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        } | undefined;
+        exclusions?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+        observations?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+    }, {
+        type: string;
+        severity: "crit" | "ok" | "warn";
+        reason: string;
+        read?: string | undefined;
+        metricIds: string[];
+        recommendation?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        hedge?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        anomalyWindow?: {
+            minutes: number;
+            touchesEnd: boolean;
+        } | undefined;
+        attribution?: {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        } | undefined;
+        exclusions?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+        observations?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+    }>, "many">;
     metrics: z.ZodArray<z.ZodObject<{
+        /** A code, e.g. "start_latency_p95"; the messages map turns it into the label. */
         id: z.ZodString;
         value: z.ZodNumber;
-        unit: z.ZodEnum<{
-            count: "count";
-            ms: "ms";
-            perMin: "perMin";
-            ratio: "ratio";
-        }>;
-        aggregation: z.ZodOptional<z.ZodEnum<{
-            count: "count";
-            p95: "p95";
-            rate: "rate";
-            ratio: "ratio";
-        }>>;
+        unit: z.ZodEnum<["ms", "count", "ratio", "perMin"]>;
+        aggregation: z.ZodOptional<z.ZodEnum<["p95", "rate", "ratio", "count"]>>;
+        /** baseline; renderer formats "(normal ~7s)". */
         normal: z.ZodOptional<z.ZodNumber>;
         delta: z.ZodOptional<z.ZodObject<{
-            dir: z.ZodEnum<{
-                down: "down";
-                flat: "flat";
-                up: "up";
-            }>;
+            dir: z.ZodEnum<["up", "down", "flat"]>;
+            /** rounded value/normal multiplier; renderer decides whether to print "6×". */
             mult: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, "strip", z.ZodTypeAny, {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        }, {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        }>>;
         series: z.ZodOptional<z.ZodObject<{
-            points: z.ZodArray<z.ZodNumber>;
-            kind: z.ZodEnum<{
-                estimated: "estimated";
-                measured: "measured";
-            }>;
-        }, z.core.$strip>>;
+            points: z.ZodArray<z.ZodNumber, "many">;
+            /** "estimated" = a proxy (e.g. pending backlog), shown informational-only. */
+            kind: z.ZodEnum<["measured", "estimated"]>;
+        }, "strip", z.ZodTypeAny, {
+            points: number[];
+            kind: "estimated" | "measured";
+        }, {
+            points: number[];
+            kind: "estimated" | "measured";
+        }>>;
+        /** named sub-values for composite metrics (e.g. throughput { done, triggered }). */
         breakdown: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        /** shown on a cause line INSTEAD of "(normal ~x)", e.g. "pinned 40 of last 60 min". */
         annotation: z.ZodOptional<z.ZodObject<{
             code: z.ZodString;
             value: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        availability: z.ZodOptional<z.ZodEnum<{
-            measured: "measured";
-            unknown: "unknown";
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            value?: number | undefined;
+        }, {
+            code: string;
+            value?: number | undefined;
         }>>;
-        severity: z.ZodEnum<{
-            crit: "crit";
-            ok: "ok";
-            warn: "warn";
-        }>;
-    }, z.core.$strip>>;
+        /** "unknown" means `value` is a placeholder a consumer must not read as real. Absent = measured. */
+        availability: z.ZodOptional<z.ZodEnum<["measured", "unknown"]>>;
+        severity: z.ZodEnum<["ok", "warn", "crit"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        value: number;
+        unit: "count" | "ms" | "perMin" | "ratio";
+        aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+        normal?: number | undefined;
+        delta?: {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        } | undefined;
+        series?: {
+            points: number[];
+            kind: "estimated" | "measured";
+        } | undefined;
+        breakdown?: Record<string, number> | undefined;
+        annotation?: {
+            code: string;
+            value?: number | undefined;
+        } | undefined;
+        availability?: "measured" | "unknown" | undefined;
+        severity: "crit" | "ok" | "warn";
+    }, {
+        id: string;
+        value: number;
+        unit: "count" | "ms" | "perMin" | "ratio";
+        aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+        normal?: number | undefined;
+        delta?: {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        } | undefined;
+        series?: {
+            points: number[];
+            kind: "estimated" | "measured";
+        } | undefined;
+        breakdown?: Record<string, number> | undefined;
+        annotation?: {
+            code: string;
+            value?: number | undefined;
+        } | undefined;
+        availability?: "measured" | "unknown" | undefined;
+        severity: "crit" | "ok" | "warn";
+    }>, "many">;
+    /** dense structured payload for agents. */
     facts: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     links: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         label: z.ZodString;
         url: z.ZodString;
-    }, z.core.$strip>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        label: string;
+        url: string;
+    }, {
+        key: string;
+        label: string;
+        url: string;
+    }>, "many">;
+    /** dominant finding's action + optional "do nothing" option. Max two entries. */
     footer: z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         link: z.ZodOptional<z.ZodString>;
+        /** a computed fact (e.g. drainMinutes), never invented. */
         value: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        link?: string | undefined;
+        value?: number | undefined;
+    }, {
+        code: string;
+        link?: string | undefined;
+        value?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    scope: string;
+    period: string;
+    baselineLabel?: string | undefined;
+    generatedAt: string;
+    windowMinutes: number;
+    summary: {
+        severity: "crit" | "ok" | "warn";
+        statements: {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }[];
+    };
+    findings: {
+        type: string;
+        severity: "crit" | "ok" | "warn";
+        reason: string;
+        read?: string | undefined;
+        metricIds: string[];
+        recommendation?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        hedge?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        anomalyWindow?: {
+            minutes: number;
+            touchesEnd: boolean;
+        } | undefined;
+        attribution?: {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        } | undefined;
+        exclusions?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+        observations?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+    }[];
+    metrics: {
+        id: string;
+        value: number;
+        unit: "count" | "ms" | "perMin" | "ratio";
+        aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+        normal?: number | undefined;
+        delta?: {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        } | undefined;
+        series?: {
+            points: number[];
+            kind: "estimated" | "measured";
+        } | undefined;
+        breakdown?: Record<string, number> | undefined;
+        annotation?: {
+            code: string;
+            value?: number | undefined;
+        } | undefined;
+        availability?: "measured" | "unknown" | undefined;
+        severity: "crit" | "ok" | "warn";
+    }[];
+    facts: Record<string, unknown>;
+    links: {
+        key: string;
+        label: string;
+        url: string;
+    }[];
+    footer: {
+        code: string;
+        link?: string | undefined;
+        value?: number | undefined;
+    }[];
+}, {
+    title: string;
+    scope: string;
+    period: string;
+    baselineLabel?: string | undefined;
+    generatedAt: string;
+    windowMinutes: number;
+    summary: {
+        severity: "crit" | "ok" | "warn";
+        statements: {
+            findingType: string;
+            severity: "crit" | "ok" | "warn";
+            reason?: string | undefined;
+        }[];
+    };
+    findings: {
+        type: string;
+        severity: "crit" | "ok" | "warn";
+        reason: string;
+        read?: string | undefined;
+        metricIds: string[];
+        recommendation?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        hedge?: {
+            code: string;
+            link?: string | undefined;
+        } | undefined;
+        anomalyWindow?: {
+            minutes: number;
+            touchesEnd: boolean;
+        } | undefined;
+        attribution?: {
+            dim: string;
+            key: string;
+            share: number;
+            of: string;
+        } | undefined;
+        exclusions?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+        observations?: {
+            code: string;
+            evidence?: Record<string, number> | undefined;
+        }[] | undefined;
+    }[];
+    metrics: {
+        id: string;
+        value: number;
+        unit: "count" | "ms" | "perMin" | "ratio";
+        aggregation?: "count" | "p95" | "rate" | "ratio" | undefined;
+        normal?: number | undefined;
+        delta?: {
+            dir: "down" | "flat" | "up";
+            mult?: number | undefined;
+        } | undefined;
+        series?: {
+            points: number[];
+            kind: "estimated" | "measured";
+        } | undefined;
+        breakdown?: Record<string, number> | undefined;
+        annotation?: {
+            code: string;
+            value?: number | undefined;
+        } | undefined;
+        availability?: "measured" | "unknown" | undefined;
+        severity: "crit" | "ok" | "warn";
+    }[];
+    facts: Record<string, unknown>;
+    links: {
+        key: string;
+        label: string;
+        url: string;
+    }[];
+    footer: {
+        code: string;
+        link?: string | undefined;
+        value?: number | undefined;
+    }[];
+}>;
 export type ReportViewModel = z.infer<typeof ReportViewModelSchema>;