ogx_open_client 1.0.3.dev0__py3-none-any.whl

ogx_client/models/conversation_item.py

@@ -0,0 +1,855 @@
+# coding: utf-8
+
+# Copyright (c) The OGX Contributors.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+"""
+    OGX Specification - Stable & Experimental APIs
+
+    This is the specification of the OGX that provides                     a set of endpoints and their corresponding interfaces that are     tailored to                     best leverage Llama Models.      **🔗 COMBINED**: This specification includes both stable production-ready APIs     and experimental pre-release APIs. Use stable APIs for production deployments     and experimental APIs for testing new features.
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+import pprint
+import re
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, ValidationError, field_validator
+from typing import Any, List, Optional
+from ogx_client.models.open_ai_response_compaction import OpenAIResponseCompaction
+from ogx_client.models.open_ai_response_input_function_tool_call_output import OpenAIResponseInputFunctionToolCallOutput
+from ogx_client.models.open_ai_response_mcp_approval_request import OpenAIResponseMCPApprovalRequest
+from ogx_client.models.open_ai_response_mcp_approval_response import OpenAIResponseMCPApprovalResponse
+from ogx_client.models.open_ai_response_message import OpenAIResponseMessage
+from ogx_client.models.open_ai_response_output_message_file_search_tool_call import OpenAIResponseOutputMessageFileSearchToolCall
+from ogx_client.models.open_ai_response_output_message_function_tool_call import OpenAIResponseOutputMessageFunctionToolCall
+from ogx_client.models.open_ai_response_output_message_mcp_call import OpenAIResponseOutputMessageMCPCall
+from ogx_client.models.open_ai_response_output_message_mcp_list_tools import OpenAIResponseOutputMessageMCPListTools
+from ogx_client.models.open_ai_response_output_message_reasoning_item import OpenAIResponseOutputMessageReasoningItem
+from ogx_client.models.open_ai_response_output_message_web_search_tool_call import OpenAIResponseOutputMessageWebSearchToolCall
+from pydantic import StrictStr, Field, model_serializer
+from typing import Any, ClassVar
+from typing_extensions import Literal, Self
+from ogx_client.lib._utils import pascal_to_snake_case
+
+CONVERSATIONITEM_ONE_OF_SCHEMAS = ["OpenAIResponseCompaction", "OpenAIResponseInputFunctionToolCallOutput", "OpenAIResponseMCPApprovalRequest", "OpenAIResponseMCPApprovalResponse", "OpenAIResponseMessage", "OpenAIResponseOutputMessageFileSearchToolCall", "OpenAIResponseOutputMessageFunctionToolCall", "OpenAIResponseOutputMessageMCPCall", "OpenAIResponseOutputMessageMCPListTools", "OpenAIResponseOutputMessageReasoningItem", "OpenAIResponseOutputMessageWebSearchToolCall"]
+
+class ConversationItem(BaseModel):
+    """
+    ConversationItem
+    """
+    # data type: OpenAIResponseMessage
+    oneof_schema_1_validator: Optional[OpenAIResponseMessage] = None
+    # data type: OpenAIResponseOutputMessageWebSearchToolCall
+    oneof_schema_2_validator: Optional[OpenAIResponseOutputMessageWebSearchToolCall] = None
+    # data type: OpenAIResponseOutputMessageFileSearchToolCall
+    oneof_schema_3_validator: Optional[OpenAIResponseOutputMessageFileSearchToolCall] = None
+    # data type: OpenAIResponseOutputMessageFunctionToolCall
+    oneof_schema_4_validator: Optional[OpenAIResponseOutputMessageFunctionToolCall] = None
+    # data type: OpenAIResponseInputFunctionToolCallOutput
+    oneof_schema_5_validator: Optional[OpenAIResponseInputFunctionToolCallOutput] = None
+    # data type: OpenAIResponseMCPApprovalRequest
+    oneof_schema_6_validator: Optional[OpenAIResponseMCPApprovalRequest] = None
+    # data type: OpenAIResponseMCPApprovalResponse
+    oneof_schema_7_validator: Optional[OpenAIResponseMCPApprovalResponse] = None
+    # data type: OpenAIResponseOutputMessageMCPCall
+    oneof_schema_8_validator: Optional[OpenAIResponseOutputMessageMCPCall] = None
+    # data type: OpenAIResponseOutputMessageMCPListTools
+    oneof_schema_9_validator: Optional[OpenAIResponseOutputMessageMCPListTools] = None
+    # data type: OpenAIResponseOutputMessageReasoningItem
+    oneof_schema_10_validator: Optional[OpenAIResponseOutputMessageReasoningItem] = None
+    # data type: OpenAIResponseCompaction
+    oneof_schema_11_validator: Optional[OpenAIResponseCompaction] = None
+    actual_instance: OpenAIResponseCompaction | OpenAIResponseInputFunctionToolCallOutput | OpenAIResponseMCPApprovalRequest | OpenAIResponseMCPApprovalResponse | OpenAIResponseMessage | OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseOutputMessageMCPCall | OpenAIResponseOutputMessageMCPListTools | OpenAIResponseOutputMessageReasoningItem | OpenAIResponseOutputMessageWebSearchToolCall | None = None
+    one_of_schemas: ClassVar[set[str]] = { "OpenAIResponseCompaction", "OpenAIResponseInputFunctionToolCallOutput", "OpenAIResponseMCPApprovalRequest", "OpenAIResponseMCPApprovalResponse", "OpenAIResponseMessage", "OpenAIResponseOutputMessageFileSearchToolCall", "OpenAIResponseOutputMessageFunctionToolCall", "OpenAIResponseOutputMessageMCPCall", "OpenAIResponseOutputMessageMCPListTools", "OpenAIResponseOutputMessageReasoningItem", "OpenAIResponseOutputMessageWebSearchToolCall" }
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    discriminator_value_class_map: ClassVar[dict[str, str]] = {
+        'compaction': 'OpenAIResponseCompaction',
+        'file_search_call': 'OpenAIResponseOutputMessageFileSearchToolCall',
+        'function_call': 'OpenAIResponseOutputMessageFunctionToolCall',
+        'function_call_output': 'OpenAIResponseInputFunctionToolCallOutput',
+        'mcp_approval_request': 'OpenAIResponseMCPApprovalRequest',
+        'mcp_approval_response': 'OpenAIResponseMCPApprovalResponse',
+        'mcp_call': 'OpenAIResponseOutputMessageMCPCall',
+        'mcp_list_tools': 'OpenAIResponseOutputMessageMCPListTools',
+        'message': 'OpenAIResponseMessage',
+        'reasoning': 'OpenAIResponseOutputMessageReasoningItem',
+        'web_search_call': 'OpenAIResponseOutputMessageWebSearchToolCall',
+        '': 'ERRORUNKNOWN'
+    }
+    discriminator_property_name: ClassVar[str] = 'type'
+
+    def __init__(self, *args, **kwargs) -> None:
+        if args:
+            if len(args) > 1:
+                raise ValueError("If a position argument is used, only 1 is allowed to set `actual_instance`")
+            if kwargs:
+                raise ValueError("If a position argument is used, keyword arguments cannot be used.")
+
+            # Preprocess the value to handle lists of dicts
+            value = args[0]
+            if isinstance(value, list):
+                # Try to construct model instances from dicts in the list
+                # This ensures default values are applied
+                from pydantic import ValidationError as PydanticValidationError
+                validated = None
+                if validated is not None:
+                    value = validated
+
+            super().__init__(actual_instance=value)
+        else:
+            super().__init__(**kwargs)
+
+    def __getattr__(self, name: str):
+        """Proxy attribute access to actual_instance for transparency."""
+        # Avoid infinite recursion for private attributes and model fields
+        if name.startswith('_') or name in ('actual_instance', 'one_of_schemas', 'model_config', 'model_fields'):
+            raise AttributeError(f"'{type(self).__name__}' object has no attribute '{name}'")
+
+        actual = super().__getattribute__('actual_instance')
+        if actual is None:
+            raise AttributeError(f"'{type(self).__name__}' object has no attribute '{name}' (actual_instance is None)")
+
+        return getattr(actual, name)
+
+    def __iter__(self):
+        """Iterate over items if actual_instance is iterable."""
+        if hasattr(self.actual_instance, '__iter__'):
+            return iter(self.actual_instance)
+        raise TypeError(f"'{type(self.actual_instance).__name__}' object is not iterable")
+
+    def __getitem__(self, index):
+        """Get item by index if actual_instance supports indexing."""
+        if hasattr(self.actual_instance, '__getitem__'):
+            return self.actual_instance[index]
+        raise TypeError(f"'{type(self.actual_instance).__name__}' object is not subscriptable")
+
+    def __len__(self):
+        """Get length if actual_instance supports len()."""
+        if hasattr(self.actual_instance, '__len__'):
+            return len(self.actual_instance)
+        raise TypeError(f"object of type '{type(self.actual_instance).__name__}' has no len()")
+
+    def __bool__(self):
+        """Handle truthiness checks - wrapper is truthy if actual_instance is not None."""
+        return self.actual_instance is not None
+
+    def __eq__(self, other):
+        """Handle equality comparisons transparently."""
+        if hasattr(self, 'actual_instance') and self.actual_instance is not None:
+            other_value = other.actual_instance if hasattr(other, 'actual_instance') else other
+            return self.actual_instance == other_value
+        return super().__eq__(other)
+
+    def __hash__(self):
+        """Handle hashing - use actual_instance's hash if available."""
+        if hasattr(self, 'actual_instance') and self.actual_instance is not None:
+            try:
+                return hash(self.actual_instance)
+            except TypeError:
+                return id(self)
+        return super().__hash__()
+
+    def __repr__(self):
+        """Return repr of actual_instance for debugging."""
+        if hasattr(self, 'actual_instance') and self.actual_instance is not None:
+            return repr(self.actual_instance)
+        return super().__repr__()
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the actual instance"""
+        if self.actual_instance is None:
+            return "null"
+
+        if hasattr(self.actual_instance, "to_json") and callable(self.actual_instance.to_json):
+            return self.actual_instance.to_json()
+        else:
+            return json.dumps(self.actual_instance)
+
+    def to_str(self) -> str:
+        """Returns the string representation of the actual instance"""
+        return pprint.pformat(self.model_dump())
+
+    @model_serializer(mode='wrap')
+    def serialize_model(self, serializer):
+        """Custom serializer that delegates to actual_instance for proper JSON serialization."""
+        # If actual_instance is None, serialize the wrapper normally
+        if not hasattr(self, 'actual_instance') or self.actual_instance is None:
+            return serializer(self)
+
+        # If actual_instance is a Pydantic model, serialize it using the default serializer
+        # This ensures nested models are also serialized correctly
+        if hasattr(self.actual_instance, '__pydantic_serializer__'):
+            # Use Pydantic's serializer infrastructure to ensure proper serialization
+            from pydantic_core import to_jsonable_python
+            return to_jsonable_python(
+                self.actual_instance,
+                by_alias=True,
+                exclude_none=True,
+                fallback=lambda x: x if isinstance(x, str | int | float | bool | type(None)) else str(x)
+            )
+        # If it's a list of Pydantic models, serialize each one
+        elif isinstance(self.actual_instance, list):
+            from pydantic_core import to_jsonable_python
+            return [
+                to_jsonable_python(
+                    item,
+                    by_alias=True,
+                    exclude_none=True,
+                    fallback=lambda x: x if isinstance(x, str | int | float | bool | type(None)) else str(x)
+                )
+                if hasattr(item, '__pydantic_serializer__')
+                else item
+                for item in self.actual_instance
+            ]
+        # Otherwise return as-is (primitives, dicts, etc.)
+        else:
+            return self.actual_instance
+
+    @field_validator('actual_instance')
+    def actual_instance_must_validate_oneof(cls, v):
+        instance = ConversationItem.model_construct()
+        error_messages = []
+        match = 0
+        # validate data type: OpenAIResponseMessage
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseMessage':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseMessage due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseMessage):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseMessage.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseMessage` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseMessage`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageWebSearchToolCall
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageWebSearchToolCall':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageWebSearchToolCall due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageWebSearchToolCall):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageWebSearchToolCall.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageWebSearchToolCall` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageWebSearchToolCall`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageFileSearchToolCall
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageFileSearchToolCall':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageFileSearchToolCall due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageFileSearchToolCall):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageFileSearchToolCall.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageFileSearchToolCall` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageFileSearchToolCall`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageFunctionToolCall
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageFunctionToolCall':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageFunctionToolCall due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageFunctionToolCall):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageFunctionToolCall.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageFunctionToolCall` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageFunctionToolCall`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseInputFunctionToolCallOutput
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseInputFunctionToolCallOutput':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseInputFunctionToolCallOutput due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseInputFunctionToolCallOutput):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseInputFunctionToolCallOutput.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseInputFunctionToolCallOutput` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseInputFunctionToolCallOutput`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseMCPApprovalRequest
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseMCPApprovalRequest':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseMCPApprovalRequest due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseMCPApprovalRequest):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseMCPApprovalRequest.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseMCPApprovalRequest` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseMCPApprovalRequest`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseMCPApprovalResponse
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseMCPApprovalResponse':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseMCPApprovalResponse due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseMCPApprovalResponse):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseMCPApprovalResponse.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseMCPApprovalResponse` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseMCPApprovalResponse`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageMCPCall
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageMCPCall':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageMCPCall due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageMCPCall):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageMCPCall.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageMCPCall` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageMCPCall`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageMCPListTools
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageMCPListTools':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageMCPListTools due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageMCPListTools):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageMCPListTools.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageMCPListTools` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageMCPListTools`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseOutputMessageReasoningItem
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseOutputMessageReasoningItem':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseOutputMessageReasoningItem due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseOutputMessageReasoningItem):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseOutputMessageReasoningItem.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseOutputMessageReasoningItem` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseOutputMessageReasoningItem`")
+        else:
+            match += 1
+        # validate data type: OpenAIResponseCompaction
+        # Check if we should skip this variant based on discriminator
+        _should_skip_discriminator = False
+        if isinstance(v, dict) and hasattr(cls, 'discriminator_value_class_map'):
+            _disc_value = v.get(cls.discriminator_property_name)
+            if _disc_value is None and cls.discriminator_property_name != 'type':
+                _disc_value = v.get('type')
+            if _disc_value and _disc_value in cls.discriminator_value_class_map:
+                _expected_class = cls.discriminator_value_class_map[_disc_value]
+                if _expected_class != 'OpenAIResponseCompaction':
+                    _should_skip_discriminator = True
+
+        if _should_skip_discriminator:
+            error_messages.append(f"Skipping OpenAIResponseCompaction due to discriminator mismatch")
+        elif not isinstance(v, OpenAIResponseCompaction):
+            # Try to construct from dict if it's a dict - this applies default values
+            if isinstance(v, dict):
+                try:
+                    constructed = OpenAIResponseCompaction.model_validate(v)
+                    match += 1
+                    # Return the constructed instance to use it instead of raw dict
+                    return constructed
+                except (ValidationError, ValueError) as e:
+                    error_messages.append(f"Error! Cannot construct `OpenAIResponseCompaction` from dict: {str(e)}")
+            else:
+                error_messages.append(f"Error! Input type `{type(v)}` is not `OpenAIResponseCompaction`")
+        else:
+            match += 1
+        if match > 1:
+            # Special case: empty lists can match multiple List[...] schemas in oneOf
+            # This is common in streaming where content starts empty
+            # In this case, just accept the first match (they're functionally equivalent for empty lists)
+            if isinstance(v, list) and len(v) == 0:
+                return v
+            # more than 1 match
+            raise ValueError("Multiple matches found when setting `actual_instance` in ConversationItem with oneOf schemas: OpenAIResponseCompaction, OpenAIResponseInputFunctionToolCallOutput, OpenAIResponseMCPApprovalRequest, OpenAIResponseMCPApprovalResponse, OpenAIResponseMessage, OpenAIResponseOutputMessageFileSearchToolCall, OpenAIResponseOutputMessageFunctionToolCall, OpenAIResponseOutputMessageMCPCall, OpenAIResponseOutputMessageMCPListTools, OpenAIResponseOutputMessageReasoningItem, OpenAIResponseOutputMessageWebSearchToolCall. Details: " + ", ".join(error_messages))
+        elif match == 0:
+            # no match
+            raise ValueError("No match found when setting `actual_instance` in ConversationItem with oneOf schemas: OpenAIResponseCompaction, OpenAIResponseInputFunctionToolCallOutput, OpenAIResponseMCPApprovalRequest, OpenAIResponseMCPApprovalResponse, OpenAIResponseMessage, OpenAIResponseOutputMessageFileSearchToolCall, OpenAIResponseOutputMessageFunctionToolCall, OpenAIResponseOutputMessageMCPCall, OpenAIResponseOutputMessageMCPListTools, OpenAIResponseOutputMessageReasoningItem, OpenAIResponseOutputMessageWebSearchToolCall. Details: " + ", ".join(error_messages))
+        else:
+            return v
+
+    @classmethod
+    def from_dict(cls, obj: str | dict[str, Any]) -> Self:
+        # Handle primitives and lists directly - don't double-serialize them
+        if isinstance(obj, (str, int, float, bool, type(None), list)):
+            # For non-dict content, bypass from_json and use actual_instance_must_validate_oneof
+            instance = cls.model_construct()
+            instance.actual_instance = cls.actual_instance_must_validate_oneof(obj)
+            return instance
+        return cls.from_json(json.dumps(obj))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Returns the object represented by the json string"""
+        instance = cls.model_construct()
+        error_messages = []
+        match = 0
+
+        # use oneOf discriminator to lookup the data type
+        _data_type = json.loads(json_str).get("type")
+        if not _data_type:
+            raise ValueError("Failed to lookup data type from the field `type` in the input.")
+
+        # check if data type is `OpenAIResponseCompaction`
+        if _data_type == "compaction":
+            instance.actual_instance = OpenAIResponseCompaction.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageFileSearchToolCall`
+        if _data_type == "file_search_call":
+            instance.actual_instance = OpenAIResponseOutputMessageFileSearchToolCall.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageFunctionToolCall`
+        if _data_type == "function_call":
+            instance.actual_instance = OpenAIResponseOutputMessageFunctionToolCall.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseInputFunctionToolCallOutput`
+        if _data_type == "function_call_output":
+            instance.actual_instance = OpenAIResponseInputFunctionToolCallOutput.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseMCPApprovalRequest`
+        if _data_type == "mcp_approval_request":
+            instance.actual_instance = OpenAIResponseMCPApprovalRequest.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseMCPApprovalResponse`
+        if _data_type == "mcp_approval_response":
+            instance.actual_instance = OpenAIResponseMCPApprovalResponse.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageMCPCall`
+        if _data_type == "mcp_call":
+            instance.actual_instance = OpenAIResponseOutputMessageMCPCall.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageMCPListTools`
+        if _data_type == "mcp_list_tools":
+            instance.actual_instance = OpenAIResponseOutputMessageMCPListTools.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseMessage`
+        if _data_type == "message":
+            instance.actual_instance = OpenAIResponseMessage.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageReasoningItem`
+        if _data_type == "reasoning":
+            instance.actual_instance = OpenAIResponseOutputMessageReasoningItem.from_json(json_str)
+            return instance
+
+        # check if data type is `OpenAIResponseOutputMessageWebSearchToolCall`
+        if _data_type == "web_search_call":
+            instance.actual_instance = OpenAIResponseOutputMessageWebSearchToolCall.from_json(json_str)
+            return instance
+
+        # check if data type is `ERRORUNKNOWN`
+        if _data_type == "":
+            instance.actual_instance = ERRORUNKNOWN.from_json(json_str)
+            return instance
+
+        # deserialize data into OpenAIResponseMessage
+        try:
+            instance.actual_instance = OpenAIResponseMessage.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageWebSearchToolCall
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageWebSearchToolCall.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageFileSearchToolCall
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageFileSearchToolCall.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageFunctionToolCall
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageFunctionToolCall.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseInputFunctionToolCallOutput
+        try:
+            instance.actual_instance = OpenAIResponseInputFunctionToolCallOutput.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseMCPApprovalRequest
+        try:
+            instance.actual_instance = OpenAIResponseMCPApprovalRequest.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseMCPApprovalResponse
+        try:
+            instance.actual_instance = OpenAIResponseMCPApprovalResponse.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageMCPCall
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageMCPCall.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageMCPListTools
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageMCPListTools.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseOutputMessageReasoningItem
+        try:
+            instance.actual_instance = OpenAIResponseOutputMessageReasoningItem.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OpenAIResponseCompaction
+        try:
+            instance.actual_instance = OpenAIResponseCompaction.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+
+        if match > 1:
+            # Special case: empty lists can match multiple List[...] schemas in oneOf
+            # This is common in streaming where content starts empty
+            # In this case, just accept the first match (they're functionally equivalent for empty lists)
+            data = json.loads(json_str)
+            if isinstance(data, list) and len(data) == 0:
+                return instance  # First match already set in instance
+            # more than 1 match
+            raise ValueError("Multiple matches found when deserializing the JSON string into ConversationItem with oneOf schemas: OpenAIResponseCompaction, OpenAIResponseInputFunctionToolCallOutput, OpenAIResponseMCPApprovalRequest, OpenAIResponseMCPApprovalResponse, OpenAIResponseMessage, OpenAIResponseOutputMessageFileSearchToolCall, OpenAIResponseOutputMessageFunctionToolCall, OpenAIResponseOutputMessageMCPCall, OpenAIResponseOutputMessageMCPListTools, OpenAIResponseOutputMessageReasoningItem, OpenAIResponseOutputMessageWebSearchToolCall. Details: " + ", ".join(error_messages))
+        elif match == 0:
+            # no match - try lenient fallback for streaming chunks
+            data = json.loads(json_str)
+
+            # Helper to remove None values recursively for streaming chunks
+            def remove_none_values(obj):
+                if isinstance(obj, dict):
+                    return {k: remove_none_values(v) for k, v in obj.items() if v is not None}
+                elif isinstance(obj, list):
+                    return [remove_none_values(item) for item in obj if item is not None]
+                return obj
+
+            # Helper to add default values for commonly missing required fields in streaming
+            def add_streaming_defaults(obj):
+                if isinstance(obj, dict):
+                    result = dict(obj)
+                    # Add empty string for finish_reason if missing (common in streaming chunks)
+                    if 'choices' in result and isinstance(result['choices'], list):
+                        for choice in result['choices']:
+                            if isinstance(choice, dict) and 'finish_reason' not in choice:
+                                choice['finish_reason'] = ''
+                    return result
+                return obj
+
+            # Try each variant with None values removed and defaults added
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseMessage.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageWebSearchToolCall.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageFileSearchToolCall.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageFunctionToolCall.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseInputFunctionToolCallOutput.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseMCPApprovalRequest.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseMCPApprovalResponse.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageMCPCall.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageMCPListTools.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseOutputMessageReasoningItem.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+            try:
+                cleaned_data = remove_none_values(data)
+                cleaned_data = add_streaming_defaults(cleaned_data)
+                variant = OpenAIResponseCompaction.model_validate(cleaned_data)
+                instance.actual_instance = variant
+                return instance
+            except Exception:
+                pass
+
+            # All variants failed
+            raise ValueError("No match found when deserializing the JSON string into ConversationItem with oneOf schemas: OpenAIResponseCompaction, OpenAIResponseInputFunctionToolCallOutput, OpenAIResponseMCPApprovalRequest, OpenAIResponseMCPApprovalResponse, OpenAIResponseMessage, OpenAIResponseOutputMessageFileSearchToolCall, OpenAIResponseOutputMessageFunctionToolCall, OpenAIResponseOutputMessageMCPCall, OpenAIResponseOutputMessageMCPListTools, OpenAIResponseOutputMessageReasoningItem, OpenAIResponseOutputMessageWebSearchToolCall. Details: " + ", ".join(error_messages))
+        else:
+            return instance
+
+    def to_dict(self) -> dict[str, Any] | OpenAIResponseCompaction | OpenAIResponseInputFunctionToolCallOutput | OpenAIResponseMCPApprovalRequest | OpenAIResponseMCPApprovalResponse | OpenAIResponseMessage | OpenAIResponseOutputMessageFileSearchToolCall | OpenAIResponseOutputMessageFunctionToolCall | OpenAIResponseOutputMessageMCPCall | OpenAIResponseOutputMessageMCPListTools | OpenAIResponseOutputMessageReasoningItem | OpenAIResponseOutputMessageWebSearchToolCall | None:
+        """Returns the dict representation of the actual instance"""
+        if self.actual_instance is None:
+            return None
+
+        # Handle lists specially - call to_dict() on each item if it has the method
+        if isinstance(self.actual_instance, list):
+            return [
+                item.to_dict() if hasattr(item, 'to_dict') and callable(item.to_dict)
+                else item
+                for item in self.actual_instance
+            ]
+        # Handle Pydantic models
+        elif hasattr(self.actual_instance, "to_dict") and callable(self.actual_instance.to_dict):
+            return self.actual_instance.to_dict()
+        # Handle other Pydantic models that don't have to_dict
+        elif hasattr(self.actual_instance, '__pydantic_serializer__'):
+            from pydantic_core import to_jsonable_python
+            return to_jsonable_python(
+                self.actual_instance,
+                by_alias=True,
+                exclude_none=True,
+                fallback=lambda x: x if isinstance(x, str | int | float | bool | type(None)) else str(x)
+            )
+        else:
+            # primitive type
+            return self.actual_instance
+
+