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..03cb78998 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 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 (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..42ff7246f 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 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 while marking it as a tool that executes via 'workflow.execute_activity'. """