mistral_common.protocol.instruct.normalize

def build_settings(self, request: ChatCompletionRequest) -> ModelSettings:
    r"""Build model settings from a chat completion request.

    For pre-v15 normalizers, model settings are all `None`.

    Args:
        request: The chat completion request whose settings are built.

    Returns:
        Returns `ModelSettings.none()`.

    Raises:
        InvalidRequestException: If a model settings builder is configured
            for a normalizer that does not support model settings.
    """
    if self._model_settings_builder is not None:
        raise InvalidRequestException(
            f"model_settings_builder should be None for {type(self).__name__}, got {self._model_settings_builder}"
        )
    return ModelSettings.none()

def from_chat_completion_request(self, request: ChatCompletionRequest[UATS]) -> InstructRequestType:
    r"""Convert a chat completion request to an instruct request.

    Aggregates system prompts into a single `system_prompt` string, merges
    consecutive same-role messages, and normalizes tool call arguments.
    Requires model settings to be empty for this normalizer version.

    Args:
        request: The chat completion request to convert.

    Returns:
        The converted instruct request, ready for tokenization.

    Raises:
        InvalidRequestException: If the request carries model settings that
            this normalizer version does not support.

    Examples:
        >>> from mistral_common.protocol.instruct.messages import UserMessage, AssistantMessage
        >>> request = ChatCompletionRequest(
        ...     messages=[
        ...         UserMessage(content="Hello"),
        ...         AssistantMessage(content="Hi"),
        ...     ],
        ... )
        >>> normalizer = InstructRequestNormalizer.normalizer()
        >>> instruct_request = normalizer.from_chat_completion_request(request)
    """
    system_prompt = self._aggregate_system_prompts(request.messages)
    messages = self._aggregate_messages(request.messages)

    settings = self.build_settings(request)
    if settings != ModelSettings.none():
        raise InvalidRequestException(f"Model settings are not supported for {type(self).__name__}, got {settings}")

    return self._build_instruct_request(
        messages=messages,
        system_prompt=system_prompt,
        request=request,
        settings=settings,
    )

@staticmethod
def normalizer(model_settings_builder: ModelSettingsBuilder | None = None) -> "InstructRequestNormalizer":
    r"""Return a normalizer for the default instruct request.

    Args:
        model_settings_builder: Must be `None` for this normalizer version.

    Returns:
        A normalizer for the default instruct request.

    Raises:
        ValueError: If `model_settings_builder` is not `None`.

    Examples:
        >>> normalizer = InstructRequestNormalizer.normalizer()
    """
    if model_settings_builder is not None:
        raise ValueError(
            f"model_settings_builder must be None for InstructRequestNormalizer, got {model_settings_builder}"
        )
    return InstructRequestNormalizer(
        UserMessage, AssistantMessage, ToolMessage, SystemMessage, InstructRequest[UATS, Tool], None
    )

@staticmethod
def normalizer(model_settings_builder: ModelSettingsBuilder | None = None) -> "InstructRequestNormalizerV13":
    r"""Return a normalizer for the default instruct request.

    Args:
        model_settings_builder: Must be `None` for this normalizer version.

    Returns:
        A normalizer for the V13 instruct request.

    Raises:
        ValueError: If `model_settings_builder` is not `None`.
    """
    if model_settings_builder is not None:
        raise ValueError(
            f"model_settings_builder must be None for InstructRequestNormalizerV13, got {model_settings_builder}"
        )
    return InstructRequestNormalizerV13(
        UserMessage, AssistantMessage, ToolMessage, SystemMessage, InstructRequest[UATS, Tool], None
    )

def build_settings(self, request: ChatCompletionRequest) -> ModelSettings:
    r"""Build model settings using the configured model settings builder.

    Args:
        request: The chat completion request.

    Returns:
        The built model settings.

    Raises:
        InvalidRequestException: If no model settings builder is configured.
    """
    if self._model_settings_builder is None:
        raise InvalidRequestException(f"model_settings_builder must not be None for {type(self).__name__}")
    return self._model_settings_builder.build_settings(request)

def from_chat_completion_request(self, request: ChatCompletionRequest[UATS]) -> InstructRequestType:
    r"""Converts a chat completion request to an instruct request.

    Args:
        request: The chat completion request to convert.

    Returns:
        The converted instruct request.
    """
    messages = self._aggregate_messages(request.messages)
    settings = self.build_settings(request)
    return self._build_instruct_request(
        messages=messages,
        system_prompt=None,
        request=request,
        settings=settings,
    )

@staticmethod
def normalizer(model_settings_builder: ModelSettingsBuilder | None = None) -> "InstructRequestNormalizerV15":
    r"""Return a normalizer for the V15 instruct request.

    Args:
        model_settings_builder: The builder for model settings.

    Returns:
        A normalizer for the V15 instruct request.
    """
    return InstructRequestNormalizerV15(
        UserMessage,
        AssistantMessage,
        ToolMessage,
        SystemMessage,
        InstructRequest,
        model_settings_builder,
    )

def from_chat_completion_request(self, request: ChatCompletionRequest[UATS]) -> InstructRequestType:
    r"""Converts a chat completion request to an instruct request.

    Args:
        request: The chat completion request to convert.

    Returns:
        The converted instruct request.

    Examples:
        >>> from mistral_common.protocol.instruct.messages import UserMessage, AssistantMessage
        >>> request = ChatCompletionRequest(
        ...     messages=[
        ...         UserMessage(content="Hello"),
        ...         AssistantMessage(content="Hi"),
        ...     ],
        ... )
        >>> normalizer = InstructRequestNormalizerV7.normalizer()
        >>> instruct_request = normalizer.from_chat_completion_request(request)
    """
    messages = self._aggregate_messages(request.messages)
    settings = self.build_settings(request)
    if settings != ModelSettings.none():
        raise InvalidRequestException(f"Model settings are not supported for {type(self).__name__}, got {settings}")
    return self._build_instruct_request(
        messages=messages,
        system_prompt=None,
        request=request,
        settings=settings,
    )

@staticmethod
def normalizer(model_settings_builder: ModelSettingsBuilder | None = None) -> "InstructRequestNormalizerV7":
    r"""Return a normalizer for the default instruct request.

    Args:
        model_settings_builder: Must be `None` for this normalizer version.

    Returns:
        A normalizer for the V7 instruct request.

    Raises:
        ValueError: If `model_settings_builder` is not `None`.

    Examples:
        >>> normalizer = InstructRequestNormalizerV7.normalizer()
    """
    if model_settings_builder is not None:
        raise ValueError(
            f"model_settings_builder must be None for InstructRequestNormalizerV7, got {model_settings_builder}"
        )
    return InstructRequestNormalizerV7(
        UserMessage, AssistantMessage, ToolMessage, SystemMessage, InstructRequest[UATS, Tool], None
    )