@purveyors/sdk 0.48.0 → 0.50.0

package/dist/index.d.ts

@@ -6092,6 +6092,116 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/catalog/{id}/price-history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily price history for one catalog coffee
+         * @description Daily price, full tier ladder, and stock state for one public supplier catalog coffee over 7 to 365 days (default 90), with minimum-tier change events so packaging changes are not read as price cuts. Available to member sessions, Parchment Intelligence sessions, and customer API keys with catalog:read.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    days?: string;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Daily price history with minimum-tier change events */
+                200: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["LotPriceHistoryResponse"];
+                    };
+                };
+                /** @description Invalid path id or days */
+                400: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Catalog coffee not found */
+                404: {
+                    headers: {
+                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                        "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Burst-Remaining": components["headers"]["X-RateLimit-Burst-Remaining"];
+                        "X-RateLimit-Burst-Reset": components["headers"]["X-RateLimit-Burst-Reset"];
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/procurement/briefs": {
         parameters: {
             query?: never;
@@ -15710,6 +15820,67 @@ interface components {
                 query_strategy: "bounded-vector-candidates-v1";
             };
         };
+        LotPriceHistoryResponse: {
+            data: {
+                catalogId: number;
+                /** @enum {string} */
+                currency: "USD";
+                /** Format: date */
+                from: string;
+                /** Format: date */
+                to: string;
+                points: {
+                    /** Format: date */
+                    date: string;
+                    /** @description Price per lb at the smallest tier, as the catalog displays it. */
+                    priceLb: number;
+                    minLbs: number | null;
+                    tiers: {
+                        minLbs: number;
+                        priceLb: number;
+                    }[];
+                    stocked: boolean;
+                    wholesale: boolean;
+                }[];
+                /** @description Minimum-tier changes (the smallest order quantity changed, so the smallest-tier price is not like for like) and stock changes. Larger tiers appearing or disappearing are not reported because they do not affect the smallest-tier price. */
+                events: ({
+                    /** Format: date */
+                    date: string;
+                    /** @enum {string} */
+                    type: "minimum_tier_change";
+                    fromMinLbs: number | null;
+                    toMinLbs: number | null;
+                } | {
+                    /** Format: date */
+                    date: string;
+                    /** @enum {string} */
+                    type: "restocked" | "unstocked";
+                })[];
+                summary: {
+                    latestPriceLb: number | null;
+                    minPriceLb: number | null;
+                    maxPriceLb: number | null;
+                    /** @description First-to-latest change in percent, only when the minimum tier never changed in the window. */
+                    comparableChangePct: number | null;
+                    minimumTierChanged: boolean;
+                };
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-price-history";
+                /** @enum {string} */
+                namespace: "/v1/catalog/{id}/price-history";
+                /** @enum {string} */
+                version: "v1";
+                days: number;
+                source: {
+                    /** @enum {string} */
+                    table: "coffee_price_snapshots";
+                    /** @enum {string} */
+                    grain: "day";
+                };
+            };
+        };
         SourcingBriefCriteria: {
             /** @enum {number} */
             version?: 1;
@@ -17688,6 +17859,8 @@ type CatalogRankPremiumHeaders = NonNullable<paths["/v1/catalog/rank-premium"]["
 type CatalogSupplierHeaders = NonNullable<paths["/v1/catalog/suppliers"]["get"]["parameters"]["header"]>;
 /** Query parameters for {@link ParchmentClient.catalog.similar}. */
 type CatalogSimilarQuery = NonNullable<paths["/v1/catalog/{id}/similar"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.catalog.priceHistory}. */
+type CatalogPriceHistoryQuery = NonNullable<paths["/v1/catalog/{id}/price-history"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.priceIndex.list}. */
 type PriceIndexQuery = NonNullable<paths["/v1/price-index"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.priceIndex.history}. */
@@ -21487,6 +21660,102 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Daily price history for one catalog coffee, with minimum-tier change events. */
+        priceHistory: (id: string, query?: CatalogPriceHistoryQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    days?: string;
+                };
+                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"]["LotPriceHistoryResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                429: components["responses"]["ApiRateLimitExceeded"];
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    days?: string;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
     };
     priceIndex: {
         /** Available exact 30-day comparisons, with no empty-origin search. */
@@ -28846,7 +29115,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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-Limit": 
+                        /** Anonymous capability body for {@link ParchmentClient.inventory.shareGrants.redeem}. */
+                        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;
@@ -29006,8 +29277,10 @@ 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-Burst-Limit": components["headers"]["X-RateLimit-Burst-Limit"];
+                        "X-RateLimit-Reset": 
+                        /** List the caller's saved sourcing briefs. */
+                        components["headers"]["X-RateLimit-Reset"];
+                        "X-RateLimit-Burst-Limit": components["headers"] /** Create a saved sourcing brief. */["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;
@@ -29073,7 +29346,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
                 401: {
                     headers: {
-                        "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                        "X-RateLimit-Limit": components["headers"] /** Read older messages before a canonical sequence cursor. */["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"];
@@ -29105,7 +29378,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"] /** Optimistically update session-owner memory. */["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;
                     };
@@ -29119,10 +29392,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"] /**
-                         * Redeem a capability supplied in JSON (never in a URL). This helper
-                         * does not require the client to be configured with a bearer token.
-                         */["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;
                     };
@@ -29206,10 +29476,7 @@ 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"] /**
-                         * Delete one of the caller's own inventory rows. Returns 409 if dependent
-                         * roast profiles or sales exist (no force-cascade).
-                         */["X-RateLimit-Reset"];
+                        "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"];
@@ -29223,7 +29490,7 @@ 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": components["headers"] /** List the caller's own roast profiles (owner-scoped). */["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"];
@@ -29320,7 +29587,7 @@ 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"] /** List Studio reference profiles without mixing them into roast history. */["X-RateLimit-Reset"];
+                        "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"];
@@ -29661,7 +29928,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 400: {
                     headers: {
                         "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                        "X-RateLimit-Remaining": components["headers"] /** Create an API key. The raw secret is returned only once. */["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"];
@@ -29691,7 +29958,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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"] /** Create or replay an embedded Checkout Session after activation. */["X-RateLimit-Burst-Limit"];
+                        "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;
@@ -30978,4 +31245,65 @@ 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 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 RoastChartData, type RoastChartDataQuery, type RoastChartEvent, type RoastChartSeries, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+/**
+ * Dotted paths of every callable ParchmentClient helper, for example
+ * `"priceIndex.comparisons"`. `raw` is the untyped openapi-fetch escape hatch
+ * and is not a named helper.
+ */
+type MethodPaths<T, Prefix extends string = ""> = {
+    [K in keyof T & string]: T[K] extends (...args: never[]) => unknown ? `${Prefix}${K}` : T[K] extends object ? MethodPaths<T[K], `${Prefix}${K}.`> : never;
+}[keyof T & string];
+type ParchmentClientMethod = MethodPaths<Omit<ParchmentClient, "raw">>;
+/**
+ * The SDK reads the Cherry web agent can perform on the signed-in user's
+ * behalf. Parchment's in-process chat adapter implements exactly these
+ * methods, and its tests fail if the two drift. Agent surfaces built on the
+ * SDK (such as the CLI) can import this list to prove they cover everything
+ * the web agent can do.
+ */
+declare const CHAT_AGENT_CAPABILITIES: readonly ["me", "catalog.list", "catalog.facets", "catalog.rank", "catalog.suppliers", "catalog.similar", "inventory.list", "roasts.list", "roasts.get", "roasts.chartData", "referenceProfiles.list", "referenceProfiles.get", "referenceProfiles.chart", "referenceProfiles.compare", "referenceProfiles.preview", "tasting.get", "priceIndex.list", "priceIndex.stats", "priceIndex.comparisons", "priceIndex.comparison", "priceIndex.history", "market.signals", "market.metadataIndex", "market.overview", "market.evidence"];
+type ChatAgentCapability = (typeof CHAT_AGENT_CAPABILITIES)[number];
+/**
+ * Writes the web agent can propose. The agent never writes directly: it
+ * returns an action card, and only the user's confirmation executes the
+ * action through the session-only `confirmedActions.execute` endpoint.
+ */
+declare const CHAT_AGENT_CONFIRMED_ACTION_TYPES: readonly ["add_bean_to_inventory", "update_bean", "create_roast_session", "create_roast_from_reference", "create_generated_reference", "update_roast_notes", "record_sale"];
+type ChatAgentConfirmedActionType = (typeof CHAT_AGENT_CONFIRMED_ACTION_TYPES)[number];
+type ChatAgentCapabilityExclusionReason = 
+/** Same write as a confirmed action; the agent proposes and the user confirms. */
+"confirmed_action_write"
+/** Bound to the signed-in user's own session; never called by the agent. */
+ | "session_only"
+/** Credential issuance or exchange. */
+ | "auth_bootstrap"
+/** Staff-only administration or publication. */
+ | "admin_only"
+/** A write with no confirmed-action path; the agent must not perform it. */
+ | "write_not_agent_facing"
+/** A read the agent has no tool for yet. */
+ | "read_not_wired"
+/** Service plumbing with no user data. */
+ | "infrastructure";
+interface ChatAgentCapabilityExclusion {
+    reason: ChatAgentCapabilityExclusionReason;
+    note: string;
+}
+/**
+ * Every ParchmentClient helper that is not a chat-agent capability, with the
+ * reason. The mapped type makes adding an SDK helper a compile error here
+ * until it is classified as a capability or an exclusion.
+ */
+declare const CHAT_AGENT_CAPABILITY_EXCLUSIONS: {
+    readonly [K in Exclude<ParchmentClientMethod, ChatAgentCapability>]: ChatAgentCapabilityExclusion;
+};
+/**
+ * The narrowed client shape the chat agent receives: only the capability
+ * helpers, with their SDK signatures.
+ */
+type PickPaths<T, P extends string> = {
+    [K in keyof T & string as K extends (P extends `${infer Head}.${string}` ? Head : P) ? K : never]: K extends P ? T[K] : PickPaths<T[K], P extends `${K}.${infer Rest}` ? Rest : never>;
+};
+type ChatAgentClient = PickPaths<ParchmentClient, ChatAgentCapability>;
+
+export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, CHAT_AGENT_CAPABILITIES, CHAT_AGENT_CAPABILITY_EXCLUSIONS, CHAT_AGENT_CONFIRMED_ACTION_TYPES, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogPriceHistoryQuery, type CatalogProofSummary, type CatalogSimilarQuery, type ChatAgentCapability, type ChatAgentCapabilityExclusion, type ChatAgentCapabilityExclusionReason, type ChatAgentClient, type ChatAgentConfirmedActionType, type ConfirmedActionExecuteRequest, type ConversationCanvasUpdateRequest, type ConversationChatStreamRequest, type ConversationMemoryDreamRequest, type ConversationMemoryUpdateRequest, type ConversationMessageAppendRequest, type ConversationSummaryUpdateRequest, type ConversationWorkspaceClearRequest, type ConversationWorkspaceCreateRequest, type ConversationWorkspaceMetadataRequest, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientMethod, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartData, type RoastChartDataQuery, type RoastChartEvent, type RoastChartSeries, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };