ultracart_api 4.1.146 → 4.1.148

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '036368fdee38b26ea356d002fd6d655ea9f4759ed13b01d66fd7b99737452573'
-  data.tar.gz: e5ee50e86b0e48f43fe29c513f6d90f0fc8c0de9d2b97f46ca3686a90cf46a2c
+  metadata.gz: ba4977a62acb33c11fa5fc16903ffa679e996f053ca6c5920f6d2f8c450c6cce
+  data.tar.gz: f8805e823b86f7ae7b56b86e2ab8dd52aec339076104437c81cfed9610dab404
 SHA512:
-  metadata.gz: 35da706c21aea107d4af2816c082c18c9dcf0198fc776d6b8a2318cbdcb9ec849b5440fd9b8e284680e58c814ded1754288b4234eef3323f9786512097d06723
-  data.tar.gz: 34ac9ffd5893e93a84f325120c40e03a5e2e0a64fd2195cae5af3aabfb353b21af54c2c9f73e4d906d5af361822f35482e6971f0c041c3889a51d5be20f3b91a
+  metadata.gz: 5c2d29199eb34ebb2d86c3071c7c185ffaf2f077f8206be73906468424bd21406c26615c26daec6a3e443022dabb5b1fd66cb5a01a2a5b069171d6439af75702
+  data.tar.gz: d51e2f0a95eea2719be0767245cb3a203dbf13b79f2627169165c317f91e9e134a948b4dcee4c70d00319f4b165a0200270b64857bb2955334f964e31999e442

data/README.md

@@ -7,7 +7,7 @@ Note: Every method has a sample for every language.  See https://github.com/Ultr
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 2.0.0
-- Package version: 4.1.146
+- Package version: 4.1.148
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 gemfile:
 
 ```shell
-gem 'ultracart_api', '4.1.146'
+gem 'ultracart_api', '4.1.148'
 ```
 
 install:
@@ -1084,6 +1084,7 @@ Class | Method | HTTP request | Description
  - [UltracartClient::ConversationVirtualAgentBudgetResponse](docs/ConversationVirtualAgentBudgetResponse.md)
  - [UltracartClient::ConversationVirtualAgentCapabilities](docs/ConversationVirtualAgentCapabilities.md)
  - [UltracartClient::ConversationVirtualAgentCapabilitiesResponse](docs/ConversationVirtualAgentCapabilitiesResponse.md)
+ - [UltracartClient::ConversationVirtualAgentCapabilityCustomCollection](docs/ConversationVirtualAgentCapabilityCustomCollection.md)
  - [UltracartClient::ConversationVirtualAgentCapabilityZohoDeskDepartment](docs/ConversationVirtualAgentCapabilityZohoDeskDepartment.md)
  - [UltracartClient::ConversationWebchatContext](docs/ConversationWebchatContext.md)
  - [UltracartClient::ConversationWebchatQueueStatus](docs/ConversationWebchatQueueStatus.md)
@@ -1927,6 +1928,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.148 | 09/04/2026 | conversations - added ai agent capabilities |
+| 4.1.147 | 09/04/2026 | sfvb - internal testing |
 | 4.1.146 | 09/03/2026 | sfvb - internal testing |
 | 4.1.145 | 09/02/2026 | sfvb - internal testing |
 | 4.1.144 | 09/02/2026 | sfvb - internal testing |

data/docs/ConversationVirtualAgentCapabilities.md

@@ -4,8 +4,11 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **access_custom_collections** | **Boolean** | Permission flag to allow this Agent to search the merchant's custom Typesense collections. | [optional] |
 | **access_storefront_and_item** | **Boolean** | Permission flag to allow this Agent access to the storefront and item information. | [optional] |
 | **cancel_subscription** | **Boolean** |  | [optional] |
+| **custom_collection_oids** | **Object** | The custom collections this Agent is allowed to search.  Empty means none, even when access_custom_collections is true. | [optional] |
+| **custom_collections** | [**Array<ConversationVirtualAgentCapabilityCustomCollection>**](ConversationVirtualAgentCapabilityCustomCollection.md) | Read only.  All of the merchant's custom collections, to populate the selection list for custom_collection_oids.  Changes here are ignored. | [optional] |
 | **delay_subscription** | **Boolean** |  | [optional] |
 | **generate_coupon** | **Boolean** | Permission flag to allow this Agent to generate coupons based upon the agent prompt instructions | [optional] |
 | **lookup_order_information** | **Boolean** |  | [optional] |
@@ -27,8 +30,11 @@
 require 'ultracart_api'
 
 instance = UltracartClient::ConversationVirtualAgentCapabilities.new(
+  access_custom_collections: null,
   access_storefront_and_item: null,
   cancel_subscription: null,
+  custom_collection_oids: null,
+  custom_collections: null,
   delay_subscription: null,
   generate_coupon: null,
   lookup_order_information: null,

data/docs/ConversationVirtualAgentCapabilityCustomCollection.md

@@ -0,0 +1,30 @@
+# UltracartClient::ConversationVirtualAgentCapabilityCustomCollection
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **ai_description** | **String** | Merchant authored description of what is in this collection, which is what the agent sees when deciding whether to search it | [optional] |
+| **ai_enabled** | **Boolean** | True if this collection has been enabled for AI access in its own configuration.  A collection that is not enabled cannot be searched even if it is selected here. | [optional] |
+| **collection_name** | **String** | Merchant assigned name of the collection | [optional] |
+| **error_message** | **String** | Error from the last build, if it failed.  A collection with an error will return nothing to the agent, so this is worth surfacing next to the selection. | [optional] |
+| **last_update_dts** | **String** | Date/time the collection was last rebuilt from the merchant's BigQuery query | [optional] |
+| **record_count** | **Integer** | Number of records loaded on the last build | [optional] |
+| **typesense_custom_collection_oid** | **Integer** | The identifier to place in custom_collection_oids to grant the agent access to this collection | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::ConversationVirtualAgentCapabilityCustomCollection.new(
+  ai_description: null,
+  ai_enabled: null,
+  collection_name: null,
+  error_message: null,
+  last_update_dts: null,
+  record_count: null,
+  typesense_custom_collection_oid: null
+)
+```
+

data/docs/SfvbApi.md

@@ -103,7 +103,7 @@ end
 
 Create a preview session
 
-Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
 
 
 ### Examples
@@ -1554,7 +1554,7 @@ end
 
 Push containers into a preview session
 
-Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
 
 
 ### Examples

data/docs/SfvbContainerResponse.md

@@ -7,7 +7,7 @@
 | **cjson** | **String** | The container JSON.  Runtime state is stripped on the way out. | [optional] |
 | **container_name** | **String** | Container name. | [optional] |
 | **hash_sha256** | **String** | SHA-256 of the cjson.  Send back as If-Match when writing. | [optional] |
-| **last_modified** | **String** | When the container was last modified, in the store's own record of it.  Present for email, postcardfront and postcardback.  Absent for upsell and item, because those tables carry no modification timestamp at all - for those two, read created_dts on the current entry of container_versions, which records when this API last wrote the container.  Note that a postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports. | [optional] |
+| **last_modified** | **String** | When the container was last modified, in the store's own record of it.  Every owner type reports this.  It is absent only when the container has never been written since the store began recording it, so treat an absent value as unknown rather than as never modified.  Two behaviours worth knowing.  A postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.  An upsell container that is rewritten with byte identical content keeps its original date rather than moving to now, because the timestamp tracks changes to the container and not writes to the offer. | [optional] |
 | **owner_object_id** | **String** | Identifier of the owning object within its store. | [optional] |
 | **owner_type** | **String** | Where this container lives. | [optional] |
 

data/docs/SfvbThemeDuplicateRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **folder** | **String** | Directory name for the new theme under /themes/.  Letters and numbers; it is cleansed before use.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made. | [optional] |
+| **folder** | **String** | Directory name for the new theme under /themes/.  Letters and numbers, one path segment.  Used verbatim - anything that is not already a valid directory name is refused rather than adjusted, because this call does not return the new theme's oid and you find your copy by matching the target_path you asked for.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made. | [optional] |
 | **target_storefront_oid** | **Integer** | Storefront to create the copy on.  Defaults to the storefront in the path.  Supply it only when copying a theme between storefronts you own. | [optional] |
 | **theme_name** | **String** | Name for the new theme. | [optional] |
 

data/docs/SfvbThemeJobResponse.md

@@ -15,7 +15,7 @@
 | **status** | **String** | Raw job status. | [optional] |
 | **submitted_dts** | **String** | When the job was queued. | [optional] |
 | **success** | **Boolean** | True only when the job finished successfully.  Check complete first. | [optional] |
-| **target_path** | **String** | Path the new theme was created at.  Returned when the job is started; the theme oid itself is NOT returned, because the job's product is a plain text report rather than a structured result.  Once the job completes, list themes and match on this path. | [optional] |
+| **target_path** | **String** | Path the new theme is being created at.  Returned when the job is started and on every poll, so you do not have to keep the response that started it.  The theme oid itself is NOT returned, so once the job completes you list themes and match on this path.  It is also what success is checked against - a finished job whose theme is not here reports success false rather than pretending. | [optional] |
 
 ## Example
 

data/docs/SfvbVersionResponse.md

@@ -7,10 +7,16 @@
 | **container_manager_version** | **String** | Container manager version used to compile for this merchant. | [optional] |
 | **container_versions_retained** | **Integer** | Versions kept per non-file container before the oldest are pruned.  Beyond this, history is gone - not merely paginated. | [optional] |
 | **element_count** | **Integer** | Number of element types this version recognizes. | [optional] |
+| **max_asset_bytes** | **Integer** | Largest binary asset that can be uploaded, in bytes, for every accepted type except video. | [optional] |
 | **max_cjson_bytes** | **Integer** | Largest CJSON document that will be parsed, in bytes. | [optional] |
+| **max_directory_entries** | **Integer** | Most entries one directory listing returns.  Asking for more is silently reduced to this rather than refused, so compare against it instead of trusting that you got what you asked for.  The listing does set a truncated flag when it drops entries. | [optional] |
+| **max_library_results_per_page** | **Integer** | Most element library results one page returns.  Asking for more is silently reduced to this, and unlike the directory listing there is no truncation flag on the response, so this number is the only way to know a larger request was cut. | [optional] |
 | **max_preview_session_bytes** | **Integer** | Largest payload one preview session may hold, in bytes. | [optional] |
+| **max_revertable_bytes** | **Integer** | Largest historical version files/revert will restore, in bytes.  Higher than max_text_read_bytes deliberately - putting back a version that is already stored is cheaper than serving it as JSON, so a version too large to read can still be reverted to. | [optional] |
 | **max_search_results** | **Integer** | Hard ceiling on file search results per page. | [optional] |
-| **max_template_bytes** | **Integer** | Largest template file that can be written, in bytes. | [optional] |
+| **max_template_bytes** | **Integer** | Largest .vm template that can be written, in bytes.  Narrow on purpose - it gates writes, only for files ending in .vm, and it is not the ceiling on reading a file back.  Use max_text_read_bytes for that. | [optional] |
+| **max_text_read_bytes** | **Integer** | Largest file files/content will return as text, in bytes.  A file above this is refused with sfvb.too_large however small its history versions are.  Bigger than max_template_bytes, so a file can be readable here and still be too large to write back as a template.  Anything above this is still readable in full through files/download, which returns raw bytes and applies no ceiling. | [optional] |
+| **max_video_bytes** | **Integer** | Largest video that can be uploaded, in bytes.  Video is the one type allowed past max_asset_bytes. | [optional] |
 | **max_widget_ids_per_request** | **Integer** | Most widget ids that can be reserved in one call. | [optional] |
 | **preview_session_ttl_seconds** | **Integer** | Seconds a preview session survives before expiring. | [optional] |
 | **release** | **String** | Release channel selected for this merchant. | [optional] |
@@ -24,10 +30,16 @@ instance = UltracartClient::SfvbVersionResponse.new(
   container_manager_version: null,
   container_versions_retained: null,
   element_count: null,
+  max_asset_bytes: null,
   max_cjson_bytes: null,
+  max_directory_entries: null,
+  max_library_results_per_page: null,
   max_preview_session_bytes: null,
+  max_revertable_bytes: null,
   max_search_results: null,
   max_template_bytes: null,
+  max_text_read_bytes: null,
+  max_video_bytes: null,
   max_widget_ids_per_request: null,
   preview_session_ttl_seconds: null,
   release: null

data/lib/ultracart_api/api/sfvb_api.rb

@@ -102,7 +102,7 @@ module UltracartClient
     end
 
     # Create a preview session
-    # Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @return [SfvbPreviewSessionResponse]
@@ -112,7 +112,7 @@ module UltracartClient
     end
 
     # Create a preview session
-    # Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor's habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
     # @param storefront_oid [Integer] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(SfvbPreviewSessionResponse, Integer, Hash)>] SfvbPreviewSessionResponse data, response status code and response headers
@@ -1990,7 +1990,7 @@ module UltracartClient
     end
 
     # Push containers into a preview session
-    # Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
     # @param storefront_oid [Integer] 
     # @param preview_session_id [String] 
     # @param preview_session [SfvbPreviewSessionRequest] Containers to stage in the preview session
@@ -2003,7 +2003,7 @@ module UltracartClient
     end
 
     # Push containers into a preview session
-    # Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+    # Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
     # @param storefront_oid [Integer] 
     # @param preview_session_id [String] 
     # @param preview_session [SfvbPreviewSessionRequest] Containers to stage in the preview session

data/lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb

@@ -15,11 +15,20 @@ require 'time'
 
 module UltracartClient
   class ConversationVirtualAgentCapabilities
+    # Permission flag to allow this Agent to search the merchant's custom Typesense collections.
+    attr_accessor :access_custom_collections
+
     # Permission flag to allow this Agent access to the storefront and item information.
     attr_accessor :access_storefront_and_item
 
     attr_accessor :cancel_subscription
 
+    # The custom collections this Agent is allowed to search.  Empty means none, even when access_custom_collections is true.
+    attr_accessor :custom_collection_oids
+
+    # Read only.  All of the merchant's custom collections, to populate the selection list for custom_collection_oids.  Changes here are ignored.
+    attr_accessor :custom_collections
+
     attr_accessor :delay_subscription
 
     # Permission flag to allow this Agent to generate coupons based upon the agent prompt instructions
@@ -79,8 +88,11 @@ module UltracartClient
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'access_custom_collections' => :'access_custom_collections',
         :'access_storefront_and_item' => :'access_storefront_and_item',
         :'cancel_subscription' => :'cancel_subscription',
+        :'custom_collection_oids' => :'custom_collection_oids',
+        :'custom_collections' => :'custom_collections',
         :'delay_subscription' => :'delay_subscription',
         :'generate_coupon' => :'generate_coupon',
         :'lookup_order_information' => :'lookup_order_information',
@@ -106,8 +118,11 @@ module UltracartClient
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'access_custom_collections' => :'Boolean',
         :'access_storefront_and_item' => :'Boolean',
         :'cancel_subscription' => :'Boolean',
+        :'custom_collection_oids' => :'Object',
+        :'custom_collections' => :'Array<ConversationVirtualAgentCapabilityCustomCollection>',
         :'delay_subscription' => :'Boolean',
         :'generate_coupon' => :'Boolean',
         :'lookup_order_information' => :'Boolean',
@@ -146,6 +161,10 @@ module UltracartClient
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'access_custom_collections')
+        self.access_custom_collections = attributes[:'access_custom_collections']
+      end
+
       if attributes.key?(:'access_storefront_and_item')
         self.access_storefront_and_item = attributes[:'access_storefront_and_item']
       end
@@ -154,6 +173,16 @@ module UltracartClient
         self.cancel_subscription = attributes[:'cancel_subscription']
       end
 
+      if attributes.key?(:'custom_collection_oids')
+        self.custom_collection_oids = attributes[:'custom_collection_oids']
+      end
+
+      if attributes.key?(:'custom_collections')
+        if (value = attributes[:'custom_collections']).is_a?(Array)
+          self.custom_collections = value
+        end
+      end
+
       if attributes.key?(:'delay_subscription')
         self.delay_subscription = attributes[:'delay_subscription']
       end
@@ -243,8 +272,11 @@ module UltracartClient
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          access_custom_collections == o.access_custom_collections &&
           access_storefront_and_item == o.access_storefront_and_item &&
           cancel_subscription == o.cancel_subscription &&
+          custom_collection_oids == o.custom_collection_oids &&
+          custom_collections == o.custom_collections &&
           delay_subscription == o.delay_subscription &&
           generate_coupon == o.generate_coupon &&
           lookup_order_information == o.lookup_order_information &&
@@ -270,7 +302,7 @@ module UltracartClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [access_storefront_and_item, cancel_subscription, delay_subscription, generate_coupon, lookup_order_information, lookup_subscription_information, open_support_ticket, open_support_ticket_channel, open_support_ticket_channel_email, open_support_ticket_zoho_desk_department_id, pause_subscription, resume_subscription, transfer_chat_to_live_agent, update_subscription_credit_card, zoho_desk_available, zoho_desk_departments].hash
+      [access_custom_collections, access_storefront_and_item, cancel_subscription, custom_collection_oids, custom_collections, delay_subscription, generate_coupon, lookup_order_information, lookup_subscription_information, open_support_ticket, open_support_ticket_channel, open_support_ticket_channel_email, open_support_ticket_zoho_desk_department_id, pause_subscription, resume_subscription, transfer_chat_to_live_agent, update_subscription_credit_card, zoho_desk_available, zoho_desk_departments].hash
     end
 
     # Builds the object from hash

data/lib/ultracart_api/models/conversation_virtual_agent_capability_custom_collection.rb

@@ -0,0 +1,280 @@
+=begin
+#UltraCart Rest API V2
+
+#UltraCart REST API Version 2
+
+The version of the OpenAPI document: 2.0.0
+Contact: support@ultracart.com
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 6.0.1-SNAPSHOT
+
+=end
+
+require 'date'
+require 'time'
+
+module UltracartClient
+  class ConversationVirtualAgentCapabilityCustomCollection
+    # Merchant authored description of what is in this collection, which is what the agent sees when deciding whether to search it
+    attr_accessor :ai_description
+
+    # True if this collection has been enabled for AI access in its own configuration.  A collection that is not enabled cannot be searched even if it is selected here.
+    attr_accessor :ai_enabled
+
+    # Merchant assigned name of the collection
+    attr_accessor :collection_name
+
+    # Error from the last build, if it failed.  A collection with an error will return nothing to the agent, so this is worth surfacing next to the selection.
+    attr_accessor :error_message
+
+    # Date/time the collection was last rebuilt from the merchant's BigQuery query
+    attr_accessor :last_update_dts
+
+    # Number of records loaded on the last build
+    attr_accessor :record_count
+
+    # The identifier to place in custom_collection_oids to grant the agent access to this collection
+    attr_accessor :typesense_custom_collection_oid
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'ai_description' => :'ai_description',
+        :'ai_enabled' => :'ai_enabled',
+        :'collection_name' => :'collection_name',
+        :'error_message' => :'error_message',
+        :'last_update_dts' => :'last_update_dts',
+        :'record_count' => :'record_count',
+        :'typesense_custom_collection_oid' => :'typesense_custom_collection_oid'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'ai_description' => :'String',
+        :'ai_enabled' => :'Boolean',
+        :'collection_name' => :'String',
+        :'error_message' => :'String',
+        :'last_update_dts' => :'String',
+        :'record_count' => :'Integer',
+        :'typesense_custom_collection_oid' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `UltracartClient::ConversationVirtualAgentCapabilityCustomCollection` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `UltracartClient::ConversationVirtualAgentCapabilityCustomCollection`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'ai_description')
+        self.ai_description = attributes[:'ai_description']
+      end
+
+      if attributes.key?(:'ai_enabled')
+        self.ai_enabled = attributes[:'ai_enabled']
+      end
+
+      if attributes.key?(:'collection_name')
+        self.collection_name = attributes[:'collection_name']
+      end
+
+      if attributes.key?(:'error_message')
+        self.error_message = attributes[:'error_message']
+      end
+
+      if attributes.key?(:'last_update_dts')
+        self.last_update_dts = attributes[:'last_update_dts']
+      end
+
+      if attributes.key?(:'record_count')
+        self.record_count = attributes[:'record_count']
+      end
+
+      if attributes.key?(:'typesense_custom_collection_oid')
+        self.typesense_custom_collection_oid = attributes[:'typesense_custom_collection_oid']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          ai_description == o.ai_description &&
+          ai_enabled == o.ai_enabled &&
+          collection_name == o.collection_name &&
+          error_message == o.error_message &&
+          last_update_dts == o.last_update_dts &&
+          record_count == o.record_count &&
+          typesense_custom_collection_oid == o.typesense_custom_collection_oid
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [ai_description, ai_enabled, collection_name, error_message, last_update_dts, record_count, typesense_custom_collection_oid].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      new.build_from_hash(attributes)
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      self.class.openapi_types.each_pair do |key, type|
+        if attributes[self.class.attribute_map[key]].nil? && self.class.openapi_nullable.include?(key)
+          self.send("#{key}=", nil)
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = UltracartClient.const_get(type)
+        klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/ultracart_api/models/sfvb_container_response.rb

@@ -24,7 +24,7 @@ module UltracartClient
     # SHA-256 of the cjson.  Send back as If-Match when writing.
     attr_accessor :hash_sha256
 
-    # When the container was last modified, in the store's own record of it.  Present for email, postcardfront and postcardback.  Absent for upsell and item, because those tables carry no modification timestamp at all - for those two, read created_dts on the current entry of container_versions, which records when this API last wrote the container.  Note that a postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.
+    # When the container was last modified, in the store's own record of it.  Every owner type reports this.  It is absent only when the container has never been written since the store began recording it, so treat an absent value as unknown rather than as never modified.  Two behaviours worth knowing.  A postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.  An upsell container that is rewritten with byte identical content keeps its original date rather than moving to now, because the timestamp tracks changes to the container and not writes to the offer.
     attr_accessor :last_modified
 
     # Identifier of the owning object within its store.

data/lib/ultracart_api/models/sfvb_theme_duplicate_request.rb

@@ -15,7 +15,7 @@ require 'time'
 
 module UltracartClient
   class SfvbThemeDuplicateRequest
-    # Directory name for the new theme under /themes/.  Letters and numbers; it is cleansed before use.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
+    # Directory name for the new theme under /themes/.  Letters and numbers, one path segment.  Used verbatim - anything that is not already a valid directory name is refused rather than adjusted, because this call does not return the new theme's oid and you find your copy by matching the target_path you asked for.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
     attr_accessor :folder
 
     # Storefront to create the copy on.  Defaults to the storefront in the path.  Supply it only when copying a theme between storefronts you own.

data/lib/ultracart_api/models/sfvb_theme_job_response.rb

@@ -48,7 +48,7 @@ module UltracartClient
     # True only when the job finished successfully.  Check complete first.
     attr_accessor :success
 
-    # Path the new theme was created at.  Returned when the job is started; the theme oid itself is NOT returned, because the job's product is a plain text report rather than a structured result.  Once the job completes, list themes and match on this path.
+    # Path the new theme is being created at.  Returned when the job is started and on every poll, so you do not have to keep the response that started it.  The theme oid itself is NOT returned, so once the job completes you list themes and match on this path.  It is also what success is checked against - a finished job whose theme is not here reports success false rather than pretending.
     attr_accessor :target_path
 
     class EnumAttributeValidator

data/lib/ultracart_api/models/sfvb_version_response.rb

@@ -24,18 +24,36 @@ module UltracartClient
     # Number of element types this version recognizes.
     attr_accessor :element_count
 
+    # Largest binary asset that can be uploaded, in bytes, for every accepted type except video.
+    attr_accessor :max_asset_bytes
+
     # Largest CJSON document that will be parsed, in bytes.
     attr_accessor :max_cjson_bytes
 
+    # Most entries one directory listing returns.  Asking for more is silently reduced to this rather than refused, so compare against it instead of trusting that you got what you asked for.  The listing does set a truncated flag when it drops entries.
+    attr_accessor :max_directory_entries
+
+    # Most element library results one page returns.  Asking for more is silently reduced to this, and unlike the directory listing there is no truncation flag on the response, so this number is the only way to know a larger request was cut.
+    attr_accessor :max_library_results_per_page
+
     # Largest payload one preview session may hold, in bytes.
     attr_accessor :max_preview_session_bytes
 
+    # Largest historical version files/revert will restore, in bytes.  Higher than max_text_read_bytes deliberately - putting back a version that is already stored is cheaper than serving it as JSON, so a version too large to read can still be reverted to.
+    attr_accessor :max_revertable_bytes
+
     # Hard ceiling on file search results per page.
     attr_accessor :max_search_results
 
-    # Largest template file that can be written, in bytes.
+    # Largest .vm template that can be written, in bytes.  Narrow on purpose - it gates writes, only for files ending in .vm, and it is not the ceiling on reading a file back.  Use max_text_read_bytes for that.
     attr_accessor :max_template_bytes
 
+    # Largest file files/content will return as text, in bytes.  A file above this is refused with sfvb.too_large however small its history versions are.  Bigger than max_template_bytes, so a file can be readable here and still be too large to write back as a template.  Anything above this is still readable in full through files/download, which returns raw bytes and applies no ceiling.
+    attr_accessor :max_text_read_bytes
+
+    # Largest video that can be uploaded, in bytes.  Video is the one type allowed past max_asset_bytes.
+    attr_accessor :max_video_bytes
+
     # Most widget ids that can be reserved in one call.
     attr_accessor :max_widget_ids_per_request
 
@@ -73,10 +91,16 @@ module UltracartClient
         :'container_manager_version' => :'container_manager_version',
         :'container_versions_retained' => :'container_versions_retained',
         :'element_count' => :'element_count',
+        :'max_asset_bytes' => :'max_asset_bytes',
         :'max_cjson_bytes' => :'max_cjson_bytes',
+        :'max_directory_entries' => :'max_directory_entries',
+        :'max_library_results_per_page' => :'max_library_results_per_page',
         :'max_preview_session_bytes' => :'max_preview_session_bytes',
+        :'max_revertable_bytes' => :'max_revertable_bytes',
         :'max_search_results' => :'max_search_results',
         :'max_template_bytes' => :'max_template_bytes',
+        :'max_text_read_bytes' => :'max_text_read_bytes',
+        :'max_video_bytes' => :'max_video_bytes',
         :'max_widget_ids_per_request' => :'max_widget_ids_per_request',
         :'preview_session_ttl_seconds' => :'preview_session_ttl_seconds',
         :'release' => :'release'
@@ -94,10 +118,16 @@ module UltracartClient
         :'container_manager_version' => :'String',
         :'container_versions_retained' => :'Integer',
         :'element_count' => :'Integer',
+        :'max_asset_bytes' => :'Integer',
         :'max_cjson_bytes' => :'Integer',
+        :'max_directory_entries' => :'Integer',
+        :'max_library_results_per_page' => :'Integer',
         :'max_preview_session_bytes' => :'Integer',
+        :'max_revertable_bytes' => :'Integer',
         :'max_search_results' => :'Integer',
         :'max_template_bytes' => :'Integer',
+        :'max_text_read_bytes' => :'Integer',
+        :'max_video_bytes' => :'Integer',
         :'max_widget_ids_per_request' => :'Integer',
         :'preview_session_ttl_seconds' => :'Integer',
         :'release' => :'String'
@@ -137,14 +167,30 @@ module UltracartClient
         self.element_count = attributes[:'element_count']
       end
 
+      if attributes.key?(:'max_asset_bytes')
+        self.max_asset_bytes = attributes[:'max_asset_bytes']
+      end
+
       if attributes.key?(:'max_cjson_bytes')
         self.max_cjson_bytes = attributes[:'max_cjson_bytes']
       end
 
+      if attributes.key?(:'max_directory_entries')
+        self.max_directory_entries = attributes[:'max_directory_entries']
+      end
+
+      if attributes.key?(:'max_library_results_per_page')
+        self.max_library_results_per_page = attributes[:'max_library_results_per_page']
+      end
+
       if attributes.key?(:'max_preview_session_bytes')
         self.max_preview_session_bytes = attributes[:'max_preview_session_bytes']
       end
 
+      if attributes.key?(:'max_revertable_bytes')
+        self.max_revertable_bytes = attributes[:'max_revertable_bytes']
+      end
+
       if attributes.key?(:'max_search_results')
         self.max_search_results = attributes[:'max_search_results']
       end
@@ -153,6 +199,14 @@ module UltracartClient
         self.max_template_bytes = attributes[:'max_template_bytes']
       end
 
+      if attributes.key?(:'max_text_read_bytes')
+        self.max_text_read_bytes = attributes[:'max_text_read_bytes']
+      end
+
+      if attributes.key?(:'max_video_bytes')
+        self.max_video_bytes = attributes[:'max_video_bytes']
+      end
+
       if attributes.key?(:'max_widget_ids_per_request')
         self.max_widget_ids_per_request = attributes[:'max_widget_ids_per_request']
       end
@@ -199,10 +253,16 @@ module UltracartClient
           container_manager_version == o.container_manager_version &&
           container_versions_retained == o.container_versions_retained &&
           element_count == o.element_count &&
+          max_asset_bytes == o.max_asset_bytes &&
           max_cjson_bytes == o.max_cjson_bytes &&
+          max_directory_entries == o.max_directory_entries &&
+          max_library_results_per_page == o.max_library_results_per_page &&
           max_preview_session_bytes == o.max_preview_session_bytes &&
+          max_revertable_bytes == o.max_revertable_bytes &&
           max_search_results == o.max_search_results &&
           max_template_bytes == o.max_template_bytes &&
+          max_text_read_bytes == o.max_text_read_bytes &&
+          max_video_bytes == o.max_video_bytes &&
           max_widget_ids_per_request == o.max_widget_ids_per_request &&
           preview_session_ttl_seconds == o.preview_session_ttl_seconds &&
           release == o.release
@@ -217,7 +277,7 @@ module UltracartClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [container_manager_version, container_versions_retained, element_count, max_cjson_bytes, max_preview_session_bytes, max_search_results, max_template_bytes, max_widget_ids_per_request, preview_session_ttl_seconds, release].hash
+      [container_manager_version, container_versions_retained, element_count, max_asset_bytes, max_cjson_bytes, max_directory_entries, max_library_results_per_page, max_preview_session_bytes, max_revertable_bytes, max_search_results, max_template_bytes, max_text_read_bytes, max_video_bytes, max_widget_ids_per_request, preview_session_ttl_seconds, release].hash
     end
 
     # Builds the object from hash

data/lib/ultracart_api/version.rb

@@ -11,5 +11,5 @@ OpenAPI Generator version: 6.0.1-SNAPSHOT
 =end
 
 module UltracartClient
-  VERSION = '4.1.146'
+  VERSION = '4.1.148'
 end

data/lib/ultracart_api.rb

@@ -338,6 +338,7 @@ require 'ultracart_api/models/conversation_virtual_agent_budget'
 require 'ultracart_api/models/conversation_virtual_agent_budget_response'
 require 'ultracart_api/models/conversation_virtual_agent_capabilities'
 require 'ultracart_api/models/conversation_virtual_agent_capabilities_response'
+require 'ultracart_api/models/conversation_virtual_agent_capability_custom_collection'
 require 'ultracart_api/models/conversation_virtual_agent_capability_zoho_desk_department'
 require 'ultracart_api/models/conversation_webchat_context'
 require 'ultracart_api/models/conversation_webchat_queue_status'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ultracart_api
 version: !ruby/object:Gem::Version
-  version: 4.1.146
+  version: 4.1.148
 platform: ruby
 authors:
 - UltraCart
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-03 00:00:00.000000000 Z
+date: 2026-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus
@@ -389,6 +389,7 @@ files:
 - docs/ConversationVirtualAgentBudgetResponse.md
 - docs/ConversationVirtualAgentCapabilities.md
 - docs/ConversationVirtualAgentCapabilitiesResponse.md
+- docs/ConversationVirtualAgentCapabilityCustomCollection.md
 - docs/ConversationVirtualAgentCapabilityZohoDeskDepartment.md
 - docs/ConversationWebchatContext.md
 - docs/ConversationWebchatQueueStatus.md
@@ -1524,6 +1525,7 @@ files:
 - lib/ultracart_api/models/conversation_virtual_agent_budget_response.rb
 - lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb
 - lib/ultracart_api/models/conversation_virtual_agent_capabilities_response.rb
+- lib/ultracart_api/models/conversation_virtual_agent_capability_custom_collection.rb
 - lib/ultracart_api/models/conversation_virtual_agent_capability_zoho_desk_department.rb
 - lib/ultracart_api/models/conversation_webchat_context.rb
 - lib/ultracart_api/models/conversation_webchat_queue_status.rb