carbon_ruby_sdk 0.2.24 → 0.2.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b61e2385085bb9887386f845b210ba35f30fcb7c4e318827914fdc2d4311a8d
-  data.tar.gz: c939329f0ef41fcbdc4a10302d6c587665078d563d969660bae0d5af05e9514d
+  metadata.gz: c562b3f56aff93a861af81dd88f0793eec36d8d8a9fc82c3f636649795dd50e5
+  data.tar.gz: 2f13ed904f9cfac8e64a28e3334e6436c062b579b729abeea7c66bf983245d94
 SHA512:
-  metadata.gz: e109bbf4cdf4b20423a509411a212b0e1b9ce246573a56cb24776f04642dae068ca3710c2748f798ddcc8aa976a18ebb92250ce4afe797efdd31efb128de6926
-  data.tar.gz: d98be3101307c2805cbeb8a8b26454f57d32fa0b40cb580902fb23c58ee0c4973e332081d1ad499ea1f8d0858545784f8c2ab98d87a45fd2500c902f0164e800
+  metadata.gz: 343fc3b835634fb8b21c4673067e63ef7b7912a4ea5afea96bdbefd924e82281a0f70ef283bed37e0ab535b1b1b0a6292aa0da93a1a93bd22770a25bc775f741
+  data.tar.gz: 95ad01e04435a5513e248d35cdd560c2635c604d8e70aa46cd173853afd211b120722e3d9e12138f349a28e0572c7287f24a72fd14a25a7c9ad3560240f33702

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    carbon_ruby_sdk (0.2.24)
+    carbon_ruby_sdk (0.2.26)
       faraday (>= 1.0.1, < 3.0)
       faraday-multipart (~> 1.0, >= 1.0.4)
 
@@ -52,7 +52,7 @@ GEM
       rspec-mocks (~> 3.13.0)
     rspec-core (3.13.0)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-mocks (3.13.1)

data/README.md

@@ -6,7 +6,7 @@
 
 Connect external data to LLMs, no matter the source.
 
-[![npm](https://img.shields.io/badge/gem-v0.2.24-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.24)
+[![npm](https://img.shields.io/badge/gem-v0.2.26-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.26)
 
 </div>
 
@@ -93,7 +93,7 @@ Connect external data to LLMs, no matter the source.
 Add to Gemfile:
 
 ```ruby
-gem 'carbon_ruby_sdk', '~> 0.2.24'
+gem 'carbon_ruby_sdk', '~> 0.2.26'
 ```
 
 ## Getting Started<a id="getting-started"></a>
@@ -1114,7 +1114,7 @@ of all possible query parameters:
 - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings
 - `set_page_as_boundary`: described above
 - `embedding_model`: the model used to generate embeddings for the document chunks
-- `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently)
+- `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs
 - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search.
 - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text
 
@@ -1178,8 +1178,8 @@ description route description for more information.
 Embedding model that will be used to embed file chunks.
 
 ##### use_ocr: `Boolean`<a id="use_ocr-boolean"></a>
-Whether or not to use OCR when processing files. Only valid for PDFs. Useful for
-documents with tables, images, and/or scanned text.
+Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and
+PNGs. Useful for documents with tables, images, and/or scanned text.
 
 ##### generate_sparse_vectors: `Boolean`<a id="generate_sparse_vectors-boolean"></a>
 Whether or not to generate sparse vectors for the file. This is *required* for
@@ -1617,7 +1617,7 @@ success state.
 
 ```ruby
 result = carbon.integrations.get_oauth_url(
-  service: "GOOGLE_CLOUD_STORAGE",
+  service: "BOX",
   tags: None,
   scope: "string_example",
   chunk_size: 1500,
@@ -1657,7 +1657,7 @@ p result
 
 #### ⚙️ Parameters<a id="⚙️-parameters"></a>
 
-##### service: [`DataSourceType`](./lib/carbon_ruby_sdk/models/data_source_type.rb)<a id="service-datasourcetypelibcarbon_ruby_sdkmodelsdata_source_typerb"></a>
+##### service: [`ExternalDataSourceType`](./lib/carbon_ruby_sdk/models/external_data_source_type.rb)<a id="service-externaldatasourcetypelibcarbon_ruby_sdkmodelsexternal_data_source_typerb"></a>
 ##### tags: `Object`<a id="tags-object"></a>
 ##### scope: `String`<a id="scope-string"></a>
 ##### chunk_size: `Integer`<a id="chunk_size-integer"></a>
@@ -1695,7 +1695,7 @@ This request id will be added to all files that get synced using the generated
 OAuth URL
 
 ##### use_ocr: `Boolean`<a id="use_ocr-boolean"></a>
-Enable OCR for files that support it. Supported formats: png, jpg, pdf
+Enable OCR for files that support it. Supported formats: pdf, png, jpg
 
 ##### parse_pdf_tables_with_ocr: `Boolean`<a id="parse_pdf_tables_with_ocr-boolean"></a>
 ##### enable_file_picker: `Boolean`<a id="enable_file_picker-boolean"></a>

data/lib/carbon_ruby_sdk/api/files_api.rb

@@ -1341,7 +1341,7 @@ module Carbon
     # - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings
     # - `set_page_as_boundary`: described above
     # - `embedding_model`: the model used to generate embeddings for the document chunks
-    # - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently)
+    # - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs
     # - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search.
     # - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text
     # 
@@ -1363,7 +1363,7 @@ module Carbon
     # @param skip_embedding_generation [Boolean] Flag to control whether or not embeddings should be generated and stored when processing file.
     # @param set_page_as_boundary [Boolean] Flag to control whether or not to set the a page's worth of content as the maximum amount of content that can appear in a chunk. Only valid for PDFs. See description route description for more information.
     # @param embedding_model [EmbeddingModel] Embedding model that will be used to embed file chunks.
-    # @param use_ocr [Boolean] Whether or not to use OCR when processing files. Only valid for PDFs. Useful for documents with tables, images, and/or scanned text.
+    # @param use_ocr [Boolean] Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with tables, images, and/or scanned text.
     # @param generate_sparse_vectors [Boolean] Whether or not to generate sparse vectors for the file. This is *required* for the file to be a candidate for hybrid search.
     # @param prepend_filename_to_chunks [Boolean] Whether or not to prepend the file's name to chunks.
     # @param max_items_per_chunk [Integer] Number of objects per chunk. For csv, tsv, xlsx, and json files only.
@@ -1414,7 +1414,7 @@ module Carbon
     # - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings
     # - `set_page_as_boundary`: described above
     # - `embedding_model`: the model used to generate embeddings for the document chunks
-    # - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently)
+    # - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs
     # - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search.
     # - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text
     # 
@@ -1436,7 +1436,7 @@ module Carbon
     # @param skip_embedding_generation [Boolean] Flag to control whether or not embeddings should be generated and stored when processing file.
     # @param set_page_as_boundary [Boolean] Flag to control whether or not to set the a page's worth of content as the maximum amount of content that can appear in a chunk. Only valid for PDFs. See description route description for more information.
     # @param embedding_model [EmbeddingModel] Embedding model that will be used to embed file chunks.
-    # @param use_ocr [Boolean] Whether or not to use OCR when processing files. Only valid for PDFs. Useful for documents with tables, images, and/or scanned text.
+    # @param use_ocr [Boolean] Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with tables, images, and/or scanned text.
     # @param generate_sparse_vectors [Boolean] Whether or not to generate sparse vectors for the file. This is *required* for the file to be a candidate for hybrid search.
     # @param prepend_filename_to_chunks [Boolean] Whether or not to prepend the file's name to chunks.
     # @param max_items_per_chunk [Integer] Number of objects per chunk. For csv, tsv, xlsx, and json files only.
@@ -1475,7 +1475,7 @@ module Carbon
     end
 
     # Create Upload File
-    # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently) - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
+    # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
     # @param file [File] 
     # @param body_create_upload_file_uploadfile_post [BodyCreateUploadFileUploadfilePost] 
     # @param [Hash] opts the optional parameters
@@ -1484,7 +1484,7 @@ module Carbon
     # @option opts [Boolean] :skip_embedding_generation Flag to control whether or not embeddings should be generated and stored             when processing file. (default to false)
     # @option opts [Boolean] :set_page_as_boundary Flag to control whether or not to set the a page's worth of content as the maximum             amount of content that can appear in a chunk. Only valid for PDFs. See description route description for             more information. (default to false)
     # @option opts [EmbeddingModel] :embedding_model Embedding model that will be used to embed file chunks. (default to 'OPENAI')
-    # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Only valid for PDFs. Useful for documents with             tables, images, and/or scanned text. (default to false)
+    # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with             tables, images, and/or scanned text. (default to false)
     # @option opts [Boolean] :generate_sparse_vectors Whether or not to generate sparse vectors for the file. This is *required* for the file to be a             candidate for hybrid search. (default to false)
     # @option opts [Boolean] :prepend_filename_to_chunks Whether or not to prepend the file's name to chunks. (default to false)
     # @option opts [Integer] :max_items_per_chunk Number of objects per chunk. For csv, tsv, xlsx, and json files only.
@@ -1503,7 +1503,7 @@ module Carbon
     end
 
     # Create Upload File
-    # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently) - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
+    # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
     # @param file [File] 
     # @param body_create_upload_file_uploadfile_post [BodyCreateUploadFileUploadfilePost] 
     # @param [Hash] opts the optional parameters
@@ -1512,7 +1512,7 @@ module Carbon
     # @option opts [Boolean] :skip_embedding_generation Flag to control whether or not embeddings should be generated and stored             when processing file. (default to false)
     # @option opts [Boolean] :set_page_as_boundary Flag to control whether or not to set the a page's worth of content as the maximum             amount of content that can appear in a chunk. Only valid for PDFs. See description route description for             more information. (default to false)
     # @option opts [EmbeddingModel] :embedding_model Embedding model that will be used to embed file chunks. (default to 'OPENAI')
-    # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Only valid for PDFs. Useful for documents with             tables, images, and/or scanned text. (default to false)
+    # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with             tables, images, and/or scanned text. (default to false)
     # @option opts [Boolean] :generate_sparse_vectors Whether or not to generate sparse vectors for the file. This is *required* for the file to be a             candidate for hybrid search. (default to false)
     # @option opts [Boolean] :prepend_filename_to_chunks Whether or not to prepend the file's name to chunks. (default to false)
     # @option opts [Integer] :max_items_per_chunk Number of objects per chunk. For csv, tsv, xlsx, and json files only.

data/lib/carbon_ruby_sdk/api/integrations_api.rb

@@ -641,7 +641,7 @@ module Carbon
     # - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the
     # success state.
     #
-    # @param service [DataSourceType] 
+    # @param service [ExternalDataSourceType] 
     # @param tags [Object] 
     # @param scope [String] 
     # @param chunk_size [Integer] 
@@ -661,7 +661,7 @@ module Carbon
     # @param data_source_id [Integer] Used to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.
     # @param connecting_new_account [Boolean] Used to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.
     # @param request_id [String] This request id will be added to all files that get synced using the generated OAuth URL
-    # @param use_ocr [Boolean] Enable OCR for files that support it. Supported formats: png, jpg, pdf
+    # @param use_ocr [Boolean] Enable OCR for files that support it. Supported formats: pdf, png, jpg
     # @param parse_pdf_tables_with_ocr [Boolean] 
     # @param enable_file_picker [Boolean] Enable integration's file picker for sources that support it. Supported sources: BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT
     # @param sync_source_items [Boolean] Enabling this flag will fetch all available content from the source to be listed via list items endpoint
@@ -711,7 +711,7 @@ module Carbon
     # - A file syncing URL which skips the OAuth flow if the user already has a valid access token and takes them to the
     # success state.
     #
-    # @param service [DataSourceType] 
+    # @param service [ExternalDataSourceType] 
     # @param tags [Object] 
     # @param scope [String] 
     # @param chunk_size [Integer] 
@@ -731,7 +731,7 @@ module Carbon
     # @param data_source_id [Integer] Used to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.
     # @param connecting_new_account [Boolean] Used to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.
     # @param request_id [String] This request id will be added to all files that get synced using the generated OAuth URL
-    # @param use_ocr [Boolean] Enable OCR for files that support it. Supported formats: png, jpg, pdf
+    # @param use_ocr [Boolean] Enable OCR for files that support it. Supported formats: pdf, png, jpg
     # @param parse_pdf_tables_with_ocr [Boolean] 
     # @param enable_file_picker [Boolean] Enable integration's file picker for sources that support it. Supported sources: BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT
     # @param sync_source_items [Boolean] Enabling this flag will fetch all available content from the source to be listed via list items endpoint

data/lib/carbon_ruby_sdk/models/external_data_source_type.rb

@@ -0,0 +1,49 @@
+=begin
+#Carbon
+
+#Connect external data to LLMs, no matter the source.
+
+The version of the OpenAPI document: 1.0.0
+=end
+
+require 'date'
+require 'time'
+
+module Carbon
+  class ExternalDataSourceType
+    BOX = "BOX".freeze
+    CONFLUENCE = "CONFLUENCE".freeze
+    DROPBOX = "DROPBOX".freeze
+    GMAIL = "GMAIL".freeze
+    GOOGLE_DRIVE = "GOOGLE_DRIVE".freeze
+    GOOGLE_CLOUD_STORAGE = "GOOGLE_CLOUD_STORAGE".freeze
+    INTERCOM = "INTERCOM".freeze
+    NOTION = "NOTION".freeze
+    ONEDRIVE = "ONEDRIVE".freeze
+    OUTLOOK = "OUTLOOK".freeze
+    SALESFORCE = "SALESFORCE".freeze
+    SHAREPOINT = "SHAREPOINT".freeze
+    SLACK = "SLACK".freeze
+    ZENDESK = "ZENDESK".freeze
+    ZOTERO = "ZOTERO".freeze
+
+    def self.all_vars
+      @all_vars ||= [BOX, CONFLUENCE, DROPBOX, GMAIL, GOOGLE_DRIVE, GOOGLE_CLOUD_STORAGE, INTERCOM, NOTION, ONEDRIVE, OUTLOOK, SALESFORCE, SHAREPOINT, SLACK, ZENDESK, ZOTERO].freeze
+    end
+
+    # Builds the enum from string
+    # @param [String] The enum value in the form of the string
+    # @return [String] The enum value
+    def self.build_from_hash(value)
+      new.build_from_hash(value)
+    end
+
+    # Builds the enum from string
+    # @param [String] The enum value in the form of the string
+    # @return [String] The enum value
+    def build_from_hash(value)
+      return value if ExternalDataSourceType.all_vars.include?(value)
+      raise "Invalid ENUM value #{value} for class #ExternalDataSourceType"
+    end
+  end
+end

data/lib/carbon_ruby_sdk/models/o_auth_url_request.rb

@@ -56,7 +56,7 @@ module Carbon
     # This request id will be added to all files that get synced using the generated OAuth URL
     attr_accessor :request_id
 
-    # Enable OCR for files that support it. Supported formats: png, jpg, pdf
+    # Enable OCR for files that support it. Supported formats: pdf, png, jpg
     attr_accessor :use_ocr
 
     attr_accessor :parse_pdf_tables_with_ocr
@@ -118,7 +118,7 @@ module Carbon
       {
         :'tags' => :'Object',
         :'scope' => :'String',
-        :'service' => :'DataSourceType',
+        :'service' => :'ExternalDataSourceType',
         :'chunk_size' => :'Integer',
         :'chunk_overlap' => :'Integer',
         :'skip_embedding_generation' => :'Boolean',

data/lib/carbon_ruby_sdk/version.rb

@@ -7,5 +7,5 @@ The version of the OpenAPI document: 1.0.0
 =end
 
 module Carbon
-  VERSION = '0.2.24'
+  VERSION = '0.2.26'
 end

data/lib/carbon_ruby_sdk.rb

@@ -50,6 +50,7 @@ require 'carbon_ruby_sdk/models/embeddings_and_chunks_order_by_columns'
 require 'carbon_ruby_sdk/models/embeddings_and_chunks_query_input'
 require 'carbon_ruby_sdk/models/embeddings_and_chunks_query_input_v2'
 require 'carbon_ruby_sdk/models/embeddings_and_chunks_response'
+require 'carbon_ruby_sdk/models/external_data_source_type'
 require 'carbon_ruby_sdk/models/external_file_sync_statuses'
 require 'carbon_ruby_sdk/models/external_source_item'
 require 'carbon_ruby_sdk/models/external_source_items_order_by'

data/spec/api/files_api_spec.rb

@@ -165,7 +165,7 @@ describe 'FilesApi' do
 
   # unit tests for upload
   # Create Upload File
-  # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks (only valid for PDFs currently) - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
+  # This endpoint is used to directly upload local files to Carbon. The `POST` request should be a multipart form request. Note that the `set_page_as_boundary` query parameter is applicable only to PDFs for now. When this value is set, PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description of all possible query parameters: - `chunk_size`: the chunk size (in tokens) applied when splitting the document - `chunk_overlap`: the chunk overlap (in tokens) applied when splitting the document - `skip_embedding_generation`: whether or not to skip the generation of chunks and embeddings - `set_page_as_boundary`: described above - `embedding_model`: the model used to generate embeddings for the document chunks - `use_ocr`: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGs - `generate_sparse_vectors`: whether or not to generate sparse vectors for the file. Required for hybrid search. - `prepend_filename_to_chunks`: whether or not to prepend the filename to the chunk text   Carbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's multimodal model; for text, we support OpenAI's `text-embedding-ada-002` and Cohere's embed-multilingual-v3.0. The model can be specified via the `embedding_model` parameter (in the POST body for `/embeddings`, and a query  parameter in `/uploadfile`). If no model is supplied, the `text-embedding-ada-002` is used by default. When performing embedding queries, embeddings from files that used the specified model will be considered in the query. For example, if files A and B have embeddings generated with `OPENAI`, and files C and D have embeddings generated with `COHERE_MULTILINGUAL_V3`, then by default, queries will only consider files A and B. If `COHERE_MULTILINGUAL_V3` is specified as the `embedding_model` in `/embeddings`, then only files C and D will be considered. Make sure that the set of all files you want considered for a query have embeddings generated via the same model. For now, **do not** set `VERTEX_MULTIMODAL` as an `embedding_model`. This model is used automatically by Carbon when it detects an image file.
   # @param file 
   # @param body_create_upload_file_uploadfile_post 
   # @param [Hash] opts the optional parameters
@@ -174,7 +174,7 @@ describe 'FilesApi' do
   # @option opts [Boolean] :skip_embedding_generation Flag to control whether or not embeddings should be generated and stored             when processing file.
   # @option opts [Boolean] :set_page_as_boundary Flag to control whether or not to set the a page's worth of content as the maximum             amount of content that can appear in a chunk. Only valid for PDFs. See description route description for             more information.
   # @option opts [EmbeddingModel] :embedding_model Embedding model that will be used to embed file chunks.
-  # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Only valid for PDFs. Useful for documents with             tables, images, and/or scanned text.
+  # @option opts [Boolean] :use_ocr Whether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with             tables, images, and/or scanned text.
   # @option opts [Boolean] :generate_sparse_vectors Whether or not to generate sparse vectors for the file. This is *required* for the file to be a             candidate for hybrid search.
   # @option opts [Boolean] :prepend_filename_to_chunks Whether or not to prepend the file's name to chunks.
   # @option opts [Integer] :max_items_per_chunk Number of objects per chunk. For csv, tsv, xlsx, and json files only.

data/spec/models/external_data_source_type_spec.rb

@@ -0,0 +1,22 @@
+=begin
+#Carbon
+
+#Connect external data to LLMs, no matter the source.
+
+The version of the OpenAPI document: 1.0.0
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for Carbon::ExternalDataSourceType
+describe Carbon::ExternalDataSourceType do
+  let(:instance) { Carbon::ExternalDataSourceType.new }
+
+  describe 'test an instance of ExternalDataSourceType' do
+    it 'should create an instance of ExternalDataSourceType' do
+      expect(instance).to be_instance_of(Carbon::ExternalDataSourceType)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: carbon_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.24
+  version: 0.2.26
 platform: ruby
 authors:
 - Konfig
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-20 00:00:00.000000000 Z
+date: 2024-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -132,6 +132,7 @@ files:
 - lib/carbon_ruby_sdk/models/embeddings_and_chunks_query_input.rb
 - lib/carbon_ruby_sdk/models/embeddings_and_chunks_query_input_v2.rb
 - lib/carbon_ruby_sdk/models/embeddings_and_chunks_response.rb
+- lib/carbon_ruby_sdk/models/external_data_source_type.rb
 - lib/carbon_ruby_sdk/models/external_file_sync_statuses.rb
 - lib/carbon_ruby_sdk/models/external_source_item.rb
 - lib/carbon_ruby_sdk/models/external_source_items_order_by.rb
@@ -305,6 +306,7 @@ files:
 - spec/models/embeddings_and_chunks_query_input_spec.rb
 - spec/models/embeddings_and_chunks_query_input_v2_spec.rb
 - spec/models/embeddings_and_chunks_response_spec.rb
+- spec/models/external_data_source_type_spec.rb
 - spec/models/external_file_sync_statuses_spec.rb
 - spec/models/external_source_item_spec.rb
 - spec/models/external_source_items_order_by_spec.rb
@@ -600,6 +602,7 @@ test_files:
 - spec/models/list_users_request_spec.rb
 - spec/models/gitbook_sync_request_spec.rb
 - spec/models/http_validation_error_spec.rb
+- spec/models/external_data_source_type_spec.rb
 - spec/models/embedding_and_chunk_spec.rb
 - spec/models/embedding_properties_spec.rb
 - spec/models/file_sync_config_nullable_spec.rb