@nautical-commerce/graphql-schema 3.21.0 → 3.23.0

package/nautical/schema.graphql

@@ -1483,6 +1483,23 @@ type Attribute implements Node & ObjectWithMetadata {
   """Position in storefront search"""
   storefrontSearchPosition: Int!
 
+  """
+  Database-level audit trail for this attribute (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): AttributeAuditEventCountableConnection!
+
   """Filterable in dashboard"""
   filterableInDashboard: Boolean!
 
@@ -1556,6 +1573,64 @@ input AttributeAssignInput {
   type: AttributeTypeEnum!
 }
 
+type AttributeAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'attribute_created', 'attribute_updated', or 'attribute_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+  inputType: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type AttributeAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [AttributeAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type AttributeAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: AttributeAuditEvent!
+}
+
 """Result of attribute bulk delete mutation."""
 type AttributeBulkDelete {
   """Number of attributes deleted."""
@@ -2751,6 +2826,23 @@ type Category implements Node & ObjectWithMetadata {
   allowProductAssignment: Boolean!
   level: Int!
 
+  """
+  Database-level audit trail for this category (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): CategoryAuditEventCountableConnection!
+
   """Background image for the category"""
   backgroundImage(size: Int = null): Image
 
@@ -2814,6 +2906,63 @@ type Category implements Node & ObjectWithMetadata {
   ): ProductCountableConnection!
 }
 
+type CategoryAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'category_created', 'category_updated', or 'category_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type CategoryAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [CategoryAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type CategoryAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: CategoryAuditEvent!
+}
+
 """Result of category bulk delete mutation."""
 type CategoryBulkDelete {
   """Number of categories deleted."""
@@ -3630,6 +3779,23 @@ type Collection implements Node & ObjectWithMetadata {
   """Whether the collection is visible"""
   isVisible: Boolean!
 
+  """
+  Database-level audit trail for this collection (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): CollectionAuditEventCountableConnection!
+
   """Whether the collection is published"""
   isPublished: Boolean!
 
@@ -3706,6 +3872,62 @@ type CollectionAddVariants {
   productErrors: [ProductError!]!
 }
 
+type CollectionAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'collection_created', '..._updated', or '..._deleted'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+  isVisible: Boolean!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type CollectionAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [CollectionAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type CollectionAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: CollectionAuditEvent!
+}
+
 """Result of collection bulk delete mutation."""
 type CollectionBulkDelete {
   """Number of collections deleted."""
@@ -5184,6 +5406,23 @@ type DigitalContent implements Node & ObjectWithMetadata {
   """Number of days the download URL is valid"""
   urlValidDays: Int
 
+  """
+  Database-level audit trail for this digital content (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): DigitalContentAuditEventCountableConnection!
+
   """The product variant associated with this digital content."""
   productVariant: ProductVariant!
 
@@ -5197,6 +5436,61 @@ type DigitalContent implements Node & ObjectWithMetadata {
   urls: [DigitalContentUrl!]!
 }
 
+type DigitalContentAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'digital_content_created', '..._updated', or '..._deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type DigitalContentAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [DigitalContentAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type DigitalContentAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: DigitalContentAuditEvent!
+}
+
 """A connection to a list of items."""
 type DigitalContentCountableConnection {
   """Pagination data for this connection"""
@@ -5288,6 +5582,23 @@ type DigitalContentUrl implements Node {
   """When the URL was created"""
   created: DateTime!
 
+  """
+  Database-level audit trail for this download URL. Tracks creation and deletion only (download-counter bumps are not audited). Requires MANAGE_PRODUCTS.
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): DigitalContentUrlAuditEventCountableConnection!
+
   """Number of times this URL has been used for downloads."""
   downloadNum: Int!
 
@@ -5298,6 +5609,62 @@ type DigitalContentUrl implements Node {
   content: DigitalContent
 }
 
+type DigitalContentUrlAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'digital_content_url_created' or 'digital_content_url_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  downloadNum: Int!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type DigitalContentUrlAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [DigitalContentUrlAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type DigitalContentUrlAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: DigitalContentUrlAuditEvent!
+}
+
 """Result of digital content URL create mutation."""
 type DigitalContentUrlCreate {
   """The created digital content URL."""
@@ -6943,6 +7310,7 @@ input ImportProductsInput {
   fieldMappings: JSONString!
   defaultProductTypeId: ID = null
   defaultCategoryId: ID = null
+  defaultWarehouseId: ID = null
   batchSize: Int = 100
 }
 
@@ -7568,6 +7936,63 @@ enum LengthUnitsStrEnum {
   M
 }
 
+"""Per-tenant configuration for the hosted MCP surface."""
+type MCPConfiguration {
+  """The ID of the object."""
+  id: ID!
+
+  """
+  When true, the tenant opts IN to the public shopping-agent surface (OAuth-scoped, read-only buyer view) on mcp.thetraide.com/{tenant_slug}/mcp.
+  """
+  shoppingEnabled: Boolean!
+
+  """
+  When true, the authenticated operator MCP surface is exposed for this tenant.
+  """
+  operatorEnabled: Boolean!
+
+  """When true, seller identity is included in agent-visible product data."""
+  sellerIdentityExposed: Boolean!
+
+  """
+  Per-agent request budget per minute. Overrides the mcp-server ADR-0009 default.
+  """
+  rateLimitPerAgent: Int!
+
+  """
+  Optional MCP protocol version pin. Null means the server default is used.
+  """
+  protocolVersionPin: String
+
+  """
+  Allowlist of pre-registered OAuth client ids (empty = open dynamic registration).
+  """
+  shoppingOauthClients: [String!]!
+
+  """Allowlist of product attribute slugs exposed to shopping agents."""
+  exposedAttributes: [String!]!
+}
+
+"""Input for updating the hosted MCP configuration for a tenant."""
+input MCPConfigurationInput {
+  shoppingEnabled: Boolean
+  shoppingOauthClients: [String!]
+  operatorEnabled: Boolean
+  exposedAttributes: [String!]
+  sellerIdentityExposed: Boolean
+  rateLimitPerAgent: Int
+  protocolVersionPin: String
+}
+
+"""Result of mcpConfigurationUpdate mutation."""
+type MCPConfigurationUpdate {
+  """The updated MCP configuration."""
+  mcpConfiguration: MCPConfiguration
+
+  """List of errors that occurred executing the mutation."""
+  mcpConfigurationErrors: [TenantError!]!
+}
+
 """Product or variant margin range"""
 type Margin {
   """Minimum margin percentage."""
@@ -9880,6 +10305,11 @@ type Mutation {
   """Update tenant onboarding steps."""
   tenantOnboardingUpdate(input: TenantOnboardingUpdateInput!): TenantOnboardingUpdate!
 
+  """
+  Update the hosted MCP configuration for the current tenant. Requires MANAGE_MARKETPLACE_CONFIGURATION permission.
+  """
+  mcpConfigurationUpdate(input: MCPConfigurationInput!): MCPConfigurationUpdate!
+
   """Upload and attach a document to an entity."""
   documentAdd(file: Upload!, relatedObjectId: ID!, description: String = null): DocumentAdd!
 
@@ -10330,6 +10760,11 @@ type NauticalOrder implements Node & ObjectWithMetadata {
     last: Int = null
   ): NauticalOrderAuditEventCountableConnection!
 
+  """
+  Unified change-history feed for this marketplace order. Combines pghistory events from NauticalOrder (status, totals, customer) and NauticalOrderLine (line additions/updates/removals) into a single TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Agreement and seller-Order timeline pattern. Optional `kinds` filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """List of seller orders in this marketplace order"""
   subOrders: [Order!]
 
@@ -13833,6 +14268,28 @@ type Product implements Node & ObjectWithMetadata {
   """Date when the product becomes available for purchase"""
   availableForPurchase: Date
 
+  """
+  Database-level audit trail for this product (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): ProductAuditEventCountableConnection!
+
+  """
+  Unified change-history feed for this product. Projects pghistory ProductEvent (the product) + ProductVariantEvent (its variants) rows into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Seller and Order timeline pattern. Requires MANAGE_PRODUCTS. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Sort order of the product"""
   sortOrder: Int
 
@@ -13995,10 +14452,67 @@ type Product implements Node & ObjectWithMetadata {
   recommendedProducts(limit: Int! = 6): [Product!]!
 }
 
-"""Available actions for a product"""
-enum ProductAction {
-  DECLINED
-  APPROVED
+"""Available actions for a product"""
+enum ProductAction {
+  DECLINED
+  APPROVED
+}
+
+type ProductAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'product_created', 'product_updated', or 'product_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  status: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductAuditEvent!
 }
 
 """Result of product bulk category update mutation."""
@@ -14481,10 +14995,80 @@ type ProductImage implements Node {
   """External system source"""
   externalSource: String
 
+  """
+  Database-level audit trail for this product image (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): ProductImageAuditEventCountableConnection!
+
   """The URL of the image"""
   url(size: Int = null): String!
 }
 
+type ProductImageAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_image_added', '..._updated', or '..._removed'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductImageAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductImageAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductImageAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductImageAuditEvent!
+}
+
 """Result of product image bulk create mutation."""
 type ProductImageBulkCreate {
   """The product with the new images."""
@@ -14926,6 +15510,23 @@ type ProductType implements Node & ObjectWithMetadata {
   """
   externallyManaged: Boolean!
 
+  """
+  Database-level audit trail for this product type (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): ProductTypeAuditEventCountableConnection!
+
   """Legacy indicator, always true"""
   hasVariants: Boolean!
 
@@ -14986,6 +15587,61 @@ type ProductType implements Node & ObjectWithMetadata {
   ): AttributeCountableConnection!
 }
 
+type ProductTypeAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_type_created', '..._updated', or '..._deleted'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  name: String!
+  slug: String!
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductTypeAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductTypeAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductTypeAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductTypeAuditEvent!
+}
+
 """Result of product type bulk delete mutation."""
 type ProductTypeBulkDelete {
   """Number of product types deleted."""
@@ -15204,6 +15860,28 @@ type ProductVariant implements Node & ObjectWithMetadata {
   """Whether backorders are allowed"""
   allowBackorders: Boolean
 
+  """
+  Database-level audit trail for this variant (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): ProductVariantAuditEventCountableConnection!
+
+  """
+  Unified change-history feed for this variant. Projects pghistory ProductVariantEvent rows (SKU, price, status, inventory changes) into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events page and mirrors the Seller and Order timeline pattern. Requires MANAGE_PRODUCTS. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Status of the variant"""
   status: ProductVariantStatus!
 
@@ -15313,6 +15991,62 @@ type ProductVariant implements Node & ObjectWithMetadata {
   ): ShopifyWebhookTransactionCountableConnection!
 }
 
+type ProductVariantAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """
+  Event label: 'variant_created', 'variant_updated', or 'variant_deleted'.
+  """
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+  sku: String
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductVariantAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductVariantAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductVariantAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductVariantAuditEvent!
+}
+
 """Result of product variant bulk create mutation."""
 type ProductVariantBulkCreate {
   """Number of variants created."""
@@ -15835,10 +16569,80 @@ type ProductVideo implements Node {
   """External system source"""
   externalSource: String
 
+  """
+  Database-level audit trail for this product video (requires MANAGE_PRODUCTS).
+  """
+  auditEvents(
+    """Returns the items in the list that come before the specified cursor."""
+    before: String = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    after: String = null
+
+    """Returns the first n items from the list."""
+    first: Int = null
+
+    """Returns the items in the list that come after the specified cursor."""
+    last: Int = null
+  ): ProductVideoAuditEventCountableConnection!
+
   """The URL of the video"""
   url: String!
 }
 
+type ProductVideoAuditEvent implements Node {
+  """The Globally Unique ID of this object"""
+  id: ID!
+  pghCreatedAt: DateTime!
+
+  """Event label: 'product_video_added', '..._updated', or '..._removed'."""
+  pghLabel: String!
+  pghContextId: NauticalUUID
+  pghContext: JSONString
+
+  """Email of the user who made the change."""
+  userEmail: String
+
+  """Global ID of the user who made the change."""
+  userId: String
+
+  """Tenant ID where the change occurred."""
+  tenantId: Int
+
+  """Tenant slug where the change occurred."""
+  tenantSlug: String
+
+  """App name if the change was via an API token."""
+  appName: String
+
+  """Global ID of the app if via an API token."""
+  appId: String
+
+  """Celery task name if the change was async."""
+  taskName: String
+}
+
+"""A connection to a list of items."""
+type ProductVideoAuditEventCountableConnection {
+  """Pagination data for this connection"""
+  pageInfo: PageInfo!
+
+  """Contains the nodes in this connection"""
+  edges: [ProductVideoAuditEventCountableEdge!]!
+
+  """Total quantity of existing nodes."""
+  totalCount: Int!
+}
+
+"""An edge in a connection."""
+type ProductVideoAuditEventCountableEdge {
+  """A cursor for use in pagination"""
+  cursor: String!
+
+  """The item at the end of the edge"""
+  node: ProductVideoAuditEvent!
+}
+
 """Result of product video bulk create mutation."""
 type ProductVideoBulkCreate {
   """The product with the new videos."""
@@ -16937,6 +17741,11 @@ type Query {
   """List of available tax types."""
   taxTypes: [TaxType!]!
 
+  """
+  Return the hosted MCP configuration for the current tenant, or null if the tenant has not been configured. A null result means everything is off (fail-closed defaults).
+  """
+  mcpConfiguration: MCPConfiguration
+
   """Look up a plugin by ID. Requires MANAGE_PLUGINS permission."""
   plugin(id: ID!, seller: ID = null): Plugin
 
@@ -18517,6 +19326,11 @@ type Seller implements Node & ObjectWithMetadata {
     last: Int = null
   ): SellerAuditEventCountableConnection!
 
+  """
+  Unified change-history feed for this seller. Projects pghistory SellerAuditEvent rows (status transitions, profile edits, payout-config changes) into a TimelineEntry list ordered most-recent-first. Powers the dashboard Events tab and mirrors the Agreement and Order timeline pattern. Optional `kinds` argument filters server-side.
+  """
+  timeline(kinds: [TimelineEntryKind!] = null): [TimelineEntry!]!
+
   """Orders for this seller"""
   orders(
     """Returns the items in the list that come before the specified cursor."""
@@ -20850,6 +21664,9 @@ type Tenant implements Node {
 
   """Marketplace configuration for the tenant"""
   marketplaceConfiguration: MarketplaceConfiguration
+
+  """Hosted MCP configuration for the tenant"""
+  mcpConfiguration: MCPConfiguration
 }
 
 """A connection to a list of items."""
@@ -21055,6 +21872,11 @@ enum TimelineEntryKind {
   ORDER
   ORDER_LINE
   FULFILLMENT
+  SELLER
+  NAUTICAL_ORDER
+  NAUTICAL_ORDER_LINE
+  PRODUCT
+  PRODUCT_VARIANT
 }
 
 type TimelineTarget {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nautical-commerce/graphql-schema",
-  "version": "3.21.0",
+  "version": "3.23.0",
   "description": "Traide API GraphQL Schema",
   "main": "./nautical/schema.graphql",
   "scripts": {