@trigger.dev/core 4.5.9 → 4.5.11

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

@@ -0,0 +1,833 @@
+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.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<["markdown", "json", "ansi"]>;
+export type ReportFormat = z.infer<typeof ReportFormatSchema>;
+export declare const ReportSeveritySchema: z.ZodEnum<["ok", "warn", "crit"]>;
+export type ReportSeverity = z.infer<typeof ReportSeveritySchema>;
+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;
+export type ReportReasonCode = z.infer<typeof ReportReasonCodeSchema>;
+/** A key into `ReportViewModel.links`, so a recommendation can point at a URL. */
+export declare const ReportLinkKeySchema: z.ZodString;
+export type ReportLinkKey = z.infer<typeof ReportLinkKeySchema>;
+export declare const ReportDeltaSchema: z.ZodObject<{
+    dir: z.ZodEnum<["up", "down", "flat"]>;
+    /** rounded value/normal multiplier; renderer decides whether to print "6×". */
+    mult: z.ZodOptional<z.ZodNumber>;
+}, "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, "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<["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<["up", "down", "flat"]>;
+        /** rounded value/normal multiplier; renderer decides whether to print "6×". */
+        mult: z.ZodOptional<z.ZodNumber>;
+    }, "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, "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>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        value?: number | undefined;
+    }, {
+        code: string;
+        value?: number | undefined;
+    }>>;
+    /** "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>;
+}, "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>;
+}, "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>>;
+}, "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>>;
+}, "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<["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>;
+    /** 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>;
+    }, "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>;
+    }, "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;
+    }, "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;
+    }, "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>>;
+    }, "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>>;
+    }, "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<["ok", "warn", "crit"]>;
+    /** Renders from (findingType, severity) unless a reason is present. */
+    reason: z.ZodOptional<z.ZodString>;
+}, "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;
+}, "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<["ok", "warn", "crit"]>;
+        statements: z.ZodArray<z.ZodObject<{
+            findingType: z.ZodString;
+            severity: z.ZodEnum<["ok", "warn", "crit"]>;
+            /** Renders from (findingType, severity) unless a reason is present. */
+            reason: z.ZodOptional<z.ZodString>;
+        }, "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<["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>;
+        /** 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>;
+        }, "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>;
+        }, "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;
+        }, "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;
+        }, "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>>;
+        }, "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>>;
+        }, "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<["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<["up", "down", "flat"]>;
+            /** rounded value/normal multiplier; renderer decides whether to print "6×". */
+            mult: z.ZodOptional<z.ZodNumber>;
+        }, "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, "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>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            value?: number | undefined;
+        }, {
+            code: string;
+            value?: number | undefined;
+        }>>;
+        /** "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;
+    }, "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>;
+    }, "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>;