@purveyors/sdk 0.54.0 → 0.57.0

package/dist/index.d.ts

@@ -4362,6 +4362,9 @@ interface paths {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                 };
                 header?: {
                     Prefer?: string;
@@ -4386,6 +4389,21 @@ interface paths {
                         "application/json": components["schemas"]["CatalogListResponse"];
                     };
                 };
+                /** @description Invalid query: an unknown variety, species or drying method code */
+                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: {
@@ -4486,6 +4504,9 @@ interface paths {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     place_id?: string;
                     bbox?: string;
                     zoom?: number;
@@ -4515,7 +4536,7 @@ interface paths {
                         "application/json": components["schemas"]["CatalogMapResponse"];
                     };
                 };
-                /** @description Malformed map geometry, zoom, place id, or elevation range */
+                /** @description Malformed map geometry, zoom, place id, or elevation range, or an unknown variety, species or drying method code */
                 400: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -4600,7 +4621,7 @@ interface paths {
         get: {
             parameters: {
                 query?: {
-                    include?: "grading";
+                    include?: ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading") | ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading")[];
                     stocked?: "true" | "false" | "all";
                     showWholesale?: "true" | "false";
                     wholesaleOnly?: "true" | "false";
@@ -4640,6 +4661,9 @@ interface paths {
                     waterActivityMax?: number | null;
                     densityMin?: number | null;
                     scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -4670,6 +4694,21 @@ interface paths {
                         "application/json": components["schemas"]["CatalogFacetsResponse"];
                     };
                 };
+                /** @description Invalid query: an unknown variety, species or drying method code */
+                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: {
@@ -6519,6 +6558,84 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/catalog/taxonomies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Variety, species, and drying-method vocabularies
+         * @description Lists canonical variety, species, and drying-method codes with labels, family links (`parent_code`), descriptions, and the supplier spellings (`aliases`) that map to each code. Reference data: identical for every authorized caller and not subject to row projection or collection limits. Retired codes are omitted unless includeRetired=true, except a retired family or species that an active code still names in `parent_code` or `species_code`: it is returned with `active: false` so every link resolves within the response. New values are added as rows; clients should not hard-code the lists.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    includeRetired?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Taxonomy vocabularies */
+                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"]["CatalogTaxonomiesResponse"];
+                    };
+                };
+                /** @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;
@@ -10020,7 +10137,7 @@ interface paths {
         get?: never;
         /**
          * Replace an owner roast live curve
-         * @description Atomically replace live temperature samples and all event markers, derive milestone and phase fields upstream, and preserve non-live temperature samples. Optional If-Match protects against lost updates.
+         * @description Atomically replace live temperature samples and all event markers, derive milestone and phase fields upstream, and preserve non-live temperature samples. The fields are derived from milestone events named `charge`, `dry_end`, `fc_start`, `fc_end`, `sc_start`, `drop`, and `cool`; the older names `start`, `maillard`, and `end` are read as `charge`, `dry_end`, and `cool` when the current name is absent. Derived times count from CHARGE, or from the start of the recording when neither `charge` nor `start` is sent, in which case `charge_time` is null. A turning point is not derived. Optional If-Match protects against lost updates.
          */
         put: {
             parameters: {
@@ -14238,6 +14355,7 @@ interface components {
         ReferenceProfileChart: {
             /** @enum {string} */
             temperatureUnit: "F" | "C";
+            /** @description Where CHARGE sits on the chart's clock, in milliseconds since the recording started. Null when no CHARGE is marked. Subtract it from any chart time for time since CHARGE. */
             chargeTimeMilliseconds: number | null;
             series: {
                 id: string;
@@ -14248,11 +14366,13 @@ interface components {
                 deviceIndex: number | null;
                 channel: 1 | 2 | null;
                 points: {
+                    /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                     timeMilliseconds: number;
                     value: number;
                 }[];
             }[];
             events: {
+                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                 timeMilliseconds: number;
                 name: string;
                 value: string | null;
@@ -14287,7 +14407,9 @@ interface components {
                     temperatureAdjustments: {
                         /** @enum {string} */
                         kind: "bean_temperature" | "environmental_temperature";
+                        /** @description Start of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         startMilliseconds: number;
+                        /** @description End of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         endMilliseconds: number;
                         delta: number;
                     }[];
@@ -14307,10 +14429,12 @@ interface components {
                         unchangedZeroSampleCount: number;
                         parent: {
                             first: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
                             last: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
@@ -14319,10 +14443,12 @@ interface components {
                         };
                         planned: {
                             first: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
                             last: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
@@ -14356,7 +14482,9 @@ interface components {
                 temperatureAdjustments: {
                     /** @enum {string} */
                     kind: "bean_temperature" | "environmental_temperature";
+                    /** @description Start of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                     startMilliseconds: number;
+                    /** @description End of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                     endMilliseconds: number;
                     delta: number;
                 }[];
@@ -14451,7 +14579,9 @@ interface components {
                     temperatureAdjustments: {
                         /** @enum {string} */
                         kind: "bean_temperature" | "environmental_temperature";
+                        /** @description Start of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         startMilliseconds: number;
+                        /** @description End of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         endMilliseconds: number;
                         delta: number;
                     }[];
@@ -14471,10 +14601,12 @@ interface components {
                         unchangedZeroSampleCount: number;
                         parent: {
                             first: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
                             last: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
@@ -14483,10 +14615,12 @@ interface components {
                         };
                         planned: {
                             first: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
                             last: {
+                                /** @description Milliseconds since the recording started. Subtract the chart's `chargeTimeMilliseconds` for time since CHARGE. */
                                 timeMilliseconds: number;
                                 value: number;
                             } | null;
@@ -14552,6 +14686,7 @@ interface components {
                     kind: "bean_temperature" | "environmental_temperature" | "auxiliary";
                     unit: string;
                     points: {
+                        /** @description Milliseconds since CHARGE. */
                         timeMilliseconds: number;
                         left: number;
                         right: number;
@@ -14560,7 +14695,9 @@ interface components {
                 }[];
                 milestones: {
                     name: string;
+                    /** @description The left profile's milestone, in milliseconds since its CHARGE. */
                     leftMilliseconds: number;
+                    /** @description The right profile's milestone, in milliseconds since its CHARGE. */
                     rightMilliseconds: number;
                     deltaMilliseconds: number;
                 }[];
@@ -14987,6 +15124,28 @@ interface components {
                     protocol: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified" | null;
                 };
             };
+            /** @description ADR-018 canonical variety, species and drying values mapped from the supplier text, which stays in cultivar_detail and drying_method. Omitted when no stated value matched the vocabulary; nothing is inferred. */
+            taxonomy?: {
+                varieties: {
+                    code: string;
+                    label: string;
+                    /** @description Family this value belongs to, when it has one */
+                    parent_code: string | null;
+                }[];
+                species: {
+                    code: string;
+                    label: string;
+                    /** @description Family this value belongs to, when it has one */
+                    parent_code: string | null;
+                }[];
+                /** @description Returned where the projection includes drying_method */
+                drying_methods?: {
+                    code: string;
+                    label: string;
+                    /** @description Family this value belongs to, when it has one */
+                    parent_code: string | null;
+                }[];
+            };
             proof?: components["schemas"]["CatalogProofSummary"];
             /** @description Entitled metadata-presence signals returned only by projection=summary; false also covers fields outside the caller projection. */
             summarySignals?: {
@@ -15224,6 +15383,9 @@ interface components {
                 grade_preparation?: string[];
                 screen_size_min?: string[];
                 elevation_band?: string[];
+                varieties?: string[];
+                species_codes?: string[];
+                drying_methods?: string[];
             };
             /** @description Counted facet values for CLI/agent use. Counts are computed after visibility and entitled query filters are applied. */
             facets: {
@@ -15319,6 +15481,18 @@ interface components {
                     value: string;
                     count: number;
                 }[];
+                varieties?: {
+                    value: string;
+                    count: number;
+                }[];
+                species_codes?: {
+                    value: string;
+                    count: number;
+                }[];
+                drying_methods?: {
+                    value: string;
+                    count: number;
+                }[];
             };
             meta: {
                 /** @enum {string} */
@@ -16703,6 +16877,49 @@ interface components {
                 dimensions: ("size" | "altitude" | "defects" | "cup" | "preparation")[];
             };
         };
+        VarietyEntry: {
+            /** @example yellow_bourbon */
+            code: string;
+            /** @example Yellow Bourbon */
+            label: string;
+            /** @description Family this value belongs to. A family code matches itself and every descendant. */
+            parent_code: string | null;
+            description: string | null;
+            active: boolean;
+            sort_order: number;
+            /** @description Normalized supplier spellings that map to this code. */
+            aliases: string[];
+            species_code: string | null;
+        };
+        TaxonomyEntry: {
+            /** @example yellow_bourbon */
+            code: string;
+            /** @example Yellow Bourbon */
+            label: string;
+            /** @description Family this value belongs to. A family code matches itself and every descendant. */
+            parent_code: string | null;
+            description: string | null;
+            active: boolean;
+            sort_order: number;
+            /** @description Normalized supplier spellings that map to this code. */
+            aliases: string[];
+        };
+        CatalogTaxonomiesResponse: {
+            data: {
+                varieties: components["schemas"]["VarietyEntry"][];
+                species: components["schemas"]["TaxonomyEntry"][];
+                drying_methods: components["schemas"]["TaxonomyEntry"][];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-taxonomies";
+                /** @enum {string} */
+                namespace: "/v1/catalog/taxonomies";
+                /** @enum {string} */
+                version: "v1";
+                taxonomies: ("variety" | "species" | "drying_method")[];
+            };
+        };
         LotPriceHistoryResponse: {
             data: {
                 catalogId: number;
@@ -17072,7 +17289,9 @@ interface components {
                     temperatureAdjustments: {
                         /** @enum {string} */
                         kind: "bean_temperature" | "environmental_temperature";
+                        /** @description Start of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         startMilliseconds: number;
+                        /** @description End of the change on the parent chart's clock. Milliseconds since the recording started, as chart points are timed. For a time counted from CHARGE, add the chart's `chargeTimeMilliseconds`. */
                         endMilliseconds: number;
                         delta: number;
                     }[];
@@ -17603,6 +17822,7 @@ interface components {
         };
         RoastTemperature: {
             roast_id: number;
+            /** @description Seconds since the recording started, the clock the curve is sampled on. Subtract the roast's `charge_time` for time since CHARGE. */
             time_seconds: number;
             bean_temp: number | null;
             environmental_temp: number | null;
@@ -17612,6 +17832,7 @@ interface components {
         };
         RoastEvent: {
             roast_id: number;
+            /** @description Seconds since the recording started, the clock the curve is sampled on. Subtract the roast's `charge_time` for time since CHARGE. */
             time_seconds: number;
             event_type: number | null;
             event_value: string | null;
@@ -17636,25 +17857,34 @@ interface components {
             roaster_type: string | null;
             roaster_size: string | null;
             temperature_unit: string | null;
+            /** @description Roast length in seconds, from CHARGE to DROP. From the start of the recording when `charge_time` is null. */
             total_roast_time: number | null;
+            /** @description Development: first crack start to DROP, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             development_percent: number | null;
             data_source: string | null;
             last_updated: string;
             roast_uuid: string | null;
+            /** @description First crack start. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             fc_start_time: number | null;
             fc_start_temp: number | null;
+            /** @description First crack end. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             fc_end_time: number | null;
             fc_end_temp: number | null;
+            /** @description DROP. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             drop_time: number | null;
             drop_temp: number | null;
             charge_temp: number | null;
+            /** @description Where CHARGE sits on the recording clock: seconds from the start of the recording to CHARGE. Null when no CHARGE is marked. Every other roast time counts from this moment; add it to one of them to place it on the curve. */
             charge_time: number | null;
-            /** @description Drying-phase end time in seconds from the roast profile. */
+            /** @description Drying-phase end. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             dry_end_time: number | null;
+            /** @description Turning point. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             tp_time: number | null;
             tp_temp: number | null;
             total_ror: number | null;
+            /** @description Drying: CHARGE to drying-phase end, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             dry_percent: number | null;
+            /** @description Maillard: drying-phase end to first crack start, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             maillard_percent: number | null;
             auc: number | null;
             dry_phase_ror: number | null;
@@ -17687,6 +17917,7 @@ interface components {
             };
         };
         RoastTemperatureInput: {
+            /** @description Seconds since the recording started. */
             timeSeconds: number;
             beanTemp?: number | null;
             environmentalTemp?: number | null;
@@ -17696,6 +17927,7 @@ interface components {
             dataSource?: "live" | "artisan_import" | "manual";
         };
         RoastEventInput: {
+            /** @description Seconds since the recording started, the same clock as the temperature samples. */
             timeSeconds: number;
             eventType?: number | null;
             eventValue?: string | null;
@@ -17721,18 +17953,24 @@ interface components {
             roasterSize?: string;
             /** @enum {string} */
             temperatureUnit?: "F" | "C";
+            /** @description Roast length in seconds, from CHARGE to DROP. */
             totalRoastTime?: number;
             developmentPercent?: number;
             dataSource?: string;
             roastUuid?: string;
+            /** @description First crack start, in seconds since CHARGE. */
             fcStartTime?: number;
             fcStartTemp?: number;
+            /** @description First crack end, in seconds since CHARGE. */
             fcEndTime?: number;
             fcEndTemp?: number;
+            /** @description DROP, in seconds since CHARGE. */
             dropTime?: number;
             dropTemp?: number;
             chargeTemp?: number;
+            /** @description Where CHARGE sits on the recording clock: seconds from the start of the recording to CHARGE. Every other roast time counts from it. */
             chargeTime?: number;
+            /** @description Turning point, in seconds since CHARGE. */
             tpTime?: number;
             tpTemp?: number;
             totalRor?: number;
@@ -17794,18 +18032,24 @@ interface components {
             roasterSize?: string;
             /** @enum {string} */
             temperatureUnit?: "F" | "C";
+            /** @description Roast length in seconds, from CHARGE to DROP. */
             totalRoastTime?: number;
             developmentPercent?: number;
             dataSource?: string;
             roastUuid?: string;
+            /** @description First crack start, in seconds since CHARGE. */
             fcStartTime?: number;
             fcStartTemp?: number;
+            /** @description First crack end, in seconds since CHARGE. */
             fcEndTime?: number;
             fcEndTemp?: number;
+            /** @description DROP, in seconds since CHARGE. */
             dropTime?: number;
             dropTemp?: number;
             chargeTemp?: number;
+            /** @description Where CHARGE sits on the recording clock: seconds from the start of the recording to CHARGE. Every other roast time counts from it. */
             chargeTime?: number;
+            /** @description Turning point, in seconds since CHARGE. */
             tpTime?: number;
             tpTemp?: number;
             totalRor?: number;
@@ -18023,25 +18267,34 @@ interface components {
             roaster_type: string | null;
             roaster_size: string | null;
             temperature_unit: string | null;
+            /** @description Roast length in seconds, from CHARGE to DROP. From the start of the recording when `charge_time` is null. */
             total_roast_time: number | null;
+            /** @description Development: first crack start to DROP, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             development_percent: number | null;
             data_source: string | null;
             last_updated: string;
             roast_uuid: string | null;
+            /** @description First crack start. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             fc_start_time: number | null;
             fc_start_temp: number | null;
+            /** @description First crack end. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             fc_end_time: number | null;
             fc_end_temp: number | null;
+            /** @description DROP. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             drop_time: number | null;
             drop_temp: number | null;
             charge_temp: number | null;
+            /** @description Where CHARGE sits on the recording clock: seconds from the start of the recording to CHARGE. Null when no CHARGE is marked. Every other roast time counts from this moment; add it to one of them to place it on the curve. */
             charge_time: number | null;
-            /** @description Drying-phase end time in seconds from the roast profile. */
+            /** @description Drying-phase end. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             dry_end_time: number | null;
+            /** @description Turning point. Seconds since CHARGE. When `charge_time` is null the roast has no CHARGE marked and this counts from the start of the recording instead. */
             tp_time: number | null;
             tp_temp: number | null;
             total_ror: number | null;
+            /** @description Drying: CHARGE to drying-phase end, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             dry_percent: number | null;
+            /** @description Maillard: drying-phase end to first crack start, as a share of the time from CHARGE to DROP (`total_roast_time`), in percent. */
             maillard_percent: number | null;
             auc: number | null;
             dry_phase_ror: number | null;
@@ -18139,6 +18392,7 @@ interface components {
         };
         RoastChartPoint: {
             data_type: string;
+            /** @description Milliseconds since the recording started, the clock the curve is sampled on. Subtract `metadata.charge_time_ms` for time since CHARGE. */
             time_milliseconds: number;
             field_name: string;
             value_numeric: number;
@@ -18147,6 +18401,7 @@ interface components {
             subcategory: string;
         };
         RoastChartSeriesPoint: {
+            /** @description Milliseconds since the recording started, the clock the curve is sampled on. Subtract `metadata.charge_time_ms` for time since CHARGE. */
             time_milliseconds: number;
             value_numeric: number;
         };
@@ -18163,6 +18418,7 @@ interface components {
             points: components["schemas"]["RoastChartSeriesPoint"][];
         };
         RoastChartEvent: {
+            /** @description Milliseconds since the recording started, the clock the curve is sampled on. Subtract `metadata.charge_time_ms` for time since CHARGE. */
             time_milliseconds: number;
             name: string;
             value: string | null;
@@ -18182,6 +18438,7 @@ interface components {
             temp_max: number | null;
             ror_min: number | null;
             ror_max: number | null;
+            /** @description Where CHARGE sits on the recording clock, in milliseconds. Null when no CHARGE is marked. Subtract it from any chart time for time since CHARGE. */
             charge_time_ms: number | null;
             temperature_unit: string | null;
             profile_schema_version: number | null;
@@ -18803,6 +19060,8 @@ type CatalogSimilarQuery = NonNullable<paths["/v1/catalog/{id}/similar"]["get"][
 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.taxonomies}. */
+type CatalogTaxonomiesQuery = NonNullable<paths["/v1/catalog/taxonomies"]["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}. */
@@ -21418,6 +21677,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                 };
                 header?: {
                     Prefer?: string;
@@ -21441,6 +21703,20 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["CatalogListResponse"];
                     };
                 };
+                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"];
@@ -21525,6 +21801,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                 } | undefined;
                 header: {
                     Prefer?: string;
@@ -21580,6 +21859,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     place_id?: string;
                     bbox?: string;
                     zoom?: number;
@@ -21714,6 +21996,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     place_id?: string;
                     bbox?: string;
                     zoom?: number;
@@ -21732,7 +22017,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         facets: (query?: CatalogFacetsQuery, headers?: CatalogFacetsHeaders) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: {
-                    include?: "grading";
+                    include?: ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading") | ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading")[];
                     stocked?: "true" | "false" | "all";
                     showWholesale?: "true" | "false";
                     wholesaleOnly?: "true" | "false";
@@ -21772,6 +22057,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     waterActivityMax?: number | null;
                     densityMin?: number | null;
                     scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -21801,6 +22089,20 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["CatalogFacetsResponse"];
                     };
                 };
+                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"];
@@ -21834,7 +22136,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, {
             params: {
                 query: {
-                    include?: "grading";
+                    include?: ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading") | ("grading" | "taxonomy" | "grading,taxonomy" | "taxonomy,grading")[];
                     stocked?: "true" | "false" | "all";
                     showWholesale?: "true" | "false";
                     wholesaleOnly?: "true" | "false";
@@ -21874,6 +22176,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     waterActivityMax?: number | null;
                     densityMin?: number | null;
                     scoreProtocol?: "sca_2004" | "cva_affective" | "q_arabica" | "coe" | "supplier_unspecified";
+                    varietyCode?: string | string[];
+                    speciesCode?: string | string[];
+                    dryingMethodCode?: string | string[];
                     processing_base_method?: string;
                     fermentation_type?: string;
                     process_additive?: string;
@@ -22916,6 +23221,69 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Variety, species, and drying-method vocabularies with aliases and family links. */
+        taxonomies: (query?: CatalogTaxonomiesQuery) => 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"]["CatalogTaxonomiesResponse"];
+                    };
+                };
+                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. */
@@ -30397,9 +30765,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: 
-                /** Closed session-only command for {@link ParchmentClient.confirmedActions.execute}. */
-                components["responses"]["ApiRateLimitExceeded"];
+                429: components["responses"]["ApiRateLimitExceeded"];
             };
         }, {
             params: {
@@ -30530,7 +30896,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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-Remaining": 
+                        /** Create a signed, short-lived login request bound to a PKCE challenge. */
+                        components["headers"]["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
                     };
@@ -30597,9 +30965,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 409: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": 
-                        /** Available exact 30-day comparisons, with no empty-origin search. */
-                        components["headers"]["X-RateLimit-Remaining"];
+                        "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"];
@@ -30629,7 +30995,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     id: string;
                     revisionId: string;
                 };
-                cookie? /** Metadata-trend index (process/disclosure/Purveyor Score over time). */: never;
+                cookie?: never;
             };
             requestBody: {
                 content: {
@@ -31488,7 +31854,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 403: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Remaining": 
+                        /** Revoke an API key owned by the authenticated session user. */
+                        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"];
@@ -31599,7 +31967,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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"];
+                        "X-RateLimit-Burst-Reset": 
+                        /** Query parameters for {@link ParchmentClient.tasting.get}. */
+                        components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
                     };
                     content: {
@@ -32793,7 +33163,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", "catalog.compare", "catalog.grades", "catalog.priceHistory", "inventory.list", "roasts.list", "roasts.get", "roasts.chartData", "referenceProfiles.list", "referenceProfiles.get", "referenceProfiles.chart", "referenceProfiles.compare", "referenceProfiles.preview", "referenceProfiles.roastCandidates", "referenceProfiles.previewFromRoast", "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.taxonomies", "catalog.priceHistory", "inventory.list", "roasts.list", "roasts.get", "roasts.chartData", "referenceProfiles.list", "referenceProfiles.get", "referenceProfiles.chart", "referenceProfiles.compare", "referenceProfiles.preview", "referenceProfiles.roastCandidates", "referenceProfiles.previewFromRoast", "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
@@ -32838,4 +33208,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 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 };
+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 CatalogTaxonomiesQuery, 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 };