trieve_ruby_client 0.8.2 → 0.11.0

data/docs/SearchOverGroupsResults.md

@@ -4,8 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **group_chunks** | [**Array<GroupScoreChunk>**](GroupScoreChunk.md) |  |  |
-| **total_chunk_pages** | **Integer** |  |  |
+| **chunks** | [**Array<ScoreChunk>**](ScoreChunk.md) |  |  |
+| **file_id** | **String** |  | [optional] |
+| **group** | [**ChunkGroup**](ChunkGroup.md) |  |  |
 
 ## Example
 
@@ -13,8 +14,9 @@
 require 'trieve_ruby_client'
 
 instance = TrieveRubyClient::SearchOverGroupsResults.new(
-  group_chunks: null,
-  total_chunk_pages: null
+  chunks: null,
+  file_id: null,
+  group: null
 )
 ```
 

data/docs/SearchQueries.md

@@ -0,0 +1,26 @@
+# TrieveRubyClient::SearchQueries
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **filter** | [**SearchAnalyticsFilter**](SearchAnalyticsFilter.md) |  | [optional] |
+| **page** | **Integer** |  | [optional] |
+| **sort_by** | [**SortBy**](SortBy.md) |  | [optional] |
+| **sort_order** | [**SortOrder**](SortOrder.md) |  | [optional] |
+| **type** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchQueries.new(
+  filter: null,
+  page: null,
+  sort_by: null,
+  sort_order: null,
+  type: null
+)
+```
+

data/docs/SearchQueryEvent.md

@@ -0,0 +1,34 @@
+# TrieveRubyClient::SearchQueryEvent
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **String** |  |  |
+| **dataset_id** | **String** |  |  |
+| **id** | **String** |  |  |
+| **latency** | **Float** |  |  |
+| **query** | **String** |  |  |
+| **request_params** | **String** |  |  |
+| **results** | [**Array<SearchResultType>**](SearchResultType.md) |  |  |
+| **search_type** | **String** |  |  |
+| **top_score** | **Float** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchQueryEvent.new(
+  created_at: null,
+  dataset_id: null,
+  id: null,
+  latency: null,
+  query: null,
+  request_params: null,
+  results: null,
+  search_type: null,
+  top_score: null
+)
+```
+

data/docs/SearchQueryResponse.md

@@ -0,0 +1,18 @@
+# TrieveRubyClient::SearchQueryResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **queries** | [**Array<SearchQueryEvent>**](SearchQueryEvent.md) |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchQueryResponse.new(
+  queries: null
+)
+```
+

data/docs/SearchRPSGraph.md

@@ -0,0 +1,20 @@
+# TrieveRubyClient::SearchRPSGraph
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **average_rps** | **Float** |  |  |
+| **time_stamp** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchRPSGraph.new(
+  average_rps: null,
+  time_stamp: null
+)
+```
+

data/docs/SearchResponseBody.md

@@ -0,0 +1,20 @@
+# TrieveRubyClient::SearchResponseBody
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **chunks** | [**Array<ScoreChunk>**](ScoreChunk.md) |  |  |
+| **total_pages** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchResponseBody.new(
+  chunks: null,
+  total_pages: null
+)
+```
+

data/docs/SearchResponseTypes.md

@@ -0,0 +1,49 @@
+# TrieveRubyClient::SearchResponseTypes
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'trieve_ruby_client'
+
+TrieveRubyClient::SearchResponseTypes.openapi_one_of
+# =>
+# [
+#   :'SearchChunkQueryResponseBody',
+#   :'SearchResponseBody'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'trieve_ruby_client'
+
+TrieveRubyClient::SearchResponseTypes.build(data)
+# => #<SearchChunkQueryResponseBody:0x00007fdd4aab02a0>
+
+TrieveRubyClient::SearchResponseTypes.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `SearchChunkQueryResponseBody`
+- `SearchResponseBody`
+- `nil` (if no type matches)
+

data/docs/SearchResultType.md

@@ -0,0 +1,49 @@
+# TrieveRubyClient::SearchResultType
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'trieve_ruby_client'
+
+TrieveRubyClient::SearchResultType.openapi_one_of
+# =>
+# [
+#   :'GroupScoreChunk',
+#   :'ScoreChunkDTO'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'trieve_ruby_client'
+
+TrieveRubyClient::SearchResultType.build(data)
+# => #<GroupScoreChunk:0x00007fdd4aab02a0>
+
+TrieveRubyClient::SearchResultType.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `GroupScoreChunk`
+- `ScoreChunkDTO`
+- `nil` (if no type matches)
+

data/docs/SearchType.md

@@ -0,0 +1,15 @@
+# TrieveRubyClient::SearchType
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchType.new()
+```
+

data/docs/SearchTypeCount.md

@@ -0,0 +1,22 @@
+# TrieveRubyClient::SearchTypeCount
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **search_count** | **Integer** |  |  |
+| **search_method** | **String** |  |  |
+| **search_type** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchTypeCount.new(
+  search_count: null,
+  search_method: null,
+  search_type: null
+)
+```
+

data/docs/SearchWithinGroupData.md

@@ -8,15 +8,22 @@
 | **get_total_pages** | **Boolean** | 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). | [optional] |
 | **group_id** | **String** | Group specifies the group to search within. Results will only consist of chunks which are bookmarks within the specified group. | [optional] |
 | **group_tracking_id** | **String** | Group_tracking_id specifies the group to search within by tracking id. Results will only consist of chunks which are bookmarks within the specified group. If both group_id and group_tracking_id are provided, group_id will be used. | [optional] |
-| **highlight_delimiters** | **Array<String>** | Set highlight_delimiters to a list of strings to use as delimiters for highlighting. If not specified, this defaults to [\"?\", \",\", \".\", \"!\"]. | [optional] |
-| **highlight_results** | **Boolean** | 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. | [optional] |
+| **highlight_delimiters** | **Array<String>** | Set highlight_delimiters to a list of strings to use as delimiters for highlighting. If not specified, this defaults to [\"?\", \",\", \".\", \"!\"]. These are the characters that will be used to split the chunk_html into splits for highlighting. | [optional] |
+| **highlight_max_length** | **Integer** | Set highlight_max_length to control the maximum number of tokens (typically whitespace separated strings, but sometimes also word stems) which can be present within a single highlight. If not specified, this defaults to 8. This is useful to shorten large splits which may have low scores due to length compared to the query. Set to something very large like 100 to highlight entire splits. | [optional] |
+| **highlight_max_num** | **Integer** | Set highlight_max_num to control the maximum number of highlights per chunk. If not specified, this defaults to 3. It may be less than 3 if no snippets score above the highlight_threshold. | [optional] |
+| **highlight_results** | **Boolean** | 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 splits and return the highlights on each scored chunk in the response. | [optional] |
+| **highlight_threshold** | **Float** | Set highlight_threshold to a lower or higher value to adjust the sensitivity of the highlights applied to the chunk html. If not specified, this defaults to 0.8. The range is 0.0 to 1.0. | [optional] |
+| **highlight_window** | **Integer** | Set highlight_window to a number to control the amount of words that are returned around the matched phrases. If not specified, this defaults to 0. This is useful for when you want to show more context around the matched words. When specified, window/2 whitespace separated words are added before and after each highlight in the response's highlights array. If an extended highlight overlaps with another highlight, the overlapping words are only included once. | [optional] |
+| **location_bias** | [**GeoInfoWithBias**](GeoInfoWithBias.md) |  | [optional] |
 | **page** | **Integer** | The page of chunks to fetch. Page is 1-indexed. | [optional] |
 | **page_size** | **Integer** | The page size is the number of chunks to fetch. This can be used to fetch more than 10 chunks at a time. | [optional] |
 | **query** | **String** | 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. |  |
 | **recency_bias** | **Float** | 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. | [optional] |
-| **score_threshold** | **Float** | Set score_threshold to a float to filter out chunks with a score below the threshold. | [optional] |
-| **search_type** | **String** | Search_type can be either \"semantic\", \"fulltext\", or \"hybrid\". \"hybrid\" will pull in one page (10 chunks) of both semantic and full-text results then re-rank them using BAAI/bge-reranker-large. \"semantic\" will pull in one page (10 chunks) of the nearest cosine distant vectors. \"fulltext\" will pull in one page (10 chunks) of full-text results based on SPLADE. |  |
+| **score_threshold** | **Float** | Set score_threshold to a float to filter out chunks with a score below the threshold. This threshold applies before weight and bias modifications. If not specified, this defaults to 0.0. | [optional] |
+| **search_type** | [**SearchMethod**](SearchMethod.md) |  |  |
 | **slim_chunks** | **Boolean** | 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. | [optional] |
+| **tag_weights** | **Hash<String, Float>** | Tag weights is a JSON object which can be used to boost the ranking of chunks with certain tags. This is useful for when you want to be able to bias towards chunks with a certain tag on the fly. The keys are the tag names and the values are the weights. | [optional] |
+| **use_reranker** | **Boolean** | If true, chunks will be reranked using scores from a cross encoder model. \"hybrid\" search will always use the reranker regardless of this setting. | [optional] |
 | **use_weights** | **Boolean** | Set use_weights to true to use the weights of the chunks in the result set in order to sort them. If not specified, this defaults to true. | [optional] |
 
 ## Example
@@ -30,7 +37,12 @@ instance = TrieveRubyClient::SearchWithinGroupData.new(
   group_id: null,
   group_tracking_id: null,
   highlight_delimiters: null,
+  highlight_max_length: null,
+  highlight_max_num: null,
   highlight_results: null,
+  highlight_threshold: null,
+  highlight_window: null,
+  location_bias: null,
   page: null,
   page_size: null,
   query: null,
@@ -38,6 +50,8 @@ instance = TrieveRubyClient::SearchWithinGroupData.new(
   score_threshold: null,
   search_type: null,
   slim_chunks: null,
+  tag_weights: null,
+  use_reranker: null,
   use_weights: null
 )
 ```

data/docs/SearchWithinGroupResponseBody.md

@@ -0,0 +1,20 @@
+# TrieveRubyClient::SearchWithinGroupResponseBody
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **chunks** | [**Array<ScoreChunk>**](ScoreChunk.md) |  |  |
+| **total_pages** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SearchWithinGroupResponseBody.new(
+  chunks: null,
+  total_pages: null
+)
+```
+

data/docs/SearchWithinGroupResults.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **bookmarks** | [**Array<ScoreChunkDTO>**](ScoreChunkDTO.md) |  |  |
-| **group** | [**ChunkGroup**](ChunkGroup.md) |  |  |
+| **group** | [**ChunkGroupAndFileId**](ChunkGroupAndFileId.md) |  |  |
 | **total_pages** | **Integer** |  |  |
 
 ## Example

data/docs/SetUserApiKeyRequest.md

@@ -4,7 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **dataset_ids** | **Array<String>** | The dataset ids which the api key will have access to. If not provided or empty, the api key will have access to all datasets the auth'ed user has access to. If both dataset_ids and organization_ids are provided, the api key will have access to the intersection of the datasets and organizations. | [optional] |
 | **name** | **String** | The name which will be assigned to the new api key. |  |
+| **organization_ids** | **Array<String>** | The organization ids which the api key will have access to. If not provided or empty, the api key will have access to all organizations the auth'ed user has access to. | [optional] |
 | **role** | **Integer** | The role which will be assigned to the new api key. Either 0 (read), 1 (read and write at the level of the currently auth'ed user). The auth'ed user must have a role greater than or equal to the role being assigned which means they must be an admin (1) or owner (2) of the organization to assign write permissions with a role of 1. |  |
 
 ## Example
@@ -13,7 +15,9 @@
 require 'trieve_ruby_client'
 
 instance = TrieveRubyClient::SetUserApiKeyRequest.new(
+  dataset_ids: null,
   name: null,
+  organization_ids: null,
   role: null
 )
 ```

data/docs/SlimChunkMetadata.md

@@ -7,10 +7,12 @@
 | **created_at** | **Time** |  |  |
 | **dataset_id** | **String** |  |  |
 | **id** | **String** |  |  |
+| **image_urls** | **Array<String>** |  | [optional] |
 | **link** | **String** |  | [optional] |
 | **location** | [**GeoInfo**](GeoInfo.md) |  | [optional] |
 | **metadata** | **Object** |  | [optional] |
-| **qdrant_point_id** | **String** |  | [optional] |
+| **num_value** | **Float** |  | [optional] |
+| **qdrant_point_id** | **String** |  |  |
 | **tag_set** | **String** |  | [optional] |
 | **time_stamp** | **Time** |  | [optional] |
 | **tracking_id** | **String** |  | [optional] |
@@ -26,9 +28,11 @@ instance = TrieveRubyClient::SlimChunkMetadata.new(
   created_at: null,
   dataset_id: null,
   id: null,
+  image_urls: null,
   link: null,
   location: null,
   metadata: null,
+  num_value: null,
   qdrant_point_id: null,
   tag_set: null,
   time_stamp: null,

data/docs/SlimChunkMetadataWithArrayTagSet.md

@@ -0,0 +1,44 @@
+# TrieveRubyClient::SlimChunkMetadataWithArrayTagSet
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **created_at** | **Time** |  |  |
+| **dataset_id** | **String** |  |  |
+| **id** | **String** |  |  |
+| **image_urls** | **Array<String>** |  | [optional] |
+| **link** | **String** |  | [optional] |
+| **location** | [**GeoInfo**](GeoInfo.md) |  | [optional] |
+| **metadata** | **Object** |  | [optional] |
+| **num_value** | **Float** |  | [optional] |
+| **qdrant_point_id** | **String** |  |  |
+| **tag_set** | **Array<String>** |  | [optional] |
+| **time_stamp** | **Time** |  | [optional] |
+| **tracking_id** | **String** |  | [optional] |
+| **updated_at** | **Time** |  |  |
+| **weight** | **Float** |  |  |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SlimChunkMetadataWithArrayTagSet.new(
+  created_at: null,
+  dataset_id: null,
+  id: null,
+  image_urls: null,
+  link: null,
+  location: null,
+  metadata: null,
+  num_value: null,
+  qdrant_point_id: null,
+  tag_set: null,
+  time_stamp: null,
+  tracking_id: null,
+  updated_at: null,
+  weight: null
+)
+```
+

data/docs/SlimChunkMetadataWithScore.md

@@ -8,7 +8,7 @@
 | **id** | **String** |  |  |
 | **link** | **String** |  | [optional] |
 | **metadata** | **Object** |  | [optional] |
-| **qdrant_point_id** | **String** |  | [optional] |
+| **qdrant_point_id** | **String** |  |  |
 | **score** | **Float** |  |  |
 | **tag_set** | **String** |  | [optional] |
 | **time_stamp** | **Time** |  | [optional] |

data/docs/SortBy.md

@@ -0,0 +1,15 @@
+# TrieveRubyClient::SortBy
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SortBy.new()
+```
+

data/docs/SortOrder.md

@@ -0,0 +1,15 @@
+# TrieveRubyClient::SortOrder
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+
+## Example
+
+```ruby
+require 'trieve_ruby_client'
+
+instance = TrieveRubyClient::SortOrder.new()
+```
+