feat: Add comprehensive Oracle Cloud Infrastructure (OCI) client support

Implements full OCI Generative AI integration following the proven AWS client architecture pattern.

Features:
- OciClient (v1) and OciClientV2 (v2) for complete API coverage
- All authentication methods: config file, direct credentials, instance principal, resource principal
- Complete API support: embed, chat, generate, rerank (including streaming variants)
- Automatic model name normalization (adds 'cohere.' prefix if needed)
- Request/response transformation between Cohere and OCI formats
- Comprehensive integration tests with multiple test suites
- Full documentation with usage examples

Implementation Details:
- Uses httpx event hooks for clean request/response interception
- Lazy loading of OCI SDK as optional dependency
- Follows BedrockClient architecture pattern for consistency
- Supports all OCI regions and compartment-based access control

Testing:
- 40+ integration tests across 5 test suites
- Tests all authentication methods
- Validates all APIs (embed, chat, generate, rerank, streaming)
- Tests multiple Cohere models (embed-v3, light-v3, multilingual-v3, command-r-plus, rerank-v3)
- Error handling and edge case coverage

Documentation:
- Comprehensive docstrings with usage examples
- README section with authentication examples
- Installation instructions for OCI optional dependency

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: fede-kamel

README.md

@@ -58,6 +58,85 @@ for event in response:
         print(event.delta.message.content.text, end="")
 ```
 
+## Oracle Cloud Infrastructure (OCI)
+
+The SDK supports Oracle Cloud Infrastructure (OCI) Generative AI service. First, install the OCI SDK:
+
+```
+pip install 'cohere[oci]'
+```
+
+Then use the `OciClient` or `OciClientV2`:
+
+```Python
+import cohere
+
+# Using OCI config file authentication (default: ~/.oci/config)
+co = cohere.OciClient(
+    oci_region="us-chicago-1",
+    oci_compartment_id="ocid1.compartment.oc1...",
+)
+
+response = co.embed(
+    model="embed-english-v3.0",
+    texts=["Hello world"],
+    input_type="search_document",
+)
+
+print(response.embeddings)
+```
+
+### OCI Authentication Methods
+
+**1. Config File (Default)**
+```Python
+co = cohere.OciClient(
+    oci_region="us-chicago-1",
+    oci_compartment_id="ocid1.compartment.oc1...",
+    # Uses ~/.oci/config with DEFAULT profile
+)
+```
+
+**2. Custom Profile**
+```Python
+co = cohere.OciClient(
+    oci_profile="MY_PROFILE",
+    oci_region="us-chicago-1",
+    oci_compartment_id="ocid1.compartment.oc1...",
+)
+```
+
+**3. Direct Credentials**
+```Python
+co = cohere.OciClient(
+    oci_user_id="ocid1.user.oc1...",
+    oci_fingerprint="xx:xx:xx:...",
+    oci_tenancy_id="ocid1.tenancy.oc1...",
+    oci_private_key_path="~/.oci/key.pem",
+    oci_region="us-chicago-1",
+    oci_compartment_id="ocid1.compartment.oc1...",
+)
+```
+
+**4. Instance Principal (for OCI Compute instances)**
+```Python
+co = cohere.OciClient(
+    auth_type="instance_principal",
+    oci_region="us-chicago-1",
+    oci_compartment_id="ocid1.compartment.oc1...",
+)
+```
+
+### Supported OCI APIs
+
+The OCI client supports all Cohere APIs:
+- Embed (with multiple embedding types)
+- Chat (with streaming via `chat_stream`)
+- Generate (with streaming via `generate_stream`)
+- Rerank
+
+See the [OCI client documentation](https://docs.cohere.com/docs/cohere-works-everywhere) for more details.
+
 ## Contributing
 
 While we value open-source contributions to this SDK, the code is generated programmatically. Additions made directly would have to be moved over to our generation code, otherwise they would be overwritten upon the next generated release. Feel free to open a PR as a proof of concept, but know that we will not be able to merge it as-is. We suggest opening an issue first to discuss with us!

pyproject.toml

@@ -53,6 +53,12 @@ python-dateutil = "^2.9.0"
 types-python-dateutil = "^2.9.0.20240316"
 ruff = "==0.11.5"
 
+[tool.poetry.group.oci]
+optional = true
+
+[tool.poetry.group.oci.dependencies]
+oci = "^2.165.0"
+
 [tool.pytest.ini_options]
 testpaths = [ "tests" ]
 asyncio_mode = "auto"

src/cohere/__init__.py

@@ -516,6 +516,8 @@
     "NotFoundError": ".errors",
     "NotImplementedError": ".errors",
     "OAuthAuthorizeResponse": ".types",
+    "OciClient": ".oci_client",
+    "OciClientV2": ".oci_client",
     "ParseInfo": ".types",
     "RerankDocument": ".types",
     "RerankRequestDocumentsItem": ".types",
@@ -848,6 +850,8 @@ def __dir__():
     "NotFoundError",
     "NotImplementedError",
     "OAuthAuthorizeResponse",
+    "OciClient",
+    "OciClientV2",
     "ParseInfo",
     "RerankDocument",
     "RerankRequestDocumentsItem",

src/cohere/manually_maintained/lazy_oci_deps.py

@@ -0,0 +1,30 @@
+"""Lazy loading for optional OCI SDK dependency."""
+
+from typing import Any
+
+OCI_INSTALLATION_MESSAGE = """
+The OCI SDK is required to use OciClient or OciClientV2.
+
+Install it with:
+    pip install oci
+
+Or with the optional dependency group:
+    pip install cohere[oci]
+"""
+
+
+def lazy_oci() -> Any:
+    """
+    Lazily import the OCI SDK.
+
+    Returns:
+        The oci module
+
+    Raises:
+        ImportError: If the OCI SDK is not installed
+    """
+    try:
+        import oci
+        return oci
+    except ImportError:
+        raise ImportError(OCI_INSTALLATION_MESSAGE)