carbon_ruby_sdk 0.2.20 → 0.2.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63fff490af752ce2a21d8db67d18b2178cc65df146277b064f9c5504d8b09277
-  data.tar.gz: 1100c683b7832c69bcd2869e6c817fd44be5619cccd7afaf7320324ddc5b0909
+  metadata.gz: 806bcc7f0eb46e3620cbeb04930aaea25d030ca1336725a4819e29d2e01f6ef1
+  data.tar.gz: 9ab058d3e97f2a70a109db053b9900332ebcbf1387e24d09f875bcecd57125b5
 SHA512:
-  metadata.gz: 03ede46c6589f77b8c1c8eb4c915467e1483c0a7cca533a6302c9ae898d72478b1aff681a264e5aca3f60f9b312a6d2ee02a52e5a77068bd86871848e9abe7d8
-  data.tar.gz: da426e61b701295417b6836a91677b9d6c3f638dad36bcff2ea01d645f26f6fb2b885082b82e5fb2b756ffeec1d1feb457d41d2f3b240bdc12b9dfbe47959097
+  metadata.gz: 4268173c09c5e36e0bb61bd87754300a97818ebda1f49101b19001ddcbb0f0d8bb8ef02c839c5b5d450a1c12de29c49c516db97f39c1f969d3b3a928ca95836a
+  data.tar.gz: 583d3c91102825020658d5d2335289e6b05e7076a782dc1eb820002fa3b3ce7de10d8824de2773d32741fb34faee2c1cee36128bcb94a840d8157185934942ea

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    carbon_ruby_sdk (0.2.20)
+    carbon_ruby_sdk (0.2.22)
       faraday (>= 1.0.1, < 3.0)
       faraday-multipart (~> 1.0, >= 1.0.4)
 
@@ -28,8 +28,8 @@ GEM
       reline (>= 0.3.0)
     method_source (1.1.0)
     multipart-post (2.4.1)
-    parallel (1.25.1)
-    parser (3.3.4.1)
+    parallel (1.26.3)
+    parser (3.3.4.2)
       ast (~> 2.4.1)
       racc
     pry (0.14.2)
@@ -44,7 +44,7 @@ GEM
     regexp_parser (2.9.2)
     reline (0.5.9)
       io-console (~> 0.5)
-    rexml (3.3.4)
+    rexml (3.3.5)
       strscan
     rspec (3.13.0)
       rspec-core (~> 3.13.0)

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.20-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.20)
+[![npm](https://img.shields.io/badge/gem-v0.2.22-blue)](https://rubygems.org/gems/carbon_ruby_sdk/versions/0.2.22)
 
 </div>
 
@@ -33,6 +33,8 @@ Connect external data to LLMs, no matter the source.
   * [`carbon.files.delete_v2`](#carbonfilesdelete_v2)
   * [`carbon.files.get_parsed_file`](#carbonfilesget_parsed_file)
   * [`carbon.files.get_raw_file`](#carbonfilesget_raw_file)
+  * [`carbon.files.modify_cold_storage_parameters`](#carbonfilesmodify_cold_storage_parameters)
+  * [`carbon.files.move_to_hot_storage`](#carbonfilesmove_to_hot_storage)
   * [`carbon.files.query_user_files`](#carbonfilesquery_user_files)
   * [`carbon.files.query_user_files_deprecated`](#carbonfilesquery_user_files_deprecated)
   * [`carbon.files.resync`](#carbonfilesresync)
@@ -91,7 +93,7 @@ Connect external data to LLMs, no matter the source.
 Add to Gemfile:
 
 ```ruby
-gem 'carbon_ruby_sdk', '~> 0.2.20'
+gem 'carbon_ruby_sdk', '~> 0.2.22'
 ```
 
 ## Getting Started<a id="getting-started"></a>
@@ -388,6 +390,7 @@ result = carbon.embeddings.get_documents(
   file_types_at_source: [
         "string_example"
     ],
+  exclude_cold_storage_files: false,
 )
 p result
 ```
@@ -456,6 +459,11 @@ results, but may take longer to complete.
 Filter files based on their type at the source (for example help center tickets
 and articles)
 
+##### exclude_cold_storage_files: `Boolean`<a id="exclude_cold_storage_files-boolean"></a>
+Flag to control whether or not to exclude files that are not in hot storage. If
+set to False, then an error will be returned if any filtered files are in cold
+storage.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [DocumentResponseList](./lib/carbon_ruby_sdk/models/document_response_list.rb)
@@ -855,6 +863,66 @@ p result
 ---
 
 
+### `carbon.files.modify_cold_storage_parameters`<a id="carbonfilesmodify_cold_storage_parameters"></a>
+
+Modify Cold Storage Parameters
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = carbon.files.modify_cold_storage_parameters(
+  filters: {
+        "include_all_children" => false,
+        "non_synced_only" => false,
+    },
+  enable_cold_storage: true,
+  hot_storage_time_to_live: 1,
+)
+p result
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### filters: [`OrganizationUserFilesToSyncFilters`](./lib/carbon_ruby_sdk/models/organization_user_files_to_sync_filters.rb)<a id="filters-organizationuserfilestosyncfilterslibcarbon_ruby_sdkmodelsorganization_user_files_to_sync_filtersrb"></a>
+##### enable_cold_storage: `Boolean`<a id="enable_cold_storage-boolean"></a>
+##### hot_storage_time_to_live: `Integer`<a id="hot_storage_time_to_live-integer"></a>
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/modify_cold_storage_parameters` `POST`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
+### `carbon.files.move_to_hot_storage`<a id="carbonfilesmove_to_hot_storage"></a>
+
+Move To Hot Storage
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = carbon.files.move_to_hot_storage(
+  filters: {
+        "include_all_children" => false,
+        "non_synced_only" => false,
+    },
+)
+p result
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### filters: [`OrganizationUserFilesToSyncFilters`](./lib/carbon_ruby_sdk/models/organization_user_files_to_sync_filters.rb)<a id="filters-organizationuserfilestosyncfilterslibcarbon_ruby_sdkmodelsorganization_user_files_to_sync_filtersrb"></a>
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/move_to_hot_storage` `POST`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `carbon.files.query_user_files`<a id="carbonfilesquery_user_files"></a>
 
 For pre-filtering documents, using `tags_v2` is preferred to using `tags` (which is now deprecated). If both `tags_v2`
@@ -1079,8 +1147,11 @@ result = carbon.files.upload(
   parse_pdf_tables_with_ocr: false,
   detect_audio_language: false,
   transcription_service: "assemblyai",
+  include_speaker_labels: false,
   media_type: "TEXT",
   split_rows: false,
+  enable_cold_storage: false,
+  hot_storage_time_to_live: 1,
 )
 p result
 ```
@@ -1130,6 +1201,10 @@ Whether to automatically detect the language of the uploaded audio file.
 The transcription service to use for audio files. If no service is specified,
 'deepgram' will be used.
 
+##### include_speaker_labels: `Boolean`<a id="include_speaker_labels-boolean"></a>
+Detect multiple speakers and label segments of speech by speaker for audio
+files.
+
 ##### media_type: [`FileContentTypesNullable`](./lib/carbon_ruby_sdk/models/file_content_types_nullable.rb)<a id="media_type-filecontenttypesnullablelibcarbon_ruby_sdkmodelsfile_content_types_nullablerb"></a>
 The media type of the file. If not provided, it will be inferred from the file
 extension.
@@ -1138,6 +1213,13 @@ extension.
 Whether to split tabular rows into chunks. Currently only valid for CSV, TSV,
 and XLSX files.
 
+##### enable_cold_storage: `Boolean`<a id="enable_cold_storage-boolean"></a>
+Enable cold storage for the file. If set to true, the file will be moved to cold
+storage after a certain period of inactivity. Default is false.
+
+##### hot_storage_time_to_live: `Integer`<a id="hot_storage_time_to_live-integer"></a>
+Time in seconds after which the file will be moved to cold storage.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [UserFile](./lib/carbon_ruby_sdk/models/user_file.rb)
@@ -1173,8 +1255,12 @@ result = carbon.files.upload_from_url(
   parse_pdf_tables_with_ocr: false,
   detect_audio_language: false,
   transcription_service: "assemblyai",
+  include_speaker_labels: false,
   media_type: "TEXT",
   split_rows: false,
+  cold_storage_params: {
+        "enable_cold_storage" => false,
+    },
 )
 p result
 ```
@@ -1197,8 +1283,10 @@ Number of objects per chunk. For csv, tsv, xlsx, and json files only.
 ##### parse_pdf_tables_with_ocr: `Boolean`<a id="parse_pdf_tables_with_ocr-boolean"></a>
 ##### detect_audio_language: `Boolean`<a id="detect_audio_language-boolean"></a>
 ##### transcription_service: [`TranscriptionServiceNullable`](./lib/carbon_ruby_sdk/models/transcription_service_nullable.rb)<a id="transcription_service-transcriptionservicenullablelibcarbon_ruby_sdkmodelstranscription_service_nullablerb"></a>
+##### include_speaker_labels: `Boolean`<a id="include_speaker_labels-boolean"></a>
 ##### media_type: [`FileContentTypesNullable`](./lib/carbon_ruby_sdk/models/file_content_types_nullable.rb)<a id="media_type-filecontenttypesnullablelibcarbon_ruby_sdkmodelsfile_content_types_nullablerb"></a>
 ##### split_rows: `Boolean`<a id="split_rows-boolean"></a>
+##### cold_storage_params: [`ColdStorageProps`](./lib/carbon_ruby_sdk/models/cold_storage_props.rb)<a id="cold_storage_params-coldstoragepropslibcarbon_ruby_sdkmodelscold_storage_propsrb"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [UserFile](./lib/carbon_ruby_sdk/models/user_file.rb)
@@ -1237,6 +1325,9 @@ result = carbon.files.upload_text(
   overwrite_file_id: 1,
   embedding_model: "OPENAI",
   generate_sparse_vectors: false,
+  cold_storage_params: {
+        "enable_cold_storage" => false,
+    },
 )
 p result
 ```
@@ -1251,6 +1342,7 @@ p result
 ##### overwrite_file_id: `Integer`<a id="overwrite_file_id-integer"></a>
 ##### embedding_model: [`EmbeddingGeneratorsNullable`](./lib/carbon_ruby_sdk/models/embedding_generators_nullable.rb)<a id="embedding_model-embeddinggeneratorsnullablelibcarbon_ruby_sdkmodelsembedding_generators_nullablerb"></a>
 ##### generate_sparse_vectors: `Boolean`<a id="generate_sparse_vectors-boolean"></a>
+##### cold_storage_params: [`ColdStorageProps`](./lib/carbon_ruby_sdk/models/cold_storage_props.rb)<a id="cold_storage_params-coldstoragepropslibcarbon_ruby_sdkmodelscold_storage_propsrb"></a>
 #### 🔄 Return<a id="🔄-return"></a>
 
 [UserFile](./lib/carbon_ruby_sdk/models/user_file.rb)
@@ -1368,6 +1460,7 @@ result = carbon.integrations.connect_freshdesk(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
 )
@@ -1554,8 +1647,10 @@ result = carbon.integrations.get_oauth_url(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
+  automatically_open_file_picker: true,
 )
 p result
 ```
@@ -1600,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: pdf
+Enable OCR for files that support it. Supported formats: jpg, png, pdf
 
 ##### 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>
@@ -1618,6 +1713,11 @@ GOOGLE_DRIVE, BOX, DROPBOX, INTERCOM, GMAIL, OUTLOOK, ZENDESK, CONFLUENCE,
 NOTION, SHAREPOINT. It will be ignored for other data sources.
 
 ##### file_sync_config: [`FileSyncConfigNullable`](./lib/carbon_ruby_sdk/models/file_sync_config_nullable.rb)<a id="file_sync_config-filesyncconfignullablelibcarbon_ruby_sdkmodelsfile_sync_config_nullablerb"></a>
+##### automatically_open_file_picker: `Boolean`<a id="automatically_open_file_picker-boolean"></a>
+Automatically open source file picker after the OAuth flow is complete. This
+flag is currently supported by BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT.
+It will be ignored for other data sources.
+
 #### 🔄 Return<a id="🔄-return"></a>
 
 [OuthURLResponse](./lib/carbon_ruby_sdk/models/outh_url_response.rb)
@@ -1920,6 +2020,7 @@ result = carbon.integrations.sync_confluence(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
 )
@@ -2026,6 +2127,7 @@ result = carbon.integrations.sync_files(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
 )
@@ -2229,6 +2331,7 @@ result = carbon.integrations.sync_gmail(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
   incremental_sync: false,
@@ -2349,6 +2452,7 @@ result = carbon.integrations.sync_outlook(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
   incremental_sync: false,
@@ -2493,6 +2597,7 @@ result = carbon.integrations.sync_s3_files(
         "sync_attachments" => false,
         "detect_audio_language" => false,
         "transcription_service" => "assemblyai",
+        "include_speaker_labels" => false,
         "split_rows" => false,
     },
 )

data/lib/carbon_ruby_sdk/api/embeddings_api.rb

@@ -132,9 +132,10 @@ module Carbon
     # @param high_accuracy [Boolean] Flag to control whether or not to perform a high accuracy embedding search. By default, this is set to false. If true, the search may return more accurate results, but may take longer to complete.
     # @param rerank [RerankParamsNullable] 
     # @param file_types_at_source [Array<HelpdeskFileTypes>] Filter files based on their type at the source (for example help center tickets and articles)
+    # @param exclude_cold_storage_files [Boolean] Flag to control whether or not to exclude files that are not in hot storage. If set to False, then an error will be returned if any filtered files are in cold storage.
     # @param body [GetEmbeddingDocumentsBody] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_documents(query:, k:, tags: SENTINEL, query_vector: SENTINEL, file_ids: SENTINEL, parent_file_ids: SENTINEL, include_all_children: false, tags_v2: SENTINEL, include_tags: SENTINEL, include_vectors: SENTINEL, include_raw_file: SENTINEL, hybrid_search: SENTINEL, hybrid_search_tuning_parameters: SENTINEL, media_type: SENTINEL, embedding_model: 'OPENAI', include_file_level_metadata: false, high_accuracy: false, rerank: SENTINEL, file_types_at_source: SENTINEL, extra: {})
+    def get_documents(query:, k:, tags: SENTINEL, query_vector: SENTINEL, file_ids: SENTINEL, parent_file_ids: SENTINEL, include_all_children: false, tags_v2: SENTINEL, include_tags: SENTINEL, include_vectors: SENTINEL, include_raw_file: SENTINEL, hybrid_search: SENTINEL, hybrid_search_tuning_parameters: SENTINEL, media_type: SENTINEL, embedding_model: 'OPENAI', include_file_level_metadata: false, high_accuracy: false, rerank: SENTINEL, file_types_at_source: SENTINEL, exclude_cold_storage_files: false, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:query] = query if query != SENTINEL
@@ -155,6 +156,7 @@ module Carbon
       _body[:high_accuracy] = high_accuracy if high_accuracy != SENTINEL
       _body[:rerank] = rerank if rerank != SENTINEL
       _body[:file_types_at_source] = file_types_at_source if file_types_at_source != SENTINEL
+      _body[:exclude_cold_storage_files] = exclude_cold_storage_files if exclude_cold_storage_files != SENTINEL
       get_embedding_documents_body = _body
       api_response = get_documents_with_http_info_impl(get_embedding_documents_body, extra)
       api_response.data
@@ -276,9 +278,10 @@ module Carbon
     # @param high_accuracy [Boolean] Flag to control whether or not to perform a high accuracy embedding search. By default, this is set to false. If true, the search may return more accurate results, but may take longer to complete.
     # @param rerank [RerankParamsNullable] 
     # @param file_types_at_source [Array<HelpdeskFileTypes>] Filter files based on their type at the source (for example help center tickets and articles)
+    # @param exclude_cold_storage_files [Boolean] Flag to control whether or not to exclude files that are not in hot storage. If set to False, then an error will be returned if any filtered files are in cold storage.
     # @param body [GetEmbeddingDocumentsBody] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_documents_with_http_info(query:, k:, tags: SENTINEL, query_vector: SENTINEL, file_ids: SENTINEL, parent_file_ids: SENTINEL, include_all_children: false, tags_v2: SENTINEL, include_tags: SENTINEL, include_vectors: SENTINEL, include_raw_file: SENTINEL, hybrid_search: SENTINEL, hybrid_search_tuning_parameters: SENTINEL, media_type: SENTINEL, embedding_model: 'OPENAI', include_file_level_metadata: false, high_accuracy: false, rerank: SENTINEL, file_types_at_source: SENTINEL, extra: {})
+    def get_documents_with_http_info(query:, k:, tags: SENTINEL, query_vector: SENTINEL, file_ids: SENTINEL, parent_file_ids: SENTINEL, include_all_children: false, tags_v2: SENTINEL, include_tags: SENTINEL, include_vectors: SENTINEL, include_raw_file: SENTINEL, hybrid_search: SENTINEL, hybrid_search_tuning_parameters: SENTINEL, media_type: SENTINEL, embedding_model: 'OPENAI', include_file_level_metadata: false, high_accuracy: false, rerank: SENTINEL, file_types_at_source: SENTINEL, exclude_cold_storage_files: false, extra: {})
       _body = {}
       _body[:tags] = tags if tags != SENTINEL
       _body[:query] = query if query != SENTINEL
@@ -299,6 +302,7 @@ module Carbon
       _body[:high_accuracy] = high_accuracy if high_accuracy != SENTINEL
       _body[:rerank] = rerank if rerank != SENTINEL
       _body[:file_types_at_source] = file_types_at_source if file_types_at_source != SENTINEL
+      _body[:exclude_cold_storage_files] = exclude_cold_storage_files if exclude_cold_storage_files != SENTINEL
       get_embedding_documents_body = _body
       get_documents_with_http_info_impl(get_embedding_documents_body, extra)
     end