Align AI samples on env-configurable address, path runs, modern typing

- Google ADK scripts read TEMPORAL_ADDRESS with a localhost:7233 default, as
  the Strands and LangGraph samples already do.
- Google ADK docs invoke scripts by path (`uv run <dir>/run_worker.py`) rather
  than `uv run python -m <module>`, matching the other suites.
- Strands samples use `str | None` instead of `Optional[str]`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: brianstrauch

google_adk_agents/README.md

@@ -52,6 +52,6 @@ To run any scenario, start its worker in one terminal and its workflow starter
 in another:
 
 ```bash
-uv run python -m google_adk_agents.<scenario>.run_worker
-uv run python -m google_adk_agents.<scenario>.run_<name>_workflow
+uv run google_adk_agents/<scenario>/run_worker.py
+uv run google_adk_agents/<scenario>/run_<name>_workflow.py
 ```

google_adk_agents/agent_patterns/README.md

@@ -15,13 +15,13 @@ Before running, review the [prerequisites in the suite README](../README.md)
 Start the worker in one terminal:
 
 ```bash
-uv run python -m google_adk_agents.agent_patterns.run_worker
+uv run google_adk_agents/agent_patterns/run_worker.py
 ```
 
 Then start the workflow in another terminal:
 
 ```bash
-uv run python -m google_adk_agents.agent_patterns.run_multi_agent_workflow
+uv run google_adk_agents/agent_patterns/run_multi_agent_workflow.py
 ```
 
 ## What to expect

google_adk_agents/agent_patterns/run_multi_agent_workflow.py

@@ -1,4 +1,5 @@
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -9,7 +10,10 @@
 
 
 async def main():
-    client = await Client.connect("localhost:7233", plugins=[GoogleAdkPlugin()])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"),
+        plugins=[GoogleAdkPlugin()],
+    )
 
     result = await client.execute_workflow(
         MultiAgentWorkflow.run,

google_adk_agents/agent_patterns/run_worker.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -14,7 +15,9 @@
 async def main():
     plugin = GoogleAdkPlugin()
 
-    client = await Client.connect("localhost:7233", plugins=[plugin])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"), plugins=[plugin]
+    )
 
     worker = Worker(
         client,

google_adk_agents/basic/README.md

@@ -17,13 +17,13 @@ Before running, review the [prerequisites in the suite README](../README.md)
 Start the worker in one terminal:
 
 ```bash
-uv run python -m google_adk_agents.basic.run_worker
+uv run google_adk_agents/basic/run_worker.py
 ```
 
 Then start the workflow in another terminal:
 
 ```bash
-uv run python -m google_adk_agents.basic.run_hello_world_workflow
+uv run google_adk_agents/basic/run_hello_world_workflow.py
 ```
 
 ## What to expect

google_adk_agents/basic/run_hello_world_workflow.py

@@ -1,4 +1,5 @@
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -10,7 +11,10 @@
 
 async def main():
     # @@@SNIPSTART google-adk-agents-basic-starter
-    client = await Client.connect("localhost:7233", plugins=[GoogleAdkPlugin()])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"),
+        plugins=[GoogleAdkPlugin()],
+    )
 
     result = await client.execute_workflow(
         HelloWorldAgentWorkflow.run,

google_adk_agents/basic/run_worker.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -15,7 +16,9 @@ async def main():
     # @@@SNIPSTART google-adk-agents-basic-worker
     plugin = GoogleAdkPlugin()
 
-    client = await Client.connect("localhost:7233", plugins=[plugin])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"), plugins=[plugin]
+    )
 
     worker = Worker(
         client,

google_adk_agents/chatbot/README.md

@@ -21,13 +21,13 @@ Before running, review the [prerequisites in the suite README](../README.md)
 Start the worker in one terminal:
 
 ```bash
-uv run python -m google_adk_agents.chatbot.run_worker
+uv run google_adk_agents/chatbot/run_worker.py
 ```
 
 Then start the interactive client in another terminal:
 
 ```bash
-uv run python -m google_adk_agents.chatbot.run_chatbot_workflow
+uv run google_adk_agents/chatbot/run_chatbot_workflow.py
 ```
 
 ## What to expect

google_adk_agents/chatbot/run_chatbot_workflow.py

@@ -1,4 +1,5 @@
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -10,7 +11,10 @@
 
 async def main():
     # @@@SNIPSTART google-adk-agents-chatbot-starter
-    client = await Client.connect("localhost:7233", plugins=[GoogleAdkPlugin()])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"),
+        plugins=[GoogleAdkPlugin()],
+    )
 
     handle = await client.start_workflow(
         ChatbotAgentWorkflow.run,

google_adk_agents/chatbot/run_worker.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+import os
 
 from temporalio.client import Client
 from temporalio.contrib.google_adk_agents import GoogleAdkPlugin
@@ -15,7 +16,9 @@ async def main():
     # @@@SNIPSTART google-adk-agents-chatbot-worker
     plugin = GoogleAdkPlugin()
 
-    client = await Client.connect("localhost:7233", plugins=[plugin])
+    client = await Client.connect(
+        os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"), plugins=[plugin]
+    )
 
     worker = Worker(
         client,