@nuxtseo/protocol 0.5.7 → 0.5.9

package/dist/v1/performance.d.ts

@@ -1662,82 +1662,245 @@ export declare const fieldVitalFindingsQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
-export declare const fieldVitalFindingSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
-    readonly metric: z.ZodEnum<{
-        cls: "cls";
-        inp: "inp";
-        lcp: "lcp";
-    }>;
-    readonly severity: z.ZodEnum<{
-        good: "good";
-        "needs-improvement": "needs-improvement";
-        poor: "poor";
-    }>;
-    readonly p75: z.ZodNullable<z.ZodNumber>;
-    readonly route: z.ZodString;
-    readonly selector: z.ZodString;
-    readonly estimatedViews: z.ZodNumber;
-    readonly fixPrompt: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    readonly metric: z.ZodEnum<{
-        cls: "cls";
-        inp: "inp";
-        lcp: "lcp";
-    }>;
-    readonly severity: z.ZodEnum<{
-        good: "good";
-        "needs-improvement": "needs-improvement";
-        poor: "poor";
-    }>;
-    readonly p75: z.ZodNullable<z.ZodNumber>;
-    readonly route: z.ZodString;
-    readonly selector: z.ZodString;
-    readonly estimatedViews: z.ZodNumber;
-    readonly fixPrompt: z.ZodString;
-}, z.core.$strip>>;
+/**
+ * One failing real-user vital attributed to a DOM element. The fields after
+ * `selector` depend on `metric`: an LCP finding names its resource and phases,
+ * an INP finding names the interaction. `fixPrompt` restates the same facts as
+ * prose for an agent to apply.
+ */
+export declare const fieldVitalFindingSchema: {
+    producer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        resource: z.ZodNullable<z.ZodString>;
+        fetchPriority: z.ZodNullable<z.ZodString>;
+        initiatorType: z.ZodNullable<z.ZodString>;
+        phases: z.ZodObject<{
+            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        metric: z.ZodLiteral<"lcp">;
+    }, z.core.$strict>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        metric: z.ZodLiteral<"inp">;
+        interaction: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        metric: z.ZodLiteral<"cls">;
+    }, z.core.$strict>], "metric">;
+    client: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"lcp">;
+        resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        initiatorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phases: z.ZodOptional<z.ZodObject<{
+            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"inp">;
+        interaction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"cls">;
+    }, z.core.$loose>], "metric">;
+};
+export type FieldVitalFinding = z.output<typeof fieldVitalFindingSchema.producer>;
 export declare const fieldVitalFindingsDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly source: z.ZodNullable<z.ZodString>;
     readonly message: z.ZodNullable<z.ZodString>;
-    readonly findings: z.ZodArray<z.ZodObject<{
-        readonly metric: z.ZodEnum<{
-            cls: "cls";
-            inp: "inp";
-            lcp: "lcp";
+    /** Null when no Web Analytics provider answered. */
+    readonly window: z.ZodNullable<z.ZodObject<{
+        from: z.ZodISODate;
+        to: z.ZodISODate;
+    }, z.core.$strict>>;
+    readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
         }>;
-        readonly severity: z.ZodEnum<{
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        resource: z.ZodNullable<z.ZodString>;
+        fetchPriority: z.ZodNullable<z.ZodString>;
+        initiatorType: z.ZodNullable<z.ZodString>;
+        phases: z.ZodObject<{
+            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+        metric: z.ZodLiteral<"lcp">;
+    }, z.core.$strict>, z.ZodObject<{
+        severity: z.ZodEnum<{
             good: "good";
             "needs-improvement": "needs-improvement";
             poor: "poor";
         }>;
-        readonly p75: z.ZodNullable<z.ZodNumber>;
-        readonly route: z.ZodString;
-        readonly selector: z.ZodString;
-        readonly estimatedViews: z.ZodNumber;
-        readonly fixPrompt: z.ZodString;
-    }, z.core.$strip>>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        metric: z.ZodLiteral<"inp">;
+        interaction: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        poorFraction: z.ZodNullable<z.ZodNumber>;
+        labHint: z.ZodNullable<z.ZodString>;
+        fixPrompt: z.ZodString;
+        metric: z.ZodLiteral<"cls">;
+    }, z.core.$strict>], "metric">>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
     readonly offset: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     readonly source: z.ZodNullable<z.ZodString>;
     readonly message: z.ZodNullable<z.ZodString>;
-    readonly findings: z.ZodArray<z.ZodObject<{
-        readonly metric: z.ZodEnum<{
-            cls: "cls";
-            inp: "inp";
-            lcp: "lcp";
+    readonly window: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        from: z.ZodISODate;
+        to: z.ZodISODate;
+    }, z.core.$loose>>>;
+    readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
         }>;
-        readonly severity: z.ZodEnum<{
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"lcp">;
+        resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        initiatorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        phases: z.ZodOptional<z.ZodObject<{
+            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        severity: z.ZodEnum<{
             good: "good";
             "needs-improvement": "needs-improvement";
             poor: "poor";
         }>;
-        readonly p75: z.ZodNullable<z.ZodNumber>;
-        readonly route: z.ZodString;
-        readonly selector: z.ZodString;
-        readonly estimatedViews: z.ZodNumber;
-        readonly fixPrompt: z.ZodString;
-    }, z.core.$strip>>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"inp">;
+        interaction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>, z.ZodObject<{
+        severity: z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>;
+        p75: z.ZodNullable<z.ZodNumber>;
+        route: z.ZodString;
+        selector: z.ZodString;
+        estimatedViews: z.ZodNumber;
+        fixPrompt: z.ZodString;
+        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metric: z.ZodLiteral<"cls">;
+    }, z.core.$loose>], "metric">>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
     readonly offset: z.ZodNumber;
@@ -1746,23 +1909,64 @@ export declare const fieldVitalFindingsResponseSchema: import("./core.js").Compa
     data: z.ZodObject<{
         readonly source: z.ZodNullable<z.ZodString>;
         readonly message: z.ZodNullable<z.ZodString>;
-        readonly findings: z.ZodArray<z.ZodObject<{
-            readonly metric: z.ZodEnum<{
-                cls: "cls";
-                inp: "inp";
-                lcp: "lcp";
+        /** Null when no Web Analytics provider answered. */
+        readonly window: z.ZodNullable<z.ZodObject<{
+            from: z.ZodISODate;
+            to: z.ZodISODate;
+        }, z.core.$strict>>;
+        readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            severity: z.ZodEnum<{
+                good: "good";
+                "needs-improvement": "needs-improvement";
+                poor: "poor";
             }>;
-            readonly severity: z.ZodEnum<{
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            poorFraction: z.ZodNullable<z.ZodNumber>;
+            labHint: z.ZodNullable<z.ZodString>;
+            fixPrompt: z.ZodString;
+            resource: z.ZodNullable<z.ZodString>;
+            fetchPriority: z.ZodNullable<z.ZodString>;
+            initiatorType: z.ZodNullable<z.ZodString>;
+            phases: z.ZodObject<{
+                timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>;
+            metric: z.ZodLiteral<"lcp">;
+        }, z.core.$strict>, z.ZodObject<{
+            severity: z.ZodEnum<{
                 good: "good";
                 "needs-improvement": "needs-improvement";
                 poor: "poor";
             }>;
-            readonly p75: z.ZodNullable<z.ZodNumber>;
-            readonly route: z.ZodString;
-            readonly selector: z.ZodString;
-            readonly estimatedViews: z.ZodNumber;
-            readonly fixPrompt: z.ZodString;
-        }, z.core.$strip>>;
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            poorFraction: z.ZodNullable<z.ZodNumber>;
+            labHint: z.ZodNullable<z.ZodString>;
+            fixPrompt: z.ZodString;
+            metric: z.ZodLiteral<"inp">;
+            interaction: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            severity: z.ZodEnum<{
+                good: "good";
+                "needs-improvement": "needs-improvement";
+                poor: "poor";
+            }>;
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            poorFraction: z.ZodNullable<z.ZodNumber>;
+            labHint: z.ZodNullable<z.ZodString>;
+            fixPrompt: z.ZodString;
+            metric: z.ZodLiteral<"cls">;
+        }, z.core.$strict>], "metric">>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
@@ -1775,23 +1979,63 @@ export declare const fieldVitalFindingsResponseSchema: import("./core.js").Compa
     data: z.ZodObject<{
         readonly source: z.ZodNullable<z.ZodString>;
         readonly message: z.ZodNullable<z.ZodString>;
-        readonly findings: z.ZodArray<z.ZodObject<{
-            readonly metric: z.ZodEnum<{
-                cls: "cls";
-                inp: "inp";
-                lcp: "lcp";
+        readonly window: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            from: z.ZodISODate;
+            to: z.ZodISODate;
+        }, z.core.$loose>>>;
+        readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            severity: z.ZodEnum<{
+                good: "good";
+                "needs-improvement": "needs-improvement";
+                poor: "poor";
             }>;
-            readonly severity: z.ZodEnum<{
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            fixPrompt: z.ZodString;
+            poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            metric: z.ZodLiteral<"lcp">;
+            resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            initiatorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            phases: z.ZodOptional<z.ZodObject<{
+                timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>, z.ZodObject<{
+            severity: z.ZodEnum<{
                 good: "good";
                 "needs-improvement": "needs-improvement";
                 poor: "poor";
             }>;
-            readonly p75: z.ZodNullable<z.ZodNumber>;
-            readonly route: z.ZodString;
-            readonly selector: z.ZodString;
-            readonly estimatedViews: z.ZodNumber;
-            readonly fixPrompt: z.ZodString;
-        }, z.core.$strip>>;
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            fixPrompt: z.ZodString;
+            poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            metric: z.ZodLiteral<"inp">;
+            interaction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>, z.ZodObject<{
+            severity: z.ZodEnum<{
+                good: "good";
+                "needs-improvement": "needs-improvement";
+                poor: "poor";
+            }>;
+            p75: z.ZodNullable<z.ZodNumber>;
+            route: z.ZodString;
+            selector: z.ZodString;
+            estimatedViews: z.ZodNumber;
+            fixPrompt: z.ZodString;
+            poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            metric: z.ZodLiteral<"cls">;
+        }, z.core.$loose>], "metric">>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
         readonly offset: z.ZodNumber;
@@ -1801,7 +2045,7 @@ export declare const fieldVitalFindingsResponseSchema: import("./core.js").Compa
         version: z.ZodLiteral<"1.0">;
     }, z.core.$loose>;
 }, z.core.$strip>>;
-export type FieldVitalFindings = z.output<typeof fieldVitalFindingsDataSchema.producer>;
+export type FieldVitalFindings = z.output<typeof fieldVitalFindingsDataSchema.client>;
 export declare const fieldVitalFindingsOperation: {
     readonly id: 'page.vitals.findings';
     readonly method: 'GET';
@@ -1850,23 +2094,64 @@ export declare const fieldVitalFindingsOperation: {
             data: z.ZodObject<{
                 readonly source: z.ZodNullable<z.ZodString>;
                 readonly message: z.ZodNullable<z.ZodString>;
-                readonly findings: z.ZodArray<z.ZodObject<{
-                    readonly metric: z.ZodEnum<{
-                        cls: "cls";
-                        inp: "inp";
-                        lcp: "lcp";
+                /** Null when no Web Analytics provider answered. */
+                readonly window: z.ZodNullable<z.ZodObject<{
+                    from: z.ZodISODate;
+                    to: z.ZodISODate;
+                }, z.core.$strict>>;
+                readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    severity: z.ZodEnum<{
+                        good: "good";
+                        "needs-improvement": "needs-improvement";
+                        poor: "poor";
+                    }>;
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    poorFraction: z.ZodNullable<z.ZodNumber>;
+                    labHint: z.ZodNullable<z.ZodString>;
+                    fixPrompt: z.ZodString;
+                    resource: z.ZodNullable<z.ZodString>;
+                    fetchPriority: z.ZodNullable<z.ZodString>;
+                    initiatorType: z.ZodNullable<z.ZodString>;
+                    phases: z.ZodObject<{
+                        timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                        resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                        resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                        elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$strict>;
+                    metric: z.ZodLiteral<"lcp">;
+                }, z.core.$strict>, z.ZodObject<{
+                    severity: z.ZodEnum<{
+                        good: "good";
+                        "needs-improvement": "needs-improvement";
+                        poor: "poor";
                     }>;
-                    readonly severity: z.ZodEnum<{
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    poorFraction: z.ZodNullable<z.ZodNumber>;
+                    labHint: z.ZodNullable<z.ZodString>;
+                    fixPrompt: z.ZodString;
+                    metric: z.ZodLiteral<"inp">;
+                    interaction: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    severity: z.ZodEnum<{
                         good: "good";
                         "needs-improvement": "needs-improvement";
                         poor: "poor";
                     }>;
-                    readonly p75: z.ZodNullable<z.ZodNumber>;
-                    readonly route: z.ZodString;
-                    readonly selector: z.ZodString;
-                    readonly estimatedViews: z.ZodNumber;
-                    readonly fixPrompt: z.ZodString;
-                }, z.core.$strip>>;
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    poorFraction: z.ZodNullable<z.ZodNumber>;
+                    labHint: z.ZodNullable<z.ZodString>;
+                    fixPrompt: z.ZodString;
+                    metric: z.ZodLiteral<"cls">;
+                }, z.core.$strict>], "metric">>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
                 readonly offset: z.ZodNumber;
@@ -1879,23 +2164,63 @@ export declare const fieldVitalFindingsOperation: {
             data: z.ZodObject<{
                 readonly source: z.ZodNullable<z.ZodString>;
                 readonly message: z.ZodNullable<z.ZodString>;
-                readonly findings: z.ZodArray<z.ZodObject<{
-                    readonly metric: z.ZodEnum<{
-                        cls: "cls";
-                        inp: "inp";
-                        lcp: "lcp";
+                readonly window: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    from: z.ZodISODate;
+                    to: z.ZodISODate;
+                }, z.core.$loose>>>;
+                readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    severity: z.ZodEnum<{
+                        good: "good";
+                        "needs-improvement": "needs-improvement";
+                        poor: "poor";
                     }>;
-                    readonly severity: z.ZodEnum<{
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    fixPrompt: z.ZodString;
+                    poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    metric: z.ZodLiteral<"lcp">;
+                    resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    initiatorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    phases: z.ZodOptional<z.ZodObject<{
+                        timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                        resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                        resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                        elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>, z.ZodObject<{
+                    severity: z.ZodEnum<{
                         good: "good";
                         "needs-improvement": "needs-improvement";
                         poor: "poor";
                     }>;
-                    readonly p75: z.ZodNullable<z.ZodNumber>;
-                    readonly route: z.ZodString;
-                    readonly selector: z.ZodString;
-                    readonly estimatedViews: z.ZodNumber;
-                    readonly fixPrompt: z.ZodString;
-                }, z.core.$strip>>;
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    fixPrompt: z.ZodString;
+                    poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    metric: z.ZodLiteral<"inp">;
+                    interaction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$loose>, z.ZodObject<{
+                    severity: z.ZodEnum<{
+                        good: "good";
+                        "needs-improvement": "needs-improvement";
+                        poor: "poor";
+                    }>;
+                    p75: z.ZodNullable<z.ZodNumber>;
+                    route: z.ZodString;
+                    selector: z.ZodString;
+                    estimatedViews: z.ZodNumber;
+                    fixPrompt: z.ZodString;
+                    poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    metric: z.ZodLiteral<"cls">;
+                }, z.core.$loose>], "metric">>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
                 readonly offset: z.ZodNumber;
@@ -1978,7 +2303,7 @@ export declare const fieldVitalFindingsOperation: {
     };
     readonly docs: {
         readonly summary: 'List field Core Web Vitals findings';
-        readonly description: 'Returns each failing real-user vital attributed to the DOM element behind it, with the p75, the CSS selector, and a ready-to-apply fix prompt. It requires a connected Web Analytics provider. If no provider is connected, findings is empty and message says so.';
+        readonly description: 'Returns each failing real-user vital attributed to the DOM element behind it, with the p75, the CSS selector, and a ready-to-apply fix prompt. An LCP finding also names its resource, fetchPriority and phases. An INP finding names the interaction. window gives the dates the provider aggregated. It requires a connected Web Analytics provider. If no provider is connected, findings is empty and message says so.';
         readonly tags: readonly ["Pages"];
         readonly examples: readonly [{
             readonly request: {
@@ -1997,6 +2322,10 @@ export declare const fieldVitalFindingsOperation: {
                     readonly data: {
                         readonly source: 'cloudflare';
                         readonly message: null;
+                        readonly window: {
+                            readonly from: '2026-07-13';
+                            readonly to: '2026-08-09';
+                        };
                         readonly findings: readonly [{
                             readonly metric: 'lcp';
                             readonly severity: 'poor';
@@ -2004,6 +2333,17 @@ export declare const fieldVitalFindingsOperation: {
                             readonly route: '/blog';
                             readonly selector: 'main > img.hero';
                             readonly estimatedViews: 1840;
+                            readonly poorFraction: 0.31;
+                            readonly labHint: null;
+                            readonly resource: 'example.com/images/hero.jpg';
+                            readonly fetchPriority: 'auto';
+                            readonly initiatorType: 'img';
+                            readonly phases: {
+                                readonly timeToFirstByte: 600;
+                                readonly resourceLoadDelay: 1900;
+                                readonly resourceLoadTime: 1200;
+                                readonly elementRenderDelay: 600;
+                            };
                             readonly fixPrompt: 'The LCP element on /blog is main > img.hero at 4300ms.';
                         }];
                         readonly total: 1;
@@ -2026,80 +2366,237 @@ export declare const performanceScanParamsSchema: z.ZodObject<{
     siteId: z.ZodString;
     scanId: z.ZodString;
 }, z.core.$strict>;
+/**
+ * Why a Scan started. `claim-recheck` follows a claimed Action. `deploy`
+ * follows a new Nuxt build. `confirmation` repeats a Scan that looked like a
+ * regression.
+ */
+export declare const PERFORMANCE_SCAN_TRIGGERS: readonly ['scheduled', 'manual', 'claim-recheck', 'deploy', 'confirmation'];
+/**
+ * Why a Scan failed. `timeout`, `unavailable`, `quota`, `rejected`, `network`,
+ * `empty`, `malformed` and `oversize` describe the PageSpeed Insights request.
+ * The rest describe the pipeline around it. `rejected` means PSI refused the
+ * URL, so a retry of the same URL fails the same way.
+ */
+export declare const PERFORMANCE_SCAN_FAILURE_KINDS: readonly ['timeout', 'unavailable', 'quota', 'rejected', 'network', 'empty', 'malformed', 'oversize', 'artifact-missing', 'processing', 'abandoned', 'unqueued', 'monitoring-changed', 'internal'];
 export declare const performanceScanSummarySchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
-    readonly id: z.ZodString;
-    readonly url: z.ZodString;
-    readonly strategy: z.ZodString;
-    readonly status: z.ZodString;
-    readonly trigger: z.ZodNullable<z.ZodString>;
-    readonly scores: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    strategy: z.ZodEnum<{
+        desktop: "desktop";
+        mobile: "mobile";
+    }>;
+    status: z.ZodEnum<{
+        complete: "complete";
+        failed: "failed";
+        running: "running";
+    }>;
+    trigger: z.ZodEnum<{
+        "claim-recheck": "claim-recheck";
+        confirmation: "confirmation";
+        deploy: "deploy";
+        manual: "manual";
+        scheduled: "scheduled";
+    }>;
+    failureKind: z.ZodNullable<z.ZodEnum<{
+        abandoned: "abandoned";
+        "artifact-missing": "artifact-missing";
+        empty: "empty";
+        internal: "internal";
+        malformed: "malformed";
+        "monitoring-changed": "monitoring-changed";
+        network: "network";
+        oversize: "oversize";
+        processing: "processing";
+        quota: "quota";
+        rejected: "rejected";
+        timeout: "timeout";
+        unavailable: "unavailable";
+        unqueued: "unqueued";
+    }>>;
+    error: z.ZodNullable<z.ZodString>;
+    lighthouseVersion: z.ZodNullable<z.ZodString>;
+    scores: z.ZodObject<{
         perf: z.ZodNullable<z.ZodNumber>;
         a11y: z.ZodNullable<z.ZodNumber>;
         bestPractices: z.ZodNullable<z.ZodNumber>;
         seo: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strict>;
-    readonly lcp: z.ZodNullable<z.ZodNumber>;
-    readonly tbt: z.ZodNullable<z.ZodNumber>;
-    readonly cls: z.ZodNullable<z.ZodNumber>;
-    readonly completedAt: z.ZodNullable<z.ZodString>;
-    readonly error: z.ZodNullable<z.ZodString>;
+    lcp: z.ZodNullable<z.ZodNumber>;
+    tbt: z.ZodNullable<z.ZodNumber>;
+    cls: z.ZodNullable<z.ZodNumber>;
+    completedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
-    readonly id: z.ZodString;
-    readonly url: z.ZodString;
-    readonly strategy: z.ZodString;
-    readonly status: z.ZodString;
-    readonly trigger: z.ZodNullable<z.ZodString>;
-    readonly scores: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    strategy: z.ZodString;
+    status: z.ZodString;
+    trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scores: z.ZodObject<{
         perf: z.ZodNullable<z.ZodNumber>;
         a11y: z.ZodNullable<z.ZodNumber>;
         bestPractices: z.ZodNullable<z.ZodNumber>;
         seo: z.ZodNullable<z.ZodNumber>;
     }, z.core.$loose>;
-    readonly lcp: z.ZodNullable<z.ZodNumber>;
-    readonly tbt: z.ZodNullable<z.ZodNumber>;
-    readonly cls: z.ZodNullable<z.ZodNumber>;
-    readonly completedAt: z.ZodNullable<z.ZodString>;
-    readonly error: z.ZodNullable<z.ZodString>;
+    lcp: z.ZodNullable<z.ZodNumber>;
+    tbt: z.ZodNullable<z.ZodNumber>;
+    cls: z.ZodNullable<z.ZodNumber>;
+    completedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>>;
+export type PerformanceScanSummary = z.output<typeof performanceScanSummarySchema.producer>;
+/** Metrics a Scan comparison can name. Same names and units as the Scan fields. */
+export declare const PERFORMANCE_SCAN_COMPARISON_METRICS: readonly ['perf', 'a11y', 'bestPractices', 'seo', 'lcp', 'tbt', 'cls', 'inp', 'fcp', 'speedIndex', 'ttfb'];
+/** Why two Scans of one Page cannot be compared. */
+export declare const PERFORMANCE_SCAN_INCOMPATIBILITY_REASONS: readonly ['source', 'target-url', 'strategy', 'lighthouse-version', 'form-factor', 'cpu-throttling', 'network-throttling', 'host-browser', 'runtime-environment'];
+/**
+ * This Scan against the previous comparable Scan of the same Page and strategy.
+ * `compared` lists each metric both Scans measured. `incompatible` names why
+ * the two Scans differ, for example a Lighthouse version change. `none` means
+ * no previous Scan was compared, which is always true for the homepage slot.
+ */
+export declare const performanceScanComparisonSchema: {
+    producer: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"compared">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        severity: z.ZodEnum<{
+            improvement: "improvement";
+            neutral: "neutral";
+            regression: "regression";
+        }>;
+        changes: z.ZodArray<z.ZodObject<{
+            metric: z.ZodEnum<{
+                a11y: "a11y";
+                bestPractices: "bestPractices";
+                cls: "cls";
+                fcp: "fcp";
+                inp: "inp";
+                lcp: "lcp";
+                perf: "perf";
+                seo: "seo";
+                speedIndex: "speedIndex";
+                tbt: "tbt";
+                ttfb: "ttfb";
+            }>;
+            previous: z.ZodNumber;
+            current: z.ZodNumber;
+            delta: z.ZodNumber;
+            severity: z.ZodEnum<{
+                improvement: "improvement";
+                neutral: "neutral";
+                regression: "regression";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"incompatible">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        reasons: z.ZodArray<z.ZodEnum<{
+            "cpu-throttling": "cpu-throttling";
+            "form-factor": "form-factor";
+            "host-browser": "host-browser";
+            "lighthouse-version": "lighthouse-version";
+            "network-throttling": "network-throttling";
+            "runtime-environment": "runtime-environment";
+            source: "source";
+            strategy: "strategy";
+            "target-url": "target-url";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"none">;
+    }, z.core.$strict>], "_tag">;
+    client: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"compared">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        severity: z.ZodString;
+        changes: z.ZodArray<z.ZodObject<{
+            previous: z.ZodNumber;
+            current: z.ZodNumber;
+            delta: z.ZodNumber;
+            metric: z.ZodString;
+            severity: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"incompatible">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        reasons: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"none">;
+    }, z.core.$loose>], "_tag">;
+};
+export type PerformanceScanComparison = z.output<typeof performanceScanComparisonSchema.producer>;
 export declare const performanceScansDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly scans: z.ZodArray<z.ZodObject<{
-        readonly id: z.ZodString;
-        readonly url: z.ZodString;
-        readonly strategy: z.ZodString;
-        readonly status: z.ZodString;
-        readonly trigger: z.ZodNullable<z.ZodString>;
-        readonly scores: z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        strategy: z.ZodEnum<{
+            desktop: "desktop";
+            mobile: "mobile";
+        }>;
+        status: z.ZodEnum<{
+            complete: "complete";
+            failed: "failed";
+            running: "running";
+        }>;
+        trigger: z.ZodEnum<{
+            "claim-recheck": "claim-recheck";
+            confirmation: "confirmation";
+            deploy: "deploy";
+            manual: "manual";
+            scheduled: "scheduled";
+        }>;
+        failureKind: z.ZodNullable<z.ZodEnum<{
+            abandoned: "abandoned";
+            "artifact-missing": "artifact-missing";
+            empty: "empty";
+            internal: "internal";
+            malformed: "malformed";
+            "monitoring-changed": "monitoring-changed";
+            network: "network";
+            oversize: "oversize";
+            processing: "processing";
+            quota: "quota";
+            rejected: "rejected";
+            timeout: "timeout";
+            unavailable: "unavailable";
+            unqueued: "unqueued";
+        }>>;
+        error: z.ZodNullable<z.ZodString>;
+        lighthouseVersion: z.ZodNullable<z.ZodString>;
+        scores: z.ZodObject<{
             perf: z.ZodNullable<z.ZodNumber>;
             a11y: z.ZodNullable<z.ZodNumber>;
             bestPractices: z.ZodNullable<z.ZodNumber>;
             seo: z.ZodNullable<z.ZodNumber>;
         }, z.core.$strict>;
-        readonly lcp: z.ZodNullable<z.ZodNumber>;
-        readonly tbt: z.ZodNullable<z.ZodNumber>;
-        readonly cls: z.ZodNullable<z.ZodNumber>;
-        readonly completedAt: z.ZodNullable<z.ZodString>;
-        readonly error: z.ZodNullable<z.ZodString>;
+        lcp: z.ZodNullable<z.ZodNumber>;
+        tbt: z.ZodNullable<z.ZodNumber>;
+        cls: z.ZodNullable<z.ZodNumber>;
+        completedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     readonly scans: z.ZodArray<z.ZodObject<{
-        readonly id: z.ZodString;
-        readonly url: z.ZodString;
-        readonly strategy: z.ZodString;
-        readonly status: z.ZodString;
-        readonly trigger: z.ZodNullable<z.ZodString>;
-        readonly scores: z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        strategy: z.ZodString;
+        status: z.ZodString;
+        trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        scores: z.ZodObject<{
             perf: z.ZodNullable<z.ZodNumber>;
             a11y: z.ZodNullable<z.ZodNumber>;
             bestPractices: z.ZodNullable<z.ZodNumber>;
             seo: z.ZodNullable<z.ZodNumber>;
         }, z.core.$loose>;
-        readonly lcp: z.ZodNullable<z.ZodNumber>;
-        readonly tbt: z.ZodNullable<z.ZodNumber>;
-        readonly cls: z.ZodNullable<z.ZodNumber>;
-        readonly completedAt: z.ZodNullable<z.ZodString>;
-        readonly error: z.ZodNullable<z.ZodString>;
+        lcp: z.ZodNullable<z.ZodNumber>;
+        tbt: z.ZodNullable<z.ZodNumber>;
+        cls: z.ZodNullable<z.ZodNumber>;
+        completedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
     readonly total: z.ZodNumber;
     readonly limit: z.ZodNumber;
@@ -2107,22 +2604,52 @@ export declare const performanceScansDataSchema: import("./core.js").CompatibleR
 export declare const performanceScansResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     data: z.ZodObject<{
         readonly scans: z.ZodArray<z.ZodObject<{
-            readonly id: z.ZodString;
-            readonly url: z.ZodString;
-            readonly strategy: z.ZodString;
-            readonly status: z.ZodString;
-            readonly trigger: z.ZodNullable<z.ZodString>;
-            readonly scores: z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            strategy: z.ZodEnum<{
+                desktop: "desktop";
+                mobile: "mobile";
+            }>;
+            status: z.ZodEnum<{
+                complete: "complete";
+                failed: "failed";
+                running: "running";
+            }>;
+            trigger: z.ZodEnum<{
+                "claim-recheck": "claim-recheck";
+                confirmation: "confirmation";
+                deploy: "deploy";
+                manual: "manual";
+                scheduled: "scheduled";
+            }>;
+            failureKind: z.ZodNullable<z.ZodEnum<{
+                abandoned: "abandoned";
+                "artifact-missing": "artifact-missing";
+                empty: "empty";
+                internal: "internal";
+                malformed: "malformed";
+                "monitoring-changed": "monitoring-changed";
+                network: "network";
+                oversize: "oversize";
+                processing: "processing";
+                quota: "quota";
+                rejected: "rejected";
+                timeout: "timeout";
+                unavailable: "unavailable";
+                unqueued: "unqueued";
+            }>>;
+            error: z.ZodNullable<z.ZodString>;
+            lighthouseVersion: z.ZodNullable<z.ZodString>;
+            scores: z.ZodObject<{
                 perf: z.ZodNullable<z.ZodNumber>;
                 a11y: z.ZodNullable<z.ZodNumber>;
                 bestPractices: z.ZodNullable<z.ZodNumber>;
                 seo: z.ZodNullable<z.ZodNumber>;
             }, z.core.$strict>;
-            readonly lcp: z.ZodNullable<z.ZodNumber>;
-            readonly tbt: z.ZodNullable<z.ZodNumber>;
-            readonly cls: z.ZodNullable<z.ZodNumber>;
-            readonly completedAt: z.ZodNullable<z.ZodString>;
-            readonly error: z.ZodNullable<z.ZodString>;
+            lcp: z.ZodNullable<z.ZodNumber>;
+            tbt: z.ZodNullable<z.ZodNumber>;
+            cls: z.ZodNullable<z.ZodNumber>;
+            completedAt: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -2134,22 +2661,24 @@ export declare const performanceScansResponseSchema: import("./core.js").Compati
 }, z.core.$strip>, z.ZodObject<{
     data: z.ZodObject<{
         readonly scans: z.ZodArray<z.ZodObject<{
-            readonly id: z.ZodString;
-            readonly url: z.ZodString;
-            readonly strategy: z.ZodString;
-            readonly status: z.ZodString;
-            readonly trigger: z.ZodNullable<z.ZodString>;
-            readonly scores: z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            strategy: z.ZodString;
+            status: z.ZodString;
+            trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            scores: z.ZodObject<{
                 perf: z.ZodNullable<z.ZodNumber>;
                 a11y: z.ZodNullable<z.ZodNumber>;
                 bestPractices: z.ZodNullable<z.ZodNumber>;
                 seo: z.ZodNullable<z.ZodNumber>;
             }, z.core.$loose>;
-            readonly lcp: z.ZodNullable<z.ZodNumber>;
-            readonly tbt: z.ZodNullable<z.ZodNumber>;
-            readonly cls: z.ZodNullable<z.ZodNumber>;
-            readonly completedAt: z.ZodNullable<z.ZodString>;
-            readonly error: z.ZodNullable<z.ZodString>;
+            lcp: z.ZodNullable<z.ZodNumber>;
+            tbt: z.ZodNullable<z.ZodNumber>;
+            cls: z.ZodNullable<z.ZodNumber>;
+            completedAt: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
         readonly total: z.ZodNumber;
         readonly limit: z.ZodNumber;
@@ -2159,7 +2688,7 @@ export declare const performanceScansResponseSchema: import("./core.js").Compati
         version: z.ZodLiteral<"1.0">;
     }, z.core.$loose>;
 }, z.core.$strip>>;
-export type PerformanceScans = z.output<typeof performanceScansDataSchema.producer>;
+export type PerformanceScans = z.output<typeof performanceScansDataSchema.client>;
 export declare const performanceScansOperation: {
     readonly id: 'page.performance.scans';
     readonly method: 'GET';
@@ -2191,22 +2720,52 @@ export declare const performanceScansOperation: {
         readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
             data: z.ZodObject<{
                 readonly scans: z.ZodArray<z.ZodObject<{
-                    readonly id: z.ZodString;
-                    readonly url: z.ZodString;
-                    readonly strategy: z.ZodString;
-                    readonly status: z.ZodString;
-                    readonly trigger: z.ZodNullable<z.ZodString>;
-                    readonly scores: z.ZodObject<{
+                    id: z.ZodString;
+                    url: z.ZodString;
+                    strategy: z.ZodEnum<{
+                        desktop: "desktop";
+                        mobile: "mobile";
+                    }>;
+                    status: z.ZodEnum<{
+                        complete: "complete";
+                        failed: "failed";
+                        running: "running";
+                    }>;
+                    trigger: z.ZodEnum<{
+                        "claim-recheck": "claim-recheck";
+                        confirmation: "confirmation";
+                        deploy: "deploy";
+                        manual: "manual";
+                        scheduled: "scheduled";
+                    }>;
+                    failureKind: z.ZodNullable<z.ZodEnum<{
+                        abandoned: "abandoned";
+                        "artifact-missing": "artifact-missing";
+                        empty: "empty";
+                        internal: "internal";
+                        malformed: "malformed";
+                        "monitoring-changed": "monitoring-changed";
+                        network: "network";
+                        oversize: "oversize";
+                        processing: "processing";
+                        quota: "quota";
+                        rejected: "rejected";
+                        timeout: "timeout";
+                        unavailable: "unavailable";
+                        unqueued: "unqueued";
+                    }>>;
+                    error: z.ZodNullable<z.ZodString>;
+                    lighthouseVersion: z.ZodNullable<z.ZodString>;
+                    scores: z.ZodObject<{
                         perf: z.ZodNullable<z.ZodNumber>;
                         a11y: z.ZodNullable<z.ZodNumber>;
                         bestPractices: z.ZodNullable<z.ZodNumber>;
                         seo: z.ZodNullable<z.ZodNumber>;
                     }, z.core.$strict>;
-                    readonly lcp: z.ZodNullable<z.ZodNumber>;
-                    readonly tbt: z.ZodNullable<z.ZodNumber>;
-                    readonly cls: z.ZodNullable<z.ZodNumber>;
-                    readonly completedAt: z.ZodNullable<z.ZodString>;
-                    readonly error: z.ZodNullable<z.ZodString>;
+                    lcp: z.ZodNullable<z.ZodNumber>;
+                    tbt: z.ZodNullable<z.ZodNumber>;
+                    cls: z.ZodNullable<z.ZodNumber>;
+                    completedAt: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -2218,22 +2777,24 @@ export declare const performanceScansOperation: {
         }, z.core.$strip>, z.ZodObject<{
             data: z.ZodObject<{
                 readonly scans: z.ZodArray<z.ZodObject<{
-                    readonly id: z.ZodString;
-                    readonly url: z.ZodString;
-                    readonly strategy: z.ZodString;
-                    readonly status: z.ZodString;
-                    readonly trigger: z.ZodNullable<z.ZodString>;
-                    readonly scores: z.ZodObject<{
+                    id: z.ZodString;
+                    url: z.ZodString;
+                    strategy: z.ZodString;
+                    status: z.ZodString;
+                    trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    scores: z.ZodObject<{
                         perf: z.ZodNullable<z.ZodNumber>;
                         a11y: z.ZodNullable<z.ZodNumber>;
                         bestPractices: z.ZodNullable<z.ZodNumber>;
                         seo: z.ZodNullable<z.ZodNumber>;
                     }, z.core.$loose>;
-                    readonly lcp: z.ZodNullable<z.ZodNumber>;
-                    readonly tbt: z.ZodNullable<z.ZodNumber>;
-                    readonly cls: z.ZodNullable<z.ZodNumber>;
-                    readonly completedAt: z.ZodNullable<z.ZodString>;
-                    readonly error: z.ZodNullable<z.ZodString>;
+                    lcp: z.ZodNullable<z.ZodNumber>;
+                    tbt: z.ZodNullable<z.ZodNumber>;
+                    cls: z.ZodNullable<z.ZodNumber>;
+                    completedAt: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>>;
                 readonly total: z.ZodNumber;
                 readonly limit: z.ZodNumber;
@@ -2316,7 +2877,7 @@ export declare const performanceScansOperation: {
     };
     readonly docs: {
         readonly summary: 'List Lighthouse Scans';
-        readonly description: 'Returns retained Lighthouse Scans for the Site, newest first, with the scores and lab vitals each one recorded. A failed Scan carries its error. Use one Scan id with the Scan read for the failing checks behind a score.';
+        readonly description: 'Returns retained Lighthouse Scans for the Site, newest first, with the scores and lab vitals each one recorded. A failed Scan carries its failureKind and error, and its scores are null. Use one Scan id with the Scan read for the failing checks behind a score.';
         readonly tags: readonly ["Pages"];
         readonly examples: readonly [{
             readonly request: {
@@ -2337,6 +2898,9 @@ export declare const performanceScansOperation: {
                             readonly strategy: 'mobile';
                             readonly status: 'complete';
                             readonly trigger: 'scheduled';
+                            readonly failureKind: null;
+                            readonly error: null;
+                            readonly lighthouseVersion: '13.5.0';
                             readonly scores: {
                                 readonly perf: 82;
                                 readonly a11y: 96;
@@ -2347,9 +2911,27 @@ export declare const performanceScansOperation: {
                             readonly tbt: 180;
                             readonly cls: 0.08;
                             readonly completedAt: '2026-08-10T01:00:00.000Z';
-                            readonly error: null;
+                        }, {
+                            readonly id: 'scan_01JXZA';
+                            readonly url: 'https://example.com/blog';
+                            readonly strategy: 'mobile';
+                            readonly status: 'failed';
+                            readonly trigger: 'scheduled';
+                            readonly failureKind: 'timeout';
+                            readonly error: 'PSI timed out loading the page';
+                            readonly lighthouseVersion: null;
+                            readonly scores: {
+                                readonly perf: null;
+                                readonly a11y: null;
+                                readonly bestPractices: null;
+                                readonly seo: null;
+                            };
+                            readonly lcp: null;
+                            readonly tbt: null;
+                            readonly cls: null;
+                            readonly completedAt: '2026-08-10T01:05:00.000Z';
                         }];
-                        readonly total: 1;
+                        readonly total: 2;
                         readonly limit: 25;
                     };
                     readonly meta: {
@@ -2712,8 +3294,40 @@ export type LcpObservedTrace = z.output<typeof lcpObservedTraceSchema>;
 export declare const performanceScanDetailDataSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
     readonly id: z.ZodString;
     readonly url: z.ZodString;
-    readonly strategy: z.ZodString;
-    readonly status: z.ZodString;
+    readonly strategy: z.ZodEnum<{
+        desktop: "desktop";
+        mobile: "mobile";
+    }>;
+    readonly status: z.ZodEnum<{
+        complete: "complete";
+        failed: "failed";
+        running: "running";
+    }>;
+    readonly trigger: z.ZodEnum<{
+        "claim-recheck": "claim-recheck";
+        confirmation: "confirmation";
+        deploy: "deploy";
+        manual: "manual";
+        scheduled: "scheduled";
+    }>;
+    readonly failureKind: z.ZodNullable<z.ZodEnum<{
+        abandoned: "abandoned";
+        "artifact-missing": "artifact-missing";
+        empty: "empty";
+        internal: "internal";
+        malformed: "malformed";
+        "monitoring-changed": "monitoring-changed";
+        network: "network";
+        oversize: "oversize";
+        processing: "processing";
+        quota: "quota";
+        rejected: "rejected";
+        timeout: "timeout";
+        unavailable: "unavailable";
+        unqueued: "unqueued";
+    }>>;
+    readonly error: z.ZodNullable<z.ZodString>;
+    readonly lighthouseVersion: z.ZodNullable<z.ZodString>;
     readonly scores: z.ZodObject<{
         perf: z.ZodNullable<z.ZodNumber>;
         a11y: z.ZodNullable<z.ZodNumber>;
@@ -2723,10 +3337,58 @@ export declare const performanceScanDetailDataSchema: import("./core.js").Compat
     readonly lcp: z.ZodNullable<z.ZodNumber>;
     readonly tbt: z.ZodNullable<z.ZodNumber>;
     readonly cls: z.ZodNullable<z.ZodNumber>;
+    readonly completedAt: z.ZodNullable<z.ZodString>;
     readonly fcp: z.ZodNullable<z.ZodNumber>;
     readonly speedIndex: z.ZodNullable<z.ZodNumber>;
     readonly ttfb: z.ZodNullable<z.ZodNumber>;
-    readonly completedAt: z.ZodNullable<z.ZodString>;
+    readonly comparison: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"compared">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        severity: z.ZodEnum<{
+            improvement: "improvement";
+            neutral: "neutral";
+            regression: "regression";
+        }>;
+        changes: z.ZodArray<z.ZodObject<{
+            metric: z.ZodEnum<{
+                a11y: "a11y";
+                bestPractices: "bestPractices";
+                cls: "cls";
+                fcp: "fcp";
+                inp: "inp";
+                lcp: "lcp";
+                perf: "perf";
+                seo: "seo";
+                speedIndex: "speedIndex";
+                tbt: "tbt";
+                ttfb: "ttfb";
+            }>;
+            previous: z.ZodNumber;
+            current: z.ZodNumber;
+            delta: z.ZodNumber;
+            severity: z.ZodEnum<{
+                improvement: "improvement";
+                neutral: "neutral";
+                regression: "regression";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"incompatible">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        reasons: z.ZodArray<z.ZodEnum<{
+            "cpu-throttling": "cpu-throttling";
+            "form-factor": "form-factor";
+            "host-browser": "host-browser";
+            "lighthouse-version": "lighthouse-version";
+            "network-throttling": "network-throttling";
+            "runtime-environment": "runtime-environment";
+            source: "source";
+            strategy: "strategy";
+            "target-url": "target-url";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        _tag: z.ZodLiteral<"none">;
+    }, z.core.$strict>], "_tag">;
     readonly javascript: z.ZodNullable<z.ZodObject<{
         transferBytes: z.ZodNullable<z.ZodNumber>;
         decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -2838,6 +3500,10 @@ export declare const performanceScanDetailDataSchema: import("./core.js").Compat
     readonly url: z.ZodString;
     readonly strategy: z.ZodString;
     readonly status: z.ZodString;
+    readonly trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    readonly failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    readonly error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    readonly lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     readonly scores: z.ZodObject<{
         perf: z.ZodNullable<z.ZodNumber>;
         a11y: z.ZodNullable<z.ZodNumber>;
@@ -2847,10 +3513,28 @@ export declare const performanceScanDetailDataSchema: import("./core.js").Compat
     readonly lcp: z.ZodNullable<z.ZodNumber>;
     readonly tbt: z.ZodNullable<z.ZodNumber>;
     readonly cls: z.ZodNullable<z.ZodNumber>;
+    readonly completedAt: z.ZodNullable<z.ZodString>;
     readonly fcp: z.ZodNullable<z.ZodNumber>;
     readonly speedIndex: z.ZodNullable<z.ZodNumber>;
     readonly ttfb: z.ZodNullable<z.ZodNumber>;
-    readonly completedAt: z.ZodNullable<z.ZodString>;
+    readonly comparison: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _tag: z.ZodLiteral<"compared">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        severity: z.ZodString;
+        changes: z.ZodArray<z.ZodObject<{
+            previous: z.ZodNumber;
+            current: z.ZodNumber;
+            delta: z.ZodNumber;
+            metric: z.ZodString;
+            severity: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"incompatible">;
+        previousScanId: z.ZodNullable<z.ZodString>;
+        reasons: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>, z.ZodObject<{
+        _tag: z.ZodLiteral<"none">;
+    }, z.core.$loose>], "_tag">>;
     readonly javascript: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         transferBytes: z.ZodNullable<z.ZodNumber>;
         decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -2960,8 +3644,40 @@ export declare const performanceScanDetailResponseSchema: import("./core.js").Co
     data: z.ZodObject<{
         readonly id: z.ZodString;
         readonly url: z.ZodString;
-        readonly strategy: z.ZodString;
-        readonly status: z.ZodString;
+        readonly strategy: z.ZodEnum<{
+            desktop: "desktop";
+            mobile: "mobile";
+        }>;
+        readonly status: z.ZodEnum<{
+            complete: "complete";
+            failed: "failed";
+            running: "running";
+        }>;
+        readonly trigger: z.ZodEnum<{
+            "claim-recheck": "claim-recheck";
+            confirmation: "confirmation";
+            deploy: "deploy";
+            manual: "manual";
+            scheduled: "scheduled";
+        }>;
+        readonly failureKind: z.ZodNullable<z.ZodEnum<{
+            abandoned: "abandoned";
+            "artifact-missing": "artifact-missing";
+            empty: "empty";
+            internal: "internal";
+            malformed: "malformed";
+            "monitoring-changed": "monitoring-changed";
+            network: "network";
+            oversize: "oversize";
+            processing: "processing";
+            quota: "quota";
+            rejected: "rejected";
+            timeout: "timeout";
+            unavailable: "unavailable";
+            unqueued: "unqueued";
+        }>>;
+        readonly error: z.ZodNullable<z.ZodString>;
+        readonly lighthouseVersion: z.ZodNullable<z.ZodString>;
         readonly scores: z.ZodObject<{
             perf: z.ZodNullable<z.ZodNumber>;
             a11y: z.ZodNullable<z.ZodNumber>;
@@ -2971,10 +3687,58 @@ export declare const performanceScanDetailResponseSchema: import("./core.js").Co
         readonly lcp: z.ZodNullable<z.ZodNumber>;
         readonly tbt: z.ZodNullable<z.ZodNumber>;
         readonly cls: z.ZodNullable<z.ZodNumber>;
+        readonly completedAt: z.ZodNullable<z.ZodString>;
         readonly fcp: z.ZodNullable<z.ZodNumber>;
         readonly speedIndex: z.ZodNullable<z.ZodNumber>;
         readonly ttfb: z.ZodNullable<z.ZodNumber>;
-        readonly completedAt: z.ZodNullable<z.ZodString>;
+        readonly comparison: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            _tag: z.ZodLiteral<"compared">;
+            previousScanId: z.ZodNullable<z.ZodString>;
+            severity: z.ZodEnum<{
+                improvement: "improvement";
+                neutral: "neutral";
+                regression: "regression";
+            }>;
+            changes: z.ZodArray<z.ZodObject<{
+                metric: z.ZodEnum<{
+                    a11y: "a11y";
+                    bestPractices: "bestPractices";
+                    cls: "cls";
+                    fcp: "fcp";
+                    inp: "inp";
+                    lcp: "lcp";
+                    perf: "perf";
+                    seo: "seo";
+                    speedIndex: "speedIndex";
+                    tbt: "tbt";
+                    ttfb: "ttfb";
+                }>;
+                previous: z.ZodNumber;
+                current: z.ZodNumber;
+                delta: z.ZodNumber;
+                severity: z.ZodEnum<{
+                    improvement: "improvement";
+                    neutral: "neutral";
+                    regression: "regression";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            _tag: z.ZodLiteral<"incompatible">;
+            previousScanId: z.ZodNullable<z.ZodString>;
+            reasons: z.ZodArray<z.ZodEnum<{
+                "cpu-throttling": "cpu-throttling";
+                "form-factor": "form-factor";
+                "host-browser": "host-browser";
+                "lighthouse-version": "lighthouse-version";
+                "network-throttling": "network-throttling";
+                "runtime-environment": "runtime-environment";
+                source: "source";
+                strategy: "strategy";
+                "target-url": "target-url";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            _tag: z.ZodLiteral<"none">;
+        }, z.core.$strict>], "_tag">;
         readonly javascript: z.ZodNullable<z.ZodObject<{
             transferBytes: z.ZodNullable<z.ZodNumber>;
             decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -3092,6 +3856,10 @@ export declare const performanceScanDetailResponseSchema: import("./core.js").Co
         readonly url: z.ZodString;
         readonly strategy: z.ZodString;
         readonly status: z.ZodString;
+        readonly trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readonly lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         readonly scores: z.ZodObject<{
             perf: z.ZodNullable<z.ZodNumber>;
             a11y: z.ZodNullable<z.ZodNumber>;
@@ -3101,10 +3869,28 @@ export declare const performanceScanDetailResponseSchema: import("./core.js").Co
         readonly lcp: z.ZodNullable<z.ZodNumber>;
         readonly tbt: z.ZodNullable<z.ZodNumber>;
         readonly cls: z.ZodNullable<z.ZodNumber>;
+        readonly completedAt: z.ZodNullable<z.ZodString>;
         readonly fcp: z.ZodNullable<z.ZodNumber>;
         readonly speedIndex: z.ZodNullable<z.ZodNumber>;
         readonly ttfb: z.ZodNullable<z.ZodNumber>;
-        readonly completedAt: z.ZodNullable<z.ZodString>;
+        readonly comparison: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            _tag: z.ZodLiteral<"compared">;
+            previousScanId: z.ZodNullable<z.ZodString>;
+            severity: z.ZodString;
+            changes: z.ZodArray<z.ZodObject<{
+                previous: z.ZodNumber;
+                current: z.ZodNumber;
+                delta: z.ZodNumber;
+                metric: z.ZodString;
+                severity: z.ZodString;
+            }, z.core.$loose>>;
+        }, z.core.$loose>, z.ZodObject<{
+            _tag: z.ZodLiteral<"incompatible">;
+            previousScanId: z.ZodNullable<z.ZodString>;
+            reasons: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>, z.ZodObject<{
+            _tag: z.ZodLiteral<"none">;
+        }, z.core.$loose>], "_tag">>;
         readonly javascript: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             transferBytes: z.ZodNullable<z.ZodNumber>;
             decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -3247,8 +4033,40 @@ export declare const performanceScanDetailOperation: {
             data: z.ZodObject<{
                 readonly id: z.ZodString;
                 readonly url: z.ZodString;
-                readonly strategy: z.ZodString;
-                readonly status: z.ZodString;
+                readonly strategy: z.ZodEnum<{
+                    desktop: "desktop";
+                    mobile: "mobile";
+                }>;
+                readonly status: z.ZodEnum<{
+                    complete: "complete";
+                    failed: "failed";
+                    running: "running";
+                }>;
+                readonly trigger: z.ZodEnum<{
+                    "claim-recheck": "claim-recheck";
+                    confirmation: "confirmation";
+                    deploy: "deploy";
+                    manual: "manual";
+                    scheduled: "scheduled";
+                }>;
+                readonly failureKind: z.ZodNullable<z.ZodEnum<{
+                    abandoned: "abandoned";
+                    "artifact-missing": "artifact-missing";
+                    empty: "empty";
+                    internal: "internal";
+                    malformed: "malformed";
+                    "monitoring-changed": "monitoring-changed";
+                    network: "network";
+                    oversize: "oversize";
+                    processing: "processing";
+                    quota: "quota";
+                    rejected: "rejected";
+                    timeout: "timeout";
+                    unavailable: "unavailable";
+                    unqueued: "unqueued";
+                }>>;
+                readonly error: z.ZodNullable<z.ZodString>;
+                readonly lighthouseVersion: z.ZodNullable<z.ZodString>;
                 readonly scores: z.ZodObject<{
                     perf: z.ZodNullable<z.ZodNumber>;
                     a11y: z.ZodNullable<z.ZodNumber>;
@@ -3258,10 +4076,58 @@ export declare const performanceScanDetailOperation: {
                 readonly lcp: z.ZodNullable<z.ZodNumber>;
                 readonly tbt: z.ZodNullable<z.ZodNumber>;
                 readonly cls: z.ZodNullable<z.ZodNumber>;
+                readonly completedAt: z.ZodNullable<z.ZodString>;
                 readonly fcp: z.ZodNullable<z.ZodNumber>;
                 readonly speedIndex: z.ZodNullable<z.ZodNumber>;
                 readonly ttfb: z.ZodNullable<z.ZodNumber>;
-                readonly completedAt: z.ZodNullable<z.ZodString>;
+                readonly comparison: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    _tag: z.ZodLiteral<"compared">;
+                    previousScanId: z.ZodNullable<z.ZodString>;
+                    severity: z.ZodEnum<{
+                        improvement: "improvement";
+                        neutral: "neutral";
+                        regression: "regression";
+                    }>;
+                    changes: z.ZodArray<z.ZodObject<{
+                        metric: z.ZodEnum<{
+                            a11y: "a11y";
+                            bestPractices: "bestPractices";
+                            cls: "cls";
+                            fcp: "fcp";
+                            inp: "inp";
+                            lcp: "lcp";
+                            perf: "perf";
+                            seo: "seo";
+                            speedIndex: "speedIndex";
+                            tbt: "tbt";
+                            ttfb: "ttfb";
+                        }>;
+                        previous: z.ZodNumber;
+                        current: z.ZodNumber;
+                        delta: z.ZodNumber;
+                        severity: z.ZodEnum<{
+                            improvement: "improvement";
+                            neutral: "neutral";
+                            regression: "regression";
+                        }>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"incompatible">;
+                    previousScanId: z.ZodNullable<z.ZodString>;
+                    reasons: z.ZodArray<z.ZodEnum<{
+                        "cpu-throttling": "cpu-throttling";
+                        "form-factor": "form-factor";
+                        "host-browser": "host-browser";
+                        "lighthouse-version": "lighthouse-version";
+                        "network-throttling": "network-throttling";
+                        "runtime-environment": "runtime-environment";
+                        source: "source";
+                        strategy: "strategy";
+                        "target-url": "target-url";
+                    }>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"none">;
+                }, z.core.$strict>], "_tag">;
                 readonly javascript: z.ZodNullable<z.ZodObject<{
                     transferBytes: z.ZodNullable<z.ZodNumber>;
                     decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -3379,6 +4245,10 @@ export declare const performanceScanDetailOperation: {
                 readonly url: z.ZodString;
                 readonly strategy: z.ZodString;
                 readonly status: z.ZodString;
+                readonly trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                readonly failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                readonly error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                readonly lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 readonly scores: z.ZodObject<{
                     perf: z.ZodNullable<z.ZodNumber>;
                     a11y: z.ZodNullable<z.ZodNumber>;
@@ -3388,10 +4258,28 @@ export declare const performanceScanDetailOperation: {
                 readonly lcp: z.ZodNullable<z.ZodNumber>;
                 readonly tbt: z.ZodNullable<z.ZodNumber>;
                 readonly cls: z.ZodNullable<z.ZodNumber>;
+                readonly completedAt: z.ZodNullable<z.ZodString>;
                 readonly fcp: z.ZodNullable<z.ZodNumber>;
                 readonly speedIndex: z.ZodNullable<z.ZodNumber>;
                 readonly ttfb: z.ZodNullable<z.ZodNumber>;
-                readonly completedAt: z.ZodNullable<z.ZodString>;
+                readonly comparison: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    _tag: z.ZodLiteral<"compared">;
+                    previousScanId: z.ZodNullable<z.ZodString>;
+                    severity: z.ZodString;
+                    changes: z.ZodArray<z.ZodObject<{
+                        previous: z.ZodNumber;
+                        current: z.ZodNumber;
+                        delta: z.ZodNumber;
+                        metric: z.ZodString;
+                        severity: z.ZodString;
+                    }, z.core.$loose>>;
+                }, z.core.$loose>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"incompatible">;
+                    previousScanId: z.ZodNullable<z.ZodString>;
+                    reasons: z.ZodArray<z.ZodString>;
+                }, z.core.$loose>, z.ZodObject<{
+                    _tag: z.ZodLiteral<"none">;
+                }, z.core.$loose>], "_tag">>;
                 readonly javascript: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     transferBytes: z.ZodNullable<z.ZodNumber>;
                     decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -3575,7 +4463,7 @@ export declare const performanceScanDetailOperation: {
     };
     readonly docs: {
         readonly summary: 'Get one Lighthouse Scan';
-        readonly description: 'Returns one Scan with the evidence behind its scores: the wasteful assets, the repeat-visit cache policy, the third-party scripts, the LCP element, and every failing accessibility and best-practices check with the CSS selectors and DOM snippets that failed. Read coverage before quoting a total: elements and checks are both capped per Scan.';
+        readonly description: 'Returns one Scan with the evidence behind its scores: the wasteful assets, the repeat-visit cache policy, the third-party scripts, the LCP element, and every failing accessibility and best-practices check with the CSS selectors and DOM snippets that failed. It also returns why the Scan started, the Lighthouse version, and the comparison with the previous Scan of the same Page. A failed Scan carries its failureKind and error. Read coverage before quoting a total: elements and checks are both capped per Scan. A null blockingTime or wastedMs is unmeasured, never zero.';
         readonly tags: readonly ["Pages"];
         readonly examples: readonly [{
             readonly request: {
@@ -3589,9 +4477,13 @@ export declare const performanceScanDetailOperation: {
                 readonly body: {
                     readonly data: {
                         readonly id: 'scan_01JXYZ';
-                        readonly url: 'https://example.com/';
+                        readonly url: 'https://example.com/pricing';
                         readonly strategy: 'mobile';
                         readonly status: 'complete';
+                        readonly trigger: 'scheduled';
+                        readonly failureKind: null;
+                        readonly error: null;
+                        readonly lighthouseVersion: '13.5.0';
                         readonly scores: {
                             readonly perf: 82;
                             readonly a11y: 96;
@@ -3605,6 +4497,24 @@ export declare const performanceScanDetailOperation: {
                         readonly speedIndex: 2400;
                         readonly ttfb: 210;
                         readonly completedAt: '2026-08-10T01:00:00.000Z';
+                        readonly comparison: {
+                            readonly _tag: 'compared';
+                            readonly previousScanId: 'scan_01JXXX';
+                            readonly severity: 'regression';
+                            readonly changes: readonly [{
+                                readonly metric: 'lcp';
+                                readonly previous: 1500;
+                                readonly current: 2200;
+                                readonly delta: 700;
+                                readonly severity: 'regression';
+                            }, {
+                                readonly metric: 'perf';
+                                readonly previous: 85;
+                                readonly current: 82;
+                                readonly delta: -3;
+                                readonly severity: 'neutral';
+                            }];
+                        };
                         readonly javascript: null;
                         readonly performanceIssues: readonly [];
                         readonly cachePolicy: readonly [];
@@ -4386,23 +5296,64 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                 data: z.ZodObject<{
                     readonly source: z.ZodNullable<z.ZodString>;
                     readonly message: z.ZodNullable<z.ZodString>;
-                    readonly findings: z.ZodArray<z.ZodObject<{
-                        readonly metric: z.ZodEnum<{
-                            cls: "cls";
-                            inp: "inp";
-                            lcp: "lcp";
+                    /** Null when no Web Analytics provider answered. */
+                    readonly window: z.ZodNullable<z.ZodObject<{
+                        from: z.ZodISODate;
+                        to: z.ZodISODate;
+                    }, z.core.$strict>>;
+                    readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        severity: z.ZodEnum<{
+                            good: "good";
+                            "needs-improvement": "needs-improvement";
+                            poor: "poor";
                         }>;
-                        readonly severity: z.ZodEnum<{
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        poorFraction: z.ZodNullable<z.ZodNumber>;
+                        labHint: z.ZodNullable<z.ZodString>;
+                        fixPrompt: z.ZodString;
+                        resource: z.ZodNullable<z.ZodString>;
+                        fetchPriority: z.ZodNullable<z.ZodString>;
+                        initiatorType: z.ZodNullable<z.ZodString>;
+                        phases: z.ZodObject<{
+                            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$strict>;
+                        metric: z.ZodLiteral<"lcp">;
+                    }, z.core.$strict>, z.ZodObject<{
+                        severity: z.ZodEnum<{
                             good: "good";
                             "needs-improvement": "needs-improvement";
                             poor: "poor";
                         }>;
-                        readonly p75: z.ZodNullable<z.ZodNumber>;
-                        readonly route: z.ZodString;
-                        readonly selector: z.ZodString;
-                        readonly estimatedViews: z.ZodNumber;
-                        readonly fixPrompt: z.ZodString;
-                    }, z.core.$strip>>;
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        poorFraction: z.ZodNullable<z.ZodNumber>;
+                        labHint: z.ZodNullable<z.ZodString>;
+                        fixPrompt: z.ZodString;
+                        metric: z.ZodLiteral<"inp">;
+                        interaction: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        severity: z.ZodEnum<{
+                            good: "good";
+                            "needs-improvement": "needs-improvement";
+                            poor: "poor";
+                        }>;
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        poorFraction: z.ZodNullable<z.ZodNumber>;
+                        labHint: z.ZodNullable<z.ZodString>;
+                        fixPrompt: z.ZodString;
+                        metric: z.ZodLiteral<"cls">;
+                    }, z.core.$strict>], "metric">>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
                     readonly offset: z.ZodNumber;
@@ -4415,23 +5366,63 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                 data: z.ZodObject<{
                     readonly source: z.ZodNullable<z.ZodString>;
                     readonly message: z.ZodNullable<z.ZodString>;
-                    readonly findings: z.ZodArray<z.ZodObject<{
-                        readonly metric: z.ZodEnum<{
-                            cls: "cls";
-                            inp: "inp";
-                            lcp: "lcp";
+                    readonly window: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        from: z.ZodISODate;
+                        to: z.ZodISODate;
+                    }, z.core.$loose>>>;
+                    readonly findings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        severity: z.ZodEnum<{
+                            good: "good";
+                            "needs-improvement": "needs-improvement";
+                            poor: "poor";
                         }>;
-                        readonly severity: z.ZodEnum<{
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        fixPrompt: z.ZodString;
+                        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        metric: z.ZodLiteral<"lcp">;
+                        resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        fetchPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        initiatorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        phases: z.ZodOptional<z.ZodObject<{
+                            timeToFirstByte: z.ZodNullable<z.ZodNumber>;
+                            resourceLoadDelay: z.ZodNullable<z.ZodNumber>;
+                            resourceLoadTime: z.ZodNullable<z.ZodNumber>;
+                            elementRenderDelay: z.ZodNullable<z.ZodNumber>;
+                        }, z.core.$loose>>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        severity: z.ZodEnum<{
                             good: "good";
                             "needs-improvement": "needs-improvement";
                             poor: "poor";
                         }>;
-                        readonly p75: z.ZodNullable<z.ZodNumber>;
-                        readonly route: z.ZodString;
-                        readonly selector: z.ZodString;
-                        readonly estimatedViews: z.ZodNumber;
-                        readonly fixPrompt: z.ZodString;
-                    }, z.core.$strip>>;
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        fixPrompt: z.ZodString;
+                        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        metric: z.ZodLiteral<"inp">;
+                        interaction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        severity: z.ZodEnum<{
+                            good: "good";
+                            "needs-improvement": "needs-improvement";
+                            poor: "poor";
+                        }>;
+                        p75: z.ZodNullable<z.ZodNumber>;
+                        route: z.ZodString;
+                        selector: z.ZodString;
+                        estimatedViews: z.ZodNumber;
+                        fixPrompt: z.ZodString;
+                        poorFraction: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                        labHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        metric: z.ZodLiteral<"cls">;
+                    }, z.core.$loose>], "metric">>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
                     readonly offset: z.ZodNumber;
@@ -4514,7 +5505,7 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
         };
         readonly docs: {
             readonly summary: 'List field Core Web Vitals findings';
-            readonly description: 'Returns each failing real-user vital attributed to the DOM element behind it, with the p75, the CSS selector, and a ready-to-apply fix prompt. It requires a connected Web Analytics provider. If no provider is connected, findings is empty and message says so.';
+            readonly description: 'Returns each failing real-user vital attributed to the DOM element behind it, with the p75, the CSS selector, and a ready-to-apply fix prompt. An LCP finding also names its resource, fetchPriority and phases. An INP finding names the interaction. window gives the dates the provider aggregated. It requires a connected Web Analytics provider. If no provider is connected, findings is empty and message says so.';
             readonly tags: readonly ["Pages"];
             readonly examples: readonly [{
                 readonly request: {
@@ -4533,6 +5524,10 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                         readonly data: {
                             readonly source: 'cloudflare';
                             readonly message: null;
+                            readonly window: {
+                                readonly from: '2026-07-13';
+                                readonly to: '2026-08-09';
+                            };
                             readonly findings: readonly [{
                                 readonly metric: 'lcp';
                                 readonly severity: 'poor';
@@ -4540,6 +5535,17 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                                 readonly route: '/blog';
                                 readonly selector: 'main > img.hero';
                                 readonly estimatedViews: 1840;
+                                readonly poorFraction: 0.31;
+                                readonly labHint: null;
+                                readonly resource: 'example.com/images/hero.jpg';
+                                readonly fetchPriority: 'auto';
+                                readonly initiatorType: 'img';
+                                readonly phases: {
+                                    readonly timeToFirstByte: 600;
+                                    readonly resourceLoadDelay: 1900;
+                                    readonly resourceLoadTime: 1200;
+                                    readonly elementRenderDelay: 600;
+                                };
                                 readonly fixPrompt: 'The LCP element on /blog is main > img.hero at 4300ms.';
                             }];
                             readonly total: 1;
@@ -4586,22 +5592,52 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
             readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
                 data: z.ZodObject<{
                     readonly scans: z.ZodArray<z.ZodObject<{
-                        readonly id: z.ZodString;
-                        readonly url: z.ZodString;
-                        readonly strategy: z.ZodString;
-                        readonly status: z.ZodString;
-                        readonly trigger: z.ZodNullable<z.ZodString>;
-                        readonly scores: z.ZodObject<{
+                        id: z.ZodString;
+                        url: z.ZodString;
+                        strategy: z.ZodEnum<{
+                            desktop: "desktop";
+                            mobile: "mobile";
+                        }>;
+                        status: z.ZodEnum<{
+                            complete: "complete";
+                            failed: "failed";
+                            running: "running";
+                        }>;
+                        trigger: z.ZodEnum<{
+                            "claim-recheck": "claim-recheck";
+                            confirmation: "confirmation";
+                            deploy: "deploy";
+                            manual: "manual";
+                            scheduled: "scheduled";
+                        }>;
+                        failureKind: z.ZodNullable<z.ZodEnum<{
+                            abandoned: "abandoned";
+                            "artifact-missing": "artifact-missing";
+                            empty: "empty";
+                            internal: "internal";
+                            malformed: "malformed";
+                            "monitoring-changed": "monitoring-changed";
+                            network: "network";
+                            oversize: "oversize";
+                            processing: "processing";
+                            quota: "quota";
+                            rejected: "rejected";
+                            timeout: "timeout";
+                            unavailable: "unavailable";
+                            unqueued: "unqueued";
+                        }>>;
+                        error: z.ZodNullable<z.ZodString>;
+                        lighthouseVersion: z.ZodNullable<z.ZodString>;
+                        scores: z.ZodObject<{
                             perf: z.ZodNullable<z.ZodNumber>;
                             a11y: z.ZodNullable<z.ZodNumber>;
                             bestPractices: z.ZodNullable<z.ZodNumber>;
                             seo: z.ZodNullable<z.ZodNumber>;
                         }, z.core.$strict>;
-                        readonly lcp: z.ZodNullable<z.ZodNumber>;
-                        readonly tbt: z.ZodNullable<z.ZodNumber>;
-                        readonly cls: z.ZodNullable<z.ZodNumber>;
-                        readonly completedAt: z.ZodNullable<z.ZodString>;
-                        readonly error: z.ZodNullable<z.ZodString>;
+                        lcp: z.ZodNullable<z.ZodNumber>;
+                        tbt: z.ZodNullable<z.ZodNumber>;
+                        cls: z.ZodNullable<z.ZodNumber>;
+                        completedAt: z.ZodNullable<z.ZodString>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -4613,22 +5649,24 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
             }, z.core.$strip>, z.ZodObject<{
                 data: z.ZodObject<{
                     readonly scans: z.ZodArray<z.ZodObject<{
-                        readonly id: z.ZodString;
-                        readonly url: z.ZodString;
-                        readonly strategy: z.ZodString;
-                        readonly status: z.ZodString;
-                        readonly trigger: z.ZodNullable<z.ZodString>;
-                        readonly scores: z.ZodObject<{
+                        id: z.ZodString;
+                        url: z.ZodString;
+                        strategy: z.ZodString;
+                        status: z.ZodString;
+                        trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        scores: z.ZodObject<{
                             perf: z.ZodNullable<z.ZodNumber>;
                             a11y: z.ZodNullable<z.ZodNumber>;
                             bestPractices: z.ZodNullable<z.ZodNumber>;
                             seo: z.ZodNullable<z.ZodNumber>;
                         }, z.core.$loose>;
-                        readonly lcp: z.ZodNullable<z.ZodNumber>;
-                        readonly tbt: z.ZodNullable<z.ZodNumber>;
-                        readonly cls: z.ZodNullable<z.ZodNumber>;
-                        readonly completedAt: z.ZodNullable<z.ZodString>;
-                        readonly error: z.ZodNullable<z.ZodString>;
+                        lcp: z.ZodNullable<z.ZodNumber>;
+                        tbt: z.ZodNullable<z.ZodNumber>;
+                        cls: z.ZodNullable<z.ZodNumber>;
+                        completedAt: z.ZodNullable<z.ZodString>;
                     }, z.core.$strip>>;
                     readonly total: z.ZodNumber;
                     readonly limit: z.ZodNumber;
@@ -4711,7 +5749,7 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
         };
         readonly docs: {
             readonly summary: 'List Lighthouse Scans';
-            readonly description: 'Returns retained Lighthouse Scans for the Site, newest first, with the scores and lab vitals each one recorded. A failed Scan carries its error. Use one Scan id with the Scan read for the failing checks behind a score.';
+            readonly description: 'Returns retained Lighthouse Scans for the Site, newest first, with the scores and lab vitals each one recorded. A failed Scan carries its failureKind and error, and its scores are null. Use one Scan id with the Scan read for the failing checks behind a score.';
             readonly tags: readonly ["Pages"];
             readonly examples: readonly [{
                 readonly request: {
@@ -4732,6 +5770,9 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                                 readonly strategy: 'mobile';
                                 readonly status: 'complete';
                                 readonly trigger: 'scheduled';
+                                readonly failureKind: null;
+                                readonly error: null;
+                                readonly lighthouseVersion: '13.5.0';
                                 readonly scores: {
                                     readonly perf: 82;
                                     readonly a11y: 96;
@@ -4742,9 +5783,27 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                                 readonly tbt: 180;
                                 readonly cls: 0.08;
                                 readonly completedAt: '2026-08-10T01:00:00.000Z';
-                                readonly error: null;
+                            }, {
+                                readonly id: 'scan_01JXZA';
+                                readonly url: 'https://example.com/blog';
+                                readonly strategy: 'mobile';
+                                readonly status: 'failed';
+                                readonly trigger: 'scheduled';
+                                readonly failureKind: 'timeout';
+                                readonly error: 'PSI timed out loading the page';
+                                readonly lighthouseVersion: null;
+                                readonly scores: {
+                                    readonly perf: null;
+                                    readonly a11y: null;
+                                    readonly bestPractices: null;
+                                    readonly seo: null;
+                                };
+                                readonly lcp: null;
+                                readonly tbt: null;
+                                readonly cls: null;
+                                readonly completedAt: '2026-08-10T01:05:00.000Z';
                             }];
-                            readonly total: 1;
+                            readonly total: 2;
                             readonly limit: 25;
                         };
                         readonly meta: {
@@ -4947,8 +6006,40 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                 data: z.ZodObject<{
                     readonly id: z.ZodString;
                     readonly url: z.ZodString;
-                    readonly strategy: z.ZodString;
-                    readonly status: z.ZodString;
+                    readonly strategy: z.ZodEnum<{
+                        desktop: "desktop";
+                        mobile: "mobile";
+                    }>;
+                    readonly status: z.ZodEnum<{
+                        complete: "complete";
+                        failed: "failed";
+                        running: "running";
+                    }>;
+                    readonly trigger: z.ZodEnum<{
+                        "claim-recheck": "claim-recheck";
+                        confirmation: "confirmation";
+                        deploy: "deploy";
+                        manual: "manual";
+                        scheduled: "scheduled";
+                    }>;
+                    readonly failureKind: z.ZodNullable<z.ZodEnum<{
+                        abandoned: "abandoned";
+                        "artifact-missing": "artifact-missing";
+                        empty: "empty";
+                        internal: "internal";
+                        malformed: "malformed";
+                        "monitoring-changed": "monitoring-changed";
+                        network: "network";
+                        oversize: "oversize";
+                        processing: "processing";
+                        quota: "quota";
+                        rejected: "rejected";
+                        timeout: "timeout";
+                        unavailable: "unavailable";
+                        unqueued: "unqueued";
+                    }>>;
+                    readonly error: z.ZodNullable<z.ZodString>;
+                    readonly lighthouseVersion: z.ZodNullable<z.ZodString>;
                     readonly scores: z.ZodObject<{
                         perf: z.ZodNullable<z.ZodNumber>;
                         a11y: z.ZodNullable<z.ZodNumber>;
@@ -4958,10 +6049,58 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                     readonly lcp: z.ZodNullable<z.ZodNumber>;
                     readonly tbt: z.ZodNullable<z.ZodNumber>;
                     readonly cls: z.ZodNullable<z.ZodNumber>;
+                    readonly completedAt: z.ZodNullable<z.ZodString>;
                     readonly fcp: z.ZodNullable<z.ZodNumber>;
                     readonly speedIndex: z.ZodNullable<z.ZodNumber>;
                     readonly ttfb: z.ZodNullable<z.ZodNumber>;
-                    readonly completedAt: z.ZodNullable<z.ZodString>;
+                    readonly comparison: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        _tag: z.ZodLiteral<"compared">;
+                        previousScanId: z.ZodNullable<z.ZodString>;
+                        severity: z.ZodEnum<{
+                            improvement: "improvement";
+                            neutral: "neutral";
+                            regression: "regression";
+                        }>;
+                        changes: z.ZodArray<z.ZodObject<{
+                            metric: z.ZodEnum<{
+                                a11y: "a11y";
+                                bestPractices: "bestPractices";
+                                cls: "cls";
+                                fcp: "fcp";
+                                inp: "inp";
+                                lcp: "lcp";
+                                perf: "perf";
+                                seo: "seo";
+                                speedIndex: "speedIndex";
+                                tbt: "tbt";
+                                ttfb: "ttfb";
+                            }>;
+                            previous: z.ZodNumber;
+                            current: z.ZodNumber;
+                            delta: z.ZodNumber;
+                            severity: z.ZodEnum<{
+                                improvement: "improvement";
+                                neutral: "neutral";
+                                regression: "regression";
+                            }>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"incompatible">;
+                        previousScanId: z.ZodNullable<z.ZodString>;
+                        reasons: z.ZodArray<z.ZodEnum<{
+                            "cpu-throttling": "cpu-throttling";
+                            "form-factor": "form-factor";
+                            "host-browser": "host-browser";
+                            "lighthouse-version": "lighthouse-version";
+                            "network-throttling": "network-throttling";
+                            "runtime-environment": "runtime-environment";
+                            source: "source";
+                            strategy: "strategy";
+                            "target-url": "target-url";
+                        }>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"none">;
+                    }, z.core.$strict>], "_tag">;
                     readonly javascript: z.ZodNullable<z.ZodObject<{
                         transferBytes: z.ZodNullable<z.ZodNumber>;
                         decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -5079,6 +6218,10 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                     readonly url: z.ZodString;
                     readonly strategy: z.ZodString;
                     readonly status: z.ZodString;
+                    readonly trigger: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    readonly failureKind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    readonly error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    readonly lighthouseVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     readonly scores: z.ZodObject<{
                         perf: z.ZodNullable<z.ZodNumber>;
                         a11y: z.ZodNullable<z.ZodNumber>;
@@ -5088,10 +6231,28 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                     readonly lcp: z.ZodNullable<z.ZodNumber>;
                     readonly tbt: z.ZodNullable<z.ZodNumber>;
                     readonly cls: z.ZodNullable<z.ZodNumber>;
+                    readonly completedAt: z.ZodNullable<z.ZodString>;
                     readonly fcp: z.ZodNullable<z.ZodNumber>;
                     readonly speedIndex: z.ZodNullable<z.ZodNumber>;
                     readonly ttfb: z.ZodNullable<z.ZodNumber>;
-                    readonly completedAt: z.ZodNullable<z.ZodString>;
+                    readonly comparison: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        _tag: z.ZodLiteral<"compared">;
+                        previousScanId: z.ZodNullable<z.ZodString>;
+                        severity: z.ZodString;
+                        changes: z.ZodArray<z.ZodObject<{
+                            previous: z.ZodNumber;
+                            current: z.ZodNumber;
+                            delta: z.ZodNumber;
+                            metric: z.ZodString;
+                            severity: z.ZodString;
+                        }, z.core.$loose>>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"incompatible">;
+                        previousScanId: z.ZodNullable<z.ZodString>;
+                        reasons: z.ZodArray<z.ZodString>;
+                    }, z.core.$loose>, z.ZodObject<{
+                        _tag: z.ZodLiteral<"none">;
+                    }, z.core.$loose>], "_tag">>;
                     readonly javascript: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         transferBytes: z.ZodNullable<z.ZodNumber>;
                         decodedBytes: z.ZodNullable<z.ZodNumber>;
@@ -5275,7 +6436,7 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
         };
         readonly docs: {
             readonly summary: 'Get one Lighthouse Scan';
-            readonly description: 'Returns one Scan with the evidence behind its scores: the wasteful assets, the repeat-visit cache policy, the third-party scripts, the LCP element, and every failing accessibility and best-practices check with the CSS selectors and DOM snippets that failed. Read coverage before quoting a total: elements and checks are both capped per Scan.';
+            readonly description: 'Returns one Scan with the evidence behind its scores: the wasteful assets, the repeat-visit cache policy, the third-party scripts, the LCP element, and every failing accessibility and best-practices check with the CSS selectors and DOM snippets that failed. It also returns why the Scan started, the Lighthouse version, and the comparison with the previous Scan of the same Page. A failed Scan carries its failureKind and error. Read coverage before quoting a total: elements and checks are both capped per Scan. A null blockingTime or wastedMs is unmeasured, never zero.';
             readonly tags: readonly ["Pages"];
             readonly examples: readonly [{
                 readonly request: {
@@ -5289,9 +6450,13 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                     readonly body: {
                         readonly data: {
                             readonly id: 'scan_01JXYZ';
-                            readonly url: 'https://example.com/';
+                            readonly url: 'https://example.com/pricing';
                             readonly strategy: 'mobile';
                             readonly status: 'complete';
+                            readonly trigger: 'scheduled';
+                            readonly failureKind: null;
+                            readonly error: null;
+                            readonly lighthouseVersion: '13.5.0';
                             readonly scores: {
                                 readonly perf: 82;
                                 readonly a11y: 96;
@@ -5305,6 +6470,24 @@ export declare const performanceV1Registry: import("./core.js").PublicV1Registry
                             readonly speedIndex: 2400;
                             readonly ttfb: 210;
                             readonly completedAt: '2026-08-10T01:00:00.000Z';
+                            readonly comparison: {
+                                readonly _tag: 'compared';
+                                readonly previousScanId: 'scan_01JXXX';
+                                readonly severity: 'regression';
+                                readonly changes: readonly [{
+                                    readonly metric: 'lcp';
+                                    readonly previous: 1500;
+                                    readonly current: 2200;
+                                    readonly delta: 700;
+                                    readonly severity: 'regression';
+                                }, {
+                                    readonly metric: 'perf';
+                                    readonly previous: 85;
+                                    readonly current: 82;
+                                    readonly delta: -3;
+                                    readonly severity: 'neutral';
+                                }];
+                            };
                             readonly javascript: null;
                             readonly performanceIssues: readonly [];
                             readonly cachePolicy: readonly [];