qanswer-sdk 0.419.0.dev0__tar.gz → 0.448.0.dev0__tar.gz

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qanswer_sdk
-Version: 0.419.0.dev0
+Version: 0.448.0.dev0
 Summary: Official Python SDK for the QAnswer API
 Home-page: 
 Author: The QA Company
@@ -229,7 +229,7 @@ print(response.answer)
 ## 📌 Versioning
 
 This SDK follows the version of the QAnswer API.
-The current version is: `0.419.0.dev0 (branch: main)`
+The current version is: `0.448.0.dev0 (branch: main)`
 
 ---
 

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/README.md

@@ -204,7 +204,7 @@ print(response.answer)
 ## 📌 Versioning
 
 This SDK follows the version of the QAnswer API.
-The current version is: `0.419.0.dev0 (branch: main)`
+The current version is: `0.448.0.dev0 (branch: main)`
 
 ---
 

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 license = {text = "MIT"}
 name = "qanswer_sdk"
-version = "0.419.0.dev0"
+version = "0.448.0.dev0"
 description = "Official Python SDK for the QAnswer API"
 authors = [{name = "The QA Company"}]
 readme = "README.md"

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.419.0.dev0"
+__version__ = "0.448.0.dev0"
 
 # Define package exports
 __all__ = [
@@ -388,6 +388,9 @@ __all__ = [
     "McpServerDto",
     "McpToolDto",
     "McpToolSelectionSource",
+    "McpToolSyncAction",
+    "McpToolSyncDiff",
+    "McpToolSyncPreview",
     "McpVisibility",
     "MessageRole",
     "MessagesStatsPerDayResponse",
@@ -981,6 +984,9 @@ from qanswer_sdk.models.mcp_server import McpServer as McpServer
 from qanswer_sdk.models.mcp_server_dto import McpServerDto as McpServerDto
 from qanswer_sdk.models.mcp_tool_dto import McpToolDto as McpToolDto
 from qanswer_sdk.models.mcp_tool_selection_source import McpToolSelectionSource as McpToolSelectionSource
+from qanswer_sdk.models.mcp_tool_sync_action import McpToolSyncAction as McpToolSyncAction
+from qanswer_sdk.models.mcp_tool_sync_diff import McpToolSyncDiff as McpToolSyncDiff
+from qanswer_sdk.models.mcp_tool_sync_preview import McpToolSyncPreview as McpToolSyncPreview
 from qanswer_sdk.models.mcp_visibility import McpVisibility as McpVisibility
 from qanswer_sdk.models.message_role import MessageRole as MessageRole
 from qanswer_sdk.models.messages_stats_per_day_response import MessagesStatsPerDayResponse as MessagesStatsPerDayResponse

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/api/mcp_api.py

@@ -29,6 +29,7 @@ from qanswer_sdk.models.mcp_server_update import MCPServerUpdate
 from qanswer_sdk.models.mcp_tool_info import MCPToolInfo
 from qanswer_sdk.models.mcp_tool_update import MCPToolUpdate
 from qanswer_sdk.models.mcp_tool_dto import McpToolDto
+from qanswer_sdk.models.mcp_tool_sync_preview import McpToolSyncPreview
 from qanswer_sdk.models.user_dataset_mcp_tool_selection_dto import UserDatasetMcpToolSelectionDto
 from qanswer_sdk.models.user_mcp_tool_selection_dto import UserMcpToolSelectionDto
 
@@ -5990,6 +5991,320 @@ class MCPApi:
 
 
 
+    @validate_call
+    def preview_update_tools(
+        self,
+        server_uid: StrictStr,
+        connection_uid: Optional[StrictStr] = None,
+        request_body: Optional[List[StrictStr]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> McpToolSyncPreview:
+        """Preview Update Tools
+
+        Dry-run of update_tools — no DB changes.  Reports, per tool, what a save with the same ``tool_names`` would do (CREATE / UPDATE / DELETE / UNCHANGED) and which spec fields (``input_schema``, ``description``, ``title``) would be re-synced from the remote MCP server, so the UI can show the diff before committing.
+
+        :param server_uid: (required)
+        :type server_uid: str
+        :param connection_uid:
+        :type connection_uid: str
+        :param request_body:
+        :type request_body: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._preview_update_tools_serialize(
+            server_uid=server_uid,
+            connection_uid=connection_uid,
+            request_body=request_body,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "McpToolSyncPreview",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def preview_update_tools_with_http_info(
+        self,
+        server_uid: StrictStr,
+        connection_uid: Optional[StrictStr] = None,
+        request_body: Optional[List[StrictStr]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[McpToolSyncPreview]:
+        """Preview Update Tools
+
+        Dry-run of update_tools — no DB changes.  Reports, per tool, what a save with the same ``tool_names`` would do (CREATE / UPDATE / DELETE / UNCHANGED) and which spec fields (``input_schema``, ``description``, ``title``) would be re-synced from the remote MCP server, so the UI can show the diff before committing.
+
+        :param server_uid: (required)
+        :type server_uid: str
+        :param connection_uid:
+        :type connection_uid: str
+        :param request_body:
+        :type request_body: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._preview_update_tools_serialize(
+            server_uid=server_uid,
+            connection_uid=connection_uid,
+            request_body=request_body,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "McpToolSyncPreview",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def preview_update_tools_without_preload_content(
+        self,
+        server_uid: StrictStr,
+        connection_uid: Optional[StrictStr] = None,
+        request_body: Optional[List[StrictStr]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Preview Update Tools
+
+        Dry-run of update_tools — no DB changes.  Reports, per tool, what a save with the same ``tool_names`` would do (CREATE / UPDATE / DELETE / UNCHANGED) and which spec fields (``input_schema``, ``description``, ``title``) would be re-synced from the remote MCP server, so the UI can show the diff before committing.
+
+        :param server_uid: (required)
+        :type server_uid: str
+        :param connection_uid:
+        :type connection_uid: str
+        :param request_body:
+        :type request_body: List[str]
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._preview_update_tools_serialize(
+            server_uid=server_uid,
+            connection_uid=connection_uid,
+            request_body=request_body,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "McpToolSyncPreview",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _preview_update_tools_serialize(
+        self,
+        server_uid,
+        connection_uid,
+        request_body,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+            'request_body': '',
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if server_uid is not None:
+            _path_params['server_uid'] = server_uid
+        # process the query parameters
+        if connection_uid is not None:
+            
+            _query_params.append(('connectionUid', connection_uid))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if request_body is not None:
+            _body_params = request_body
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'QAnswer-Api-Key', 
+            'Bearer token'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/api/mcp/servers/{server_uid}/tools/update/preview',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
     @validate_call
     def reauthorize_connection(
         self,

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/api_client.py

@@ -91,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.419.0.dev0/python'
+        self.user_agent = 'OpenAPI-Generator/0.448.0.dev0/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/configuration.py

@@ -543,7 +543,7 @@ conf = qanswer_sdk.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 2.0.0\n"\
-               "SDK Package Version: 0.419.0.dev0".\
+               "SDK Package Version: 0.448.0.dev0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/models/__init__.py

@@ -319,6 +319,9 @@ from qanswer_sdk.models.mcp_server import McpServer
 from qanswer_sdk.models.mcp_server_dto import McpServerDto
 from qanswer_sdk.models.mcp_tool_dto import McpToolDto
 from qanswer_sdk.models.mcp_tool_selection_source import McpToolSelectionSource
+from qanswer_sdk.models.mcp_tool_sync_action import McpToolSyncAction
+from qanswer_sdk.models.mcp_tool_sync_diff import McpToolSyncDiff
+from qanswer_sdk.models.mcp_tool_sync_preview import McpToolSyncPreview
 from qanswer_sdk.models.mcp_visibility import McpVisibility
 from qanswer_sdk.models.message_role import MessageRole
 from qanswer_sdk.models.messages_stats_per_day_response import MessagesStatsPerDayResponse

{qanswer_sdk-0.419.0.dev0 → qanswer_sdk-0.448.0.dev0}/qanswer_sdk/models/conversation_message.py

@@ -37,7 +37,7 @@ class ConversationMessage(BaseModel):
     contents: List[ContentItem]
     message_id: StrictStr
     parent_message_id: Optional[StrictStr] = None
-    timestamp: Optional[StrictStr] = '2026-06-07T12:28:18Z'
+    timestamp: Optional[StrictStr] = '2026-06-09T18:46:12Z'
     feedback: Optional[StrictInt] = -1
     origin: Optional[StrictStr] = None
     sources: Optional[List[Source]] = Field(default=None, description="All sources referenced in the response")
@@ -231,7 +231,7 @@ class ConversationMessage(BaseModel):
             "contents": [ContentItem.from_dict(_item) for _item in obj["contents"]] if obj.get("contents") is not None else None,
             "message_id": obj.get("message_id"),
             "parent_message_id": obj.get("parent_message_id"),
-            "timestamp": obj.get("timestamp") if obj.get("timestamp") is not None else '2026-06-07T12:28:18Z',
+            "timestamp": obj.get("timestamp") if obj.get("timestamp") is not None else '2026-06-09T18:46:12Z',
             "feedback": obj.get("feedback") if obj.get("feedback") is not None else -1,
             "origin": obj.get("origin"),
             "sources": [Source.from_dict(_item) for _item in obj["sources"]] if obj.get("sources") is not None else None,

qanswer_sdk-0.448.0.dev0/qanswer_sdk/models/mcp_tool_sync_action.py

@@ -0,0 +1,39 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class McpToolSyncAction(str, Enum):
+    """
+    What a save/update will do to a tool relative to the current DB state.
+    """
+
+    """
+    allowed enum values
+    """
+    CREATE = 'CREATE'
+    UPDATE = 'UPDATE'
+    DELETE = 'DELETE'
+    UNCHANGED = 'UNCHANGED'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of McpToolSyncAction from a JSON string"""
+        return cls(json.loads(json_str))
+
+

qanswer_sdk-0.448.0.dev0/qanswer_sdk/models/mcp_tool_sync_diff.py

@@ -0,0 +1,100 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class McpToolSyncDiff(BaseModel):
+    """
+    Per-tool plan describing the effect of an update_tools save (dry run).
+    """ # noqa: E501
+    name: StrictStr = Field(description="Tool name")
+    tool_uid: Optional[StrictStr] = Field(default=None, description="Existing tool UID, or None if the tool does not exist yet")
+    action: StrictStr = Field(description="What the save will do to this tool")
+    changed_fields: Optional[List[StrictStr]] = Field(default=None, description="Spec fields that will be re-synced from the remote MCP server (any of 'input_schema', 'description', 'title'). Empty unless action is UPDATE.")
+    __properties: ClassVar[List[str]] = ["name", "tool_uid", "action", "changed_fields"]
+
+    @field_validator('action')
+    def action_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['CREATE', 'UPDATE', 'DELETE', 'UNCHANGED']):
+            raise ValueError("must be one of enum values ('CREATE', 'UPDATE', 'DELETE', 'UNCHANGED')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of McpToolSyncDiff from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of McpToolSyncDiff from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "tool_uid": obj.get("tool_uid"),
+            "action": obj.get("action"),
+            "changed_fields": obj.get("changed_fields")
+        })
+        return _obj
+
+

qanswer_sdk-0.448.0.dev0/qanswer_sdk/models/mcp_tool_sync_preview.py

@@ -0,0 +1,95 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List
+from qanswer_sdk.models.mcp_tool_sync_diff import McpToolSyncDiff
+from typing import Optional, Set
+from typing_extensions import Self
+
+class McpToolSyncPreview(BaseModel):
+    """
+    Dry-run result for update_tools: the per-tool sync plan, no DB changes made.
+    """ # noqa: E501
+    tools: List[McpToolSyncDiff] = Field(description="Per-tool sync plan")
+    __properties: ClassVar[List[str]] = ["tools"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of McpToolSyncPreview from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in tools (list)
+        _items = []
+        if self.tools:
+            for _item_tools in self.tools:
+                if _item_tools:
+                    _items.append(_item_tools.to_dict())
+            _dict['tools'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of McpToolSyncPreview from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "tools": [McpToolSyncDiff.from_dict(_item) for _item in obj["tools"]] if obj.get("tools") is not None else None
+        })
+        return _obj
+
+