SDK regeneration

Author: fern-api[bot]

poetry.lock

@@ -3,7 +3,7 @@ name = "cohere"
 
 [tool.poetry]
 name = "cohere"
-version = "5.16.1"
+version = "5.16.2"
 description = ""
 readme = "README.md"
 authors = []

pyproject.toml

@@ -27,6 +27,7 @@
     ChatContentStartEventDelta,
     ChatContentStartEventDeltaMessage,
     ChatContentStartEventDeltaMessageContent,
+    ChatContentStartEventDeltaMessageContentType,
     ChatDataMetrics,
     ChatDebugEvent,
     ChatDocument,
@@ -205,6 +206,7 @@
     TextResponseFormatV2,
     TextSystemMessageV2ContentItem,
     TextToolContent,
+    ThinkingAssistantMessageResponseContentItem,
     TokenizeResponse,
     Tool,
     ToolCall,
@@ -325,6 +327,7 @@
     "ChatContentStartEventDelta",
     "ChatContentStartEventDeltaMessage",
     "ChatContentStartEventDeltaMessageContent",
+    "ChatContentStartEventDeltaMessageContentType",
     "ChatDataMetrics",
     "ChatDebugEvent",
     "ChatDocument",
@@ -536,6 +539,7 @@
     "TextResponseFormatV2",
     "TextSystemMessageV2ContentItem",
     "TextToolContent",
+    "ThinkingAssistantMessageResponseContentItem",
     "TokenizeResponse",
     "TooManyRequestsError",
     "Tool",

src/cohere/__init__.py

@@ -22,10 +22,10 @@ def __init__(
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "cohere/5.16.1",
+            "User-Agent": "cohere/5.16.2",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "cohere",
-            "X-Fern-SDK-Version": "5.16.1",
+            "X-Fern-SDK-Version": "5.16.2",
         }
         if self._client_name is not None:
             headers["X-Client-Name"] = self._client_name

src/cohere/core/client_wrapper.py

@@ -44,6 +44,8 @@ def list_finetuned_models(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListFinetunedModelsResponse:
         """
+        Returns a list of fine-tuned models that the user has access to.
+
         Parameters
         ----------
         page_size : typing.Optional[int]
@@ -88,6 +90,8 @@ def create_finetuned_model(
         self, *, request: FinetunedModel, request_options: typing.Optional[RequestOptions] = None
     ) -> CreateFinetunedModelResponse:
         """
+        Creates a new fine-tuned model. The model will be trained on the dataset specified in the request body. The training process may take some time, and the model will be available once the training is complete.
+
         Parameters
         ----------
         request : FinetunedModel
@@ -128,6 +132,8 @@ def get_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> GetFinetunedModelResponse:
         """
+        Retrieve a fine-tuned model by its ID.
+
         Parameters
         ----------
         id : str
@@ -160,6 +166,9 @@ def delete_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> DeleteFinetunedModelResponse:
         """
+        Deletes a fine-tuned model. The model will be removed from the system and will no longer be available for use.
+        This operation is irreversible.
+
         Parameters
         ----------
         id : str
@@ -198,6 +207,8 @@ def update_finetuned_model(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> UpdateFinetunedModelResponse:
         """
+        Updates the fine-tuned model with the given ID. The model will be updated with the new settings and name provided in the request body.
+
         Parameters
         ----------
         id : str
@@ -255,6 +266,10 @@ def list_events(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListEventsResponse:
         """
+        Returns a list of events that occurred during the life-cycle of the fine-tuned model.
+        The events are ordered by creation time, with the most recent event first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -313,6 +328,10 @@ def list_training_step_metrics(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListTrainingStepMetricsResponse:
         """
+        Returns a list of metrics measured during the training of a fine-tuned model.
+        The metrics are ordered by step number, with the most recent step first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -375,6 +394,8 @@ async def list_finetuned_models(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListFinetunedModelsResponse:
         """
+        Returns a list of fine-tuned models that the user has access to.
+
         Parameters
         ----------
         page_size : typing.Optional[int]
@@ -427,6 +448,8 @@ async def create_finetuned_model(
         self, *, request: FinetunedModel, request_options: typing.Optional[RequestOptions] = None
     ) -> CreateFinetunedModelResponse:
         """
+        Creates a new fine-tuned model. The model will be trained on the dataset specified in the request body. The training process may take some time, and the model will be available once the training is complete.
+
         Parameters
         ----------
         request : FinetunedModel
@@ -475,6 +498,8 @@ async def get_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> GetFinetunedModelResponse:
         """
+        Retrieve a fine-tuned model by its ID.
+
         Parameters
         ----------
         id : str
@@ -515,6 +540,9 @@ async def delete_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> DeleteFinetunedModelResponse:
         """
+        Deletes a fine-tuned model. The model will be removed from the system and will no longer be available for use.
+        This operation is irreversible.
+
         Parameters
         ----------
         id : str
@@ -561,6 +589,8 @@ async def update_finetuned_model(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> UpdateFinetunedModelResponse:
         """
+        Updates the fine-tuned model with the given ID. The model will be updated with the new settings and name provided in the request body.
+
         Parameters
         ----------
         id : str
@@ -626,6 +656,10 @@ async def list_events(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListEventsResponse:
         """
+        Returns a list of events that occurred during the life-cycle of the fine-tuned model.
+        The events are ordered by creation time, with the most recent event first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -692,6 +726,10 @@ async def list_training_step_metrics(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ListTrainingStepMetricsResponse:
         """
+        Returns a list of metrics measured during the training of a fine-tuned model.
+        The metrics are ordered by step number, with the most recent step first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str

src/cohere/finetuning/client.py

@@ -44,6 +44,8 @@ def list_finetuned_models(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ListFinetunedModelsResponse]:
         """
+        Returns a list of fine-tuned models that the user has access to.
+
         Parameters
         ----------
         page_size : typing.Optional[int]
@@ -164,6 +166,8 @@ def create_finetuned_model(
         self, *, request: FinetunedModel, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[CreateFinetunedModelResponse]:
         """
+        Creates a new fine-tuned model. The model will be trained on the dataset specified in the request body. The training process may take some time, and the model will be available once the training is complete.
+
         Parameters
         ----------
         request : FinetunedModel
@@ -271,6 +275,8 @@ def get_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[GetFinetunedModelResponse]:
         """
+        Retrieve a fine-tuned model by its ID.
+
         Parameters
         ----------
         id : str
@@ -374,6 +380,9 @@ def delete_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[DeleteFinetunedModelResponse]:
         """
+        Deletes a fine-tuned model. The model will be removed from the system and will no longer be available for use.
+        This operation is irreversible.
+
         Parameters
         ----------
         id : str
@@ -483,6 +492,8 @@ def update_finetuned_model(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[UpdateFinetunedModelResponse]:
         """
+        Updates the fine-tuned model with the given ID. The model will be updated with the new settings and name provided in the request body.
+
         Parameters
         ----------
         id : str
@@ -612,6 +623,10 @@ def list_events(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ListEventsResponse]:
         """
+        Returns a list of events that occurred during the life-cycle of the fine-tuned model.
+        The events are ordered by creation time, with the most recent event first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -740,6 +755,10 @@ def list_training_step_metrics(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ListTrainingStepMetricsResponse]:
         """
+        Returns a list of metrics measured during the training of a fine-tuned model.
+        The metrics are ordered by step number, with the most recent step first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -864,6 +883,8 @@ async def list_finetuned_models(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ListFinetunedModelsResponse]:
         """
+        Returns a list of fine-tuned models that the user has access to.
+
         Parameters
         ----------
         page_size : typing.Optional[int]
@@ -984,6 +1005,8 @@ async def create_finetuned_model(
         self, *, request: FinetunedModel, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[CreateFinetunedModelResponse]:
         """
+        Creates a new fine-tuned model. The model will be trained on the dataset specified in the request body. The training process may take some time, and the model will be available once the training is complete.
+
         Parameters
         ----------
         request : FinetunedModel
@@ -1091,6 +1114,8 @@ async def get_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[GetFinetunedModelResponse]:
         """
+        Retrieve a fine-tuned model by its ID.
+
         Parameters
         ----------
         id : str
@@ -1194,6 +1219,9 @@ async def delete_finetuned_model(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[DeleteFinetunedModelResponse]:
         """
+        Deletes a fine-tuned model. The model will be removed from the system and will no longer be available for use.
+        This operation is irreversible.
+
         Parameters
         ----------
         id : str
@@ -1303,6 +1331,8 @@ async def update_finetuned_model(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[UpdateFinetunedModelResponse]:
         """
+        Updates the fine-tuned model with the given ID. The model will be updated with the new settings and name provided in the request body.
+
         Parameters
         ----------
         id : str
@@ -1432,6 +1462,10 @@ async def list_events(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ListEventsResponse]:
         """
+        Returns a list of events that occurred during the life-cycle of the fine-tuned model.
+        The events are ordered by creation time, with the most recent event first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str
@@ -1560,6 +1594,10 @@ async def list_training_step_metrics(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ListTrainingStepMetricsResponse]:
         """
+        Returns a list of metrics measured during the training of a fine-tuned model.
+        The metrics are ordered by step number, with the most recent step first.
+        The list can be paginated using `page_size` and `page_token` parameters.
+
         Parameters
         ----------
         finetuned_model_id : str

src/cohere/finetuning/raw_client.py

@@ -11,6 +11,7 @@
 from .assistant_message_response_content_item import (
     AssistantMessageResponseContentItem,
     TextAssistantMessageResponseContentItem,
+    ThinkingAssistantMessageResponseContentItem,
 )
 from .assistant_message_v2content import AssistantMessageV2Content
 from .assistant_message_v2content_item import AssistantMessageV2ContentItem, TextAssistantMessageV2ContentItem
@@ -28,6 +29,7 @@
 from .chat_content_start_event_delta import ChatContentStartEventDelta
 from .chat_content_start_event_delta_message import ChatContentStartEventDeltaMessage
 from .chat_content_start_event_delta_message_content import ChatContentStartEventDeltaMessageContent
+from .chat_content_start_event_delta_message_content_type import ChatContentStartEventDeltaMessageContentType
 from .chat_data_metrics import ChatDataMetrics
 from .chat_debug_event import ChatDebugEvent
 from .chat_document import ChatDocument
@@ -248,6 +250,7 @@
     "ChatContentStartEventDelta",
     "ChatContentStartEventDeltaMessage",
     "ChatContentStartEventDeltaMessageContent",
+    "ChatContentStartEventDeltaMessageContentType",
     "ChatDataMetrics",
     "ChatDebugEvent",
     "ChatDocument",
@@ -426,6 +429,7 @@
     "TextResponseFormatV2",
     "TextSystemMessageV2ContentItem",
     "TextToolContent",
+    "ThinkingAssistantMessageResponseContentItem",
     "TokenizeResponse",
     "Tool",
     "ToolCall",

src/cohere/types/__init__.py

@@ -23,6 +23,17 @@ class Config:
             extra = pydantic.Extra.allow
 
 
+class ThinkingAssistantMessageResponseContentItem(UncheckedBaseModel):
+    value: typing.Optional[typing.Any] = None
+    type: typing.Literal["thinking"] = "thinking"
+
+    if not IS_PYDANTIC_V2:
+
+        class Config:
+            smart_union = True
+
+
 AssistantMessageResponseContentItem = typing_extensions.Annotated[
-    TextAssistantMessageResponseContentItem, UnionMetadata(discriminant="type")
+    typing.Union[TextAssistantMessageResponseContentItem, ThinkingAssistantMessageResponseContentItem],
+    UnionMetadata(discriminant="type"),
 ]

src/cohere/types/assistant_message_response_content_item.py

@@ -5,11 +5,12 @@
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 from ..core.unchecked_base_model import UncheckedBaseModel
+from .chat_content_start_event_delta_message_content_type import ChatContentStartEventDeltaMessageContentType
 
 
 class ChatContentStartEventDeltaMessageContent(UncheckedBaseModel):
     text: typing.Optional[str] = None
-    type: typing.Optional[typing.Literal["text"]] = None
+    type: typing.Optional[ChatContentStartEventDeltaMessageContentType] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow")  # type: ignore # Pydantic v2

src/cohere/types/chat_content_start_event_delta_message_content.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ChatContentStartEventDeltaMessageContentType = typing.Union[typing.Literal["text", "thinking"], typing.Any]