@purveyors/sdk 0.37.0 → 0.39.0

package/dist/index.d.ts

@@ -3642,6 +3642,195 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/price-index/comparisons": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Available 30-day price changes
+         * @description Automatically discovers usable origins for an exact 30-day comparison ending on the latest completed observation day within the last seven UTC dates. Returns only available comparisons, or an empty list. Actual dates are explicit; no shortened window, freshness backfill, or historical continuity is implied. Requires Parchment Intelligence.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    wholesale?: "true" | "false" | "all";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Available comparisons and their exact dates */
+                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"]["PriceComparisons"];
+                    };
+                };
+                /** @description Invalid market */
+                400: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/price-index/comparison": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fresh matched-listing price comparison
+         * @description Compares exact UTC dates within 365 days for one origin and market. Requires Parchment Intelligence. Supplier-balanced fresh matched prices only; catalog composition is not repricing. This observed comparison is not a canonical market publication. Missing fresh coverage returns null, never zero.
+         */
+        get: {
+            parameters: {
+                query: {
+                    from: string;
+                    to: string;
+                    origin: string;
+                    wholesale?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Observed comparison with coverage */
+                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"]["MatchedPriceComparison"];
+                    };
+                };
+                /** @description Invalid comparison bounds */
+                400: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/price-index": {
         parameters: {
             query?: never;
@@ -10778,22 +10967,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/conversation/memory": {
+    "/v1/conversation/workspaces/{workspaceId}/summary/compact": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Read session-owner memory
-         * @description Session-only owner conversation state. API keys are not accepted; owner identity is derived from the authenticated session.
+         * Generate and commit a bounded workspace summary
+         * @description Session-only Cherry Runtime compaction. Parchment owns the prompt, model, provider credential, message bounds, cooldown, and optimistic commit.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    workspaceId: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
@@ -10810,7 +11003,7 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ConversationMemoryResponse"];
+                        "application/json": components["schemas"]["ConversationSummaryCompactionResponse"];
                     };
                 };
                 /** @description Invalid conversation-state request */
@@ -10903,7 +11096,23 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: components["responses"]["ApiRateLimitExceeded"];
+                /** @description AI provider 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 Conversation-state persistence is temporarily unavailable */
                 503: {
                     headers: {
@@ -10921,11 +11130,26 @@ interface paths {
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/conversation/chat": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Optimistically update session-owner memory
-         * @description Session-only owner conversation state. API keys are not accepted; owner identity is derived from the authenticated session.
+         * Stream a Cherry Runtime response
+         * @description Session-only AI SDK UI-message stream. Parchment owns model selection, provider credentials, prompts, tool execution, request bounds, and cancellation propagation.
          */
-        put: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -10934,11 +11158,11 @@ interface paths {
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["ConversationMemoryUpdateRequest"];
+                    "application/json": components["schemas"]["ConversationChatStreamRequest"];
                 };
             };
             responses: {
-                /** @description Conversation-state result */
+                /** @description AI SDK UI-message event stream */
                 200: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10950,10 +11174,10 @@ interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ConversationMemoryUpdateResponse"];
+                        "text/event-stream": string;
                     };
                 };
-                /** @description Invalid conversation-state request */
+                /** @description Invalid chat request */
                 400: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
@@ -10998,23 +11222,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Workspace not found for the authenticated owner */
-                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 Reset epoch, version, replay payload, or high-water conflict */
-                409: {
+                /** @description Chat request or prompt exceeds a server-owned bound */
+                413: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -11028,8 +11237,9 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Conversation-state request body exceeds 1 MiB */
-                413: {
+                429: components["responses"]["ApiRateLimitExceeded"];
+                /** @description AI provider is temporarily unavailable */
+                503: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -11043,15 +11253,288 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: components["responses"]["ApiRateLimitExceeded"];
-                /** @description Conversation-state persistence is temporarily unavailable */
-                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"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/conversation/memory": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read session-owner memory
+         * @description Session-only owner conversation state. API keys are not accepted; owner identity is derived from the authenticated session.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Conversation-state result */
+                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"]["ConversationMemoryResponse"];
+                    };
+                };
+                /** @description Invalid conversation-state request */
+                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 Workspace not found for the authenticated owner */
+                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 Reset epoch, version, replay payload, or high-water 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"];
+                    };
+                };
+                /** @description Conversation-state request body exceeds 1 MiB */
+                413: {
+                    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"];
+                /** @description Conversation-state persistence is temporarily unavailable */
+                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"];
+                    };
+                };
+            };
+        };
+        /**
+         * Optimistically update session-owner memory
+         * @description Session-only owner conversation state. API keys are not accepted; owner identity is derived from the authenticated session.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["ConversationMemoryUpdateRequest"];
+                };
+            };
+            responses: {
+                /** @description Conversation-state result */
+                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"]["ConversationMemoryUpdateResponse"];
+                    };
+                };
+                /** @description Invalid conversation-state request */
+                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 Workspace not found for the authenticated owner */
+                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 Reset epoch, version, replay payload, or high-water 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"];
+                    };
+                };
+                /** @description Conversation-state request body exceeds 1 MiB */
+                413: {
+                    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"];
+                /** @description Conversation-state persistence is temporarily unavailable */
+                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;
                     };
@@ -12145,6 +12628,40 @@ interface components {
                 limitations: string[];
             };
         };
+        MatchedPriceComparison: {
+            from: string;
+            to: string;
+            origin: string;
+            wholesale: boolean;
+            /** @enum {string} */
+            status: "available" | "insufficient_fresh_coverage";
+            changePercent: number | null;
+            sample: {
+                fromListings: number;
+                toListings: number;
+                matchedListings: number;
+                matchedSuppliers: number;
+                /** @description Matched listings divided by starting-date listings; requires at least 50% of the starting cohort, five matches and three suppliers. */
+                matchedCoverage: number;
+            };
+            /** @enum {string} */
+            methodology: "matched-supplier-median-log-v1";
+            /** @enum {boolean} */
+            canonicalPublication: false;
+        };
+        PriceComparisons: {
+            /** @enum {number} */
+            windowDays: 30;
+            /** Format: date */
+            from: string | null;
+            /** Format: date */
+            to: string | null;
+            comparisons: (components["schemas"]["MatchedPriceComparison"] & {
+                /** @enum {string} */
+                status?: "available";
+                changePercent?: number;
+            })[];
+        };
         PriceIndexItem: {
             date: string;
             origin: string;
@@ -14638,6 +15155,39 @@ interface components {
             expectedMessageHighWater: number;
             contextSummary: string;
         };
+        ConversationSummaryCompactionResponse: {
+            data: {
+                contextSummary: string;
+                summaryVersion: number;
+                resetEpoch: number;
+                messageHighWater: number;
+                skipped: boolean;
+                retryAfterMs?: number;
+            };
+            meta: components["schemas"]["ConversationResponseMeta"];
+        };
+        ConversationChatStreamRequest: {
+            messages: unknown[];
+            workspaceContext?: {
+                /** Format: uuid */
+                id?: string;
+                type?: string;
+                includeMemory?: boolean;
+                canvasDescription?: string;
+            };
+            pageContext?: {
+                /** @enum {string} */
+                surface: "catalog" | "analytics" | "dashboard" | "beans" | "roast" | "profit";
+                summary: string;
+                entities?: {
+                    /** @enum {string} */
+                    type: "coffee" | "inventory_bean" | "roast" | "supplier";
+                    id: number | string;
+                    label: string;
+                }[];
+            };
+            includeUserMemory?: boolean;
+        };
         ConversationMemory: {
             content: string;
             version: number;
@@ -14887,6 +15437,8 @@ type CliAuthRequestCreate = NonNullable<paths["/v1/cli-auth/requests"]["post"]["
 type CliAuthInspectRequest = NonNullable<paths["/v1/cli-auth/inspect"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthApproveRequest = NonNullable<paths["/v1/cli-auth/approve"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthExchangeRequest = NonNullable<paths["/v1/cli-auth/token"]["post"]["requestBody"]>["content"]["application/json"];
+/** Browser-compatible AI SDK UI-message stream request. */
+type ConversationChatStreamRequest = components["schemas"]["ConversationChatStreamRequest"];
 /**
  * Create a typed Parchment API client.
  *
@@ -16259,7 +16811,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     query?: never;
                     header?: never;
                     path?: never;
-                    cookie?: never;
+                    cookie? /** Live catalog price context by origin. */: never;
                 };
                 requestBody?: never;
                 responses: {
@@ -16315,7 +16867,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     query?: never;
                     header?: never;
                     path?: never;
-                    cookie?: never;
+                    cookie? /** Live catalog price context by origin. */: never;
                 };
                 requestBody?: never;
                 responses: {
@@ -16463,7 +17015,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         discrepancies: () => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header? /** Optimistically replace canvas state. */: never;
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
@@ -16496,12 +17048,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 401: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": 
-                        /**
-                         * Redeem a capability supplied in JSON (never in a URL). This helper
-                         * does not require the client to be configured with a bearer token.
-                         */
-                        components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
@@ -16516,7 +17063,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
-                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Reset": 
+                        /** Read the session owner's versioned durable memory. */
+                        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"];
@@ -16530,11 +17079,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 503: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": components["headers"] /**
-                         * Get unknown, accepted, in-progress, completed, or terminal-rejected
-                         * state. Unknown is explicitly nonterminal, including missing or
-                         * cross-tenant UUIDs, so clients retain the UUID and retry.
-                         */["X-RateLimit-Remaining"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
@@ -16549,7 +17094,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, openapi_fetch.FetchOptions<{
             parameters: {
                 query?: never;
-                header? /** Optimistically replace canvas state. */: never;
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
@@ -16582,12 +17127,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 401: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": 
-                        /**
-                         * Redeem a capability supplied in JSON (never in a URL). This helper
-                         * does not require the client to be configured with a bearer token.
-                         */
-                        components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
@@ -16602,7 +17142,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
-                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Reset": 
+                        /** Read the session owner's versioned durable memory. */
+                        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"];
@@ -16616,11 +17158,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 503: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": components["headers"] /**
-                         * Get unknown, accepted, in-progress, completed, or terminal-rejected
-                         * state. Unknown is explicitly nonterminal, including missing or
-                         * cross-tenant UUIDs, so clients retain the UUID and retry.
-                         */["X-RateLimit-Remaining"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
                         "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                         "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
                         "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
@@ -16652,7 +17190,7 @@ 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"] /** List the caller's own roast profiles (owner-scoped). */["X-RateLimit-Burst-Reset"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
@@ -16730,7 +17268,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": 
+                        /**
+                         * Create a roast profile from an Artisan `.alog` file against one of the
+                         * caller's green-coffee lots, persisting the imported curve, events, and
+                         * an artisan_import_log entry atomically. Requires a session or an
+                         * owner-bound API key carrying the exact `roast:write` scope. The
+                         * optional `idempotencyKey` is payload-bound: same-key, same-payload
+                         * retries replay, while changed payloads conflict.
+                         */
+                        components["schemas"]["ErrorResponse"];
                     };
                 };
             };
@@ -16784,7 +17331,7 @@ 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": components["headers"] /** Delete one of the caller's own sales. */["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
                     };
@@ -18359,10 +18906,167 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                    };
+                };
+                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"];
+            };
+        }, openapi_fetch.FetchOptions<{
+            parameters: {
+                query?: never;
+                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"]["CatalogProofCoverageResponse"];
+                    };
+                };
+                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"];
+            };
+        }> | undefined, `${string}/${string}`>>;
+        /** Find catalog coffees similar to a target coffee. */
+        similar: (id: string, query?: CatalogSimilarQuery) => Promise<openapi_fetch.FetchResponse<{
+            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;
+            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"]["CatalogSimilarityResponse"];
+                    };
+                };
+                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"];
                     };
                 };
-                401: {
+                404: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -18376,7 +19080,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                429: components["responses"]["ApiRateLimitExceeded"];
+                503: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
                         "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
@@ -18390,11 +19095,30 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: components["responses"]["ApiRateLimitExceeded"];
             };
-        }, openapi_fetch.FetchOptions<{
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    threshold?: string;
+                    limit?: number;
+                    stocked_only?: "true" | "false";
+                    mode?: "all" | "likely_same" | "similar_profile";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    priceIndex: {
+        /** Available exact 30-day comparisons, with no empty-origin search. */
+        comparisons: (query?: {
+            wholesale?: "true" | "false" | "all";
+        }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: never;
+                query?: {
+                    wholesale?: "true" | "false" | "all";
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
@@ -18412,7 +19136,21 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                        "application/json": components["schemas"]["PriceComparisons"];
+                    };
+                };
+                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: {
@@ -18445,20 +19183,29 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
                 429: components["responses"]["ApiRateLimitExceeded"];
             };
-        }> | undefined, `${string}/${string}`>>;
-        /** Find catalog coffees similar to a target coffee. */
-        similar: (id: string, query?: CatalogSimilarQuery) => Promise<openapi_fetch.FetchResponse<{
+        }, {
+            params: {
+                query: {
+                    wholesale?: "true" | "false" | "all";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /** Fresh matched-listing movement, not catalog composition or a canonical publication. */
+        comparison: (query: {
+            from: string;
+            to: string;
+            origin: string;
+            wholesale?: "true" | "false";
+        }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: {
-                    threshold?: string;
-                    limit?: number;
-                    stocked_only?: "true" | "false";
-                    mode?: "all" | "likely_same" | "similar_profile";
+                query: {
+                    from: string;
+                    to: string;
+                    origin: string;
+                    wholesale?: "true" | "false";
                 };
                 header?: never;
-                path: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
@@ -18474,7 +19221,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CatalogSimilarityResponse"];
+                        "application/json": components["schemas"]["MatchedPriceComparison"];
                     };
                 };
                 400: {
@@ -18519,51 +19266,18 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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"];
-                    };
-                };
                 429: components["responses"]["ApiRateLimitExceeded"];
-                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"];
-                    };
-                };
             };
         }, {
             params: {
-                path: {
-                    id: string;
-                };
                 query: {
-                    threshold?: string;
-                    limit?: number;
-                    stocked_only?: "true" | "false";
-                    mode?: "all" | "likely_same" | "similar_profile";
-                } | undefined;
+                    from: string;
+                    to: string;
+                    origin: string;
+                    wholesale?: "true" | "false";
+                };
             };
         }, `${string}/${string}`>>;
-    };
-    priceIndex: {
         /** Parchment Price Index (aggregate snapshots). */
         list: (query?: PriceIndexQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -20128,6 +20842,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, `${string}/${string}`>>;
     };
     conversation: {
+        chat: {
+            /**
+             * Open a raw AI SDK UI-message stream. The response body is deliberately
+             * left unread so BFFs and browser transports can forward chunks without
+             * buffering. Aborting the supplied signal cancels the upstream request.
+             */
+            stream: (body: ConversationChatStreamRequest, init?: {
+                signal?: AbortSignal;
+            }) => Promise<Response>;
+        };
         workspaces: {
             /** Get or create the session owner's singleton workspace. */
             getOrCreate: (body: ConversationWorkspaceCreateRequest) => Promise<openapi_fetch.FetchResponse<{
@@ -21261,6 +21985,154 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     contextSummary: string;
                 };
             }, `${string}/${string}`>>;
+            /** Generate and CAS-commit a Parchment-owned workspace summary. */
+            compactSummary: (workspaceId: string) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path: {
+                        workspaceId: string;
+                    };
+                    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"]["ConversationSummaryCompactionResponse"];
+                        };
+                    };
+                    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"];
+                        };
+                    };
+                    413: {
+                        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"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        workspaceId: string;
+                    };
+                };
+            }, `${string}/${string}`>>;
         };
         memory: {
             /** Read the session owner's versioned durable memory. */
@@ -25918,4 +26790,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 CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogProofSummary, type CatalogSimilarQuery, type ConfirmedActionExecuteRequest, type ConversationCanvasUpdateRequest, 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 ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartDataQuery, 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, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogProofSummary, type CatalogSimilarQuery, type ConfirmedActionExecuteRequest, type ConversationCanvasUpdateRequest, type ConversationChatStreamRequest, 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 ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartDataQuery, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };