Merge branch 'main' into fix/runtime-retriever-overrides

Author: vinkiYu

docs-website/reference/integrations-api/oracle.md

@@ -54,6 +54,14 @@ run_async(
 
 Async variant of :meth:`run`.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the synchronous resources of the underlying Document Store.
+
 #### to_dict
 
 ```python
@@ -191,6 +199,14 @@ Initialise the document store and optionally create the backing table and indexe
 - <code>ValueError</code> – If `table_name` is not a valid Oracle identifier or `embedding_dim` is not
   a positive integer.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the associated synchronous resources.
+
 #### create_keyword_index
 
 ```python
@@ -635,7 +651,7 @@ get_metadata_field_unique_values(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -645,10 +661,10 @@ Return a paginated list of distinct values for a metadata field, plus the total
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 
@@ -707,7 +723,7 @@ get_metadata_field_unique_values_async(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -717,10 +733,10 @@ Asynchronously returns a paginated list of distinct values for a metadata field,
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 

docs-website/reference_versioned_docs/version-2.18/integrations-api/oracle.md

@@ -54,6 +54,14 @@ run_async(
 
 Async variant of :meth:`run`.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the synchronous resources of the underlying Document Store.
+
 #### to_dict
 
 ```python
@@ -191,6 +199,14 @@ Initialise the document store and optionally create the backing table and indexe
 - <code>ValueError</code> – If `table_name` is not a valid Oracle identifier or `embedding_dim` is not
   a positive integer.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the associated synchronous resources.
+
 #### create_keyword_index
 
 ```python
@@ -635,7 +651,7 @@ get_metadata_field_unique_values(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -645,10 +661,10 @@ Return a paginated list of distinct values for a metadata field, plus the total
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 
@@ -707,7 +723,7 @@ get_metadata_field_unique_values_async(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -717,10 +733,10 @@ Asynchronously returns a paginated list of distinct values for a metadata field,
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 

docs-website/reference_versioned_docs/version-2.19/integrations-api/oracle.md

@@ -54,6 +54,14 @@ run_async(
 
 Async variant of :meth:`run`.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the synchronous resources of the underlying Document Store.
+
 #### to_dict
 
 ```python
@@ -191,6 +199,14 @@ Initialise the document store and optionally create the backing table and indexe
 - <code>ValueError</code> – If `table_name` is not a valid Oracle identifier or `embedding_dim` is not
   a positive integer.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the associated synchronous resources.
+
 #### create_keyword_index
 
 ```python
@@ -635,7 +651,7 @@ get_metadata_field_unique_values(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -645,10 +661,10 @@ Return a paginated list of distinct values for a metadata field, plus the total
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 
@@ -707,7 +723,7 @@ get_metadata_field_unique_values_async(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -717,10 +733,10 @@ Asynchronously returns a paginated list of distinct values for a metadata field,
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 

docs-website/reference_versioned_docs/version-2.20/integrations-api/oracle.md

@@ -54,6 +54,14 @@ run_async(
 
 Async variant of :meth:`run`.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the synchronous resources of the underlying Document Store.
+
 #### to_dict
 
 ```python
@@ -191,6 +199,14 @@ Initialise the document store and optionally create the backing table and indexe
 - <code>ValueError</code> – If `table_name` is not a valid Oracle identifier or `embedding_dim` is not
   a positive integer.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the associated synchronous resources.
+
 #### create_keyword_index
 
 ```python
@@ -635,7 +651,7 @@ get_metadata_field_unique_values(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -645,10 +661,10 @@ Return a paginated list of distinct values for a metadata field, plus the total
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 
@@ -707,7 +723,7 @@ get_metadata_field_unique_values_async(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -717,10 +733,10 @@ Asynchronously returns a paginated list of distinct values for a metadata field,
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 

docs-website/reference_versioned_docs/version-2.21/integrations-api/oracle.md

@@ -54,6 +54,14 @@ run_async(
 
 Async variant of :meth:`run`.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the synchronous resources of the underlying Document Store.
+
 #### to_dict
 
 ```python
@@ -191,6 +199,14 @@ Initialise the document store and optionally create the backing table and indexe
 - <code>ValueError</code> – If `table_name` is not a valid Oracle identifier or `embedding_dim` is not
   a positive integer.
 
+#### close
+
+```python
+close() -> None
+```
+
+Release the associated synchronous resources.
+
 #### create_keyword_index
 
 ```python
@@ -635,7 +651,7 @@ get_metadata_field_unique_values(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -645,10 +661,10 @@ Return a paginated list of distinct values for a metadata field, plus the total
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**
 
@@ -707,7 +723,7 @@ get_metadata_field_unique_values_async(
     metadata_field: str,
     search_term: str | None = None,
     from_: int = 0,
-    size: int | None = None,
+    size: int | None = 10,
 ) -> tuple[list[str], int]
 ```
 
@@ -717,10 +733,10 @@ Asynchronously returns a paginated list of distinct values for a metadata field,
 
 - **metadata_field** (<code>str</code>) – Metadata field name. May be prefixed with `"meta."`
   (e.g. `"meta.lang"` or `"lang"`).
-- **search_term** (<code>str | None</code>) – Optional substring filter applied to both the document text and the field value.
+- **search_term** (<code>str | None</code>) – Optional case-insensitive substring filter applied to the metadata field's own value.
 - **from\_** (<code>int</code>) – Zero-based offset for pagination. Defaults to `0`.
-- **size** (<code>int | None</code>) – Maximum number of values to return. When `None` all values from `from_` onward
-  are returned.
+- **size** (<code>int | None</code>) – Maximum number of values to return. Defaults to `10`. When `None` all values
+  from `from_` onward are returned.
 
 **Returns:**