@purveyors/sdk 0.53.0 → 0.56.0

package/dist/index.d.ts

@@ -1159,7 +1159,10 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Snapshot an executed roast as a reference profile */
+        /**
+         * Save an executed roast as a reference profile
+         * @description Save one of the caller's executed roasts as a reference profile. The default `chart_snapshot` basis stores the roast's chart for comparison only. The `artisan_source` basis copies the Artisan file the roast was imported from, so the reference can be the base for a planned profile and its export; it requires a roast with an Artisan file on record, returns 400 `roast_artisan_source_unavailable` with a `reason` otherwise, and returns the reference already saved from that roast's file instead of creating a duplicate. The roast is never modified. Requires Mallard Studio, and for API keys the exact roast:read and roast:write scopes.
+         */
         post: {
             parameters: {
                 query?: never;
@@ -1175,7 +1178,22 @@ interface paths {
                 };
             };
             responses: {
-                /** @description Created immutable roast snapshot */
+                /** @description The reference already saved from this roast's Artisan file */
+                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"]["ReferenceProfileResponse"];
+                    };
+                };
+                /** @description Created reference profile */
                 201: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -1190,8 +1208,144 @@ interface paths {
                         "application/json": components["schemas"]["ReferenceProfileResponse"];
                     };
                 };
-                /** @description Invalid request */
+                /** @description Invalid request, or the roast has no usable Artisan file on record */
                 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"]["RoastSourceErrorResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description Reference profile or source roast not found */
+                404: {
+                    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 Revision, idempotency, or concurrency conflict */
+                409: {
+                    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"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/reference-profiles/from-roast/candidates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List executed roasts that can be the base for a planned profile
+         * @description List the caller's executed roasts whose Artisan file is on record, newest first, each with its current revision token and the reference it is or would be saved under. `ineligibleRoastCount` counts the caller's other roasts, which have no usable Artisan file on record (entered manually, logged live, imported before files were kept, or holding a file larger than a reference profile allows). Requires Mallard Studio, and for API keys the exact roast:read scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Roasts with an Artisan file on record */
+                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"]["ReferenceProfileRoastCandidatesResponse"];
+                    };
+                };
+                /** @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"];
@@ -1205,6 +1359,73 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/reference-profiles/from-roast/preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Preview a planned profile based on an executed roast
+         * @description Preview a constrained planned profile built on the Artisan file one of the caller's executed roasts was imported from. Read-only: nothing is saved and the roast is not modified. Returns the same measured preview as a saved reference, plus the reference identity a later save would use. Roasts without a usable Artisan file on record return 400 `roast_artisan_source_unavailable` with a `reason`. Requires Mallard Studio, and for API keys the exact roast:read scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["ReferenceProfileRoastGenerationRequest"];
+                };
+            };
+            responses: {
+                /** @description Deterministic preview without persistence */
+                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"]["ReferenceProfileRoastGenerationPreviewResponse"];
+                    };
+                };
+                /** @description Invalid request, or the roast has no usable Artisan file on record */
+                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"]["RoastSourceErrorResponse"];
+                    };
+                };
                 /** @description Authentication required */
                 401: {
                     headers: {
@@ -6007,7 +6228,7 @@ interface paths {
         };
         /**
          * Find catalog coffees similar to a target coffee
-         * @description Vector-similarity matches between public supplier catalog coffees, with deterministic identity gating, supplier-diversity re-ranking, and a canonical/similar split. User-owned coffees are excluded. Available to member sessions and customer API keys; API keys also require catalog:read. Green responses return at most 25 matches.
+         * @description Vector-similarity matches between public supplier catalog coffees, with deterministic identity gating, supplier-diversity re-ranking, and a canonical/similar split. User-owned coffees are excluded. Available to member sessions, or any customer API key with catalog:read (all API plans, within plan quota). Responses return at most 25 matches.
          */
         get: {
             parameters: {
@@ -6298,7 +6519,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/catalog/{id}/price-history": {
+    "/v1/catalog/taxonomies": {
         parameters: {
             query?: never;
             header?: never;
@@ -6306,23 +6527,21 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Daily price history for one catalog coffee
-         * @description Daily price, full tier ladder, and stock state for one public supplier catalog coffee over 7 to 365 days (default 90), with minimum-tier change events so packaging changes are not read as price cuts. Available to member sessions, Parchment Intelligence sessions, and customer API keys with catalog:read.
+         * 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?: {
-                    days?: string;
+                    includeRetired?: "true" | "false";
                 };
                 header?: never;
-                path: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Daily price history with minimum-tier change events */
+                /** @description Taxonomy vocabularies */
                 200: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -6334,22 +6553,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["LotPriceHistoryResponse"];
-                    };
-                };
-                /** @description Invalid path id or days */
-                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"];
+                        "application/json": components["schemas"]["CatalogTaxonomiesResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -6382,21 +6586,6 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Catalog coffee not found */
-                404: {
-                    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"];
             };
         };
@@ -6408,7 +6597,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/procurement/briefs": {
+    "/v1/catalog/{id}/price-history": {
         parameters: {
             query?: never;
             header?: never;
@@ -6416,12 +6605,122 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List saved sourcing briefs
-         * @description List the authenticated principal's active sourcing briefs. Requires a Parchment Intelligence or member session, or a paid (member+) API plan; API keys also need the catalog:read scope.
+         * Daily price history for one catalog coffee
+         * @description Daily price, full tier ladder, and stock state for one public supplier catalog coffee over 7 to 365 days (default 90), with minimum-tier change events so packaging changes are not read as price cuts. Available to member sessions, Parchment Intelligence sessions, and customer API keys with catalog:read.
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    days?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Daily price history with minimum-tier change events */
+                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"]["LotPriceHistoryResponse"];
+                    };
+                };
+                /** @description Invalid path id or days */
+                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"];
+                    };
+                };
+                /** @description Catalog coffee not found */
+                404: {
+                    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/procurement/briefs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List saved sourcing briefs
+         * @description List the authenticated principal's active sourcing briefs. Requires a Parchment Intelligence or member session, or a paid (member+) API plan; API keys also need the catalog:read scope.
+         */
+        get: {
+            parameters: {
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
@@ -7134,7 +7433,7 @@ interface paths {
         put?: never;
         /**
          * Execute a user-confirmed product action
-         * @description Execute one of the closed product actions for the authenticated session owner. The stable executionId provides payload-bound replay, and owner plus entitlement checks run again inside the same database transaction as the mutation. Generated reference saves require explicit user confirmation and remain planned profiles. API keys are not accepted.
+         * @description Execute one of the closed product actions for the authenticated session owner. The stable executionId provides payload-bound replay, and owner plus entitlement checks run again inside the same database transaction as the mutation. Generated reference saves require explicit user confirmation and remain planned profiles; one based on an executed roast also saves that roast's stored Artisan file as its parent reference and never modifies the roast. API keys are not accepted.
          */
         post: {
             parameters: {
@@ -7164,7 +7463,7 @@ interface paths {
                         "application/json": components["schemas"]["ConfirmedActionExecuteResponse"];
                     };
                 };
-                /** @description Invalid or unsupported confirmed-action payload */
+                /** @description Invalid or unsupported confirmed-action payload, or a roast-based plan whose roast has no usable Artisan file on record */
                 400: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -7176,7 +7475,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["RoastSourceErrorResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -9799,7 +10098,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: {
@@ -10246,7 +10545,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/roasts/{id}/artisan-import": {
+    "/v1/roasts/imports/from-reference": {
         parameters: {
             query?: never;
             header?: never;
@@ -10254,29 +10553,28 @@ interface paths {
             cookie?: never;
         };
         get?: never;
+        put?: never;
         /**
-         * Replace a roast's Artisan import
-         * @description Re-derive one of the caller's existing roasts from an Artisan `.alog` file: replace its temperature curve, event markers, milestones, chart bounds, and computed metrics, and write an artisan_import_log entry atomically. The roast's identity (coffee, batch name, roast date, weights, and user notes) is preserved. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * Create a roast from a saved Artisan reference
+         * @description Create a roast profile owned by the caller from the Artisan file stored with one of their uploaded reference profiles, against one of their green-coffee lots. The curve, events, and import log are written atomically, exactly as a direct Artisan import. Only uploaded Artisan references qualify: a planned (generated) profile is never recorded as a roast, and a reference saved from an existing roast is refused because that roast is already in history. Requires Mallard Studio, and for API keys the exact roast:read and roast:write scopes.
          */
-        put: {
+        post: {
             parameters: {
                 query?: never;
                 header?: {
-                    "if-match"?: string;
-                };
-                path: {
-                    id: number;
+                    "idempotency-key"?: string;
                 };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
+                    "application/json": components["schemas"]["RoastImportFromReferenceRequest"];
                 };
             };
             responses: {
-                /** @description The updated roast profile plus import summary */
-                200: {
+                /** @description The created roast profile plus import summary */
+                201: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -10287,7 +10585,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastImportResponse"];
+                        "application/json": components["schemas"]["RoastImportFromReferenceResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -10335,7 +10633,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such roast profile owned by the caller */
+                /** @description No such coffee lot owned by the caller */
                 404: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10399,23 +10697,42 @@ interface paths {
                 };
             };
         };
-        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}/artisan-import": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
         /**
-         * Clear a roast's Artisan import
-         * @description Remove import-derived temperature samples, event markers, and artisan_import_log rows from one of the caller's existing roasts without deleting the roast profile. Import-derived profile metrics are reset to manual/null values. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * Replace a roast's Artisan import
+         * @description Re-derive one of the caller's existing roasts from an Artisan `.alog` file: replace its temperature curve, event markers, milestones, chart bounds, and computed metrics, and write an artisan_import_log entry atomically. The roast's identity (coffee, batch name, roast date, weights, and user notes) is preserved. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
          */
-        delete: {
+        put: {
             parameters: {
                 query?: never;
-                header?: never;
+                header?: {
+                    "if-match"?: string;
+                };
                 path: {
                     id: number;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
+                };
+            };
             responses: {
-                /** @description The cleared roast id plus deleted row counts */
+                /** @description The updated roast profile plus import summary */
                 200: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10427,7 +10744,22 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                        "application/json": components["schemas"]["RoastImportResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                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 */
@@ -10475,6 +10807,21 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
+                    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 Per-user mutation throttle exceeded; retry after a short wait Customer API keys may also receive an account monthly or machine burst quota rejection. */
                 429: {
                     headers: {
@@ -10509,38 +10856,23 @@ interface paths {
                 };
             };
         };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/roasts/classify": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
+        post?: never;
         /**
-         * Classify an imported roast
-         * @description Match Artisan roast metadata to one of the supplied owner inventory rows. Requires member entitlement and either an authenticated session or an owner-bound API key carrying the exact roast:read scope.
+         * Clear a roast's Artisan import
+         * @description Remove import-derived temperature samples, event markers, and artisan_import_log rows from one of the caller's existing roasts without deleting the roast profile. Import-derived profile metrics are reset to manual/null values. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
          */
-        post: {
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["RoastClassificationRequest"];
+                path: {
+                    id: number;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Best inventory match, or null when no reasonable match exists */
+                /** @description The cleared roast id plus deleted row counts */
                 200: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10552,11 +10884,11 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastClassificationResponse"];
+                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
                     };
                 };
-                /** @description Invalid request body or input cap exceeded */
-                400: {
+                /** @description Authentication required */
+                401: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -10570,8 +10902,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Authentication required */
-                401: {
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -10585,8 +10917,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Insufficient entitlement (plan or role) */
-                403: {
+                /** @description No such roast profile owned by the caller */
+                404: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -10600,7 +10932,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description API or upstream classification rate limit exceeded Customer API keys may also receive an account monthly or machine burst quota rejection. */
+                /** @description Per-user mutation throttle exceeded; retry after a short wait Customer API keys may also receive an account monthly or machine burst quota rejection. */
                 429: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10617,7 +10949,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Classification provider is unavailable or not configured */
+                /** @description Roast writes are not enabled in this environment */
                 503: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10634,23 +10966,148 @@ interface paths {
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/roasts/{id}/chart-data": {
+    "/v1/roasts/classify": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get sampled roast chart data
-         * @description Fetch a chart-ready model with adaptively sampled primary and auxiliary series, discrete events, and metadata for one of the authenticated principal's roast profiles. The legacy flat points projection remains available for compatibility. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope on an uncapped API plan.
-         */
+         * Classify an imported roast
+         * @description Match Artisan roast metadata to one of the supplied owner inventory rows. Requires member entitlement and either an authenticated session or an owner-bound API key carrying the exact roast:read scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastClassificationRequest"];
+                };
+            };
+            responses: {
+                /** @description Best inventory match, or null when no reasonable match exists */
+                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"]["RoastClassificationResponse"];
+                    };
+                };
+                /** @description Invalid request body or input cap exceeded */
+                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"];
+                    };
+                };
+                /** @description API or upstream classification rate limit exceeded Customer API keys may also receive an account monthly or machine burst quota rejection. */
+                429: {
+                    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"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        "X-RateLimit-Blocked-By": components["headers"]["X-RateLimit-Blocked-By"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Classification provider is unavailable or not configured */
+                503: {
+                    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"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}/chart-data": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get sampled roast chart data
+         * @description Fetch a chart-ready model with adaptively sampled primary and auxiliary series, discrete events, and metadata for one of the authenticated principal's roast profiles. The legacy flat points projection remains available for compatibility. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope on an uncapped API plan.
+         */
         get: {
             parameters: {
                 query?: {
@@ -13798,7 +14255,13 @@ interface components {
             updatedAt: string;
         };
         ReferenceProfileListResponse: {
-            data: components["schemas"]["ReferenceProfileSummary"][];
+            data: (components["schemas"]["ReferenceProfileSummary"] & {
+                /** @description The executed roast the current revision was saved from, or null for an uploaded or planned profile. */
+                sourceRoast: {
+                    id: number;
+                    revision: string;
+                } | null;
+            })[];
             meta: {
                 /** @enum {string} */
                 resource: "reference-profiles";
@@ -13853,6 +14316,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;
@@ -13863,11 +14327,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;
@@ -13902,7 +14368,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;
                     }[];
@@ -13922,10 +14390,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;
@@ -13934,10 +14404,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;
@@ -13971,7 +14443,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;
                 }[];
@@ -14000,12 +14474,156 @@ interface components {
             fileContent: string;
             fileSize?: number;
         };
+        RoastSourceErrorResponse: {
+            error: {
+                code: string;
+                message: string;
+                /**
+                 * @description Present when code is `roast_artisan_source_unavailable`. `no_artisan_import`: the roast was entered manually or logged live. `artisan_file_not_retained`: it was imported before Artisan files were kept. `artisan_file_too_large`: its file is larger than a reference profile can hold.
+                 * @enum {string}
+                 */
+                reason?: "no_artisan_import" | "artisan_file_not_retained" | "artisan_file_too_large";
+            };
+        };
         ReferenceProfileFromRoastRequest: {
             roastId: number;
+            /** @description The roast's current revision token (its last_updated value). */
             roastRevision: string;
+            /**
+             * @description chart_snapshot keeps a comparison-only chart. artisan_source copies the roast's stored Artisan file so a planned profile can be built from it.
+             * @default chart_snapshot
+             * @enum {string}
+             */
+            basis: "chart_snapshot" | "artisan_source";
             title?: string;
             notes?: string;
         };
+        ReferenceProfileRoastCandidatesResponse: {
+            data: {
+                roasts: {
+                    roastId: number;
+                    roastRevision: string;
+                    label: string;
+                    batchName: string | null;
+                    coffeeName: string | null;
+                    roastDate: string | null;
+                    reference: {
+                        /** Format: uuid */
+                        profileId: string;
+                        /** Format: uuid */
+                        revisionId: string;
+                        saved: boolean;
+                    };
+                }[];
+                eligibleCount: number;
+                totalRoastCount: number;
+                ineligibleRoastCount: number;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "reference-profile-roast-candidates";
+                /** @enum {string} */
+                namespace: "/v1/reference-profiles";
+                /** @enum {string} */
+                version: "v1";
+            };
+        };
+        ReferenceProfileRoastGenerationPreviewResponse: {
+            data: {
+                /** Format: uuid */
+                parentRevisionId: string;
+                title: string;
+                userGoal: string | null;
+                modelRecommendation: string | null;
+                userEdits: string | null;
+                changes: {
+                    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;
+                    }[];
+                };
+                measuredFacts: {
+                    /** @enum {string} */
+                    temperatureUnit: "F" | "C";
+                    adjustments: {
+                        /** @enum {string} */
+                        kind: "bean_temperature" | "environmental_temperature";
+                        startMilliseconds: number;
+                        endMilliseconds: number;
+                        requestedDelta: number;
+                        /** @enum {string} */
+                        unit: "F" | "C";
+                        changedSampleCount: number;
+                        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;
+                            minimum: number | null;
+                            maximum: number | null;
+                        };
+                        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;
+                            minimum: number | null;
+                            maximum: number | null;
+                        };
+                    }[];
+                    /** @enum {boolean} */
+                    eventsUnchanged: true;
+                };
+                chart: components["schemas"]["ReferenceProfileChart"];
+                /** @enum {boolean} */
+                exportEligible: true;
+                /**
+                 * Format: uuid
+                 * @description The reference this roast's Artisan file is, or will be, saved under.
+                 */
+                parentProfileId: string;
+                /** @description Whether that reference already exists. A preview never creates it. */
+                parentSaved: boolean;
+                sourceRoast: {
+                    id: number;
+                    revision: string;
+                    label: string;
+                    batchName: string | null;
+                    coffeeName: string | null;
+                    roastDate: string | null;
+                };
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "reference-profile-previews";
+                /** @enum {string} */
+                namespace: "/v1/reference-profiles";
+                /** @enum {string} */
+                version: "v1";
+            };
+        };
+        ReferenceProfileRoastGenerationRequest: components["schemas"]["ReferenceProfileGenerationRequest"] & {
+            roastId: number;
+            roastRevision: string;
+        };
         ProfileComparisonResponse: {
             data: {
                 /** @enum {string} */
@@ -14029,6 +14647,7 @@ interface components {
                     kind: "bean_temperature" | "environmental_temperature" | "auxiliary";
                     unit: string;
                     points: {
+                        /** @description Milliseconds since CHARGE. */
                         timeMilliseconds: number;
                         left: number;
                         right: number;
@@ -14037,7 +14656,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;
                 }[];
@@ -16180,14 +16801,57 @@ interface components {
                 dimensions: ("size" | "altitude" | "defects" | "cup" | "preparation")[];
             };
         };
-        LotPriceHistoryResponse: {
+        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: {
-                catalogId: number;
+                varieties: components["schemas"]["VarietyEntry"][];
+                species: components["schemas"]["TaxonomyEntry"][];
+                drying_methods: components["schemas"]["TaxonomyEntry"][];
+            };
+            meta: {
                 /** @enum {string} */
-                currency: "USD";
-                /** Format: date */
-                from: string;
-                /** Format: date */
+                resource: "catalog-taxonomies";
+                /** @enum {string} */
+                namespace: "/v1/catalog/taxonomies";
+                /** @enum {string} */
+                version: "v1";
+                taxonomies: ("variety" | "species" | "drying_method")[];
+            };
+        };
+        LotPriceHistoryResponse: {
+            data: {
+                catalogId: number;
+                /** @enum {string} */
+                currency: "USD";
+                /** Format: date */
+                from: string;
+                /** Format: date */
                 to: string;
                 points: {
                     /** Format: date */
@@ -16549,12 +17213,16 @@ 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;
                     }[];
                 };
                 change_set_summary: string;
+                source_roast_id?: number | string;
+                source_roast_revision?: string;
             };
         } | {
             /** @description Stable operation id. Repeating it with the same action payload replays the stored result; changing the payload returns 409. */
@@ -17078,6 +17746,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;
@@ -17087,6 +17756,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;
@@ -17111,25 +17781,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;
@@ -17162,6 +17841,7 @@ interface components {
             };
         };
         RoastTemperatureInput: {
+            /** @description Seconds since the recording started. */
             timeSeconds: number;
             beanTemp?: number | null;
             environmentalTemp?: number | null;
@@ -17171,6 +17851,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;
@@ -17196,18 +17877,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;
@@ -17269,18 +17956,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;
@@ -17393,6 +18086,61 @@ interface components {
             /** @description Reported source size in bytes for import-log metadata; defaults to the content length. */
             fileSize?: number;
         };
+        RoastImportFromReferenceResponse: {
+            data: {
+                roast: components["schemas"]["RoastDetailResource"];
+                import: components["schemas"]["ArtisanImportSummary"];
+                reference: {
+                    /** Format: uuid */
+                    profileId: string;
+                    /** Format: uuid */
+                    revisionId: string;
+                    /** @description Whether the reference now lists the new roast as a linked roast. */
+                    linked: boolean;
+                };
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "roasts";
+                /** @enum {string} */
+                namespace: "/v1/roasts";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+            };
+        };
+        RoastImportFromReferenceRequest: {
+            /**
+             * Format: uuid
+             * @description A saved Artisan reference profile owned by the caller.
+             */
+            referenceProfileId: string;
+            /**
+             * Format: uuid
+             * @description That reference's current revision.
+             */
+            referenceRevisionId: string;
+            /** @description green_coffee_inv.id owned by the caller to roast against. */
+            coffeeId: number;
+            /** @description Batch name; defaults to '<coffee> - <roast date>'. */
+            batchName?: string;
+            /** @description Roast date (YYYY-MM-DD); defaults to the file's date. */
+            roastDate?: string;
+            /** @description Input weight in oz; defaults to the file's weight if present. */
+            ozIn?: number;
+            /** @description Output weight in oz; defaults to the file's weight if present. */
+            ozOut?: number;
+            /** @description Roast notes; overrides the generated import summary note. */
+            roastNotes?: string;
+            roastTargets?: string;
+        };
         RoastArtisanImportReplaceRequest: {
             /** @description Source file name. Must end in .alog, .alog.json, or .json (Artisan export). */
             fileName: string;
@@ -17443,25 +18191,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;
@@ -17559,6 +18316,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;
@@ -17567,6 +18325,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;
         };
@@ -17583,6 +18342,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;
@@ -17602,6 +18362,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;
@@ -18223,6 +18984,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}. */
@@ -18302,6 +19065,10 @@ type RoastChartSeries = components["schemas"]["RoastChartSeries"];
 type RoastChartEvent = components["schemas"]["RoastChartEvent"];
 type ReferenceProfileImportRequest = NonNullable<paths["/v1/reference-profiles/imports"]["post"]["requestBody"]>["content"]["application/json"];
 type ReferenceProfileFromRoastRequest = NonNullable<paths["/v1/reference-profiles/from-roast"]["post"]["requestBody"]>["content"]["application/json"];
+/** Request body for {@link ParchmentClient.referenceProfiles.previewFromRoast}. */
+type ReferenceProfileRoastGenerationRequest = NonNullable<paths["/v1/reference-profiles/from-roast/preview"]["post"]["requestBody"]>["content"]["application/json"];
+/** Query parameters for {@link ParchmentClient.referenceProfiles.roastCandidates}. */
+type ReferenceProfileRoastCandidatesQuery = NonNullable<paths["/v1/reference-profiles/from-roast/candidates"]["get"]["parameters"]["query"]>;
 type ReferenceProfileUpdateRequest = NonNullable<paths["/v1/reference-profiles/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
 type ReferenceProfileGenerationRequest = NonNullable<paths["/v1/reference-profiles/{id}/revisions/{revisionId}/preview"]["post"]["requestBody"]>["content"]["application/json"];
 type ProfileComparisonRequest = NonNullable<paths["/v1/profile-comparisons"]["post"]["requestBody"]>["content"]["application/json"];
@@ -18317,6 +19084,8 @@ type RoastUpdateRequest = NonNullable<paths["/v1/roasts/{id}"]["patch"]["request
 type RoastLiveCurveRequest = NonNullable<paths["/v1/roasts/{id}/live-curve"]["put"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.import}. */
 type RoastImportRequest = NonNullable<paths["/v1/roasts/imports"]["post"]["requestBody"]>["content"]["application/json"];
+/** Request body for {@link ParchmentClient.roasts.importFromReference}. */
+type RoastImportFromReferenceRequest = NonNullable<paths["/v1/roasts/imports/from-reference"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.replaceArtisanImport}. */
 type RoastArtisanImportReplaceRequest = NonNullable<paths["/v1/roasts/{id}/artisan-import"]["put"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.sales.list}. */
@@ -22330,6 +23099,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. */
@@ -23921,7 +24753,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["RoastSourceErrorResponse"];
                     };
                 };
                 401: {
@@ -24090,6 +24922,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         }[];
                     };
                     change_set_summary: string;
+                    source_roast_id?: number | string;
+                    source_roast_revision?: string;
                 };
             } | {
                 executionId: string;
@@ -29330,6 +30164,165 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             } | undefined;
         }, `${string}/${string}`>>;
+        /**
+         * Create a roast profile from the Artisan file stored with one of the
+         * caller's uploaded reference profiles. Only uploaded Artisan references
+         * qualify: planned (generated) profiles are never recorded as roasts,
+         * and a reference saved from an existing roast is refused. Requires
+         * Mallard Studio plus a session, or an owner-bound API key carrying the
+         * exact `roast:read` and `roast:write` scopes. The optional
+         * `idempotencyKey` is payload-bound.
+         */
+        importFromReference: (body: RoastImportFromReferenceRequest, options?: {
+            idempotencyKey?: string;
+        }) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastImportFromReferenceRequest"];
+                };
+            };
+            responses: {
+                201: {
+                    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"]["RoastImportFromReferenceResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                404: {
+                    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"];
+                    };
+                };
+                409: {
+                    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: {
+                    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"];
+                        "Retry-After": components["headers"]["Retry-After"];
+                        "X-RateLimit-Blocked-By": components["headers"]["X-RateLimit-Blocked-By"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    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"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                referenceProfileId: string;
+                referenceRevisionId: string;
+                coffeeId: number;
+                batchName?: string;
+                roastDate?: string;
+                ozIn?: number;
+                ozOut?: number;
+                roastNotes?: string;
+                roastTargets?: string;
+            };
+            params: {
+                header: {
+                    "idempotency-key": string;
+                };
+            } | undefined;
+        }, `${string}/${string}`>>;
         /**
          * Replace the Artisan import data on one of the caller's existing roasts,
          * re-deriving its curve, events, and computed metrics while preserving the
@@ -29650,9 +30643,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: {
@@ -29783,7 +30774,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;
                     };
@@ -30350,6 +31343,13 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
+        /**
+         * Save an executed roast as a reference. `basis: "artisan_source"`
+         * copies the roast's stored Artisan file so a planned profile can be
+         * built from it, and returns the reference already saved from that
+         * roast's file instead of a duplicate; the default
+         * `"chart_snapshot"` keeps a comparison-only chart.
+         */
         fromRoast: (body: ReferenceProfileFromRoastRequest, idempotencyKey: string) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
@@ -30365,6 +31365,20 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
             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"]["ReferenceProfileResponse"];
+                    };
+                };
                 201: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -30390,7 +31404,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["RoastSourceErrorResponse"];
                     };
                 };
                 401: {
@@ -30455,6 +31469,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             body: {
                 roastId: number;
                 roastRevision: string;
+                basis: "chart_snapshot" | "artisan_source";
                 title?: string;
                 notes?: string;
             };
@@ -30464,6 +31479,195 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
+        /**
+         * List the caller's executed roasts whose Artisan file is on record and
+         * can therefore be the base for a planned profile, newest first.
+         */
+        roastCandidates: (query?: ReferenceProfileRoastCandidatesQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    limit?: number;
+                };
+                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"]["ReferenceProfileRoastCandidatesResponse"];
+                    };
+                };
+                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: {
+                    limit?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Preview a planned profile built directly on an executed roast's stored
+         * Artisan file. Read-only: nothing is saved and the roast is unchanged.
+         */
+        previewFromRoast: (body: ReferenceProfileRoastGenerationRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["ReferenceProfileRoastGenerationRequest"];
+                };
+            };
+            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"]["ReferenceProfileRoastGenerationPreviewResponse"];
+                    };
+                };
+                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"]["RoastSourceErrorResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                404: {
+                    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"];
+                    };
+                };
+                409: {
+                    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"];
+            };
+        }, {
+            body: {
+                title: string;
+                notes?: string;
+                userGoal?: string;
+                modelRecommendation?: string;
+                userEdits?: string;
+                changes: {
+                    temperatureAdjustments: {
+                        kind: "bean_temperature" | "environmental_temperature";
+                        startMilliseconds: number;
+                        endMilliseconds: number;
+                        delta: number;
+                    }[];
+                };
+            } & {
+                roastId: number;
+                roastRevision: string;
+            };
+        }, `${string}/${string}`>>;
         update: (id: string, body: ReferenceProfileUpdateRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
@@ -30528,7 +31732,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"];
@@ -30629,9 +31835,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": 
-                        /** Request body for {@link ParchmentClient.apiKeys.create}. */
-                        components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 403: {
@@ -30641,7 +31845,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: {
@@ -31835,7 +33041,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", "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", "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
@@ -31880,4 +33086,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 };