@purveyors/sdk 0.48.0 → 0.50.0

package/dist/index.js

@@ -158,6 +158,10 @@ function createParchmentClient(options) {
       /** Find catalog coffees similar to a target coffee. */
       similar: (id, query) => client.GET("/v1/catalog/{id}/similar", {
         params: { path: { id }, query }
+      }),
+      /** Daily price history for one catalog coffee, with minimum-tier change events. */
+      priceHistory: (id, query) => client.GET("/v1/catalog/{id}/price-history", {
+        params: { path: { id }, query }
       })
     },
     priceIndex: {
@@ -595,7 +599,399 @@ function createParchmentClient(options) {
     }
   };
 }
+
+// src/chatAgentCapabilities.ts
+var CHAT_AGENT_CAPABILITIES = [
+  "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"
+];
+var CHAT_AGENT_CONFIRMED_ACTION_TYPES = [
+  "add_bean_to_inventory",
+  "update_bean",
+  "create_roast_session",
+  "create_roast_from_reference",
+  "create_generated_reference",
+  "update_roast_notes",
+  "record_sale"
+];
+var CHAT_AGENT_CAPABILITY_EXCLUSIONS = {
+  health: { reason: "infrastructure", note: "Liveness only." },
+  "apiKeys.list": {
+    reason: "session_only",
+    note: "API key management belongs to the account owner."
+  },
+  "apiKeys.create": {
+    reason: "auth_bootstrap",
+    note: "Issues a raw credential."
+  },
+  "apiKeys.revoke": {
+    reason: "session_only",
+    note: "API key management belongs to the account owner."
+  },
+  "apiKeys.rotate": {
+    reason: "auth_bootstrap",
+    note: "Issues a replacement raw credential."
+  },
+  "apiUsage.get": {
+    reason: "session_only",
+    note: "Developer account analytics, not coffee data."
+  },
+  "emailSubscriptions.get": {
+    reason: "session_only",
+    note: "Email preferences are managed in account settings."
+  },
+  "emailSubscriptions.setMarketRead": {
+    reason: "session_only",
+    note: "Email preferences are managed in account settings."
+  },
+  "emailSubscriptions.unsubscribeMarketRead": {
+    reason: "session_only",
+    note: "Capability-link unsubscribe from email."
+  },
+  "marketBrief.drafts.create": {
+    reason: "admin_only",
+    note: "Market Brief publication pipeline."
+  },
+  "accountDeletion.request": {
+    reason: "session_only",
+    note: "Requires a purpose-bound reauthentication assertion."
+  },
+  "billing.checkout.create": {
+    reason: "session_only",
+    note: "Billing is user-driven checkout."
+  },
+  "billing.checkout.get": {
+    reason: "session_only",
+    note: "Billing is user-driven checkout."
+  },
+  "billing.checkout.reconcile": {
+    reason: "session_only",
+    note: "Billing is user-driven checkout."
+  },
+  "billing.subscriptions.list": {
+    reason: "session_only",
+    note: "Billing state is shown in account settings."
+  },
+  "billing.subscriptions.mutate": {
+    reason: "session_only",
+    note: "Cancel or resume is user-driven."
+  },
+  "billingAdministration.discrepancies": {
+    reason: "admin_only",
+    note: "Staff billing reconciliation."
+  },
+  "billingAdministration.recompute": {
+    reason: "admin_only",
+    note: "Staff billing reconciliation."
+  },
+  "billingAdministration.setManual": {
+    reason: "admin_only",
+    note: "Staff entitlement grants."
+  },
+  "cliAuth.create": { reason: "auth_bootstrap", note: "CLI login flow." },
+  "cliAuth.inspect": { reason: "auth_bootstrap", note: "CLI login flow." },
+  "cliAuth.approve": { reason: "auth_bootstrap", note: "CLI login flow." },
+  "cliAuth.exchange": { reason: "auth_bootstrap", note: "CLI login flow." },
+  "catalog.access": {
+    reason: "read_not_wired",
+    note: "Catalog visibility metadata; the agent reads `me` instead."
+  },
+  "catalog.map": {
+    reason: "read_not_wired",
+    note: "Map clusters and geometry for the web map view."
+  },
+  "catalog.originPriceStats": {
+    reason: "read_not_wired",
+    note: "Covered for the agent by market.overview origin price distribution."
+  },
+  "catalog.stats": {
+    reason: "read_not_wired",
+    note: "No chat tool yet."
+  },
+  "catalog.rankPremium": {
+    reason: "read_not_wired",
+    note: "The agent ranks through catalog.rank objectives."
+  },
+  "catalog.supplierDetail": {
+    reason: "read_not_wired",
+    note: "The agent reads supplier aggregates through catalog.suppliers."
+  },
+  "catalog.supplierRank": {
+    reason: "read_not_wired",
+    note: "The agent reads supplier aggregates through catalog.suppliers."
+  },
+  "catalog.proofCoverage": {
+    reason: "read_not_wired",
+    note: "No chat tool yet."
+  },
+  "catalog.priceHistory": {
+    reason: "read_not_wired",
+    note: "Per-lot daily price history for the coffee detail chart; no chat tool yet."
+  },
+  "procurement.briefs.list": {
+    reason: "read_not_wired",
+    note: "Active briefs reach the agent as prompt context, not a tool."
+  },
+  "procurement.briefs.create": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action exists for sourcing briefs."
+  },
+  "procurement.briefs.get": {
+    reason: "read_not_wired",
+    note: "Active briefs reach the agent as prompt context, not a tool."
+  },
+  "procurement.briefs.matches": {
+    reason: "read_not_wired",
+    note: "No chat tool yet."
+  },
+  "portfolio.trackedLots.list": {
+    reason: "read_not_wired",
+    note: "Tracked lots reach the agent as prompt context, not a tool."
+  },
+  "portfolio.trackedLots.track": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action exists for tracked lots."
+  },
+  "portfolio.trackedLots.untrack": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action exists for tracked lots."
+  },
+  "confirmedActions.execute": {
+    reason: "session_only",
+    note: "Runs only after the user confirms an agent-proposed action card."
+  },
+  "conversation.chat.stream": {
+    reason: "session_only",
+    note: "The agent's own transport."
+  },
+  "conversation.workspaces.getOrCreate": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.get": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.update": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.messages.history": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.messages.append": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.messages.clear": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.updateCanvas": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.getCompactionInputs": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.updateSummary": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.workspaces.compactSummary": {
+    reason: "session_only",
+    note: "Conversation persistence owned by the chat client."
+  },
+  "conversation.memory.get": {
+    reason: "session_only",
+    note: "Memory reaches the agent as prompt context."
+  },
+  "conversation.memory.update": {
+    reason: "session_only",
+    note: "Memory is edited by the user or the memory pipeline."
+  },
+  "conversation.memory.dream": {
+    reason: "session_only",
+    note: "Memory is edited by the user or the memory pipeline."
+  },
+  "inventory.shareGrants.create": {
+    reason: "write_not_agent_facing",
+    note: "Mints a cross-user capability token."
+  },
+  "inventory.shareGrants.redeem": {
+    reason: "write_not_agent_facing",
+    note: "Redeems a cross-user capability token."
+  },
+  "inventory.create": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action add_bean_to_inventory."
+  },
+  "inventory.createManualBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk import; no confirmed action."
+  },
+  "inventory.getManualBatch": {
+    reason: "read_not_wired",
+    note: "Bulk-import recovery read."
+  },
+  "inventory.reserveManualBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk import; no confirmed action."
+  },
+  "inventory.commitManualBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk import; no confirmed action."
+  },
+  "inventory.getManualBatchStatus": {
+    reason: "read_not_wired",
+    note: "Bulk-import recovery read."
+  },
+  "inventory.reserveCatalogBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk import; no confirmed action."
+  },
+  "inventory.commitCatalogBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk import; no confirmed action."
+  },
+  "inventory.getCatalogBatchStatus": {
+    reason: "read_not_wired",
+    note: "Bulk-import recovery read."
+  },
+  "inventory.update": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action update_bean."
+  },
+  "inventory.delete": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "roasts.classify": {
+    reason: "read_not_wired",
+    note: "Artisan import matching helper for upload flows."
+  },
+  "roasts.create": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action create_roast_session."
+  },
+  "roasts.createBatch": {
+    reason: "write_not_agent_facing",
+    note: "Bulk roast creation; no confirmed action."
+  },
+  "roasts.update": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action update_roast_notes (notes and targets only)."
+  },
+  "roasts.delete": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "roasts.deleteBatch": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "roasts.replaceLiveCurve": {
+    reason: "write_not_agent_facing",
+    note: "Live roast logging client only."
+  },
+  "roasts.import": {
+    reason: "write_not_agent_facing",
+    note: "Artisan file upload; saved references import through confirmed action create_roast_from_reference."
+  },
+  "roasts.replaceArtisanImport": {
+    reason: "write_not_agent_facing",
+    note: "Artisan file upload."
+  },
+  "roasts.clearArtisanImport": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "referenceProfiles.generate": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action create_generated_reference."
+  },
+  "referenceProfiles.exportGenerated": {
+    reason: "read_not_wired",
+    note: "File export for Artisan, not a chat read."
+  },
+  "referenceProfiles.import": {
+    reason: "write_not_agent_facing",
+    note: "Artisan file upload."
+  },
+  "referenceProfiles.fromRoast": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  },
+  "referenceProfiles.update": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  },
+  "referenceProfiles.delete": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "referenceProfiles.linkRoast": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  },
+  "referenceProfiles.unlinkRoast": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  },
+  "sales.list": {
+    reason: "read_not_wired",
+    note: "No chat tool yet."
+  },
+  "sales.create": {
+    reason: "confirmed_action_write",
+    note: "Confirmed action record_sale."
+  },
+  "sales.update": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  },
+  "sales.delete": {
+    reason: "write_not_agent_facing",
+    note: "Destructive; no confirmed action."
+  },
+  "profit.list": {
+    reason: "read_not_wired",
+    note: "No chat tool yet."
+  },
+  "tasting.rate": {
+    reason: "write_not_agent_facing",
+    note: "No confirmed action."
+  }
+};
 export {
+  CHAT_AGENT_CAPABILITIES,
+  CHAT_AGENT_CAPABILITY_EXCLUSIONS,
+  CHAT_AGENT_CONFIRMED_ACTION_TYPES,
   createParchmentClient
 };
 //# sourceMappingURL=index.js.map