@cyanheads/nasa-power-mcp-server 0.1.1 → 0.2.0

package/dist/mcp-server/tools/definitions/comparison-contracts.d.ts

@@ -3,7 +3,7 @@ import { z } from '@cyanheads/mcp-ts-core';
 import { type CompareRequest } from '../../../services/power/index.js';
 /** Full per-site provenance survives analytical staging. */
 export declare const ComparisonOutputSchema: z.ZodObject<{
-    request: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    request: z.ZodObject<{
         community: z.ZodDefault<z.ZodEnum<{
             AG: "AG";
             RE: "RE";
@@ -22,174 +22,48 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
         windSurface: z.ZodOptional<z.ZodEnum<{
             "airport ice": "airport ice";
             airport_ice: "airport_ice";
+            airportgrass: "airportgrass";
             airportice: "airportice";
-            grass: "grass";
+            openwater: "openwater";
+            seaice: "seaice";
+            vegtype_1: "vegtype_1";
+            vegtype_10: "vegtype_10";
+            vegtype_11: "vegtype_11";
+            vegtype_12: "vegtype_12";
+            vegtype_2: "vegtype_2";
+            vegtype_20: "vegtype_20";
+            vegtype_3: "vegtype_3";
+            vegtype_4: "vegtype_4";
+            vegtype_5: "vegtype_5";
+            vegtype_6: "vegtype_6";
+            vegtype_7: "vegtype_7";
+            vegtype_8: "vegtype_8";
+            vegtype_9: "vegtype_9";
         }>>;
-        temporalResolution: z.ZodLiteral<"hourly">;
-        startDate: z.ZodString;
-        endDate: z.ZodString;
-        locations: z.ZodArray<z.ZodObject<{
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            label: z.ZodString;
-        }, z.core.$strict>>;
-        sort: z.ZodOptional<z.ZodObject<{
-            parameter: z.ZodString;
-            direction: z.ZodEnum<{
-                asc: "asc";
-                desc: "desc";
-            }>;
-        }, z.core.$strict>>;
-        selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            mode: z.ZodLiteral<"preset">;
-            preset: z.ZodEnum<{
-                agroclimatology: "agroclimatology";
-                building_hvac: "building_hvac";
-                solar_pv: "solar_pv";
-                water_balance: "water_balance";
-                wind_turbine: "wind_turbine";
-            }>;
-        }, z.core.$strict>, z.ZodObject<{
-            mode: z.ZodLiteral<"parameters">;
-            parameters: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>], "mode">>;
-    }, z.core.$strict>, z.ZodObject<{
-        community: z.ZodDefault<z.ZodEnum<{
-            AG: "AG";
-            RE: "RE";
-            SB: "SB";
-        }>>;
-        units: z.ZodDefault<z.ZodEnum<{
-            imperial: "imperial";
-            metric: "metric";
-        }>>;
-        timeStandard: z.ZodDefault<z.ZodEnum<{
-            LST: "LST";
-            UTC: "UTC";
-        }>>;
-        selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            mode: z.ZodLiteral<"preset">;
-            preset: z.ZodEnum<{
-                agroclimatology: "agroclimatology";
-                building_hvac: "building_hvac";
-                solar_pv: "solar_pv";
-                water_balance: "water_balance";
-                wind_turbine: "wind_turbine";
-            }>;
-        }, z.core.$strict>, z.ZodObject<{
-            mode: z.ZodLiteral<"parameters">;
-            parameters: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>], "mode">>;
-        siteElevation: z.ZodOptional<z.ZodNumber>;
-        windElevation: z.ZodOptional<z.ZodNumber>;
-        windSurface: z.ZodOptional<z.ZodEnum<{
-            "airport ice": "airport ice";
-            airport_ice: "airport_ice";
-            airportice: "airportice";
-            grass: "grass";
-        }>>;
-        startDate: z.ZodString;
-        endDate: z.ZodString;
-        locations: z.ZodArray<z.ZodObject<{
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            label: z.ZodString;
-        }, z.core.$strict>>;
-        sort: z.ZodOptional<z.ZodObject<{
-            parameter: z.ZodString;
-            direction: z.ZodEnum<{
-                asc: "asc";
-                desc: "desc";
-            }>;
-        }, z.core.$strict>>;
-        temporalResolution: z.ZodLiteral<"daily">;
-    }, z.core.$strict>, z.ZodObject<{
-        community: z.ZodDefault<z.ZodEnum<{
-            AG: "AG";
-            RE: "RE";
-            SB: "SB";
-        }>>;
-        units: z.ZodDefault<z.ZodEnum<{
-            imperial: "imperial";
-            metric: "metric";
-        }>>;
-        timeStandard: z.ZodDefault<z.ZodEnum<{
-            LST: "LST";
-            UTC: "UTC";
-        }>>;
-        selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            mode: z.ZodLiteral<"preset">;
-            preset: z.ZodEnum<{
-                agroclimatology: "agroclimatology";
-                building_hvac: "building_hvac";
-                solar_pv: "solar_pv";
-                water_balance: "water_balance";
-                wind_turbine: "wind_turbine";
-            }>;
-        }, z.core.$strict>, z.ZodObject<{
-            mode: z.ZodLiteral<"parameters">;
-            parameters: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>], "mode">>;
-        siteElevation: z.ZodOptional<z.ZodNumber>;
-        windElevation: z.ZodOptional<z.ZodNumber>;
-        windSurface: z.ZodOptional<z.ZodEnum<{
-            "airport ice": "airport ice";
-            airport_ice: "airport_ice";
-            airportice: "airportice";
-            grass: "grass";
-        }>>;
-        temporalResolution: z.ZodLiteral<"monthly">;
-        startYear: z.ZodNumber;
-        endYear: z.ZodNumber;
-        locations: z.ZodArray<z.ZodObject<{
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            label: z.ZodString;
-        }, z.core.$strict>>;
-        sort: z.ZodOptional<z.ZodObject<{
-            parameter: z.ZodString;
-            direction: z.ZodEnum<{
-                asc: "asc";
-                desc: "desc";
+        temporalResolution: z.ZodEnum<{
+            climatology: "climatology";
+            daily: "daily";
+            hourly: "hourly";
+            monthly: "monthly";
+        }>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+        startYear: z.ZodOptional<z.ZodNumber>;
+        endYear: z.ZodOptional<z.ZodNumber>;
+        selection: z.ZodObject<{
+            mode: z.ZodEnum<{
+                parameters: "parameters";
+                preset: "preset";
             }>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>, z.ZodObject<{
-        community: z.ZodDefault<z.ZodEnum<{
-            AG: "AG";
-            RE: "RE";
-            SB: "SB";
-        }>>;
-        units: z.ZodDefault<z.ZodEnum<{
-            imperial: "imperial";
-            metric: "metric";
-        }>>;
-        timeStandard: z.ZodDefault<z.ZodEnum<{
-            LST: "LST";
-            UTC: "UTC";
-        }>>;
-        selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            mode: z.ZodLiteral<"preset">;
-            preset: z.ZodEnum<{
+            preset: z.ZodOptional<z.ZodEnum<{
                 agroclimatology: "agroclimatology";
                 building_hvac: "building_hvac";
                 solar_pv: "solar_pv";
                 water_balance: "water_balance";
                 wind_turbine: "wind_turbine";
-            }>;
-        }, z.core.$strict>, z.ZodObject<{
-            mode: z.ZodLiteral<"parameters">;
-            parameters: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>], "mode">>;
-        siteElevation: z.ZodOptional<z.ZodNumber>;
-        windElevation: z.ZodOptional<z.ZodNumber>;
-        windSurface: z.ZodOptional<z.ZodEnum<{
-            "airport ice": "airport ice";
-            airport_ice: "airport_ice";
-            airportice: "airportice";
-            grass: "grass";
-        }>>;
-        startYear: z.ZodOptional<z.ZodNumber>;
-        endYear: z.ZodOptional<z.ZodNumber>;
+            }>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
         locations: z.ZodArray<z.ZodObject<{
             latitude: z.ZodNumber;
             longitude: z.ZodNumber;
@@ -202,8 +76,7 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
                 desc: "desc";
             }>;
         }, z.core.$strict>>;
-        temporalResolution: z.ZodDefault<z.ZodLiteral<"climatology">>;
-    }, z.core.$strict>], "temporalResolution">;
+    }, z.core.$strip>;
     metadata: z.ZodObject<{
         fetchedAt: z.ZodString;
         endpointUrls: z.ZodArray<z.ZodString>;
@@ -219,7 +92,7 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
         extra: z.ZodRecord<z.ZodString, z.ZodType<import("../../../services/power/index.js").JsonValue, unknown, z.core.$ZodTypeInternals<import("../../../services/power/index.js").JsonValue, unknown>>>;
     }, z.core.$strip>>;
     locations: z.ZodArray<z.ZodObject<{
-        request: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        request: z.ZodObject<{
             community: z.ZodDefault<z.ZodEnum<{
                 AG: "AG";
                 RE: "RE";
@@ -240,146 +113,49 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
             windSurface: z.ZodOptional<z.ZodEnum<{
                 "airport ice": "airport ice";
                 airport_ice: "airport_ice";
+                airportgrass: "airportgrass";
                 airportice: "airportice";
-                grass: "grass";
+                openwater: "openwater";
+                seaice: "seaice";
+                vegtype_1: "vegtype_1";
+                vegtype_10: "vegtype_10";
+                vegtype_11: "vegtype_11";
+                vegtype_12: "vegtype_12";
+                vegtype_2: "vegtype_2";
+                vegtype_20: "vegtype_20";
+                vegtype_3: "vegtype_3";
+                vegtype_4: "vegtype_4";
+                vegtype_5: "vegtype_5";
+                vegtype_6: "vegtype_6";
+                vegtype_7: "vegtype_7";
+                vegtype_8: "vegtype_8";
+                vegtype_9: "vegtype_9";
             }>>;
-            temporalResolution: z.ZodLiteral<"hourly">;
-            startDate: z.ZodString;
-            endDate: z.ZodString;
-            selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                mode: z.ZodLiteral<"preset">;
-                preset: z.ZodEnum<{
-                    agroclimatology: "agroclimatology";
-                    building_hvac: "building_hvac";
-                    solar_pv: "solar_pv";
-                    water_balance: "water_balance";
-                    wind_turbine: "wind_turbine";
+            temporalResolution: z.ZodEnum<{
+                climatology: "climatology";
+                daily: "daily";
+                hourly: "hourly";
+                monthly: "monthly";
+            }>;
+            startDate: z.ZodOptional<z.ZodString>;
+            endDate: z.ZodOptional<z.ZodString>;
+            startYear: z.ZodOptional<z.ZodNumber>;
+            endYear: z.ZodOptional<z.ZodNumber>;
+            selection: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    parameters: "parameters";
+                    preset: "preset";
                 }>;
-            }, z.core.$strict>, z.ZodObject<{
-                mode: z.ZodLiteral<"parameters">;
-                parameters: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>], "mode">>;
-        }, z.core.$strict>, z.ZodObject<{
-            community: z.ZodDefault<z.ZodEnum<{
-                AG: "AG";
-                RE: "RE";
-                SB: "SB";
-            }>>;
-            units: z.ZodDefault<z.ZodEnum<{
-                imperial: "imperial";
-                metric: "metric";
-            }>>;
-            timeStandard: z.ZodDefault<z.ZodEnum<{
-                LST: "LST";
-                UTC: "UTC";
-            }>>;
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                mode: z.ZodLiteral<"preset">;
-                preset: z.ZodEnum<{
+                preset: z.ZodOptional<z.ZodEnum<{
                     agroclimatology: "agroclimatology";
                     building_hvac: "building_hvac";
                     solar_pv: "solar_pv";
                     water_balance: "water_balance";
                     wind_turbine: "wind_turbine";
-                }>;
-            }, z.core.$strict>, z.ZodObject<{
-                mode: z.ZodLiteral<"parameters">;
-                parameters: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>], "mode">>;
-            siteElevation: z.ZodOptional<z.ZodNumber>;
-            windElevation: z.ZodOptional<z.ZodNumber>;
-            windSurface: z.ZodOptional<z.ZodEnum<{
-                "airport ice": "airport ice";
-                airport_ice: "airport_ice";
-                airportice: "airportice";
-                grass: "grass";
-            }>>;
-            temporalResolution: z.ZodDefault<z.ZodLiteral<"daily">>;
-            startDate: z.ZodString;
-            endDate: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            community: z.ZodDefault<z.ZodEnum<{
-                AG: "AG";
-                RE: "RE";
-                SB: "SB";
-            }>>;
-            units: z.ZodDefault<z.ZodEnum<{
-                imperial: "imperial";
-                metric: "metric";
-            }>>;
-            timeStandard: z.ZodDefault<z.ZodEnum<{
-                LST: "LST";
-                UTC: "UTC";
-            }>>;
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                mode: z.ZodLiteral<"preset">;
-                preset: z.ZodEnum<{
-                    agroclimatology: "agroclimatology";
-                    building_hvac: "building_hvac";
-                    solar_pv: "solar_pv";
-                    water_balance: "water_balance";
-                    wind_turbine: "wind_turbine";
-                }>;
-            }, z.core.$strict>, z.ZodObject<{
-                mode: z.ZodLiteral<"parameters">;
-                parameters: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>], "mode">>;
-            siteElevation: z.ZodOptional<z.ZodNumber>;
-            windElevation: z.ZodOptional<z.ZodNumber>;
-            windSurface: z.ZodOptional<z.ZodEnum<{
-                "airport ice": "airport ice";
-                airport_ice: "airport_ice";
-                airportice: "airportice";
-                grass: "grass";
-            }>>;
-            temporalResolution: z.ZodLiteral<"monthly">;
-            startYear: z.ZodNumber;
-            endYear: z.ZodNumber;
-        }, z.core.$strict>, z.ZodObject<{
-            community: z.ZodDefault<z.ZodEnum<{
-                AG: "AG";
-                RE: "RE";
-                SB: "SB";
-            }>>;
-            units: z.ZodDefault<z.ZodEnum<{
-                imperial: "imperial";
-                metric: "metric";
-            }>>;
-            timeStandard: z.ZodDefault<z.ZodEnum<{
-                LST: "LST";
-                UTC: "UTC";
-            }>>;
-            latitude: z.ZodNumber;
-            longitude: z.ZodNumber;
-            selection: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                mode: z.ZodLiteral<"preset">;
-                preset: z.ZodEnum<{
-                    agroclimatology: "agroclimatology";
-                    building_hvac: "building_hvac";
-                    solar_pv: "solar_pv";
-                    water_balance: "water_balance";
-                    wind_turbine: "wind_turbine";
-                }>;
-            }, z.core.$strict>, z.ZodObject<{
-                mode: z.ZodLiteral<"parameters">;
-                parameters: z.ZodArray<z.ZodString>;
-            }, z.core.$strict>], "mode">>;
-            siteElevation: z.ZodOptional<z.ZodNumber>;
-            windElevation: z.ZodOptional<z.ZodNumber>;
-            windSurface: z.ZodOptional<z.ZodEnum<{
-                "airport ice": "airport ice";
-                airport_ice: "airport_ice";
-                airportice: "airportice";
-                grass: "grass";
-            }>>;
-            temporalResolution: z.ZodLiteral<"climatology">;
-            startYear: z.ZodOptional<z.ZodNumber>;
-            endYear: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>], "temporalResolution">;
+                }>>;
+                parameters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
         metadata: z.ZodObject<{
             endpointUrl: z.ZodString;
             fetchedAt: z.ZodString;
@@ -452,6 +228,7 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
         label: z.ZodString;
         latitude: z.ZodNumber;
         longitude: z.ZodNumber;
+        summaryCount: z.ZodOptional<z.ZodNumber>;
         sortMetric: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>;
     failed: z.ZodArray<z.ZodObject<{
@@ -543,6 +320,44 @@ export declare const ComparisonOutputSchema: z.ZodObject<{
         describeTool: z.ZodLiteral<"nasa_power_dataframe_describe">;
         queryTool: z.ZodLiteral<"nasa_power_dataframe_query">;
     }, z.core.$strip>>;
+    summaryDatasets: z.ZodOptional<z.ZodObject<{
+        buckets: z.ZodObject<{
+            canvas_id: z.ZodString;
+            table: z.ZodString;
+            rowCount: z.ZodNumber;
+            expiresAt: z.ZodString;
+            columns: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                nullable: z.ZodBoolean;
+                units: z.ZodOptional<z.ZodString>;
+                valueKind: z.ZodOptional<z.ZodEnum<{
+                    number: "number";
+                    orientation: "orientation";
+                }>>;
+            }, z.core.$strip>>;
+            describeTool: z.ZodLiteral<"nasa_power_dataframe_describe">;
+            queryTool: z.ZodLiteral<"nasa_power_dataframe_query">;
+        }, z.core.$strip>;
+        locations: z.ZodObject<{
+            canvas_id: z.ZodString;
+            table: z.ZodString;
+            rowCount: z.ZodNumber;
+            expiresAt: z.ZodString;
+            columns: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodString;
+                nullable: z.ZodBoolean;
+                units: z.ZodOptional<z.ZodString>;
+                valueKind: z.ZodOptional<z.ZodEnum<{
+                    number: "number";
+                    orientation: "orientation";
+                }>>;
+            }, z.core.$strip>>;
+            describeTool: z.ZodLiteral<"nasa_power_dataframe_describe">;
+            queryTool: z.ZodLiteral<"nasa_power_dataframe_query">;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Sequential sites share references, pacing, attempts, decoded bytes and deadline. */
 export declare function presentComparison(request: CompareRequest, canvasId: string | undefined, ctx: Context): Promise<import("../../../services/canvas/index.js").PresentedDataset<{
@@ -552,7 +367,7 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
         timeStandard: "LST" | "UTC";
         siteElevation?: number | undefined;
         windElevation?: number | undefined;
-        windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
+        windSurface?: "airport ice" | "airport_ice" | "airportgrass" | "airportice" | "openwater" | "seaice" | "vegtype_1" | "vegtype_10" | "vegtype_11" | "vegtype_12" | "vegtype_2" | "vegtype_20" | "vegtype_3" | "vegtype_4" | "vegtype_5" | "vegtype_6" | "vegtype_7" | "vegtype_8" | "vegtype_9" | undefined;
         temporalResolution: "hourly";
         startDate: string;
         endDate: string;
@@ -585,7 +400,7 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
         };
         siteElevation?: number | undefined;
         windElevation?: number | undefined;
-        windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
+        windSurface?: "airport ice" | "airport_ice" | "airportgrass" | "airportice" | "openwater" | "seaice" | "vegtype_1" | "vegtype_10" | "vegtype_11" | "vegtype_12" | "vegtype_2" | "vegtype_20" | "vegtype_3" | "vegtype_4" | "vegtype_5" | "vegtype_6" | "vegtype_7" | "vegtype_8" | "vegtype_9" | undefined;
         startDate: string;
         endDate: string;
         locations: {
@@ -611,7 +426,7 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
         };
         siteElevation?: number | undefined;
         windElevation?: number | undefined;
-        windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
+        windSurface?: "airport ice" | "airport_ice" | "airportgrass" | "airportice" | "openwater" | "seaice" | "vegtype_1" | "vegtype_10" | "vegtype_11" | "vegtype_12" | "vegtype_2" | "vegtype_20" | "vegtype_3" | "vegtype_4" | "vegtype_5" | "vegtype_6" | "vegtype_7" | "vegtype_8" | "vegtype_9" | undefined;
         temporalResolution: "monthly";
         startYear: number;
         endYear: number;
@@ -637,7 +452,7 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
         };
         siteElevation?: number | undefined;
         windElevation?: number | undefined;
-        windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
+        windSurface?: "airport ice" | "airport_ice" | "airportgrass" | "airportice" | "openwater" | "seaice" | "vegtype_1" | "vegtype_10" | "vegtype_11" | "vegtype_12" | "vegtype_2" | "vegtype_20" | "vegtype_3" | "vegtype_4" | "vegtype_5" | "vegtype_6" | "vegtype_7" | "vegtype_8" | "vegtype_9" | undefined;
         startYear?: number | undefined;
         endYear?: number | undefined;
         locations: {
@@ -670,74 +485,17 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
             longitude: number;
             siteElevation?: number | undefined;
             windElevation?: number | undefined;
-            windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
-            temporalResolution: "hourly";
-            startDate: string;
-            endDate: string;
-            selection: {
-                mode: "preset";
-                preset: "agroclimatology" | "building_hvac" | "solar_pv" | "water_balance" | "wind_turbine";
-            } | {
-                mode: "parameters";
-                parameters: string[];
-            };
-        } | {
-            community: "AG" | "RE" | "SB";
-            units: "imperial" | "metric";
-            timeStandard: "LST" | "UTC";
-            latitude: number;
-            longitude: number;
-            selection: {
-                mode: "preset";
-                preset: "agroclimatology" | "building_hvac" | "solar_pv" | "water_balance" | "wind_turbine";
-            } | {
-                mode: "parameters";
-                parameters: string[];
-            };
-            siteElevation?: number | undefined;
-            windElevation?: number | undefined;
-            windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
-            temporalResolution: "daily";
-            startDate: string;
-            endDate: string;
-        } | {
-            community: "AG" | "RE" | "SB";
-            units: "imperial" | "metric";
-            timeStandard: "LST" | "UTC";
-            latitude: number;
-            longitude: number;
-            selection: {
-                mode: "preset";
-                preset: "agroclimatology" | "building_hvac" | "solar_pv" | "water_balance" | "wind_turbine";
-            } | {
-                mode: "parameters";
-                parameters: string[];
-            };
-            siteElevation?: number | undefined;
-            windElevation?: number | undefined;
-            windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
-            temporalResolution: "monthly";
-            startYear: number;
-            endYear: number;
-        } | {
-            community: "AG" | "RE" | "SB";
-            units: "imperial" | "metric";
-            timeStandard: "LST" | "UTC";
-            latitude: number;
-            longitude: number;
-            selection: {
-                mode: "preset";
-                preset: "agroclimatology" | "building_hvac" | "solar_pv" | "water_balance" | "wind_turbine";
-            } | {
-                mode: "parameters";
-                parameters: string[];
-            };
-            siteElevation?: number | undefined;
-            windElevation?: number | undefined;
-            windSurface?: "airport ice" | "airport_ice" | "airportice" | "grass" | undefined;
-            temporalResolution: "climatology";
+            windSurface?: "airport ice" | "airport_ice" | "airportgrass" | "airportice" | "openwater" | "seaice" | "vegtype_1" | "vegtype_10" | "vegtype_11" | "vegtype_12" | "vegtype_2" | "vegtype_20" | "vegtype_3" | "vegtype_4" | "vegtype_5" | "vegtype_6" | "vegtype_7" | "vegtype_8" | "vegtype_9" | undefined;
+            temporalResolution: "climatology" | "daily" | "hourly" | "monthly";
+            startDate?: string | undefined;
+            endDate?: string | undefined;
             startYear?: number | undefined;
             endYear?: number | undefined;
+            selection: {
+                mode: "parameters" | "preset";
+                preset?: "agroclimatology" | "building_hvac" | "solar_pv" | "water_balance" | "wind_turbine" | undefined;
+                parameters?: string[] | undefined;
+            };
         };
         metadata: {
             endpointUrl: string;
@@ -798,6 +556,7 @@ export declare function presentComparison(request: CompareRequest, canvasId: str
         label: string;
         latitude: number;
         longitude: number;
+        summaryCount?: number | undefined;
         sortMetric: number | null;
     }[];
     failed: {

package/dist/mcp-server/tools/definitions/comparison-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comparison-contracts.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/comparison-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAI3C,OAAO,EACL,KAAK,cAAc,EAcpB,MAAM,2BAA2B,CAAC;AAsCnC,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkDjC,CAAC;AAEH,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqLJ,SAAS;QACT,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAoBD,MAAM;cACP,aAAa;;;;;;;;;;;;;;;IAWhC"}
+{"version":3,"file":"comparison-contracts.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/comparison-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAI3C,OAAO,EACL,KAAK,cAAc,EAcpB,MAAM,2BAA2B,CAAC;AA2CnC,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuDjC,CAAC;AAEH,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAyLJ,SAAS;QACT,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAoBD,MAAM;cACP,aAAa;;;;;;;;;;;;;;;IAWhC"}

package/dist/mcp-server/tools/definitions/comparison-contracts.js

@@ -3,8 +3,8 @@ import { createHash } from 'node:crypto';
 import { z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
 import { POWER_LIMITS } from '../../../config/server-config.js';
-import { getCanvasService } from '../../../services/canvas/index.js';
-import { CompareRequestSchema, DatasetHandleSchema, describePowerError, getPowerService, ObservationRowSchema, PowerDatasetSchema, powerError, requestedParameters, summarizeBuckets, } from '../../../services/power/index.js';
+import { getCanvasService, SummaryDatasetsSchema } from '../../../services/canvas/index.js';
+import { DatasetHandleSchema, describePowerError, getPowerService, NormalizedCompareRequestSchema, ObservationRowSchema, PowerDatasetSchema, powerError, requestedParameters, summarizeBuckets, } from '../../../services/power/index.js';
 const IdentitySchema = z.object({
     locationId: z.string().describe('Stable identity assigned by input position'),
     label: z.string().describe('Verbatim caller label, possibly duplicated'),
@@ -36,6 +36,11 @@ const BucketSchema = z.object({
     mean: z.number().nullable().describe('Valid-only arithmetic mean, null without valid values'),
 });
 const LocationSchema = IdentitySchema.extend(PowerDatasetSchema.omit({ rows: true }).shape).extend({
+    summaryCount: z
+        .number()
+        .int()
+        .optional()
+        .describe('Exact number of summaries for this location when summaries are previews'),
     sortMetric: z
         .number()
         .nullable()
@@ -43,7 +48,7 @@ const LocationSchema = IdentitySchema.extend(PowerDatasetSchema.omit({ rows: tru
 });
 /** Full per-site provenance survives analytical staging. */
 export const ComparisonOutputSchema = z.object({
-    request: CompareRequestSchema.describe('Normalized shared request and original location order'),
+    request: NormalizedCompareRequestSchema.describe('Normalized shared request and original location order'),
     metadata: z
         .object({
         fetchedAt: z.string().describe('Comparison assembly access time'),
@@ -88,9 +93,14 @@ export const ComparisonOutputSchema = z.object({
         .describe('Complete observations or bounded preview when staged'),
     rowCount: z.number().int().describe('Exact full merged observation count'),
     dataset: DatasetHandleSchema.nullable().describe('Full-table handle on overflow, otherwise null'),
+    summaryDatasets: SummaryDatasetsSchema.optional().describe('Full summary handles when summary arrays are bounded previews; summaryIndex restores original order'),
 });
 /** Sequential sites share references, pacing, attempts, decoded bytes and deadline. */
 export function presentComparison(request, canvasId, ctx) {
+    if (request.selection.mode === 'parameters')
+        request.selection.parameters = [...new Set(request.selection.parameters)];
+    if (request.windSurface === 'airport_ice' || request.windSurface === 'airport ice')
+        request.windSurface = 'airportice';
     return getCanvasService().withProducer('comparison', ctx, async (producerCtx) => {
         const power = getPowerService();
         const budget = power.createCallBudget(producerCtx, true);
@@ -236,7 +246,7 @@ export function presentComparison(request, canvasId, ctx) {
                     ? -1
                     : (sort.direction === 'asc' ? 1 : -1) * (a.sortMetric - b.sortMetric));
         callCtx.signal.throwIfAborted();
-        return getCanvasService().present({
+        return getCanvasService().presentComparison({
             request,
             metadata: {
                 fetchedAt: new Date().toISOString(),