trieve_ruby_client 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +5 -5
  3. data/docs/ChunkData.md +1 -1
  4. data/docs/ChunkMetadata.md +0 -2
  5. data/docs/ChunkMetadataWithScore.md +0 -2
  6. data/docs/GroupScoreSlimChunks.md +4 -0
  7. data/docs/RecommendChunksRequest.md +1 -1
  8. data/docs/RecommendGroupChunksRequest.md +1 -1
  9. data/docs/SearchChunkData.md +5 -5
  10. data/docs/SearchOverGroupsData.md +3 -3
  11. data/docs/SearchWithinGroupData.md +5 -5
  12. data/lib/trieve_ruby_client/api/auth_api.rb +1 -1
  13. data/lib/trieve_ruby_client/api/chunk_api.rb +1 -1
  14. data/lib/trieve_ruby_client/api/chunk_group_api.rb +1 -1
  15. data/lib/trieve_ruby_client/api/dataset_api.rb +1 -1
  16. data/lib/trieve_ruby_client/api/events_api.rb +1 -1
  17. data/lib/trieve_ruby_client/api/file_api.rb +1 -1
  18. data/lib/trieve_ruby_client/api/health_api.rb +1 -1
  19. data/lib/trieve_ruby_client/api/invitation_api.rb +1 -1
  20. data/lib/trieve_ruby_client/api/message_api.rb +1 -1
  21. data/lib/trieve_ruby_client/api/organization_api.rb +1 -1
  22. data/lib/trieve_ruby_client/api/stripe_api.rb +1 -1
  23. data/lib/trieve_ruby_client/api/topic_api.rb +1 -1
  24. data/lib/trieve_ruby_client/api/user_api.rb +1 -1
  25. data/lib/trieve_ruby_client/api_client.rb +1 -1
  26. data/lib/trieve_ruby_client/api_error.rb +1 -1
  27. data/lib/trieve_ruby_client/configuration.rb +1 -1
  28. data/lib/trieve_ruby_client/models/add_chunk_to_group_data.rb +1 -1
  29. data/lib/trieve_ruby_client/models/api_key_dto.rb +1 -1
  30. data/lib/trieve_ruby_client/models/auth_query.rb +1 -1
  31. data/lib/trieve_ruby_client/models/batch_queued_chunk_response.rb +1 -1
  32. data/lib/trieve_ruby_client/models/bookmark_data.rb +1 -1
  33. data/lib/trieve_ruby_client/models/bookmark_group_result.rb +1 -1
  34. data/lib/trieve_ruby_client/models/chat_message_proxy.rb +1 -1
  35. data/lib/trieve_ruby_client/models/chunk_data.rb +8 -2
  36. data/lib/trieve_ruby_client/models/chunk_filter.rb +1 -1
  37. data/lib/trieve_ruby_client/models/chunk_group.rb +1 -1
  38. data/lib/trieve_ruby_client/models/chunk_group_and_file.rb +1 -1
  39. data/lib/trieve_ruby_client/models/chunk_metadata.rb +2 -18
  40. data/lib/trieve_ruby_client/models/chunk_metadata_with_score.rb +2 -18
  41. data/lib/trieve_ruby_client/models/client_dataset_configuration.rb +1 -1
  42. data/lib/trieve_ruby_client/models/create_chunk_data.rb +1 -1
  43. data/lib/trieve_ruby_client/models/create_chunk_group_data.rb +1 -1
  44. data/lib/trieve_ruby_client/models/create_dataset_request.rb +1 -1
  45. data/lib/trieve_ruby_client/models/create_message_data.rb +1 -1
  46. data/lib/trieve_ruby_client/models/create_organization_data.rb +1 -1
  47. data/lib/trieve_ruby_client/models/create_topic_data.rb +1 -1
  48. data/lib/trieve_ruby_client/models/dataset.rb +1 -1
  49. data/lib/trieve_ruby_client/models/dataset_and_usage.rb +1 -1
  50. data/lib/trieve_ruby_client/models/dataset_dto.rb +1 -1
  51. data/lib/trieve_ruby_client/models/dataset_usage_count.rb +1 -1
  52. data/lib/trieve_ruby_client/models/delete_topic_data.rb +1 -1
  53. data/lib/trieve_ruby_client/models/delete_user_api_key_request.rb +1 -1
  54. data/lib/trieve_ruby_client/models/edit_message_data.rb +1 -1
  55. data/lib/trieve_ruby_client/models/error_response_body.rb +1 -1
  56. data/lib/trieve_ruby_client/models/event.rb +1 -1
  57. data/lib/trieve_ruby_client/models/event_return.rb +1 -1
  58. data/lib/trieve_ruby_client/models/field_condition.rb +1 -1
  59. data/lib/trieve_ruby_client/models/file.rb +1 -1
  60. data/lib/trieve_ruby_client/models/file_dto.rb +1 -1
  61. data/lib/trieve_ruby_client/models/generate_chunks_request.rb +1 -1
  62. data/lib/trieve_ruby_client/models/geo_info.rb +1 -1
  63. data/lib/trieve_ruby_client/models/geo_types.rb +1 -1
  64. data/lib/trieve_ruby_client/models/get_chunks_data.rb +1 -1
  65. data/lib/trieve_ruby_client/models/get_events_data.rb +1 -1
  66. data/lib/trieve_ruby_client/models/get_groups_for_chunks_data.rb +1 -1
  67. data/lib/trieve_ruby_client/models/get_tracking_chunks_data.rb +1 -1
  68. data/lib/trieve_ruby_client/models/group_data.rb +1 -1
  69. data/lib/trieve_ruby_client/models/group_score_chunk.rb +1 -1
  70. data/lib/trieve_ruby_client/models/group_score_slim_chunks.rb +22 -2
  71. data/lib/trieve_ruby_client/models/invitation_data.rb +1 -1
  72. data/lib/trieve_ruby_client/models/location_bounding_box.rb +1 -1
  73. data/lib/trieve_ruby_client/models/location_polygon.rb +1 -1
  74. data/lib/trieve_ruby_client/models/location_radius.rb +1 -1
  75. data/lib/trieve_ruby_client/models/match_condition.rb +1 -1
  76. data/lib/trieve_ruby_client/models/message.rb +1 -1
  77. data/lib/trieve_ruby_client/models/organization.rb +1 -1
  78. data/lib/trieve_ruby_client/models/organization_usage_count.rb +1 -1
  79. data/lib/trieve_ruby_client/models/range.rb +1 -1
  80. data/lib/trieve_ruby_client/models/range_condition.rb +1 -1
  81. data/lib/trieve_ruby_client/models/recommend_chunks_request.rb +2 -2
  82. data/lib/trieve_ruby_client/models/recommend_group_chunks_request.rb +2 -2
  83. data/lib/trieve_ruby_client/models/regenerate_message_data.rb +1 -1
  84. data/lib/trieve_ruby_client/models/return_queued_chunk.rb +1 -1
  85. data/lib/trieve_ruby_client/models/score_chunk_dto.rb +1 -1
  86. data/lib/trieve_ruby_client/models/score_slim_chunks.rb +1 -1
  87. data/lib/trieve_ruby_client/models/search_chunk_data.rb +16 -16
  88. data/lib/trieve_ruby_client/models/search_chunk_query_response_body.rb +1 -1
  89. data/lib/trieve_ruby_client/models/search_over_groups_data.rb +4 -4
  90. data/lib/trieve_ruby_client/models/search_over_groups_results.rb +1 -1
  91. data/lib/trieve_ruby_client/models/search_over_groups_slim_results.rb +1 -1
  92. data/lib/trieve_ruby_client/models/search_slim_chunk_query_response_body.rb +1 -1
  93. data/lib/trieve_ruby_client/models/search_within_group_data.rb +16 -16
  94. data/lib/trieve_ruby_client/models/search_within_group_results.rb +1 -1
  95. data/lib/trieve_ruby_client/models/search_within_group_slim_results.rb +1 -1
  96. data/lib/trieve_ruby_client/models/set_user_api_key_request.rb +1 -1
  97. data/lib/trieve_ruby_client/models/set_user_api_key_response.rb +1 -1
  98. data/lib/trieve_ruby_client/models/single_queued_chunk_response.rb +1 -1
  99. data/lib/trieve_ruby_client/models/slim_chunk_metadata.rb +1 -1
  100. data/lib/trieve_ruby_client/models/slim_chunk_metadata_with_score.rb +1 -1
  101. data/lib/trieve_ruby_client/models/slim_group.rb +1 -1
  102. data/lib/trieve_ruby_client/models/slim_user.rb +1 -1
  103. data/lib/trieve_ruby_client/models/stripe_plan.rb +1 -1
  104. data/lib/trieve_ruby_client/models/suggested_queries_request.rb +1 -1
  105. data/lib/trieve_ruby_client/models/suggested_queries_response.rb +1 -1
  106. data/lib/trieve_ruby_client/models/topic.rb +1 -1
  107. data/lib/trieve_ruby_client/models/update_chunk_by_tracking_id_data.rb +1 -1
  108. data/lib/trieve_ruby_client/models/update_chunk_data.rb +1 -1
  109. data/lib/trieve_ruby_client/models/update_chunk_group_data.rb +1 -1
  110. data/lib/trieve_ruby_client/models/update_dataset_request.rb +1 -1
  111. data/lib/trieve_ruby_client/models/update_group_by_tracking_id_data.rb +1 -1
  112. data/lib/trieve_ruby_client/models/update_organization_data.rb +1 -1
  113. data/lib/trieve_ruby_client/models/update_topic_data.rb +1 -1
  114. data/lib/trieve_ruby_client/models/update_user_org_role_data.rb +1 -1
  115. data/lib/trieve_ruby_client/models/upload_file_data.rb +1 -1
  116. data/lib/trieve_ruby_client/models/upload_file_result.rb +1 -1
  117. data/lib/trieve_ruby_client/models/user_organization.rb +1 -1
  118. data/lib/trieve_ruby_client/version.rb +2 -2
  119. data/lib/trieve_ruby_client.rb +1 -1
  120. data/openapi-generator.yaml +1 -1
  121. data/openapi.json +38 -33
  122. data/spec/spec_helper.rb +1 -1
  123. data/trieve_ruby_client-0.8.0.gem +0 -0
  124. data/trieve_ruby_client.gemspec +1 -1
  125. metadata +3 -2
data/openapi.json CHANGED
@@ -12,7 +12,7 @@
12
12
  "name": "BSL",
13
13
  "url": "https://github.com/devflowinc/trieve/blob/main/LICENSE.txt"
14
14
  },
15
- "version": "0.8.0"
15
+ "version": "0.8.2"
16
16
  },
17
17
  "servers": [
18
18
  {
@@ -4266,11 +4266,13 @@
4266
4266
  },
4267
4267
  "ChunkData": {
4268
4268
  "type": "object",
4269
+ "required": [
4270
+ "chunk_html"
4271
+ ],
4269
4272
  "properties": {
4270
4273
  "chunk_html": {
4271
4274
  "type": "string",
4272
- "description": "HTML content of the chunk. This can also be plaintext. The innerText of the HTML will be used to create the embedding vector. The point of using HTML is for convienience, as some users have applications where users submit HTML content.",
4273
- "nullable": true
4275
+ "description": "HTML content of the chunk. This can also be plaintext. The innerText of the HTML will be used to create the embedding vector. The point of using HTML is for convienience, as some users have applications where users submit HTML content."
4274
4276
  },
4275
4277
  "chunk_vector": {
4276
4278
  "type": "array",
@@ -4573,7 +4575,6 @@
4573
4575
  "type": "object",
4574
4576
  "required": [
4575
4577
  "id",
4576
- "content",
4577
4578
  "created_at",
4578
4579
  "updated_at",
4579
4580
  "dataset_id",
@@ -4584,9 +4585,6 @@
4584
4585
  "type": "string",
4585
4586
  "nullable": true
4586
4587
  },
4587
- "content": {
4588
- "type": "string"
4589
- },
4590
4588
  "created_at": {
4591
4589
  "type": "string",
4592
4590
  "format": "date-time"
@@ -4643,7 +4641,6 @@
4643
4641
  },
4644
4642
  "example": {
4645
4643
  "chunk_html": "<p>Hello, world!</p>",
4646
- "content": "Hello, world!",
4647
4644
  "created_at": "2021-01-01T00:00:00",
4648
4645
  "dataset_id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
4649
4646
  "id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
@@ -4663,7 +4660,6 @@
4663
4660
  "type": "object",
4664
4661
  "required": [
4665
4662
  "id",
4666
- "content",
4667
4663
  "created_at",
4668
4664
  "updated_at",
4669
4665
  "dataset_id",
@@ -4675,9 +4671,6 @@
4675
4671
  "type": "string",
4676
4672
  "nullable": true
4677
4673
  },
4678
- "content": {
4679
- "type": "string"
4680
- },
4681
4674
  "created_at": {
4682
4675
  "type": "string",
4683
4676
  "format": "date-time"
@@ -5761,6 +5754,14 @@
5761
5754
  "type": "string",
5762
5755
  "format": "uuid"
5763
5756
  },
5757
+ "group_name": {
5758
+ "type": "string",
5759
+ "nullable": true
5760
+ },
5761
+ "group_tracking_id": {
5762
+ "type": "string",
5763
+ "nullable": true
5764
+ },
5764
5765
  "metadata": {
5765
5766
  "type": "array",
5766
5767
  "items": {
@@ -5770,6 +5771,8 @@
5770
5771
  },
5771
5772
  "example": {
5772
5773
  "group_id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
5774
+ "group_name": "Example Group",
5775
+ "group_tracking_id": "example_tracking_id",
5773
5776
  "metadata": [
5774
5777
  {
5775
5778
  "metadata": [
@@ -6170,7 +6173,7 @@
6170
6173
  },
6171
6174
  "slim_chunks": {
6172
6175
  "type": "boolean",
6173
- "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement. Default is false.",
6176
+ "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement (typicall 10-50ms). Default is false.",
6174
6177
  "nullable": true
6175
6178
  },
6176
6179
  "strategy": {
@@ -6246,7 +6249,7 @@
6246
6249
  },
6247
6250
  "slim_chunks": {
6248
6251
  "type": "boolean",
6249
- "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement. Default is false.",
6252
+ "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement (typicall 10-50ms). Default is false.",
6250
6253
  "nullable": true
6251
6254
  },
6252
6255
  "strategy": {
@@ -6378,11 +6381,6 @@
6378
6381
  "query"
6379
6382
  ],
6380
6383
  "properties": {
6381
- "date_bias": {
6382
- "type": "boolean",
6383
- "description": "Set date_bias to true to bias search results towards more recent chunks. This will work best in hybrid search mode.",
6384
- "nullable": true
6385
- },
6386
6384
  "filters": {
6387
6385
  "allOf": [
6388
6386
  {
@@ -6398,7 +6396,7 @@
6398
6396
  },
6399
6397
  "get_total_pages": {
6400
6398
  "type": "boolean",
6401
- "description": "Get total page count for the query accounting for the applied filters. Defaults to true, but can be set to false to reduce latency in edge cases performance.",
6399
+ "description": "Get total page count for the query accounting for the applied filters. Defaults to false, but can be set to true when the latency penalty is acceptable (typically 50-200ms).",
6402
6400
  "nullable": true
6403
6401
  },
6404
6402
  "highlight_delimiters": {
@@ -6411,7 +6409,7 @@
6411
6409
  },
6412
6410
  "highlight_results": {
6413
6411
  "type": "boolean",
6414
- "description": "Set highlight_results to true to highlight the results. If not specified, this defaults to true.",
6412
+ "description": "Set highlight_results to false for a slight latency improvement (1-10ms). If not specified, this defaults to true. This will add <b><mark> tags to the chunk_html of the chunks to highlight matching sub-sentences.",
6415
6413
  "nullable": true
6416
6414
  },
6417
6415
  "page": {
@@ -6432,6 +6430,12 @@
6432
6430
  "type": "string",
6433
6431
  "description": "Query is the search query. This can be any string. The query will be used to create an embedding vector and/or SPLADE vector which will be used to find the result set."
6434
6432
  },
6433
+ "recency_bias": {
6434
+ "type": "number",
6435
+ "format": "float",
6436
+ "description": "Recency Bias lets you determine how much of an effect the recency of chunks will have on the search results. If not specified, this defaults to 0.0. We recommend setting this to 1.0 for a gentle reranking of the results, >3.0 for a strong reranking of the results.",
6437
+ "nullable": true
6438
+ },
6435
6439
  "score_threshold": {
6436
6440
  "type": "number",
6437
6441
  "format": "float",
@@ -6444,7 +6448,7 @@
6444
6448
  },
6445
6449
  "slim_chunks": {
6446
6450
  "type": "boolean",
6447
- "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement. Default is false.",
6451
+ "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement (typicall 10-50ms). Default is false.",
6448
6452
  "nullable": true
6449
6453
  },
6450
6454
  "use_weights": {
@@ -6559,7 +6563,7 @@
6559
6563
  },
6560
6564
  "get_total_pages": {
6561
6565
  "type": "boolean",
6562
- "description": "Get total page count for the query accounting for the applied filters. Defaults to true, but can be set to false to reduce latency in edge cases performance.",
6566
+ "description": "Get total page count for the query accounting for the applied filters. Defaults to false, but can be set to true when the latency penalty is acceptable (typically 50-200ms).",
6563
6567
  "nullable": true
6564
6568
  },
6565
6569
  "group_size": {
@@ -6579,7 +6583,7 @@
6579
6583
  },
6580
6584
  "highlight_results": {
6581
6585
  "type": "boolean",
6582
- "description": "Set highlight_results to true to highlight the results. If not specified, this defaults to true.",
6586
+ "description": "Set highlight_results to false for a slight latency improvement (1-10ms). If not specified, this defaults to true. This will add <b><mark> tags to the chunk_html of the chunks to highlight matching sub-sentences.",
6583
6587
  "nullable": true
6584
6588
  },
6585
6589
  "page": {
@@ -6612,7 +6616,7 @@
6612
6616
  },
6613
6617
  "slim_chunks": {
6614
6618
  "type": "boolean",
6615
- "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement. Default is false.",
6619
+ "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement (typicall 10-50ms). Default is false.",
6616
6620
  "nullable": true
6617
6621
  }
6618
6622
  }
@@ -6681,11 +6685,6 @@
6681
6685
  "search_type"
6682
6686
  ],
6683
6687
  "properties": {
6684
- "date_bias": {
6685
- "type": "boolean",
6686
- "description": "Set date_bias to true to bias search results towards more recent chunks. This will work best in hybrid search mode.",
6687
- "nullable": true
6688
- },
6689
6688
  "filters": {
6690
6689
  "allOf": [
6691
6690
  {
@@ -6696,7 +6695,7 @@
6696
6695
  },
6697
6696
  "get_total_pages": {
6698
6697
  "type": "boolean",
6699
- "description": "Get total page count for the query accounting for the applied filters. Defaults to true, but can be set to false to reduce latency in edge cases performance.",
6698
+ "description": "Get total page count for the query accounting for the applied filters. Defaults to false, but can be set to true when the latency penalty is acceptable (typically 50-200ms).",
6700
6699
  "nullable": true
6701
6700
  },
6702
6701
  "group_id": {
@@ -6720,7 +6719,7 @@
6720
6719
  },
6721
6720
  "highlight_results": {
6722
6721
  "type": "boolean",
6723
- "description": "Set highlight_results to true to highlight the results. If not specified, this defaults to true.",
6722
+ "description": "Set highlight_results to false for a slight latency improvement (1-10ms). If not specified, this defaults to true. This will add <b><mark> tags to the chunk_html of the chunks to highlight matching sub-sentences.",
6724
6723
  "nullable": true
6725
6724
  },
6726
6725
  "page": {
@@ -6741,6 +6740,12 @@
6741
6740
  "type": "string",
6742
6741
  "description": "The query is the search query. This can be any string. The query will be used to create an embedding vector and/or SPLADE vector which will be used to find the result set."
6743
6742
  },
6743
+ "recency_bias": {
6744
+ "type": "number",
6745
+ "format": "float",
6746
+ "description": "Recency Bias lets you determine how much of an effect the recency of chunks will have on the search results. If not specified, this defaults to 0.0.",
6747
+ "nullable": true
6748
+ },
6744
6749
  "score_threshold": {
6745
6750
  "type": "number",
6746
6751
  "format": "float",
@@ -6753,7 +6758,7 @@
6753
6758
  },
6754
6759
  "slim_chunks": {
6755
6760
  "type": "boolean",
6756
- "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement. Default is false.",
6761
+ "description": "Set slim_chunks to true to avoid returning the content and chunk_html of the chunks. This is useful for when you want to reduce amount of data over the wire for latency improvement (typicall 10-50ms). Default is false.",
6757
6762
  "nullable": true
6758
6763
  },
6759
6764
  "use_weights": {
data/spec/spec_helper.rb CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  #Trieve OpenAPI Specification. This document describes all of the operations available through the Trieve API.
5
5
 
6
- The version of the OpenAPI document: 0.8.0
6
+ The version of the OpenAPI document: 0.8.2
7
7
  Contact: developers@trieve.ai
8
8
  Generated by: https://openapi-generator.tech
9
9
  Generator version: 7.4.0
Binary file
@@ -5,7 +5,7 @@
5
5
 
6
6
  #Trieve OpenAPI Specification. This document describes all of the operations available through the Trieve API.
7
7
 
8
- The version of the OpenAPI document: 0.8.0
8
+ The version of the OpenAPI document: 0.8.2
9
9
  Contact: developers@trieve.ai
10
10
  Generated by: https://openapi-generator.tech
11
11
  Generator version: 7.4.0
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: trieve_ruby_client
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.8.0
4
+ version: 0.8.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Trieve
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-05-08 00:00:00.000000000 Z
11
+ date: 2024-05-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: typhoeus
@@ -435,6 +435,7 @@ files:
435
435
  - trieve_ruby_client-0.6.9.gem
436
436
  - trieve_ruby_client-0.7.2.gem
437
437
  - trieve_ruby_client-0.7.6.gem
438
+ - trieve_ruby_client-0.8.0.gem
438
439
  - trieve_ruby_client.gemspec
439
440
  homepage: https://trieve.ai
440
441
  licenses: