mistralai 1.0.3__py3-none-any.whl → 1.2.0__py3-none-any.whl

mistralai_gcp/models/fimcompletionstreamrequest.py

@@ -1,10 +1,16 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from mistralai_gcp.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
+from mistralai_gcp.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
 from pydantic import model_serializer
-from typing import List, Optional, TypedDict, Union
-from typing_extensions import NotRequired
+from typing import List, Optional, Union
+from typing_extensions import NotRequired, TypedDict
 
 
 FIMCompletionStreamRequestStopTypedDict = Union[str, List[str]]
@@ -23,14 +29,12 @@ class FIMCompletionStreamRequestTypedDict(TypedDict):
     """
     prompt: str
     r"""The text/code to complete."""
-    temperature: NotRequired[float]
-    r"""What sampling temperature to use, between 0.0 and 1.0. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. We generally recommend altering this or `top_p` but not both."""
+    temperature: NotRequired[Nullable[float]]
+    r"""What sampling temperature to use, we recommend between 0.0 and 0.7. Higher values like 0.7 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. We generally recommend altering this or `top_p` but not both. The default value varies depending on the model you are targeting. Call the `/models` endpoint to retrieve the appropriate value."""
     top_p: NotRequired[float]
     r"""Nucleus sampling, where the model considers the results of the tokens with `top_p` probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We generally recommend altering this or `temperature` but not both."""
     max_tokens: NotRequired[Nullable[int]]
     r"""The maximum number of tokens to generate in the completion. The token count of your prompt plus `max_tokens` cannot exceed the model's context length."""
-    min_tokens: NotRequired[Nullable[int]]
-    r"""The minimum number of tokens to generate in the completion."""
     stream: NotRequired[bool]
     stop: NotRequired[FIMCompletionStreamRequestStopTypedDict]
     r"""Stop generation if this token is detected. Or if one of these tokens is detected when providing an array"""
@@ -38,7 +42,9 @@ class FIMCompletionStreamRequestTypedDict(TypedDict):
     r"""The seed to use for random sampling. If set, different calls will generate deterministic results."""
     suffix: NotRequired[Nullable[str]]
     r"""Optional text/code that adds more context for the model. When given a `prompt` and a `suffix` the model will fill what is between them. When `suffix` is not provided, the model will simply execute completion starting with `prompt`."""
-    
+    min_tokens: NotRequired[Nullable[int]]
+    r"""The minimum number of tokens to generate in the completion."""
+
 
 class FIMCompletionStreamRequest(BaseModel):
     model: Nullable[str]
@@ -46,28 +52,53 @@ class FIMCompletionStreamRequest(BaseModel):
     - `codestral-2405`
     - `codestral-latest`
     """
+
     prompt: str
     r"""The text/code to complete."""
-    temperature: Optional[float] = 0.7
-    r"""What sampling temperature to use, between 0.0 and 1.0. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. We generally recommend altering this or `top_p` but not both."""
+
+    temperature: OptionalNullable[float] = UNSET
+    r"""What sampling temperature to use, we recommend between 0.0 and 0.7. Higher values like 0.7 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. We generally recommend altering this or `top_p` but not both. The default value varies depending on the model you are targeting. Call the `/models` endpoint to retrieve the appropriate value."""
+
     top_p: Optional[float] = 1
     r"""Nucleus sampling, where the model considers the results of the tokens with `top_p` probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We generally recommend altering this or `temperature` but not both."""
+
     max_tokens: OptionalNullable[int] = UNSET
     r"""The maximum number of tokens to generate in the completion. The token count of your prompt plus `max_tokens` cannot exceed the model's context length."""
-    min_tokens: OptionalNullable[int] = UNSET
-    r"""The minimum number of tokens to generate in the completion."""
+
     stream: Optional[bool] = True
+
     stop: Optional[FIMCompletionStreamRequestStop] = None
     r"""Stop generation if this token is detected. Or if one of these tokens is detected when providing an array"""
+
     random_seed: OptionalNullable[int] = UNSET
     r"""The seed to use for random sampling. If set, different calls will generate deterministic results."""
+
     suffix: OptionalNullable[str] = UNSET
     r"""Optional text/code that adds more context for the model. When given a `prompt` and a `suffix` the model will fill what is between them. When `suffix` is not provided, the model will simply execute completion starting with `prompt`."""
-    
+
+    min_tokens: OptionalNullable[int] = UNSET
+    r"""The minimum number of tokens to generate in the completion."""
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["temperature", "top_p", "max_tokens", "min_tokens", "stream", "stop", "random_seed", "suffix"]
-        nullable_fields = ["model", "max_tokens", "min_tokens", "random_seed", "suffix"]
+        optional_fields = [
+            "temperature",
+            "top_p",
+            "max_tokens",
+            "stream",
+            "stop",
+            "random_seed",
+            "suffix",
+            "min_tokens",
+        ]
+        nullable_fields = [
+            "model",
+            "temperature",
+            "max_tokens",
+            "random_seed",
+            "suffix",
+            "min_tokens",
+        ]
         null_default_fields = []
 
         serialized = handler(self)
@@ -77,9 +108,13 @@ class FIMCompletionStreamRequest(BaseModel):
         for n, f in self.model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
+            serialized.pop(k, None)
 
             optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (self.__pydantic_fields_set__.intersection({n}) or k in null_default_fields) # pylint: disable=no-member
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
 
             if val is not None and val != UNSET_SENTINEL:
                 m[k] = val
@@ -89,4 +124,3 @@ class FIMCompletionStreamRequest(BaseModel):
                 m[k] = val
 
         return m
-        

mistralai_gcp/models/function.py

@@ -2,18 +2,19 @@
 
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
-from typing import Any, Dict, Optional, TypedDict
-from typing_extensions import NotRequired
+from typing import Any, Dict, Optional
+from typing_extensions import NotRequired, TypedDict
 
 
 class FunctionTypedDict(TypedDict):
     name: str
     parameters: Dict[str, Any]
     description: NotRequired[str]
-    
+
 
 class Function(BaseModel):
     name: str
+
     parameters: Dict[str, Any]
+
     description: Optional[str] = ""
-    

mistralai_gcp/models/functioncall.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
-from typing import Any, Dict, TypedDict, Union
+from typing import Any, Dict, Union
+from typing_extensions import TypedDict
 
 
 ArgumentsTypedDict = Union[Dict[str, Any], str]
@@ -14,9 +15,9 @@ Arguments = Union[Dict[str, Any], str]
 class FunctionCallTypedDict(TypedDict):
     name: str
     arguments: ArgumentsTypedDict
-    
+
 
 class FunctionCall(BaseModel):
     name: str
+
     arguments: Arguments
-    

mistralai_gcp/models/functionname.py

@@ -0,0 +1,17 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from mistralai_gcp.types import BaseModel
+from typing_extensions import TypedDict
+
+
+class FunctionNameTypedDict(TypedDict):
+    r"""this restriction of `Function` is used to select a specific function to call"""
+
+    name: str
+
+
+class FunctionName(BaseModel):
+    r"""this restriction of `Function` is used to select a specific function to call"""
+
+    name: str

mistralai_gcp/models/httpvalidationerror.py

@@ -6,13 +6,12 @@ from mistralai_gcp import utils
 from mistralai_gcp.types import BaseModel
 from typing import List, Optional
 
+
 class HTTPValidationErrorData(BaseModel):
     detail: Optional[List[ValidationError]] = None
-    
 
 
 class HTTPValidationError(Exception):
-    r"""Validation Error"""
     data: HTTPValidationErrorData
 
     def __init__(self, data: HTTPValidationErrorData):
@@ -20,4 +19,3 @@ class HTTPValidationError(Exception):
 
     def __str__(self) -> str:
         return utils.marshal_json(self.data, HTTPValidationErrorData)
-

mistralai_gcp/models/responseformat.py

@@ -1,18 +1,17 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
+from .responseformats import ResponseFormats
 from mistralai_gcp.types import BaseModel
-from typing import Literal, Optional, TypedDict
-from typing_extensions import NotRequired
+from typing import Optional
+from typing_extensions import NotRequired, TypedDict
 
 
-ResponseFormats = Literal["text", "json_object"]
-r"""An object specifying the format that the model must output. Setting to `{ \"type\": \"json_object\" }` enables JSON mode, which guarantees the message the model generates is in JSON. When using JSON mode you MUST also instruct the model to produce JSON yourself with a system or a user message."""
-
 class ResponseFormatTypedDict(TypedDict):
     type: NotRequired[ResponseFormats]
-    
+    r"""An object specifying the format that the model must output. Setting to `{ \"type\": \"json_object\" }` enables JSON mode, which guarantees the message the model generates is in JSON. When using JSON mode you MUST also instruct the model to produce JSON yourself with a system or a user message."""
+
 
 class ResponseFormat(BaseModel):
-    type: Optional[ResponseFormats] = "text"
-    
+    type: Optional[ResponseFormats] = None
+    r"""An object specifying the format that the model must output. Setting to `{ \"type\": \"json_object\" }` enables JSON mode, which guarantees the message the model generates is in JSON. When using JSON mode you MUST also instruct the model to produce JSON yourself with a system or a user message."""

mistralai_gcp/models/responseformats.py

@@ -0,0 +1,8 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from typing import Literal
+
+
+ResponseFormats = Literal["text", "json_object"]
+r"""An object specifying the format that the model must output. Setting to `{ \"type\": \"json_object\" }` enables JSON mode, which guarantees the message the model generates is in JSON. When using JSON mode you MUST also instruct the model to produce JSON yourself with a system or a user message."""

mistralai_gcp/models/security.py

@@ -3,14 +3,22 @@
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
 from mistralai_gcp.utils import FieldMetadata, SecurityMetadata
-from typing import TypedDict
-from typing_extensions import Annotated
+from typing_extensions import Annotated, TypedDict
 
 
 class SecurityTypedDict(TypedDict):
     api_key: str
-    
+
 
 class Security(BaseModel):
-    api_key: Annotated[str, FieldMetadata(security=SecurityMetadata(scheme=True, scheme_type="http", sub_type="bearer", field_name="Authorization"))]
-    
+    api_key: Annotated[
+        str,
+        FieldMetadata(
+            security=SecurityMetadata(
+                scheme=True,
+                scheme_type="http",
+                sub_type="bearer",
+                field_name="Authorization",
+            )
+        ),
+    ]

mistralai_gcp/models/systemmessage.py

@@ -1,26 +1,27 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from .contentchunk import ContentChunk, ContentChunkTypedDict
+from .textchunk import TextChunk, TextChunkTypedDict
 from mistralai_gcp.types import BaseModel
-from typing import List, Literal, Optional, TypedDict, Union
-from typing_extensions import NotRequired
+from typing import List, Literal, Optional, Union
+from typing_extensions import NotRequired, TypedDict
 
 
-ContentTypedDict = Union[str, List[ContentChunkTypedDict]]
+SystemMessageContentTypedDict = Union[str, List[TextChunkTypedDict]]
 
 
-Content = Union[str, List[ContentChunk]]
+SystemMessageContent = Union[str, List[TextChunk]]
 
 
 Role = Literal["system"]
 
+
 class SystemMessageTypedDict(TypedDict):
-    content: ContentTypedDict
+    content: SystemMessageContentTypedDict
     role: NotRequired[Role]
-    
+
 
 class SystemMessage(BaseModel):
-    content: Content
+    content: SystemMessageContent
+
     role: Optional[Role] = "system"
-    

mistralai_gcp/models/textchunk.py

@@ -2,16 +2,25 @@
 
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
+from mistralai_gcp.utils import validate_const
 import pydantic
-from typing import Final, Optional, TypedDict
-from typing_extensions import Annotated
+from pydantic.functional_validators import AfterValidator
+from typing import Literal, Optional
+from typing_extensions import Annotated, TypedDict
+
+
+Type = Literal["text"]
 
 
 class TextChunkTypedDict(TypedDict):
     text: str
-    
+    type: Type
+
 
 class TextChunk(BaseModel):
     text: str
-    TYPE: Annotated[Final[Optional[str]], pydantic.Field(alias="type")] = "text" # type: ignore
-    
+
+    TYPE: Annotated[
+        Annotated[Optional[Type], AfterValidator(validate_const("text"))],
+        pydantic.Field(alias="type"),
+    ] = "text"

mistralai_gcp/models/tool.py

@@ -2,21 +2,22 @@
 
 from __future__ import annotations
 from .function import Function, FunctionTypedDict
-from mistralai_gcp.types import BaseModel, UnrecognizedStr
+from .tooltypes import ToolTypes
+from mistralai_gcp.types import BaseModel
 from mistralai_gcp.utils import validate_open_enum
 from pydantic.functional_validators import PlainValidator
-from typing import Literal, Optional, TypedDict, Union
-from typing_extensions import Annotated, NotRequired
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
 
 
-ToolToolTypes = Union[Literal["function"], UnrecognizedStr]
-
 class ToolTypedDict(TypedDict):
     function: FunctionTypedDict
-    type: NotRequired[ToolToolTypes]
-    
+    type: NotRequired[ToolTypes]
+
 
 class Tool(BaseModel):
     function: Function
-    type: Annotated[Optional[ToolToolTypes], PlainValidator(validate_open_enum(False))] = "function"
-    
+
+    type: Annotated[Optional[ToolTypes], PlainValidator(validate_open_enum(False))] = (
+        None
+    )

mistralai_gcp/models/toolcall.py

@@ -2,23 +2,25 @@
 
 from __future__ import annotations
 from .functioncall import FunctionCall, FunctionCallTypedDict
-from mistralai_gcp.types import BaseModel, UnrecognizedStr
+from .tooltypes import ToolTypes
+from mistralai_gcp.types import BaseModel
 from mistralai_gcp.utils import validate_open_enum
 from pydantic.functional_validators import PlainValidator
-from typing import Literal, Optional, TypedDict, Union
-from typing_extensions import Annotated, NotRequired
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
 
 
-ToolTypes = Union[Literal["function"], UnrecognizedStr]
-
 class ToolCallTypedDict(TypedDict):
     function: FunctionCallTypedDict
     id: NotRequired[str]
     type: NotRequired[ToolTypes]
-    
+
 
 class ToolCall(BaseModel):
     function: FunctionCall
+
     id: Optional[str] = "null"
-    type: Annotated[Optional[ToolTypes], PlainValidator(validate_open_enum(False))] = "function"
-    
+
+    type: Annotated[Optional[ToolTypes], PlainValidator(validate_open_enum(False))] = (
+        None
+    )

mistralai_gcp/models/toolchoice.py

@@ -0,0 +1,29 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .functionname import FunctionName, FunctionNameTypedDict
+from .tooltypes import ToolTypes
+from mistralai_gcp.types import BaseModel
+from mistralai_gcp.utils import validate_open_enum
+from pydantic.functional_validators import PlainValidator
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class ToolChoiceTypedDict(TypedDict):
+    r"""ToolChoice is either a ToolChoiceEnum or a ToolChoice"""
+
+    function: FunctionNameTypedDict
+    r"""this restriction of `Function` is used to select a specific function to call"""
+    type: NotRequired[ToolTypes]
+
+
+class ToolChoice(BaseModel):
+    r"""ToolChoice is either a ToolChoiceEnum or a ToolChoice"""
+
+    function: FunctionName
+    r"""this restriction of `Function` is used to select a specific function to call"""
+
+    type: Annotated[Optional[ToolTypes], PlainValidator(validate_open_enum(False))] = (
+        None
+    )

mistralai_gcp/models/toolchoiceenum.py

@@ -0,0 +1,7 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from typing import Literal
+
+
+ToolChoiceEnum = Literal["auto", "none", "any", "required"]

mistralai_gcp/models/toolmessage.py

@@ -1,27 +1,37 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from mistralai_gcp.types import BaseModel, Nullable, OptionalNullable, UNSET, UNSET_SENTINEL
+from mistralai_gcp.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
 from pydantic import model_serializer
-from typing import Literal, Optional, TypedDict
-from typing_extensions import NotRequired
+from typing import Literal, Optional
+from typing_extensions import NotRequired, TypedDict
 
 
 ToolMessageRole = Literal["tool"]
 
+
 class ToolMessageTypedDict(TypedDict):
     content: str
     tool_call_id: NotRequired[Nullable[str]]
     name: NotRequired[Nullable[str]]
     role: NotRequired[ToolMessageRole]
-    
+
 
 class ToolMessage(BaseModel):
     content: str
+
     tool_call_id: OptionalNullable[str] = UNSET
+
     name: OptionalNullable[str] = UNSET
+
     role: Optional[ToolMessageRole] = "tool"
-    
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
         optional_fields = ["tool_call_id", "name", "role"]
@@ -35,9 +45,13 @@ class ToolMessage(BaseModel):
         for n, f in self.model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
+            serialized.pop(k, None)
 
             optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (self.__pydantic_fields_set__.intersection({n}) or k in null_default_fields) # pylint: disable=no-member
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
 
             if val is not None and val != UNSET_SENTINEL:
                 m[k] = val
@@ -47,4 +61,3 @@ class ToolMessage(BaseModel):
                 m[k] = val
 
         return m
-        

mistralai_gcp/models/tooltypes.py

@@ -0,0 +1,8 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from mistralai_gcp.types import UnrecognizedStr
+from typing import Literal, Union
+
+
+ToolTypes = Union[Literal["function"], UnrecognizedStr]

mistralai_gcp/models/usageinfo.py

@@ -2,17 +2,18 @@
 
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
-from typing import TypedDict
+from typing_extensions import TypedDict
 
 
 class UsageInfoTypedDict(TypedDict):
     prompt_tokens: int
     completion_tokens: int
     total_tokens: int
-    
+
 
 class UsageInfo(BaseModel):
     prompt_tokens: int
+
     completion_tokens: int
+
     total_tokens: int
-    

mistralai_gcp/models/usermessage.py

@@ -1,26 +1,58 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from .textchunk import TextChunk, TextChunkTypedDict
-from mistralai_gcp.types import BaseModel
-from typing import List, Literal, Optional, TypedDict, Union
-from typing_extensions import NotRequired
+from .contentchunk import ContentChunk, ContentChunkTypedDict
+from mistralai_gcp.types import BaseModel, Nullable, UNSET_SENTINEL
+from pydantic import model_serializer
+from typing import List, Literal, Optional, Union
+from typing_extensions import NotRequired, TypedDict
 
 
-UserMessageContentTypedDict = Union[str, List[TextChunkTypedDict]]
+UserMessageContentTypedDict = Union[str, List[ContentChunkTypedDict]]
 
 
-UserMessageContent = Union[str, List[TextChunk]]
+UserMessageContent = Union[str, List[ContentChunk]]
 
 
 UserMessageRole = Literal["user"]
 
+
 class UserMessageTypedDict(TypedDict):
-    content: UserMessageContentTypedDict
+    content: Nullable[UserMessageContentTypedDict]
     role: NotRequired[UserMessageRole]
-    
+
 
 class UserMessage(BaseModel):
-    content: UserMessageContent
+    content: Nullable[UserMessageContent]
+
     role: Optional[UserMessageRole] = "user"
-    
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["role"]
+        nullable_fields = ["content"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in self.model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m

mistralai_gcp/models/validationerror.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 from mistralai_gcp.types import BaseModel
-from typing import List, TypedDict, Union
+from typing import List, Union
+from typing_extensions import TypedDict
 
 
 LocTypedDict = Union[str, int]
@@ -15,10 +16,11 @@ class ValidationErrorTypedDict(TypedDict):
     loc: List[LocTypedDict]
     msg: str
     type: str
-    
+
 
 class ValidationError(BaseModel):
     loc: List[Loc]
+
     msg: str
+
     type: str
-