feat(models): Add OCI Generative AI provider for Google Gemini on OCI

pyproject.toml

@@ -131,6 +131,10 @@ optional-dependencies.extensions = [
   "pypika>=0.50",                                                    # For crewai->chromadb dependency
   "toolbox-adk>=1,<2",                                               # For tools.toolbox_toolset.ToolboxToolset
 ]
+optional-dependencies.oci = [
+  "oci>=2.126.0",                                                    # OCI Generative AI native SDK (OCIGenAILlm)
+  "openai>=1.100.2",                                                 # OpenAI-compatible v1 transport (OCIGenAIOpenAILlm)
+]
 optional-dependencies.otel-gcp = [ "opentelemetry-instrumentation-google-genai>=0.6b0,<1" ]
 optional-dependencies.slack = [ "slack-bolt>=1.22" ]
 optional-dependencies.test = [

src/google/adk/models/__init__.py

@@ -31,6 +31,8 @@
   from .gemma_llm import Gemma3Ollama
   from .google_llm import Gemini
   from .lite_llm import LiteLlm
+  from .oci_genai_llm import OCIGenAILlm
+  from .oci_genai_openai_llm import OCIGenAIOpenAILlm
 
 __all__ = [
     'ApigeeLlm',
@@ -41,6 +43,8 @@
     'Gemma3Ollama',
     'LLMRegistry',
     'LiteLlm',
+    'OCIGenAILlm',
+    'OCIGenAIOpenAILlm',
 ]
 
 _LAZY_PROVIDERS: dict[str, tuple[list[str], str]] = {
@@ -78,6 +82,21 @@
         ],
         'lite_llm',
     ),
+    'OCIGenAILlm': (
+        [
+            r'meta\.llama-.*',
+            r'google\.gemini-.*',
+            r'google\.gemma-.*',
+            r'xai\.grok-.*',
+            r'mistralai\.mistral-.*',
+            r'mistralai\.mixtral-.*',
+            r'nvidia\..*',
+        ],
+        'oci_genai_llm',
+    ),
+    # OCIGenAIOpenAILlm is not auto-routed: users instantiate it explicitly
+    # when they want the OpenAI-compat v1 transport instead of the native SDK.
+    'OCIGenAIOpenAILlm': ([], 'oci_genai_openai_llm'),
 }
 
 for _name, (_patterns, _module) in _LAZY_PROVIDERS.items():