From a0ddb52fa3f3d1c00631b8df8f18cc495f473ad3 Mon Sep 17 00:00:00 2001
From: Tim Conley <timothy.conley@temporal.io>
Date: Fri, 13 Mar 2026 14:11:32 -0700
Subject: [PATCH 1/2] Add experimental notices to ADK top level objects

---
 temporalio/contrib/google_adk_agents/_mcp.py     | 8 ++++++++
 temporalio/contrib/google_adk_agents/_plugin.py  | 8 ++++++++
 temporalio/contrib/google_adk_agents/workflow.py | 4 ++++
 3 files changed, 20 insertions(+)

diff --git a/temporalio/contrib/google_adk_agents/_mcp.py b/temporalio/contrib/google_adk_agents/_mcp.py
index c4b6cdf5f..6c6123806 100644
--- a/temporalio/contrib/google_adk_agents/_mcp.py
+++ b/temporalio/contrib/google_adk_agents/_mcp.py
@@ -82,6 +82,10 @@ class _CallToolArguments:
 class TemporalMcpToolSetProvider:
     """Provider for creating Temporal-aware MCP toolsets.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     Manages the creation of toolset activities and handles tool execution
     within Temporal workflows.
     """
@@ -198,6 +202,10 @@ async def run_async(
 class TemporalMcpToolSet(BaseToolset):
     """Temporal-aware MCP toolset implementation.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     Executes MCP tools as Temporal activities, providing proper isolation
     and execution guarantees within workflows.
     """
diff --git a/temporalio/contrib/google_adk_agents/_plugin.py b/temporalio/contrib/google_adk_agents/_plugin.py
index 89dc7fc99..89b6ba92a 100644
--- a/temporalio/contrib/google_adk_agents/_plugin.py
+++ b/temporalio/contrib/google_adk_agents/_plugin.py
@@ -23,6 +23,10 @@
 def setup_deterministic_runtime():
     """Configures ADK runtime for Temporal determinism.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     This should be called at the start of a Temporal Workflow before any ADK components
     (like SessionService) are used, if they rely on runtime.get_time() or runtime.new_uuid().
     """
@@ -52,6 +56,10 @@ def _deterministic_id_provider() -> str:
 class GoogleAdkPlugin(SimplePlugin):
     """A Temporal Worker Plugin configured for ADK.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     This plugin configures:
     - Pydantic Payload Converter (required for ADK objects).
     - Sandbox Passthrough for google.adk and google.genai modules.
diff --git a/temporalio/contrib/google_adk_agents/workflow.py b/temporalio/contrib/google_adk_agents/workflow.py
index 0a65809cd..8de0742f6 100644
--- a/temporalio/contrib/google_adk_agents/workflow.py
+++ b/temporalio/contrib/google_adk_agents/workflow.py
@@ -9,6 +9,10 @@
 def activity_tool(activity_def: Callable, **kwargs: Any) -> Callable:
     """Decorator/Wrapper to wrap a Temporal Activity as an ADK Tool.
 
+    .. warning::
+        This class is experimental and may change in future versions.
+        Use with caution in production environments.
+
     This ensures the activity's signature is preserved for ADK's tool schema generation
     while marking it as a tool that executes via 'workflow.execute_activity'.
     """

From 6928c2b862cc6f91cf70350eb5461af2832f44f4 Mon Sep 17 00:00:00 2001
From: Tim Conley <timothy.conley@temporal.io>
Date: Fri, 13 Mar 2026 14:16:56 -0700
Subject: [PATCH 2/2] Add experimental notices to ADK top level objects

---
 temporalio/contrib/google_adk_agents/_plugin.py  | 2 +-
 temporalio/contrib/google_adk_agents/workflow.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/temporalio/contrib/google_adk_agents/_plugin.py b/temporalio/contrib/google_adk_agents/_plugin.py
index 89b6ba92a..03cb78998 100644
--- a/temporalio/contrib/google_adk_agents/_plugin.py
+++ b/temporalio/contrib/google_adk_agents/_plugin.py
@@ -24,7 +24,7 @@ def setup_deterministic_runtime():
     """Configures ADK runtime for Temporal determinism.
 
     .. warning::
-        This class is experimental and may change in future versions.
+        This function is experimental and may change in future versions.
         Use with caution in production environments.
 
     This should be called at the start of a Temporal Workflow before any ADK components
diff --git a/temporalio/contrib/google_adk_agents/workflow.py b/temporalio/contrib/google_adk_agents/workflow.py
index 8de0742f6..42ff7246f 100644
--- a/temporalio/contrib/google_adk_agents/workflow.py
+++ b/temporalio/contrib/google_adk_agents/workflow.py
@@ -10,7 +10,7 @@ def activity_tool(activity_def: Callable, **kwargs: Any) -> Callable:
     """Decorator/Wrapper to wrap a Temporal Activity as an ADK Tool.
 
     .. warning::
-        This class is experimental and may change in future versions.
+        This function is experimental and may change in future versions.
         Use with caution in production environments.
 
     This ensures the activity's signature is preserved for ADK's tool schema generation