@purveyors/sdk 0.28.0 → 0.30.0

package/dist/index.d.ts

@@ -537,6 +537,176 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/webhooks/resend/market-brief": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Receive verified Market Brief provider events
+         * @description Verifies the Resend Svix signature against the untouched raw body, then idempotently settles provider opt-out or suppression state under Parchment authority.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "svix-id": string;
+                    "svix-timestamp": string;
+                    "svix-signature": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The authentic delivery was settled or ignored */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            received: true;
+                        };
+                    };
+                };
+                /** @description The signature or provider payload is invalid */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The provider payload exceeds the bounded body limit */
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Provider configuration or durable settlement is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market-brief/drafts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Accept or replay one deployed Market Brief draft
+         * @description Authenticates the dedicated coffee-app machine credential, verifies the exact deployed Market Brief projection, and creates or recovers one unsent provider draft under Parchment authority.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketBriefDraftInput"];
+                };
+            };
+            responses: {
+                /** @description The exact immutable draft already exists */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                    };
+                };
+                /** @description Draft creation or ambiguity recovery remains durable */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                    };
+                };
+                /** @description The submitted deployment or projection is invalid */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The dedicated machine credential is absent or invalid */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The deployment, immutable version, or provider draft conflicts with durable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The request body exceeds the bounded projection limit */
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Draft admission, deployed verification, storage, or provider recovery is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/billing/subscriptions": {
         parameters: {
             query?: never;
@@ -1521,6 +1691,67 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/email-subscriptions/market-read/unsubscribe": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unsubscribe from Market Read without a user session
+         * @description Accepts an opaque account-lifetime capability and idempotently reduces Market Read consent. The response does not reveal whether the capability exists or whether consent changed.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadUnsubscribeInput"];
+                };
+            };
+            responses: {
+                /** @description The unsubscribe request was accepted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketReadUnsubscribeResponse"];
+                    };
+                };
+                /** @description Invalid unsubscribe request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Email preference storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/cli-auth/requests": {
         parameters: {
             query?: never;
@@ -2880,7 +3111,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/price-index/stats": {
+    "/v1/market/overview": {
         parameters: {
             query?: never;
             header?: never;
@@ -2888,33 +3119,25 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Price movement significance stats
-         * @description Precomputed movement-significance stats over price_index_move_stats. The unfiltered retail slice is public; origin/process/wholesale filters require Parchment Intelligence (ppiAccess).
+         * Public green-coffee market overview
+         * @description Returns aggregate-only daily change, live catalog coverage, movement velocity, processing mix, and origin price distributions over the public catalog. The public-demo credential, authenticated sessions, and API keys with catalog public-read access receive the same public evidence; direct anonymous API calls are rejected. Named lots and entitled supplier evidence are separate resources.
          */
         get: {
             parameters: {
-                query?: {
-                    page?: number;
-                    limit?: number;
-                    origin?: string;
-                    process?: string;
-                    market?: "retail" | "wholesale" | "all";
-                    window?: "7d" | "30d";
-                    baseline_weeks?: number;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description A page of price movement significance stats */
+                /** @description Public aggregate market overview */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
+                        "application/json": components["schemas"]["MarketOverviewResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -2935,6 +3158,15 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Public market overview capacity exceeded */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
@@ -2945,7 +3177,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/market/metadata-index": {
+    "/v1/price-index/stats": {
         parameters: {
             query?: never;
             header?: never;
@@ -2953,20 +3185,19 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Metadata-trend index (process/disclosure/Purveyor Score over time)
-         * @description Metadata-trend index over metadata_index_snapshots. The process/retail/month slice is public; other dimensions, origins, and grains require Parchment Intelligence (ppiAccess). Purveyor Score dimensions use coffee_catalog.purveyor_score and companion fields, never supplier-stated score_value.
+         * Price movement significance stats
+         * @description Precomputed movement-significance stats over price_index_move_stats. The unfiltered retail slice is public; origin/process/wholesale filters require Parchment Intelligence (ppiAccess).
          */
         get: {
             parameters: {
                 query?: {
                     page?: number;
                     limit?: number;
-                    dimension?: "process" | "disclosure" | "purveyor_score" | "purveyor_score_confidence" | "purveyor_score_tier";
                     origin?: string;
+                    process?: string;
                     market?: "retail" | "wholesale" | "all";
-                    grain?: "week" | "month";
-                    from?: string;
-                    to?: string;
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
                 };
                 header?: never;
                 path?: never;
@@ -2974,13 +3205,13 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description A metadata-trend series */
+                /** @description A page of price movement significance stats */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["MetadataIndexResponse"];
+                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -3011,7 +3242,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/catalog/{id}/similar": {
+    "/v1/market/metadata-index": {
         parameters: {
             query?: never;
             header?: never;
@@ -3019,21 +3250,87 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Find catalog coffees similar to a target coffee
-         * @description Vector-similarity matches between supplier catalog coffees, with deterministic identity gating, supplier-diversity re-ranking, and a canonical/similar split. User-owned coffees are excluded. Requires the bean-matching capability (a member session or a paid API plan).
+         * Metadata-trend index (process/disclosure/Purveyor Score over time)
+         * @description Metadata-trend index over metadata_index_snapshots. The process/retail/month slice is public; other dimensions, origins, and grains require Parchment Intelligence (ppiAccess). Purveyor Score dimensions use coffee_catalog.purveyor_score and companion fields, never supplier-stated score_value.
          */
         get: {
             parameters: {
                 query?: {
-                    threshold?: string;
+                    page?: number;
                     limit?: number;
-                    stocked_only?: "true" | "false";
-                    mode?: "all" | "likely_same" | "similar_profile";
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
+                    dimension?: "process" | "disclosure" | "purveyor_score" | "purveyor_score_confidence" | "purveyor_score_tier";
+                    origin?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    grain?: "week" | "month";
+                    from?: string;
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A metadata-trend series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MetadataIndexResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/{id}/similar": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Find catalog coffees similar to a target coffee
+         * @description Vector-similarity matches between supplier catalog coffees, with deterministic identity gating, supplier-diversity re-ranking, and a canonical/similar split. User-owned coffees are excluded. Requires the bean-matching capability (a member session or a paid API plan).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    threshold?: string;
+                    limit?: number;
+                    stocked_only?: "true" | "false";
+                    mode?: "all" | "likely_same" | "similar_profile";
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
@@ -4169,7 +4466,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/inventory/{id}": {
+    "/v1/inventory/catalog-batches/reservations": {
         parameters: {
             query?: never;
             header?: never;
@@ -4178,29 +4475,30 @@ interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
         /**
-         * Delete an owner inventory item
-         * @description Delete one of the caller's own inventory rows. Returns 409 if dependent roast profiles or sales exist (no force-cascade). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         * Reserve a catalog inventory batch
+         * @description Durably accept complete canonical intent for 1–50 existing visible catalog coffees before mutation starts. After acceptance, clients retain only batchId. Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    id: number;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CatalogInventoryBatchReserveRequest"];
+                };
+            };
             responses: {
-                /** @description The inventory row was deleted */
-                200: {
+                /** @description The durable accepted lifecycle */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryDeleteResponse"];
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -4230,16 +4528,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such inventory item owned by the caller */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
+                /** @description The batch UUID is already reserved for different canonical catalog inventory intent */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -4257,7 +4546,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Inventory writes are not enabled in this environment */
+                /** @description Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -4268,36 +4557,43 @@ interface paths {
                 };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/catalog-batches/{batchId}/commit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Update an owner inventory item
-         * @description Update fields on one of the caller's own inventory rows. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         * Commit a reserved catalog inventory batch
+         * @description Claim and atomically commit the server-owned request for a reserved batch UUID. Concurrent commits serialize through the durable lifecycle; callers may safely retry with no request body.
          */
-        patch: {
+        post: {
             parameters: {
                 query?: never;
-                header?: {
-                    "if-match"?: string;
-                };
+                header?: never;
                 path: {
-                    id: number;
+                    batchId: string;
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["InventoryUpdateRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description The updated inventory row */
+                /** @description The current identity-only lifecycle, including completion or terminal rejection */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryItemResponse"];
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -4327,7 +4623,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such inventory item owned by the caller */
+                /** @description No reserved catalog inventory batch exists for this owner and batch UUID */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -4336,15 +4632,6 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 /** @description Per-user mutation throttle exceeded; retry after a short wait */
                 429: {
                     headers: {
@@ -4354,7 +4641,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Inventory writes are not enabled in this environment */
+                /** @description Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -4365,9 +4652,13 @@ interface paths {
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
-    "/v1/roasts": {
+    "/v1/inventory/catalog-batches/{batchId}/status": {
         parameters: {
             query?: never;
             header?: never;
@@ -4375,36 +4666,27 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List owner roasts
-         * @description List the authenticated principal's own roast profiles, most recent first. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         * Get catalog inventory batch lifecycle
+         * @description Return unknown, accepted, in_progress, completed, or terminal_rejected for owner-scoped durable intent. Missing and cross-tenant UUIDs are the same nonterminal unknown state.
          */
         get: {
             parameters: {
-                query?: {
-                    coffee_id?: number;
-                    roast_id?: number;
-                    batch_name?: string;
-                    coffee_name?: string;
-                    date_start?: string;
-                    date_end?: string;
-                    stocked_only?: boolean | null;
-                    catalog_id?: number;
-                    limit?: number;
-                    offset?: number | null;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    batchId: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description The principal's own roast profiles */
+                /** @description The identity-only catalog inventory batch lifecycle */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastListResponse"];
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -4434,35 +4716,57 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
         /**
-         * Create an owner roast
-         * @description Create a roast profile owned by the authenticated principal, optionally replacing its temperature curve and event markers atomically. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * Delete an owner inventory item
+         * @description Delete one of the caller's own inventory rows. Returns 409 if dependent roast profiles or sales exist (no force-cascade). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
          */
-        post: {
+        delete: {
             parameters: {
                 query?: never;
-                header?: {
-                    "idempotency-key"?: string;
+                header?: never;
+                path: {
+                    id: number;
                 };
-                path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["RoastCreateRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description The created roast profile */
-                201: {
+                /** @description The inventory row was deleted */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastDetailResponse"];
+                        "application/json": components["schemas"]["InventoryDeleteResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -4492,7 +4796,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such coffee lot owned by the caller */
+                /** @description No such inventory item owned by the caller */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -4501,7 +4805,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Write conflict: an If-Match precondition failed */
+                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -4519,7 +4823,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Roast writes are not enabled in this environment */
+                /** @description Inventory writes are not enabled in this environment */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -4530,38 +4834,300 @@ interface paths {
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/roasts/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
         /**
-         * Get an owner roast
-         * @description Fetch one of the authenticated principal's roast profiles by id, optionally with its temperature curve and event markers. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         * Update an owner inventory item
+         * @description Update fields on one of the caller's own inventory rows. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
          */
-        get: {
+        patch: {
             parameters: {
-                query?: {
-                    includeTemps?: boolean | null;
-                    includeEvents?: boolean | null;
+                query?: never;
+                header?: {
+                    "if-match"?: string;
                 };
-                header?: never;
                 path: {
-                    id: string;
+                    id: number;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
-            responses: {
-                /** @description The requested roast profile */
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["InventoryUpdateRequest"];
+                };
+            };
+            responses: {
+                /** @description The updated inventory row */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryItemResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description No such inventory item owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Inventory writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/v1/roasts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List owner roasts
+         * @description List the authenticated principal's own roast profiles, most recent first. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    coffee_id?: number;
+                    roast_id?: number;
+                    batch_name?: string;
+                    coffee_name?: string;
+                    date_start?: string;
+                    date_end?: string;
+                    stocked_only?: boolean | null;
+                    catalog_id?: number;
+                    limit?: number;
+                    offset?: number | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The principal's own roast profiles */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastListResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create an owner roast
+         * @description Create a roast profile owned by the authenticated principal, optionally replacing its temperature curve and event markers atomically. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The created roast profile */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastDetailResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description No such coffee lot owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Roast writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an owner roast
+         * @description Fetch one of the authenticated principal's roast profiles by id, optionally with its temperature curve and event markers. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    includeTemps?: boolean | null;
+                    includeEvents?: boolean | null;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The requested roast profile */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -5877,6 +6443,34 @@ interface components {
             status: "accepted" | "attempting" | "published" | "settled" | "closed" | "conflict";
             clientSecret: string | null;
         };
+        MarketBriefDraftState: {
+            /** Format: uuid */
+            draftId: string;
+            edition: number;
+            productionCommit: string;
+            /** @enum {string} */
+            status: "creating" | "uncertain" | "created" | "conflict";
+        };
+        MarketBriefDraftResponse: {
+            data: components["schemas"]["MarketBriefDraftState"];
+        };
+        MarketBriefDraftInput: {
+            /** @enum {number} */
+            schemaVersion: 1;
+            /** @enum {string} */
+            publication: "market-brief";
+            edition: number;
+            slug: string;
+            /** Format: uri */
+            canonicalUrl: string;
+            productionCommit: string;
+            /** @enum {string} */
+            rendererVersion: "market-brief-email-v1";
+            projectionSha256: string;
+            subject: string;
+            html: string;
+            text: string;
+        };
         BillingSubscriptionOperation: {
             /** Format: uuid */
             operationId: string;
@@ -6024,6 +6618,16 @@ interface components {
             /** @enum {boolean} */
             subscribed: false;
         };
+        MarketReadUnsubscribeResponse: {
+            data: {
+                /** @enum {boolean} */
+                accepted: true;
+            };
+        };
+        MarketReadUnsubscribeInput: {
+            /** Format: uuid */
+            capability: string;
+        };
         CatalogAccessResponse: {
             visibility: {
                 isPrivilegedSession: boolean;
@@ -6937,6 +7541,135 @@ interface components {
                 };
             };
         };
+        MarketOverviewResponse: {
+            data: {
+                daily: {
+                    asOf: string | null;
+                    totalStocked: number;
+                    totalSuppliers: number;
+                    totalOrigins: number;
+                    retailMedian: number | null;
+                    changes: {
+                        retailMedian7d: number | null;
+                        retailMedian30d: number | null;
+                        supply7d: number | null;
+                        supply30d: number | null;
+                    };
+                };
+                coverage: {
+                    totalListings: number;
+                    stockedListings: {
+                        total: number;
+                        retail: number;
+                        wholesale: number;
+                    };
+                    stockedOrigins: {
+                        total: number;
+                        retail: number;
+                        wholesale: number;
+                    };
+                    stockedSuppliers: {
+                        total: number;
+                        retail: number;
+                        wholesale: number;
+                    };
+                };
+                movement: {
+                    referenceDate: string;
+                    arrivals: {
+                        sevenDay: {
+                            retail: number;
+                            wholesale: number;
+                        };
+                        thirtyDay: {
+                            retail: number;
+                            wholesale: number;
+                        };
+                    };
+                    delistings: {
+                        sevenDay: {
+                            retail: number;
+                            wholesale: number;
+                        };
+                        thirtyDay: {
+                            retail: number;
+                            wholesale: number;
+                        };
+                    };
+                };
+                processDistribution: {
+                    process: string;
+                    total: number;
+                    retail: number;
+                    wholesale: number;
+                }[];
+                originPriceDistribution: {
+                    origin: string;
+                    /** @enum {string} */
+                    market: "all" | "retail" | "wholesale";
+                    price: {
+                        min: number;
+                        max: number;
+                        average: number;
+                        median: number;
+                        p25: number;
+                        p75: number;
+                    };
+                    sampleSize: number;
+                    supplierCount: number;
+                }[];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "market-overview";
+                /** @enum {string} */
+                namespace: "/v1/market/overview";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                    ppiAccess: boolean;
+                };
+                access: {
+                    /** @enum {boolean} */
+                    publicSlice: true;
+                    /** @enum {boolean} */
+                    publicOnly: true;
+                    totalAvailable: number;
+                    rowLimit: number;
+                    /** @enum {boolean} */
+                    limited: false;
+                };
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    asOf: string | null;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
+                thresholds: {
+                    movementWindowsDays: [
+                        7,
+                        30
+                    ];
+                    minimumOriginLots: number;
+                };
+                source: {
+                    tables: [
+                        "market_daily_summary",
+                        "coffee_catalog"
+                    ];
+                    /** @enum {boolean} */
+                    aggregateOnly: true;
+                };
+            };
+        };
         PriceMoveStatsItem: {
             segment: {
                 origin: string | null;
@@ -7589,27 +8322,82 @@ interface components {
             notes?: string;
             items: components["schemas"]["ManualInventoryBatchItem"][];
         };
-        ManualInventoryBatchTerminalError: {
+        ManualInventoryBatchTerminalError: {
+            code: string;
+            message: string;
+        };
+        ManualInventoryBatchLifecycle: {
+            /** Format: uuid */
+            batchId: string;
+            /** @enum {string} */
+            status: "unknown" | "accepted" | "in_progress" | "completed" | "terminal_rejected";
+            result: components["schemas"]["ManualInventoryBatchResult"] | null;
+            error: components["schemas"]["ManualInventoryBatchTerminalError"] | null;
+            /** Format: date-time */
+            updatedAt: string | null;
+        };
+        ManualInventoryBatchLifecycleResponse: {
+            data: components["schemas"]["ManualInventoryBatchLifecycle"];
+            meta: {
+                /** @enum {string} */
+                resource: "inventory-manual-batch-lifecycle";
+                /** @enum {string} */
+                namespace: "/v1/inventory/manual-batches";
+                /** @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;
+                };
+            };
+        };
+        ManualInventoryBatchReserveRequest: {
+            /**
+             * Format: uuid
+             * @description Stable client-generated batch identity. Store only this UUID after reservation succeeds.
+             */
+            batchId: string;
+            /** @description Purchase date (YYYY-MM-DD); defaults to today (UTC). */
+            purchaseDate?: string;
+            /** @description Shared tax and shipping total with at most two decimal places. Parchment allocates exact cents deterministically by item order. */
+            taxShipTotal?: number;
+            notes?: string;
+            items: components["schemas"]["ManualInventoryBatchItem"][];
+        };
+        CatalogInventoryBatchResult: {
+            /** Format: uuid */
+            batchId: string;
+            items: {
+                /** Format: uuid */
+                rowId: string;
+                inventoryId: number;
+            }[];
+        };
+        CatalogInventoryBatchTerminalError: {
             code: string;
             message: string;
         };
-        ManualInventoryBatchLifecycle: {
+        CatalogInventoryBatchLifecycle: {
             /** Format: uuid */
             batchId: string;
             /** @enum {string} */
             status: "unknown" | "accepted" | "in_progress" | "completed" | "terminal_rejected";
-            result: components["schemas"]["ManualInventoryBatchResult"] | null;
-            error: components["schemas"]["ManualInventoryBatchTerminalError"] | null;
+            result: components["schemas"]["CatalogInventoryBatchResult"] | null;
+            error: components["schemas"]["CatalogInventoryBatchTerminalError"] | null;
             /** Format: date-time */
             updatedAt: string | null;
         };
-        ManualInventoryBatchLifecycleResponse: {
-            data: components["schemas"]["ManualInventoryBatchLifecycle"];
+        CatalogInventoryBatchLifecycleResponse: {
+            data: components["schemas"]["CatalogInventoryBatchLifecycle"];
             meta: {
                 /** @enum {string} */
-                resource: "inventory-manual-batch-lifecycle";
+                resource: "inventory-catalog-batch-lifecycle";
                 /** @enum {string} */
-                namespace: "/v1/inventory/manual-batches";
+                namespace: "/v1/inventory/catalog-batches";
                 /** @enum {string} */
                 version: "v1";
                 auth: {
@@ -7622,18 +8410,39 @@ interface components {
                 };
             };
         };
-        ManualInventoryBatchReserveRequest: {
+        CatalogInventoryBatchItem: {
             /**
              * Format: uuid
-             * @description Stable client-generated batch identity. Store only this UUID after reservation succeeds.
+             * @description Stable client-generated row identity returned unchanged with the created inventory id.
+             */
+            rowId: string;
+            /** @description Visible coffee_catalog.id to add to owner inventory. */
+            catalogId: number;
+            /** @description Purchased quantity in pounds. */
+            qty: number;
+            /** @description Total bean cost for this inventory lot. */
+            cost?: number;
+            /** @description Owner-assigned integer ranking for this inventory lot (PostgreSQL integer range). */
+            rank?: number | null;
+            /** @description Explicit stock-state override. When omitted, stock is derived from purchased quantity. */
+            stocked?: boolean;
+            /** @description Owner cupping data stored as JSON. */
+            cuppingNotes?: string | number | boolean | unknown[] | {
+                [key: string]: unknown;
+            } | null;
+        };
+        CatalogInventoryBatchReserveRequest: {
+            /**
+             * Format: uuid
+             * @description Stable client-generated batch identity. Persist only this UUID after reservation succeeds.
              */
             batchId: string;
             /** @description Purchase date (YYYY-MM-DD); defaults to today (UTC). */
             purchaseDate?: string;
-            /** @description Shared tax and shipping total with at most two decimal places. Parchment allocates exact cents deterministically by item order. */
+            /** @description Shared tax and shipping total. Parchment normalizes exact cents before reservation and allocates them by input order. */
             taxShipTotal?: number;
             notes?: string;
-            items: components["schemas"]["ManualInventoryBatchItem"][];
+            items: components["schemas"]["CatalogInventoryBatchItem"][];
         };
         InventoryItemResponse: {
             data: components["schemas"]["InventoryResource"];
@@ -8416,9 +9225,10 @@ interface ParchmentClientOptions {
     /** Base URL of the Parchment API, e.g. https://api.purveyors.io */
     baseUrl: string;
     /**
-     * Optional bearer token (a Supabase JWT or, later, an API key). Sent as
-     * `Authorization: Bearer <token>`. Auth is resolved server-side against the
-     * unified principal model; the SDK only forwards the credential.
+     * Optional bearer token (a Supabase JWT, API key, or dedicated machine
+     * credential). Sent as
+     * `Authorization: Bearer <token>`. Auth is resolved server-side at the route
+     * boundary; the SDK only forwards the credential.
      */
     token?: string;
     /** Override the fetch implementation (useful for tests or custom runtimes). */
@@ -8469,6 +9279,8 @@ type PriceIndexQuery = NonNullable<paths["/v1/price-index"]["get"]["parameters"]
 type PriceIndexHistoryQuery = NonNullable<paths["/v1/price-index/history"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.market.signals}. */
 type MarketSignalsQuery = NonNullable<paths["/v1/market/signals"]["get"]["parameters"]["query"]>;
+/** Aggregate-only public green-coffee market evidence. */
+type MarketOverview = components["schemas"]["MarketOverviewResponse"];
 /** Query parameters for {@link ParchmentClient.priceIndex.stats}. */
 type PriceIndexStatsQuery = NonNullable<paths["/v1/price-index/stats"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.market.metadataIndex}. */
@@ -8493,6 +9305,12 @@ type ManualInventoryCreateRequest = components["schemas"]["ManualInventoryCreate
 type ManualInventoryBatchCreateRequest = NonNullable<paths["/v1/inventory/manual-batches"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for reserving durable server-owned manual-batch intent. */
 type ManualInventoryBatchReserveRequest = NonNullable<paths["/v1/inventory/manual-batches/reservations"]["post"]["requestBody"]>["content"]["application/json"];
+/** Complete canonical intent accepted by the catalog-batch reservation lane. */
+type CatalogInventoryBatchReserveRequest = NonNullable<paths["/v1/inventory/catalog-batches/reservations"]["post"]["requestBody"]>["content"]["application/json"];
+/** Durable catalog-batch state returned by reserve, commit, and status. */
+type CatalogInventoryBatchLifecycle = components["schemas"]["CatalogInventoryBatchLifecycle"];
+/** Identity-only terminal result; catalog resources remain a separate read. */
+type CatalogInventoryBatchResult = components["schemas"]["CatalogInventoryBatchResult"];
 /** Request body for {@link ParchmentClient.inventory.update}. */
 type InventoryUpdateRequest = NonNullable<paths["/v1/inventory/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.roasts.list}. */
@@ -8533,6 +9351,10 @@ type OwnerApiUsageQuery = NonNullable<paths["/v1/api-usage"]["get"]["parameters"
 type OwnerApiUsage = components["schemas"]["OwnerApiUsageResponse"];
 /** Request body for {@link ParchmentClient.emailSubscriptions.setMarketRead}. */
 type MarketReadPreferenceRequest = NonNullable<paths["/v1/email-subscriptions/market-read"]["put"]["requestBody"]>["content"]["application/json"];
+/** Request body for {@link ParchmentClient.emailSubscriptions.unsubscribeMarketRead}. */
+type MarketReadUnsubscribeRequest = NonNullable<paths["/v1/email-subscriptions/market-read/unsubscribe"]["post"]["requestBody"]>["content"]["application/json"];
+/** Immutable deployed projection accepted by {@link ParchmentClient.marketBrief.drafts.create}. */
+type MarketBriefDraftCreateRequest = NonNullable<paths["/v1/market-brief/drafts"]["post"]["requestBody"]>["content"]["application/json"];
 /** Durable state returned by an account-deletion request. */
 type AccountDeletionOperation = components["schemas"]["AccountDeletionOperation"];
 /** Purpose-bound recent-reauthentication assertion for account deletion. */
@@ -9184,6 +10006,140 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 subscribed: false;
             };
         }, `${string}/${string}`>>;
+        /** Idempotently unsubscribe using an opaque capability without requiring a session. */
+        unsubscribeMarketRead: (body: MarketReadUnsubscribeRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadUnsubscribeInput"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketReadUnsubscribeResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                capability: string;
+            };
+        }, `${string}/${string}`>>;
+    };
+    marketBrief: {
+        drafts: {
+            /** Accept, create, or recover one immutable deployed edition version. */
+            create: (body: MarketBriefDraftCreateRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query? /** Live catalog price context by origin. */: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftInput"];
+                    };
+                };
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                        };
+                    };
+                    202: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                        };
+                    };
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"] /** Parchment Price Index (aggregate snapshots). */["ErrorResponse"];
+                        };
+                    };
+                    413: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                body: {
+                    schemaVersion: 1;
+                    publication: "market-brief";
+                    edition: number;
+                    slug: string;
+                    canonicalUrl: string;
+                    productionCommit: string;
+                    rendererVersion: "market-brief-email-v1";
+                    projectionSha256: string;
+                    subject: string;
+                    html: string;
+                    text: string;
+                };
+            }, `${string}/${string}`>>;
+        };
     };
     accountDeletion: {
         /** Accept or replay deletion using a purpose-bound reauthentication assertion. */
@@ -9427,7 +10383,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** Liveness and service identity. */["BillingCheckoutSession"];
+                            "application/json": components["schemas"]["BillingCheckoutSession"];
                         };
                     };
                     401: {
@@ -9611,7 +10567,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** List the caller's saved sourcing briefs. */["BillingSubscriptionOperation"];
+                            "application/json": components["schemas"]["BillingSubscriptionOperation"];
                         };
                     };
                     202: {
@@ -9628,7 +10584,12 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": 
+                            /**
+                             * Delete one of the caller's own inventory rows. Returns 409 if dependent
+                             * roast profiles or sales exist (no force-cascade).
+                             */
+                            components["schemas"]["ErrorResponse"];
                         };
                     };
                     404: {
@@ -9859,21 +10820,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         setManual: (ownerId: string, body: BillingManualEntitlementsRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header
-                /**
-                 * Record a sale against one of the caller's own green-coffee inventory
-                 * lots. Requires a session or an owner-bound API key carrying the exact
-                 * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the
-                 * same key replays the original result, and a concurrent duplicate gets
-                 * 409 while the first is in flight.
-                 */
-                ? /**
-                 * Record a sale against one of the caller's own green-coffee inventory
-                 * lots. Requires a session or an owner-bound API key carrying the exact
-                 * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the
-                 * same key replays the original result, and a concurrent duplicate gets
-                 * 409 while the first is in flight.
-                 */: never;
+                header?: never;
                 path: {
                     ownerId: string;
                 };
@@ -11253,7 +12200,118 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    windowDays?: number;
+                    page?: number;
+                    limit?: number;
+                    order?: "asc" | "desc";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /** Price movement significance stats (precomputed). */
+        stats: (query?: PriceIndexStatsQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    market: {
+        /** Aggregate daily changes, catalog coverage, movement, processing, and origin prices. */
+        overview: () => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketOverviewResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -11262,28 +12320,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                 };
             };
-        }, {
-            params: {
-                query: {
-                    windowDays?: number;
-                    page?: number;
-                    limit?: number;
-                    order?: "asc" | "desc";
-                } | undefined;
-            };
-        }, `${string}/${string}`>>;
-        /** Price movement significance stats (precomputed). */
-        stats: (query?: PriceIndexStatsQuery) => Promise<openapi_fetch.FetchResponse<{
+        }, openapi_fetch.FetchOptions<{
             parameters: {
-                query?: {
-                    page?: number;
-                    limit?: number;
-                    origin?: string;
-                    process?: string;
-                    market?: "retail" | "wholesale" | "all";
-                    window?: "7d" | "30d";
-                    baseline_weeks?: number;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
@@ -11295,7 +12334,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
+                        "application/json": components["schemas"]["MarketOverviewResponse"];
                     };
                 };
                 401: {
@@ -11314,22 +12353,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
-        }, {
-            params: {
-                query: {
-                    page?: number;
-                    limit?: number;
-                    origin?: string;
-                    process?: string;
-                    market?: "retail" | "wholesale" | "all";
-                    window?: "7d" | "30d";
-                    baseline_weeks?: number;
-                } | undefined;
-            };
-        }, `${string}/${string}`>>;
-    };
-    market: {
+        }> | undefined, `${string}/${string}`>>;
         /** Actionable market value signals. */
         signals: (query?: MarketSignalsQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -12535,6 +13568,222 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
+        /** Durably reserve canonical catalog-backed inventory intent. */
+        reserveCatalogBatch: (body: CatalogInventoryBatchReserveRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CatalogInventoryBatchReserveRequest"];
+                };
+            };
+            responses: {
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                batchId: string;
+                purchaseDate?: string;
+                taxShipTotal?: number;
+                notes?: string;
+                items: components["schemas"]["CatalogInventoryBatchItem"][];
+            };
+        }, `${string}/${string}`>>;
+        /** Atomically commit a reserved catalog batch by UUID, with no body. */
+        commitCatalogBatch: (batchId: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    batchId: string;
+                };
+            };
+        }, `${string}/${string}`>>;
+        /** Recover the owner-scoped lifecycle; missing batches remain unknown. */
+        getCatalogBatchStatus: (batchId: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    batchId: string;
+                };
+            };
+        }, `${string}/${string}`>>;
         /**
          * Update one of the caller's own inventory rows. Pass `ifMatch` (the
          * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
@@ -14192,4 +15441,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastChartDataQuery, 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, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastChartDataQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };