h2ogpte 1.6.52rc1__py3-none-any.whl → 1.6.53rc2__py3-none-any.whl

h2ogpte/__init__.py

@@ -3,7 +3,7 @@ from h2ogpte.h2ogpte import H2OGPTE
 from h2ogpte.h2ogpte_async import H2OGPTEAsync
 from h2ogpte.session_async import SessionAsync
 
-__version__ = "1.6.52rc1"
+__version__ = "1.6.53rc2"
 
 __all__ = [
     "H2OGPTE",

h2ogpte/h2ogpte.py

@@ -2745,7 +2745,20 @@ class H2OGPTE(H2OGPTESyncBase):
             handwriting_check:
                 Check pages for handwriting. Will use specialized models if handwriting is found.
             metadata:
-                Metadata to be associated with the document.
+                Dictionary mapping upload_ids to their metadata. Each key must be an upload_id
+                from the upload_ids list, and each value is a dictionary of metadata key-value
+                pairs to associate with that document.
+
+                Example::
+
+                    # Single document
+                    metadata = {upload_id: {"category": "reports", "year": "2024"}}
+
+                    # Multiple documents
+                    metadata = {
+                        upload_id_1: {"category": "reports"},
+                        upload_id_2: {"category": "invoices"}
+                    }
             timeout:
                 Timeout in seconds.
             ingest_mode:
@@ -7138,6 +7151,41 @@ class H2OGPTE(H2OGPTESyncBase):
     def add_custom_agent_tool(
         self, tool_type: str, tool_args: dict, custom_tool_path: Optional[str] = None
     ) -> list:
+        """Adds a custom agent tool.
+
+        Args:
+            tool_type: The type of custom tool being added. Valid values:
+                - 'local_mcp': Model Context Protocol server running locally
+                - 'remote_mcp': Model Context Protocol server running remotely
+                - 'browser_action': Custom browser automation actions
+                - 'general_code': General purpose code execution tools
+
+            tool_args: Dictionary containing tool-specific arguments. Structure varies by tool_type:
+
+                For 'remote_mcp':
+                {
+                    "mcp_config_json": "JSON string with MCP server configuration",
+                    "enable_by_default": True/False (optional, defaults to True)
+                }
+
+                For 'local_mcp', 'browser_action', and 'general_code':
+                {
+                    "tool_name": "string (optional, defaults to filename without extension)",
+                    "description": "string (optional, tool description)",
+                    "enable_by_default": True/False (optional, defaults to True),
+                    "should_unzip": True/False (optional, for general_code .zip files only),
+                    "tool_usage_mode": ["runner", "creator"] (optional list of strings, for remote_mcp)
+                }
+
+            custom_tool_path: Path to the tool file to upload (optional). Requirements vary by tool_type:
+                - 'local_mcp': .zip file containing MCP server code
+                - 'remote_mcp': Optional .json file with MCP configuration
+                - 'browser_action': .py file (must start with 'browser_') or .zip containing browser action scripts
+                - 'general_code': .py or .zip file with custom code
+
+        Returns:
+            list: List of created custom agent tool IDs
+        """
         header = self._get_auth_header()
         custom_tool_path = str(custom_tool_path) if custom_tool_path else None
         with self._RESTClient(self) as rest_client:

h2ogpte/h2ogpte_async.py

@@ -2943,7 +2943,20 @@ class H2OGPTEAsync:
             handwriting_check:
                 Check pages for handwriting. Will use specialized models if handwriting is found.
             metadata:
-                Metadata to be associated with the document.
+                Dictionary mapping upload_ids to their metadata. Each key must be an upload_id
+                from the upload_ids list, and each value is a dictionary of metadata key-value
+                pairs to associate with that document.
+
+                Example::
+
+                    # Single document
+                    metadata = {upload_id: {"category": "reports", "year": "2024"}}
+
+                    # Multiple documents
+                    metadata = {
+                        upload_id_1: {"category": "reports"},
+                        upload_id_2: {"category": "invoices"}
+                    }
             timeout:
                 Timeout in seconds.
             ingest_mode:
@@ -7393,6 +7406,41 @@ class H2OGPTEAsync:
     async def add_custom_agent_tool(
         self, tool_type: str, tool_args: dict, custom_tool_path: Optional[str] = None
     ) -> list:
+        """Adds a custom agent tool.
+
+        Args:
+            tool_type: The type of custom tool being added. Valid values:
+                - 'local_mcp': Model Context Protocol server running locally
+                - 'remote_mcp': Model Context Protocol server running remotely
+                - 'browser_action': Custom browser automation actions
+                - 'general_code': General purpose code execution tools
+
+            tool_args: Dictionary containing tool-specific arguments. Structure varies by tool_type:
+
+                For 'remote_mcp':
+                {
+                    "mcp_config_json": "JSON string with MCP server configuration",
+                    "enable_by_default": True/False (optional, defaults to True)
+                }
+
+                For 'local_mcp', 'browser_action', and 'general_code':
+                {
+                    "tool_name": "string (optional, defaults to filename without extension)",
+                    "description": "string (optional, tool description)",
+                    "enable_by_default": True/False (optional, defaults to True),
+                    "should_unzip": True/False (optional, for general_code .zip files only),
+                    "tool_usage_mode": ["runner", "creator"] (optional list of strings, for remote_mcp)
+                }
+
+            custom_tool_path: Path to the tool file to upload (optional). Requirements vary by tool_type:
+                - 'local_mcp': .zip file containing MCP server code
+                - 'remote_mcp': Optional .json file with MCP configuration
+                - 'browser_action': .py file (must start with 'browser_') or .zip containing browser action scripts
+                - 'general_code': .py or .zip file with custom code
+
+        Returns:
+            list: List of created custom agent tool IDs
+        """
         header = await self._get_auth_header()
         custom_tool_path = str(custom_tool_path) if custom_tool_path else None
         async with self._RESTClient(self) as rest_client:

h2ogpte/rest_async/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "1.6.52-dev1"
+__version__ = "1.6.53-dev2"
 
 # import apis into sdk package
 from h2ogpte.rest_async.api.api_keys_api import APIKeysApi

h2ogpte/rest_async/api/agents_api.py

@@ -16,7 +16,7 @@ from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
 from typing import Any, Dict, List, Optional, Tuple, Union
 from typing_extensions import Annotated
 
-from pydantic import Field, StrictBytes, StrictInt, StrictStr
+from pydantic import Field, StrictBytes, StrictInt, StrictStr, field_validator
 from typing import List, Optional, Tuple, Union
 from typing_extensions import Annotated
 from h2ogpte.rest_async.models.add_custom_agent_tool201_response_inner import AddCustomAgentTool201ResponseInner
@@ -54,11 +54,11 @@ class AgentsApi:
     @validate_call
     async def add_custom_agent_tool(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -76,15 +76,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -138,11 +138,11 @@ class AgentsApi:
     @validate_call
     async def add_custom_agent_tool_with_http_info(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -160,15 +160,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -222,11 +222,11 @@ class AgentsApi:
     @validate_call
     async def add_custom_agent_tool_without_preload_content(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -244,15 +244,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request

h2ogpte/rest_async/api_client.py

@@ -90,7 +90,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/1.6.52-dev1/python'
+        self.user_agent = 'OpenAPI-Generator/1.6.53-dev2/python'
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

h2ogpte/rest_async/configuration.py

@@ -499,7 +499,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: v1.0.0\n"\
-               "SDK Package Version: 1.6.52-dev1".\
+               "SDK Package Version: 1.6.53-dev2".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

h2ogpte/rest_async/models/chat_settings.py

@@ -41,8 +41,8 @@ class ChatSettings(BaseModel):
         if value is None:
             return value
 
-        if value not in set(['true', 'false', 'auto']):
-            raise ValueError("must be one of enum values ('true', 'false', 'auto')")
+        if value not in set(['on', 'off', 'auto']):
+            raise ValueError("must be one of enum values ('on', 'off', 'auto')")
         return value
 
     model_config = ConfigDict(

h2ogpte/rest_sync/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "1.6.52-dev1"
+__version__ = "1.6.53-dev2"
 
 # import apis into sdk package
 from h2ogpte.rest_sync.api.api_keys_api import APIKeysApi

h2ogpte/rest_sync/api/agents_api.py

@@ -16,7 +16,7 @@ from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
 from typing import Any, Dict, List, Optional, Tuple, Union
 from typing_extensions import Annotated
 
-from pydantic import Field, StrictBytes, StrictInt, StrictStr
+from pydantic import Field, StrictBytes, StrictInt, StrictStr, field_validator
 from typing import List, Optional, Tuple, Union
 from typing_extensions import Annotated
 from h2ogpte.rest_sync.models.add_custom_agent_tool201_response_inner import AddCustomAgentTool201ResponseInner
@@ -54,11 +54,11 @@ class AgentsApi:
     @validate_call
     def add_custom_agent_tool(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -76,15 +76,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -138,11 +138,11 @@ class AgentsApi:
     @validate_call
     def add_custom_agent_tool_with_http_info(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -160,15 +160,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -222,11 +222,11 @@ class AgentsApi:
     @validate_call
     def add_custom_agent_tool_without_preload_content(
         self,
-        tool_type: StrictStr,
-        tool_args: StrictStr,
-        file: Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]] = None,
+        tool_type: Annotated[StrictStr, Field(description="The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools ")],
+        tool_args: Annotated[StrictStr, Field(description="JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) } ")],
+        file: Annotated[Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]], Field(description="The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code ")] = None,
         custom_tool_path: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Optional filename to use when storing the uploaded file")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -244,15 +244,15 @@ class AgentsApi:
 
         Add Custom Agent Tools
 
-        :param tool_type: (required)
+        :param tool_type: The type of custom tool being added: - local_mcp: Model Context Protocol server running locally - remote_mcp: Model Context Protocol server running remotely - browser_action: Custom browser automation actions - general_code: General purpose code execution tools  (required)
         :type tool_type: str
-        :param tool_args: (required)
+        :param tool_args: JSON string containing tool-specific arguments. The structure varies by tool_type:  For remote_mcp: {   \\\"mcp_config_json\\\": \\\"JSON string with MCP server configuration\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true) }  For local_mcp, browser_action, and general_code: {   \\\"tool_name\\\": \\\"string (optional, defaults to filename without extension)\\\",   \\\"description\\\": \\\"string (optional, tool description)\\\",   \\\"enable_by_default\\\": true/false (optional, defaults to true),   \\\"should_unzip\\\": true/false (optional, for general_code .zip files only),   \\\"tool_usage_mode\\\": [\\\"runner\\\", \\\"creator\\\"] (optional list of strings) }  (required)
         :type tool_args: str
-        :param file:
+        :param file: The tool file to upload. Requirements vary by tool_type: - local_mcp: .zip file containing MCP server code - remote_mcp: Optional .json file with MCP configuration - browser_action: .py file (must start with 'browser_') or .zip containing browser action scripts - general_code: .py or .zip file with custom code 
         :type file: bytearray
         :param custom_tool_path:
         :type custom_tool_path: str
-        :param filename:
+        :param filename: Optional filename to use when storing the uploaded file
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request

h2ogpte/rest_sync/api_client.py

@@ -90,7 +90,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/1.6.52-dev1/python'
+        self.user_agent = 'OpenAPI-Generator/1.6.53-dev2/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

h2ogpte/rest_sync/configuration.py

@@ -503,7 +503,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: v1.0.0\n"\
-               "SDK Package Version: 1.6.52-dev1".\
+               "SDK Package Version: 1.6.53-dev2".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

h2ogpte/rest_sync/models/chat_settings.py

@@ -41,8 +41,8 @@ class ChatSettings(BaseModel):
         if value is None:
             return value
 
-        if value not in set(['true', 'false', 'auto']):
-            raise ValueError("must be one of enum values ('true', 'false', 'auto')")
+        if value not in set(['on', 'off', 'auto']):
+            raise ValueError("must be one of enum values ('on', 'off', 'auto')")
         return value
 
     model_config = ConfigDict(

{h2ogpte-1.6.52rc1.dist-info → h2ogpte-1.6.53rc2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: h2ogpte
-Version: 1.6.52rc1
+Version: 1.6.53rc2
 Summary: Client library for Enterprise h2oGPTe
 Author-email: "H2O.ai, Inc." <support@h2o.ai>
 Project-URL: Source, https://github.com/h2oai/h2ogpte

{h2ogpte-1.6.52rc1.dist-info → h2ogpte-1.6.53rc2.dist-info}/RECORD

@@ -1,8 +1,8 @@
-h2ogpte/__init__.py,sha256=s1Z1cuMci106Wj0LLj4bfxr3ZEqP2AlwRMzHg43c8Bk,1524
+h2ogpte/__init__.py,sha256=xqUMOwwbvjsEQ2ppgmYZFh1EvR6dSxs4KB9HfOdOcVo,1524
 h2ogpte/connectors.py,sha256=CRAEpkn9GotcCjWANfJjZ5Hq1cjGWJ4H_IO4eJgVWiI,8466
 h2ogpte/errors.py,sha256=XgLdfJO1fZ9Bf9rhUKpnvRzzvkNyan3Oc6WzGS6hCUA,1248
-h2ogpte/h2ogpte.py,sha256=X0MIQ6JOgHJkCeBhlTwvqrSuom5KFZ3H7DZJN1EWn1w,310278
-h2ogpte/h2ogpte_async.py,sha256=x2KlYVQN0CrNe1N67Of-WDpVDBzw0sIlQm5kQByAGJ4,330175
+h2ogpte/h2ogpte.py,sha256=V1yamOJ29JmjUoEkT7D5iaLRGedMRXnOJZZ0ajInBWU,312669
+h2ogpte/h2ogpte_async.py,sha256=ToWNi7bapDwcF7ELppcTvZoLlH3WtmzGAk8B7hJHFBc,332566
 h2ogpte/h2ogpte_sync_base.py,sha256=ftsVzpMqEsyi0UACMI-7H_EIYEx9JEdEUImbyjWy_Hc,15285
 h2ogpte/session.py,sha256=uyU0QJhTpN9vMfie3hj3S8pvMOLkcJdsnnXrSgCgxqE,32770
 h2ogpte/session_async.py,sha256=F5wg8bIRhdXZNvc_6WLtT1tQUAPVPaKq4bYJDoMCEOA,31738
@@ -41,14 +41,14 @@ h2ogpte/cli/ui/prompts.py,sha256=bJvRe_32KppQTK5bqnsrPh0RS4JaY9KkiV7y-3v8PMQ,538
 h2ogpte/cli/ui/status_bar.py,sha256=hs2MLvkg-y3Aiu3gWRtgMXf3jv3DGe7Y47ucgoBAP7Y,3852
 h2ogpte/cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 h2ogpte/cli/utils/file_manager.py,sha256=ghNDX6G3Dr0vFvBYjbqx5o7qxq-pN8Vo2Rp1vyITfLo,13988
-h2ogpte/rest_async/__init__.py,sha256=uw6g0DS5MqgOvPTeY86cskqX_2y4t5g-JyHsnWGjS1g,15336
-h2ogpte/rest_async/api_client.py,sha256=pVYayYv5Kv-o4Nzty1hCWY7NoZZSvsE8NNei8QEkJ5M,29510
+h2ogpte/rest_async/__init__.py,sha256=UlQIkjqknnVQPEYIh-DME3-JEinp2ab3VQZuCh5jKjk,15336
+h2ogpte/rest_async/api_client.py,sha256=j3veCMCqQhiZlN7tKjke1CPobTZojBZNXGQrLWiyZeY,29510
 h2ogpte/rest_async/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
-h2ogpte/rest_async/configuration.py,sha256=7TBm3lwUWY8_9R5D1C9V6sEscjRpKiE54abjT0zi0n4,19567
+h2ogpte/rest_async/configuration.py,sha256=p2c5TNeM8OqMuqq5OAbn6GOxuPdWB1TIdSjOG_Gt3Zc,19567
 h2ogpte/rest_async/exceptions.py,sha256=aSDc-0lURtyQjf5HGa7_Ta0nATxKxfHW3huDA2Zdj6o,8370
 h2ogpte/rest_async/rest.py,sha256=mdjDwzJ1kiaYtONUfDRqKsRPw5-tG6eyZV2P1yBuwRo,9147
 h2ogpte/rest_async/api/__init__.py,sha256=R_x57GGyaSgxZyrJOyOt551TodbRSQf3T7VrraQc-84,973
-h2ogpte/rest_async/api/agents_api.py,sha256=_-7Y1h3ssEqqgjriUmuDnngbimbVifva75Z7ks3-wNw,177547
+h2ogpte/rest_async/api/agents_api.py,sha256=B96qOwSyjttB1YXIP6GSI7u2k1-MCta5ht0f8JcDmxw,185958
 h2ogpte/rest_async/api/api_keys_api.py,sha256=hgywNjCWaIrhFRJacKuPkJSKDEltIK8B9fi-4xMWLgs,58244
 h2ogpte/rest_async/api/chat_api.py,sha256=bJDJqTIXiTYW4anTkqE4XYuEqRDcRW8LcwlMgXyQQS4,295852
 h2ogpte/rest_async/api/collections_api.py,sha256=kg6ZJyqNtnrqu2Q1cS8S-ViYPjXTEAynE2nlSQ-61HA,649556
@@ -87,7 +87,7 @@ h2ogpte/rest_async/models/chat_message_meta.py,sha256=dgM0NIDSdB6_MN7lEiR4frDFCV
 h2ogpte/rest_async/models/chat_message_reference.py,sha256=P5_jxbgfNcwdzC7OgND27EbVemPKiZay0jsCYn8qqTs,5248
 h2ogpte/rest_async/models/chat_session.py,sha256=RVvL2IvMzIQPJ2W6lheUJyN3i6kaffQ80ox66sivq_M,5199
 h2ogpte/rest_async/models/chat_session_update_request.py,sha256=yiH14-IrQfbZ0qINIAyGgtrmhgDr-E-cmd9_5OVVHKU,4411
-h2ogpte/rest_async/models/chat_settings.py,sha256=95VV_za51NcVzgn5EADwRjPmP8ek4iHWRkOQCSQOlfA,17149
+h2ogpte/rest_async/models/chat_settings.py,sha256=pdXyWx9FC6RZTYRmMBSfO_fO8Djz9j7e_lGvz7dFD7M,17141
 h2ogpte/rest_async/models/chat_settings_tags.py,sha256=W8q1R6hMIXGNOcyc5k-hAOSOUCV7744IOcTsT7SKOU4,7424
 h2ogpte/rest_async/models/chunk.py,sha256=4t2oms4W29WEYKi7KvzCArsLOaCOLYyyQRrJttlDUAU,4759
 h2ogpte/rest_async/models/chunk_search_result.py,sha256=keifMKId0YhLFGzh5nv3jNCtQt7YciiwUd6-DsNckAs,4985
@@ -203,14 +203,14 @@ h2ogpte/rest_async/models/user_deletion_request.py,sha256=z7gD8XKOGwwg782TRzXJii
 h2ogpte/rest_async/models/user_info.py,sha256=ef59Eh9k42JUY3X2RnCrwYR7sc_8lXT1vRLGoNz3uTU,4489
 h2ogpte/rest_async/models/user_job_details.py,sha256=kzu8fLxVsRMgnyt6dLr0VWjlIoE3i1VRpGR9nDxFyk4,4985
 h2ogpte/rest_async/models/user_permission.py,sha256=1k74E7s2kD2waSZ79KPlgTupVYEacTKWMqcKxv2972A,4856
-h2ogpte/rest_sync/__init__.py,sha256=2xI5Yz9d8449PcarRN7xhjzhxNSXGb7WEJbHi9XmA8s,15173
-h2ogpte/rest_sync/api_client.py,sha256=oUbiWrIzN_cbr3Zr4eAdxaQ6EIC74P450i6Jc1yfS7g,29397
+h2ogpte/rest_sync/__init__.py,sha256=ICpDb7V-NKYUU2woCJWyrkFhW5BA4YXZjSigvEcH-R4,15173
+h2ogpte/rest_sync/api_client.py,sha256=3x6DrbIQhYYna6rVhaa3yRO-GuNi9f5xijLRoiPGQBc,29397
 h2ogpte/rest_sync/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
-h2ogpte/rest_sync/configuration.py,sha256=e7Me0Y--qtcrt1ezteLFnuINHMvexKsb9QNPRmsaA5M,19850
+h2ogpte/rest_sync/configuration.py,sha256=iAwY7P5AHwg7vCyPGaIGttOQD-gtUyUWd9D1DD47eDU,19850
 h2ogpte/rest_sync/exceptions.py,sha256=aSDc-0lURtyQjf5HGa7_Ta0nATxKxfHW3huDA2Zdj6o,8370
 h2ogpte/rest_sync/rest.py,sha256=evRzviTYC_fsrpTtFlGvruXmquH9C0jDn-oQrGrE5A0,11314
 h2ogpte/rest_sync/api/__init__.py,sha256=ZuLQQtyiXnP5UOwTlIOYLGLQq1BG_0PEkzC9s698vjM,958
-h2ogpte/rest_sync/api/agents_api.py,sha256=zWzPXtqHbhBe6xVZZKYl93bFLDVzNw2KmAJG5xIW6i0,176763
+h2ogpte/rest_sync/api/agents_api.py,sha256=4dEYWDm3Fcq2n6eF3I9Pl8uzXBDFNK6PQBehcSGChf0,185174
 h2ogpte/rest_sync/api/api_keys_api.py,sha256=MueDC8Z4VUC61IVIBem0kD0Wpgh35MvhoilUtPVLrN0,57997
 h2ogpte/rest_sync/api/chat_api.py,sha256=9DoF08mTxi3D7sYRkvOM76qB4crS13lb5QmTXtJIV1U,294582
 h2ogpte/rest_sync/api/collections_api.py,sha256=DsM57mFCtEn7WjMen3-zbZz_fC0TH1-zttlXJGQwwCs,647030
@@ -249,7 +249,7 @@ h2ogpte/rest_sync/models/chat_message_meta.py,sha256=dgM0NIDSdB6_MN7lEiR4frDFCVZ
 h2ogpte/rest_sync/models/chat_message_reference.py,sha256=P5_jxbgfNcwdzC7OgND27EbVemPKiZay0jsCYn8qqTs,5248
 h2ogpte/rest_sync/models/chat_session.py,sha256=RVvL2IvMzIQPJ2W6lheUJyN3i6kaffQ80ox66sivq_M,5199
 h2ogpte/rest_sync/models/chat_session_update_request.py,sha256=yiH14-IrQfbZ0qINIAyGgtrmhgDr-E-cmd9_5OVVHKU,4411
-h2ogpte/rest_sync/models/chat_settings.py,sha256=Qrkq4iAfK83Ts8oo50UYiA1vX_QHXpzJvF_7LEWFQq0,17148
+h2ogpte/rest_sync/models/chat_settings.py,sha256=RxZrOO_i8HfokuLbgaCtAKkEkKk3OYftkRQfQfjgAdE,17140
 h2ogpte/rest_sync/models/chat_settings_tags.py,sha256=fZoLR7g19bvVz4ChhttflYp36PkUsiEFwwh4A5VFEHk,7423
 h2ogpte/rest_sync/models/chunk.py,sha256=4t2oms4W29WEYKi7KvzCArsLOaCOLYyyQRrJttlDUAU,4759
 h2ogpte/rest_sync/models/chunk_search_result.py,sha256=keifMKId0YhLFGzh5nv3jNCtQt7YciiwUd6-DsNckAs,4985
@@ -365,8 +365,8 @@ h2ogpte/rest_sync/models/user_deletion_request.py,sha256=z7gD8XKOGwwg782TRzXJiiP
 h2ogpte/rest_sync/models/user_info.py,sha256=ef59Eh9k42JUY3X2RnCrwYR7sc_8lXT1vRLGoNz3uTU,4489
 h2ogpte/rest_sync/models/user_job_details.py,sha256=9cbhpgLMDpar-aTOaY5Ygud-8Kbi23cLNldTGab0Sd8,4984
 h2ogpte/rest_sync/models/user_permission.py,sha256=1k74E7s2kD2waSZ79KPlgTupVYEacTKWMqcKxv2972A,4856
-h2ogpte-1.6.52rc1.dist-info/METADATA,sha256=MoKLFcBXgEa0qVyGjc47yLD1dfnov4VNDp-zouYcbkg,8615
-h2ogpte-1.6.52rc1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-h2ogpte-1.6.52rc1.dist-info/entry_points.txt,sha256=BlaqX2SXJanrOGqNYwnzvCxHGNadM7RBI4pW4rVo5z4,54
-h2ogpte-1.6.52rc1.dist-info/top_level.txt,sha256=vXV4JnNwFWFAqTWyHrH-cGIQqbCcEDG9-BbyNn58JpM,8
-h2ogpte-1.6.52rc1.dist-info/RECORD,,
+h2ogpte-1.6.53rc2.dist-info/METADATA,sha256=VrdXthT9GpkouOkKVq-n-KLabKZiZgQSz4HMi_C5ix0,8615
+h2ogpte-1.6.53rc2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+h2ogpte-1.6.53rc2.dist-info/entry_points.txt,sha256=BlaqX2SXJanrOGqNYwnzvCxHGNadM7RBI4pW4rVo5z4,54
+h2ogpte-1.6.53rc2.dist-info/top_level.txt,sha256=vXV4JnNwFWFAqTWyHrH-cGIQqbCcEDG9-BbyNn58JpM,8
+h2ogpte-1.6.53rc2.dist-info/RECORD,,