[fern-generated] SDK regeneration

Author: fern-api[bot]

.fern/metadata.json

@@ -100,10 +100,10 @@
       }
     ]
   },
-  "originGitCommit": "3f4bc18b3d90a318965a1fc2f5980339c012a6e2",
-  "originGitCommitIsDirty": true,
+  "originGitCommit": "5c526877987b8b4e11151461d0c251002eb24341",
+  "originGitCommitIsDirty": false,
   "invokedBy": "ci",
-  "requestedVersion": "7.0.8",
+  "requestedVersion": "7.1.0",
   "ciProvider": "github",
-  "sdkVersion": "7.0.8"
+  "sdkVersion": "7.1.0"
 }

poetry.lock

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "cohere"
-version = "7.0.8"
+version = "7.1.0"
 description = ""
 readme = "README.md"
 authors = []

pyproject.toml

@@ -2876,6 +2876,107 @@ If tool_choice isn't specified, then the model is free to choose whether to use
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.v2.<a href="src/cohere/v2/client.py">parse</a>(...) -> ParseResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Parse a document image into structured output. Use `output_format` to select
+blocks or markdown (default).
+
+Currently supports `document.type = image_url` only (data URI or remote http(s)
+image URL). PDF / file URL inputs are not yet supported.
+
+Image limits: 20 MB file size; 50 megapixels or 200 MB decoded (whichever is
+exceeded first).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```python
+from cohere import Client, ParseDocument
+from cohere.environment import ClientEnvironment
+
+client = Client(
+    token="<token>",
+    environment=ClientEnvironment.PRODUCTION,
+)
+
+client.v2.parse(
+    model="parse-v5.0",
+    document=ParseDocument(
+        type="image_url",
+        image_url="https://cohere.com/favicon-32x32.png",
+    ),
+    output_format="markdown",
+)
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**model:** `str` — The name of a compatible Cohere parse model.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**document:** `ParseDocument` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**output_format:** `typing.Optional[ParseOutputFormat]` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

reference.md

@@ -18,6 +18,7 @@
         AssistantMessageV2Content,
         AssistantMessageV2ContentOneItem,
         AuthTokenType,
+        BlocksParsePage,
         ChatCitation,
         ChatCitationGenerationEvent,
         ChatCitationType,
@@ -156,6 +157,7 @@
         GetModelResponseSamplingDefaults,
         Image,
         ImageContent,
+        ImageParseBlock,
         ImageUrl,
         ImageUrlContent,
         ImageUrlDetail,
@@ -169,11 +171,30 @@
         ListEmbedJobResponse,
         ListModelsResponse,
         LogprobItem,
+        MarkdownParsePage,
         Message,
         Metrics,
         NonStreamedChatResponse,
         OAuthAuthorizeResponse,
+        ParseBlock,
+        ParseBlocksPageVariant,
+        ParseBoundingBox,
+        ParseBoundingBoxNormalized,
+        ParseDocument,
+        ParseImageBlock,
+        ParseImageCategory,
+        ParseImageContentBlock,
         ParseInfo,
+        ParseMarkdownPage,
+        ParseMarkdownPageVariant,
+        ParseOutputFormat,
+        ParsePage,
+        ParseResponse,
+        ParseTableBlock,
+        ParseTableContentBlock,
+        ParseTableContentType,
+        ParseTextBlock,
+        ParseTextContentBlock,
         RerankDocument,
         RerankRequestDocumentsItem,
         RerankResponse,
@@ -202,12 +223,14 @@
         SystemMessageV2,
         SystemMessageV2Content,
         SystemMessageV2ContentOneItem,
+        TableParseBlock,
         TextAssistantMessageResponseContentItem,
         TextAssistantMessageV2ContentOneItem,
         TextContent,
         TextEmbedContent,
         TextGenerationGenerateStreamedResponse,
         TextGenerationStreamedChatResponse,
+        TextParseBlock,
         TextResponseFormat,
         TextResponseFormatV2,
         TextSystemMessageV2ContentOneItem,
@@ -334,6 +357,7 @@
     "BatchStatus": ".batches",
     "BedrockClient": ".bedrock_client",
     "BedrockClientV2": ".bedrock_client",
+    "BlocksParsePage": ".types",
     "CancelBatchResponse": ".batches",
     "ChatCitation": ".types",
     "ChatCitationGenerationEvent": ".types",
@@ -498,6 +522,7 @@
     "GetModelResponseSamplingDefaults": ".types",
     "Image": ".types",
     "ImageContent": ".types",
+    "ImageParseBlock": ".types",
     "ImageUrl": ".types",
     "ImageUrlContent": ".types",
     "ImageUrlDetail": ".types",
@@ -514,6 +539,7 @@
     "ListEmbedJobResponse": ".types",
     "ListModelsResponse": ".types",
     "LogprobItem": ".types",
+    "MarkdownParsePage": ".types",
     "Message": ".types",
     "MessageEndStreamedChatResponseV2": ".aliases",
     "MessageEndV2ChatStreamResponse": ".v2",
@@ -526,7 +552,25 @@
     "OAuthAuthorizeResponse": ".types",
     "OciClient": ".oci_client",
     "OciClientV2": ".oci_client",
+    "ParseBlock": ".types",
+    "ParseBlocksPageVariant": ".types",
+    "ParseBoundingBox": ".types",
+    "ParseBoundingBoxNormalized": ".types",
+    "ParseDocument": ".types",
+    "ParseImageBlock": ".types",
+    "ParseImageCategory": ".types",
+    "ParseImageContentBlock": ".types",
     "ParseInfo": ".types",
+    "ParseMarkdownPage": ".types",
+    "ParseMarkdownPageVariant": ".types",
+    "ParseOutputFormat": ".types",
+    "ParsePage": ".types",
+    "ParseResponse": ".types",
+    "ParseTableBlock": ".types",
+    "ParseTableContentBlock": ".types",
+    "ParseTableContentType": ".types",
+    "ParseTextBlock": ".types",
+    "ParseTextContentBlock": ".types",
     "RerankDocument": ".types",
     "RerankRequestDocumentsItem": ".types",
     "RerankResponse": ".types",
@@ -559,12 +603,14 @@
     "SystemMessageV2": ".types",
     "SystemMessageV2Content": ".types",
     "SystemMessageV2ContentOneItem": ".types",
+    "TableParseBlock": ".types",
     "TextAssistantMessageResponseContentItem": ".types",
     "TextAssistantMessageV2ContentOneItem": ".types",
     "TextContent": ".types",
     "TextEmbedContent": ".types",
     "TextGenerationGenerateStreamedResponse": ".types",
     "TextGenerationStreamedChatResponse": ".types",
+    "TextParseBlock": ".types",
     "TextResponseFormat": ".types",
     "TextResponseFormatV2": ".types",
     "TextSystemMessageV2ContentOneItem": ".types",
@@ -673,6 +719,7 @@ def __dir__():
     "BatchStatus",
     "BedrockClient",
     "BedrockClientV2",
+    "BlocksParsePage",
     "CancelBatchResponse",
     "ChatCitation",
     "ChatCitationGenerationEvent",
@@ -837,6 +884,7 @@ def __dir__():
     "GetModelResponseSamplingDefaults",
     "Image",
     "ImageContent",
+    "ImageParseBlock",
     "ImageUrl",
     "ImageUrlContent",
     "ImageUrlDetail",
@@ -853,6 +901,7 @@ def __dir__():
     "ListEmbedJobResponse",
     "ListModelsResponse",
     "LogprobItem",
+    "MarkdownParsePage",
     "Message",
     "MessageEndStreamedChatResponseV2",
     "MessageEndV2ChatStreamResponse",
@@ -865,7 +914,25 @@ def __dir__():
     "OAuthAuthorizeResponse",
     "OciClient",
     "OciClientV2",
+    "ParseBlock",
+    "ParseBlocksPageVariant",
+    "ParseBoundingBox",
+    "ParseBoundingBoxNormalized",
+    "ParseDocument",
+    "ParseImageBlock",
+    "ParseImageCategory",
+    "ParseImageContentBlock",
     "ParseInfo",
+    "ParseMarkdownPage",
+    "ParseMarkdownPageVariant",
+    "ParseOutputFormat",
+    "ParsePage",
+    "ParseResponse",
+    "ParseTableBlock",
+    "ParseTableContentBlock",
+    "ParseTableContentType",
+    "ParseTextBlock",
+    "ParseTextContentBlock",
     "RerankDocument",
     "RerankRequestDocumentsItem",
     "RerankResponse",
@@ -898,12 +965,14 @@ def __dir__():
     "SystemMessageV2",
     "SystemMessageV2Content",
     "SystemMessageV2ContentOneItem",
+    "TableParseBlock",
     "TextAssistantMessageResponseContentItem",
     "TextAssistantMessageV2ContentOneItem",
     "TextContent",
     "TextEmbedContent",
     "TextGenerationGenerateStreamedResponse",
     "TextGenerationStreamedChatResponse",
+    "TextParseBlock",
     "TextResponseFormat",
     "TextResponseFormatV2",
     "TextSystemMessageV2ContentOneItem",

src/cohere/__init__.py

@@ -35,12 +35,12 @@ def get_headers(self) -> typing.Dict[str, str]:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "cohere/7.0.8",
+            "User-Agent": "cohere/7.1.0",
             "X-Fern-Language": "Python",
             "X-Fern-Runtime": f"python/{platform.python_version()}",
             "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",
             "X-Fern-SDK-Name": "cohere",
-            "X-Fern-SDK-Version": "7.0.8",
+            "X-Fern-SDK-Version": "7.1.0",
             **(self.get_custom_headers() or {}),
         }
         if self._client_name is not None:

src/cohere/core/client_wrapper.py

@@ -59,12 +59,50 @@ def patched_init(self, /, **data):
     return cls
 
 
+def omit_authorization_header_when_api_key_is_empty() -> None:
+    """
+    Do not send an `Authorization` header when the client is created with an empty API key.
+
+    This allows pointing the client at a proxy or a self-hosted deployment that performs its own
+    authentication, e.g. `cohere.Client(api_key="")`.
+    """
+    from .core.client_wrapper import AsyncClientWrapper, BaseClientWrapper
+
+    if getattr(BaseClientWrapper, "_omits_empty_authorization", False):
+        return
+
+    get_headers = BaseClientWrapper.get_headers
+    async_get_headers = AsyncClientWrapper.async_get_headers
+
+    def patched_get_headers(self: BaseClientWrapper) -> typing.Dict[str, str]:
+        headers = get_headers(self)
+        # Inspect the header that get_headers() already built rather than calling _get_token()
+        # again: for the callable `api_key` form that would invoke the supplier twice per request,
+        # and a supplier whose value changes between the two calls would produce the wrong header.
+        if headers.get("Authorization") == "Bearer ":
+            headers.pop("Authorization", None)
+        return headers
+
+    async def patched_async_get_headers(self: AsyncClientWrapper) -> typing.Dict[str, str]:
+        headers = await async_get_headers(self)
+        if headers.get("Authorization") == "Bearer ":
+            headers.pop("Authorization", None)
+        return headers
+
+    BaseClientWrapper.get_headers = patched_get_headers  # type: ignore[method-assign]
+    AsyncClientWrapper.async_get_headers = patched_async_get_headers  # type: ignore[method-assign]
+    BaseClientWrapper._omits_empty_authorization = True  # type: ignore[attr-defined]
+
+
 def run_overrides():
     """
         These are overrides to allow us to make changes to generated code without touching the generated files themselves.
         Should be used judiciously!
     """
 
+    # Override to skip the Authorization header entirely when an empty api_key is passed
+    omit_authorization_header_when_api_key_is_empty()
+
     # Override to allow access to aliases in EmbedByTypeResponseEmbeddings eg embeddings.float rather than embeddings.float_
     setattr(EmbedByTypeResponseEmbeddings, "__getattr__", allow_access_to_aliases)