@purveyors/sdk 0.50.0 → 0.52.0

package/dist/index.d.ts

@@ -4124,6 +4124,16 @@ interface paths {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -4237,6 +4247,16 @@ interface paths {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -4385,6 +4405,16 @@ interface paths {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -6092,6 +6122,178 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/catalog/compare": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Compare catalog coffees side by side
+         * @description Compares 2 to 6 catalog coffees: price at a chosen quantity, tiers, origin-median context, availability, origin, process, variety, grading (screen size, grade designations by dimension, lab analysis, defects, and protocol-labeled cup score), and tasting notes. Grading rows never carry best marks. Each row is marked same, partial, or different, and price rows mark the cheapest lots. Viewer sessions compare 2 coffees; member and Parchment Intelligence sessions and customer API keys with catalog:read compare up to 6.
+         */
+        get: {
+            parameters: {
+                query: {
+                    ids: string;
+                    quantityLbs?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Lots with comparison rows */
+                200: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogComparisonResponse"];
+                    };
+                };
+                /** @description Invalid ids or quantity */
+                400: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/grades": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Green grade designation vocabulary
+         * @description Lists namespaced grade codes (`<system>:<token>`, e.g. KE:AA, ET:G1, GT:SHB, PREP:EP) with their system, issuing body, grading dimensions, label, description, and any cited implied ranges. Reference data: identical for every authorized caller and not subject to row projection or collection limits. Retired codes are omitted unless includeRetired=true.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    includeRetired?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Grade designations */
+                200: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogGradesResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/catalog/{id}/price-history": {
         parameters: {
             query?: never;
@@ -14118,6 +14320,13 @@ interface components {
                 canExport: boolean;
             };
         };
+        GradeImpliedRanges: {
+            screen_min: number | null;
+            /** @description Null with a minimum means the definition has no upper threshold. */
+            screen_max: number | null;
+            elevation_min_masl: number | null;
+            elevation_max_masl: number | null;
+        } | null;
         /** @description API-owned row-level trust summary. Raw evidence is never included. */
         CatalogProofSummary: {
             /** @enum {string} */
@@ -14219,6 +14428,38 @@ interface components {
             unstocked_date?: string | null;
             ai_description?: string | null;
             ai_tasting_notes?: unknown;
+            /** @description ADR-016 green grading (member sessions and customer API keys). Disclosed values only; implied ranges stay on each code. */
+            grading?: {
+                elevation: {
+                    min_masl: number | null;
+                    max_masl: number | null;
+                };
+                screen: {
+                    /** @description Disclosed screen size, 64ths of an inch */
+                    min: number | null;
+                    /** @description Null with a minimum means open-ended upward (18+) */
+                    max: number | null;
+                };
+                codes: {
+                    code: string;
+                    label: string;
+                    system: string;
+                    dimensions: ("size" | "altitude" | "defects" | "cup" | "preparation")[];
+                    implied: components["schemas"]["GradeImpliedRanges"];
+                }[];
+                /** @description Versioned lab analysis: moisture_pct, water_activity, density_g_l, density_method, quakers, defects {protocol, sample_g, category_1, category_2, full_defect_equivalents} */
+                analysis: {
+                    [key: string]: unknown;
+                } | null;
+                cup_score: {
+                    value: number | null;
+                    /**
+                     * @description Scores compare only within one established protocol; supplier_unspecified is never ranked.
+                     * @enum {string|null}
+                     */
+                    protocol: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified" | null;
+                };
+            };
             proof?: components["schemas"]["CatalogProofSummary"];
             /** @description Entitled metadata-presence signals returned only by projection=summary; false also covers fields outside the caller projection. */
             summarySignals?: {
@@ -15820,6 +16061,86 @@ interface components {
                 query_strategy: "bounded-vector-candidates-v1";
             };
         };
+        CatalogComparisonResponse: {
+            data: {
+                quantityLbs: number;
+                lots: {
+                    id: number;
+                    name: string;
+                    source: string | null;
+                    link: string | null;
+                    stocked: boolean | null;
+                    wholesale: boolean | null;
+                    price: {
+                        quantityLbs: number;
+                        /** @description Price per lb when buying the requested quantity; null below the minimum order. */
+                        atQuantityLb: number | null;
+                        smallestTierLb: number | null;
+                        minOrderLbs: number | null;
+                        tiers: {
+                            minLbs: number | null;
+                            priceLb: number;
+                        }[];
+                        originMedianLb: number | null;
+                        vsOriginMedianPct: number | null;
+                    };
+                }[];
+                rows: {
+                    key: string;
+                    /** @enum {string} */
+                    group: "Price" | "Availability" | "Origin" | "Process" | "Coffee" | "Grading" | "Taste" | "Listing";
+                    label: string;
+                    /** @description One value per lot, in lot order; null when that lot does not disclose it. */
+                    values: (string | number | null)[];
+                    /**
+                     * @description same: every lot has the same value. partial: the lots that disclose it agree, but some do not disclose it. different: values differ.
+                     * @enum {string}
+                     */
+                    relation: "same" | "different" | "partial";
+                    /** @description Lots with the lowest price on price rows whose values differ; empty otherwise. */
+                    bestLotIds: number[];
+                }[];
+                bestPriceLotIds: number[];
+                /** @description Requested ids not visible to this caller or not found. */
+                missingIds: number[];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-compare";
+                /** @enum {string} */
+                namespace: "/v1/catalog/compare";
+                /** @enum {string} */
+                version: "v1";
+                maxLots: number;
+            };
+        };
+        GradeDesignation: {
+            /** @example KE:AA */
+            code: string;
+            /** @example KE */
+            system: string;
+            issuing_body: string | null;
+            country_code: string | null;
+            dimensions: ("size" | "altitude" | "defects" | "cup" | "preparation")[];
+            label: string;
+            description: string;
+            implied: components["schemas"]["GradeImpliedRanges"] & unknown;
+            implied_source: string | null;
+            active: boolean;
+            sort_order: number;
+        };
+        CatalogGradesResponse: {
+            data: components["schemas"]["GradeDesignation"][];
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-grades";
+                /** @enum {string} */
+                namespace: "/v1/catalog/grades";
+                /** @enum {string} */
+                version: "v1";
+                dimensions: ("size" | "altitude" | "defects" | "cup" | "preparation")[];
+            };
+        };
         LotPriceHistoryResponse: {
             data: {
                 catalogId: number;
@@ -17859,6 +18180,10 @@ type CatalogRankPremiumHeaders = NonNullable<paths["/v1/catalog/rank-premium"]["
 type CatalogSupplierHeaders = NonNullable<paths["/v1/catalog/suppliers"]["get"]["parameters"]["header"]>;
 /** Query parameters for {@link ParchmentClient.catalog.similar}. */
 type CatalogSimilarQuery = NonNullable<paths["/v1/catalog/{id}/similar"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.catalog.compare}. */
+type CatalogCompareQuery = NonNullable<paths["/v1/catalog/compare"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.catalog.grades}. */
+type CatalogGradesQuery = NonNullable<paths["/v1/catalog/grades"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.catalog.priceHistory}. */
 type CatalogPriceHistoryQuery = NonNullable<paths["/v1/catalog/{id}/price-history"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.priceIndex.list}. */
@@ -20451,6 +20776,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -20547,6 +20882,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -20591,6 +20936,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -20714,6 +21069,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -20766,6 +21131,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -20856,6 +21231,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     elevationMinMasl?: number | null;
                     elevationMaxMasl?: number | null;
                     includeUnknownElevation?: "true" | "false";
+                    screenMin?: number | null;
+                    screenMax?: number | null;
+                    includeUnknownScreen?: "true" | "false";
+                    gradeCode?: string | string[];
+                    peaberry?: "true" | "false";
+                    labAnalyzed?: "true" | "false";
+                    moistureMax?: number | null;
+                    waterActivityMax?: number | null;
+                    densityMin?: number | null;
+                    scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -21660,6 +22045,85 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Compare 2 to 6 catalog coffees side by side. */
+        compare: (query: CatalogCompareQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query: {
+                    ids: string;
+                    quantityLbs?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogComparisonResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        }, {
+            params: {
+                query: {
+                    ids: string;
+                    quantityLbs?: string;
+                };
+            };
+        }, `${string}/${string}`>>;
         /** Daily price history for one catalog coffee, with minimum-tier change events. */
         priceHistory: (id: string, query?: CatalogPriceHistoryQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -21756,6 +22220,69 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Green grade designation vocabulary, e.g. KE:AA, GT:SHB, PREP:EP. */
+        grades: (query?: CatalogGradesQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    includeRetired?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogGradesResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        }, {
+            params: {
+                query: {
+                    includeRetired?: "true" | "false";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
     };
     priceIndex: {
         /** Available exact 30-day comparisons, with no empty-origin search. */
@@ -29076,7 +29603,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: components["responses"]["ApiRateLimitExceeded"];
+                429: 
+                /** Closed session-only command for {@link ParchmentClient.confirmedActions.execute}. */
+                components["responses"]["ApiRateLimitExceeded"];
             };
         }, {
             params: {
@@ -29115,9 +29644,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
-                        "X-RateLimit-Burst-Limit": 
-                        /** Anonymous capability body for {@link ParchmentClient.inventory.shareGrants.redeem}. */
-                        components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
@@ -29277,10 +29804,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
-                        "X-RateLimit-Reset": 
-                        /** List the caller's saved sourcing briefs. */
-                        components["headers"]["X-RateLimit-Reset"];
-                        "X-RateLimit-Burst-Limit": components["headers"] /** Create a saved sourcing brief. */["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
@@ -29346,7 +29871,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
                 401: {
                     headers: {
-                        "X-RateLimit-Limit": components["headers"] /** Read older messages before a canonical sequence cursor. */["X-RateLimit-Limit"];
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
@@ -29490,7 +30015,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
-                        "X-RateLimit-Reset": components["headers"] /** List the caller's own roast profiles (owner-scoped). */["X-RateLimit-Reset"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
@@ -30057,7 +30582,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": 
+                        /** Request body for {@link ParchmentClient.apiKeys.create}. */
+                        components["schemas"]["ErrorResponse"];
                     };
                 };
                 403: {
@@ -31261,7 +31788,7 @@ type ParchmentClientMethod = MethodPaths<Omit<ParchmentClient, "raw">>;
  * SDK (such as the CLI) can import this list to prove they cover everything
  * the web agent can do.
  */
-declare const CHAT_AGENT_CAPABILITIES: readonly ["me", "catalog.list", "catalog.facets", "catalog.rank", "catalog.suppliers", "catalog.similar", "inventory.list", "roasts.list", "roasts.get", "roasts.chartData", "referenceProfiles.list", "referenceProfiles.get", "referenceProfiles.chart", "referenceProfiles.compare", "referenceProfiles.preview", "tasting.get", "priceIndex.list", "priceIndex.stats", "priceIndex.comparisons", "priceIndex.comparison", "priceIndex.history", "market.signals", "market.metadataIndex", "market.overview", "market.evidence"];
+declare const CHAT_AGENT_CAPABILITIES: readonly ["me", "catalog.list", "catalog.facets", "catalog.rank", "catalog.suppliers", "catalog.similar", "catalog.compare", "catalog.grades", "catalog.priceHistory", "inventory.list", "roasts.list", "roasts.get", "roasts.chartData", "referenceProfiles.list", "referenceProfiles.get", "referenceProfiles.chart", "referenceProfiles.compare", "referenceProfiles.preview", "tasting.get", "priceIndex.list", "priceIndex.stats", "priceIndex.comparisons", "priceIndex.comparison", "priceIndex.history", "market.signals", "market.metadataIndex", "market.overview", "market.evidence"];
 type ChatAgentCapability = (typeof CHAT_AGENT_CAPABILITIES)[number];
 /**
  * Writes the web agent can propose. The agent never writes directly: it
@@ -31306,4 +31833,4 @@ type PickPaths<T, P extends string> = {
 };
 type ChatAgentClient = PickPaths<ParchmentClient, ChatAgentCapability>;
 
-export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, CHAT_AGENT_CAPABILITIES, CHAT_AGENT_CAPABILITY_EXCLUSIONS, CHAT_AGENT_CONFIRMED_ACTION_TYPES, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogPriceHistoryQuery, type CatalogProofSummary, type CatalogSimilarQuery, type ChatAgentCapability, type ChatAgentCapabilityExclusion, type ChatAgentCapabilityExclusionReason, type ChatAgentClient, type ChatAgentConfirmedActionType, type ConfirmedActionExecuteRequest, type ConversationCanvasUpdateRequest, type ConversationChatStreamRequest, type ConversationMemoryDreamRequest, type ConversationMemoryUpdateRequest, type ConversationMessageAppendRequest, type ConversationSummaryUpdateRequest, type ConversationWorkspaceClearRequest, type ConversationWorkspaceCreateRequest, type ConversationWorkspaceMetadataRequest, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientMethod, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartData, type RoastChartDataQuery, type RoastChartEvent, type RoastChartSeries, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, CHAT_AGENT_CAPABILITIES, CHAT_AGENT_CAPABILITY_EXCLUSIONS, CHAT_AGENT_CONFIRMED_ACTION_TYPES, type CatalogCompareQuery, type CatalogGradesQuery, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogPriceHistoryQuery, type CatalogProofSummary, type CatalogSimilarQuery, type ChatAgentCapability, type ChatAgentCapabilityExclusion, type ChatAgentCapabilityExclusionReason, type ChatAgentClient, type ChatAgentConfirmedActionType, type ConfirmedActionExecuteRequest, type ConversationCanvasUpdateRequest, type ConversationChatStreamRequest, type ConversationMemoryDreamRequest, type ConversationMemoryUpdateRequest, type ConversationMessageAppendRequest, type ConversationSummaryUpdateRequest, type ConversationWorkspaceClearRequest, type ConversationWorkspaceCreateRequest, type ConversationWorkspaceMetadataRequest, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientMethod, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartData, type RoastChartDataQuery, type RoastChartEvent, type RoastChartSeries, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };