@purveyors/sdk 0.38.0 → 0.40.0

package/dist/index.d.ts

@@ -3642,6 +3642,99 @@ 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;
@@ -11043,6 +11136,131 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/conversation/chat": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 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.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["ConversationChatStreamRequest"];
+                };
+            };
+            responses: {
+                /** @description AI SDK UI-message event stream */
+                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: {
+                        "text/event-stream": string;
+                    };
+                };
+                /** @description Invalid chat 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 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"];
+                        "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 AI provider 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"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/conversation/memory": {
         parameters: {
             query?: never;
@@ -11333,6 +11551,177 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/conversation/memory/dream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reflect recent conversation into session-owner memory
+         * @description Session-only Cherry Runtime memory reflection. Parchment owns the prompt, model, provider credential, bounds, cooldown, and optimistic commit.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["ConversationMemoryDreamRequest"];
+                };
+            };
+            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"]["ConversationMemoryDreamResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @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: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 interface components {
     schemas: {
@@ -12423,6 +12812,7 @@ interface components {
                 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} */
@@ -12430,6 +12820,19 @@ interface components {
             /** @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;
@@ -14934,6 +15337,28 @@ interface components {
             };
             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;
@@ -14956,6 +15381,22 @@ interface components {
             /** @enum {string} */
             updatedBy: "user" | "agent";
         };
+        ConversationMemoryDreamResponse: {
+            data: components["schemas"]["ConversationMemory"] & {
+                skipped: boolean;
+                /** @enum {string} */
+                reason?: "cooldown" | "empty-response";
+                retryAfterMs?: number;
+            };
+            meta: components["schemas"]["ConversationResponseMeta"];
+        };
+        ConversationMemoryDreamRequest: {
+            messages: {
+                /** @enum {string} */
+                role: "user" | "assistant";
+                content: string;
+            }[];
+        };
     };
     responses: {
         /** @description Account monthly allowance or fixed one-minute machine burst allowance exhausted. Rejected attempts are not added to usage. */
@@ -15089,6 +15530,7 @@ type ConversationWorkspaceClearRequest = NonNullable<paths["/v1/conversation/wor
 type ConversationCanvasUpdateRequest = NonNullable<paths["/v1/conversation/workspaces/{workspaceId}/canvas"]["put"]["requestBody"]>["content"]["application/json"];
 type ConversationSummaryUpdateRequest = NonNullable<paths["/v1/conversation/workspaces/{workspaceId}/summary"]["put"]["requestBody"]>["content"]["application/json"];
 type ConversationMemoryUpdateRequest = NonNullable<paths["/v1/conversation/memory"]["put"]["requestBody"]>["content"]["application/json"];
+type ConversationMemoryDreamRequest = NonNullable<paths["/v1/conversation/memory/dream"]["post"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.inventory.list}. */
 type InventoryListQuery = NonNullable<paths["/v1/inventory"]["get"]["parameters"]["query"]>;
 /** Request body for {@link ParchmentClient.inventory.create}. */
@@ -15183,6 +15625,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.
  *
@@ -16193,7 +16637,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                            "application/json": components["schemas"] /** List canonical owner subscription snapshots. */["MarketBriefDraftResponse"];
                         };
                     };
                     202: {
@@ -16594,7 +17038,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": components["schemas"] /** Aggregate proof-coverage over the public catalog. */["ErrorResponse"];
                         };
                     };
                     503: {
@@ -16602,7 +17046,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** Parchment Price Index (aggregate snapshots). */["ErrorResponse"];
+                            "application/json": components["schemas"]["ErrorResponse"];
                         };
                     };
                 };
@@ -16650,7 +17094,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": components["schemas"] /** Aggregate proof-coverage over the public catalog. */["ErrorResponse"];
                         };
                     };
                     503: {
@@ -16658,7 +17102,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** Parchment Price Index (aggregate snapshots). */["ErrorResponse"];
+                            "application/json": components["schemas"]["ErrorResponse"];
                         };
                     };
                 };
@@ -16666,7 +17110,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             /** Durably cancel or resume the complete provider subscription. */
             mutate: (subscriptionId: string, body: BillingSubscriptionMutationRequest) => Promise<openapi_fetch.FetchResponse<{
                 parameters: {
-                    query?: never;
+                    query? /** Tier-one price-index chart history. */: never;
                     header?: never;
                     path: {
                         subscriptionId: string;
@@ -16705,7 +17149,11 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": components["schemas"] /**
+                             * List an owner-scoped tracked catalog-id page and bounded recent
+                             * summaries enriched with live catalog state. Follow nextCursor when
+                             * a capped response reports truncation.
+                             */["ErrorResponse"];
                         };
                     };
                     404: {
@@ -16830,9 +17278,10 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                     content: {
                         "application/json": components["schemas"] /**
-                         * 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.
+                         * Create an owner inventory lot. Requires a session or an owner-bound API
+                         * key carrying the exact `inventory:write` scope. Manual coffee creates
+                         * require `idempotencyKey`; catalog-backed creates accept it optionally.
+                         * The same key and payload replay the original result.
                          */["ErrorResponse"];
                     };
                 };
@@ -16911,9 +17360,10 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                     content: {
                         "application/json": components["schemas"] /**
-                         * 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.
+                         * Create an owner inventory lot. Requires a session or an owner-bound API
+                         * key carrying the exact `inventory:write` scope. Manual coffee creates
+                         * require `idempotencyKey`; catalog-backed creates accept it optionally.
+                         * The same key and payload replay the original result.
                          */["ErrorResponse"];
                     };
                 };
@@ -16973,7 +17423,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"] /** List the caller's own roast profiles (owner-scoped). */["ErrorResponse"];
                     };
                 };
                 404: {
@@ -16996,14 +17446,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"] /**
-                         * 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.
-                         */["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
                         "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
                         [name: string]: unknown;
                     };
@@ -17087,7 +17530,13 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
                 403: {
                     headers: {
-                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Limit": 
+                        /**
+                         * List the caller's owner-scoped profit summaries. API keys require
+                         * inventory:read, roast:read, and sales:read. Use pagination.total to
+                         * exhaust the complete owner result set.
+                         */
+                        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"];
@@ -18857,6 +19306,85 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, `${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?: {
+                    wholesale?: "true" | "false" | "all";
+                };
+                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"]["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: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        }, {
+            params: {
+                query: {
+                    wholesale?: "true" | "false" | "all";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
         /** Fresh matched-listing movement, not catalog composition or a canonical publication. */
         comparison: (query: {
             from: string;
@@ -20509,6 +21037,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<{
@@ -22175,6 +22713,157 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     updatedBy: "user" | "agent";
                 };
             }, `${string}/${string}`>>;
+            /** Reflect bounded recent messages into versioned session-owner memory. */
+            dream: (body: ConversationMemoryDreamRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": components["schemas"]["ConversationMemoryDreamRequest"];
+                    };
+                };
+                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"]["ConversationMemoryDreamResponse"];
+                        };
+                    };
+                    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"];
+                        };
+                    };
+                };
+            }, {
+                body: {
+                    messages: {
+                        role: "user" | "assistant";
+                        content: string;
+                    }[];
+                };
+            }, `${string}/${string}`>>;
         };
     };
     inventory: {
@@ -26447,4 +27136,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 ConversationMemoryDreamRequest, type ConversationMemoryUpdateRequest, type ConversationMessageAppendRequest, type ConversationSummaryUpdateRequest, type ConversationWorkspaceClearRequest, type ConversationWorkspaceCreateRequest, type ConversationWorkspaceMetadataRequest, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type 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 };