Google adk tour (#33)

* Restate runner

* Improve runner abstraction

* Add mcp and websearch examples

* Add mcp examples

* bind websearch and mcp approval agents

* Cleanup

* Context manager runner

* Cleanup

* Use SDK OpenAI extensions

* add retry opts

* update template

* update openai agents tour

* update openai agents tour

* Add ADK tour examples

* Add ADK tour

* Use RestateSession everywhere

* Google ADK tour

* Google ADK tour

* Fix service version

* Delete experiment

* Add git workflows for adk

* update readme

* update links

* update git workflow

* Formatting

Author: gvdongen

.github/workflows/release.yml

@@ -25,9 +25,12 @@ jobs:
           draft: true
           files: |
                   python-openai-agents-tour-of-agents.zip
+                  python-openai-agents-examples.zip
                   python-openai-agents-template.zip
+                  python-google-adk-tour-of-agents.zip
                   python-patterns.zip
                   typescript-vercel-ai-examples.zip
                   typescript-vercel-ai-template.zip
                   typescript-vercel-ai-template-nextjs.zip
                   typescript-vercel-ai-tour-of-agents.zip
+                  typescript-patterns.zip

.tools/run_python_tests.sh

@@ -29,6 +29,10 @@ function python_mypi_lint() {
 # OpenAI agents Python examples
 pushd $PROJECT_ROOT/openai-agents/template && python_mypi_lint && popd
 pushd $PROJECT_ROOT/openai-agents/tour-of-agents && python_mypi_lint && popd
+pushd $PROJECT_ROOT/openai-agents/examples && python_mypi_lint && popd
+
+# Google ADK agents Python examples
+pushd $PROJECT_ROOT/google-adk/tour-of-agents && python_mypi_lint && popd
 
 # Pattern Python examples
 pushd $PROJECT_ROOT/python-patterns && python_mypi_lint && popd

.tools/update_python_examples.sh

@@ -19,7 +19,11 @@ search_and_replace_version $PROJECT_ROOT/a2a
 
 # OpenAI agents Python examples
 search_and_replace_version $PROJECT_ROOT/openai-agents/tour-of-agents
+search_and_replace_version $PROJECT_ROOT/openai-agents/examples
 search_and_replace_version $PROJECT_ROOT/openai-agents/template
 
+# Google ADK agents Python examples
+search_and_replace_version $PROJECT_ROOT/google-adk/tour-of-agents
+
 # Pattern Python examples
 search_and_replace_version $PROJECT_ROOT/python-patterns

README.md

@@ -35,13 +35,14 @@ The Restate approach works **independent of specific SDKs** but **integrates eas
 ## Full Example Catalog
 
 ### Agent SDK Integrations  
-| Integration | Example | Description | Code | Docs                                                 |
-|-------------|---------|-------------|------|------------------------------------------------------|
-| **Vercel AI SDK** | **Template** | A minimal example of how to use Restate with the Vercel AI SDK | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/template) | [📖](https://docs.restate.dev/ai-quickstart)         |
-| | **Tour of Agents** | A step-by-step tutorial showing how to build resilient agents | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/tour-of-agents) | [📖](https://docs.restate.dev/tour/vercel-ai-agents) |
-| | **Examples** | More advanced examples that can be deployed as a Next.js app on Vercel | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/examples) | -                                                    |
-| **OpenAI Agents SDK** | **Template** | A minimal example of how to use Restate with the OpenAI Agents SDK | [<img src="https://skillicons.dev/icons?i=python&theme=light" width="20" height="20">](openai-agents/template) | [📖](https://docs.restate.dev/ai-quickstart)         |
-| | **Tour of Agents** | A step-by-step tutorial showing how to build resilient agents | [<img src="https://skillicons.dev/icons?i=python&theme=light" width="20" height="20">](openai-agents/tour-of-agents) | [📖](https://docs.restate.dev/tour/openai-agents)    |
+| Integration               | Example | Description | Code                                                                                                                 | Docs                                                 |
+|---------------------------|---------|-------------|----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **Vercel AI SDK**         | **Template** | A minimal example of how to use Restate with the Vercel AI SDK | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/template)               | [📖](https://docs.restate.dev/ai-quickstart)         |
+|                           | **Tour of Agents** | A step-by-step tutorial showing how to build resilient agents | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/tour-of-agents)         | [📖](https://docs.restate.dev/tour/vercel-ai-agents) |
+|                           | **Examples** | More advanced examples that can be deployed as a Next.js app on Vercel | [<img src="https://skillicons.dev/icons?i=ts&theme=light" width="20" height="20">](vercel-ai/examples)               | -                                                    |
+| **OpenAI Agents SDK**     | **Template** | A minimal example of how to use Restate with the OpenAI Agents SDK | [<img src="https://skillicons.dev/icons?i=python&theme=light" width="20" height="20">](openai-agents/template)       | [📖](https://docs.restate.dev/ai-quickstart)         |
+|                           | **Tour of Agents** | A step-by-step tutorial showing how to build resilient agents | [<img src="https://skillicons.dev/icons?i=python&theme=light" width="20" height="20">](openai-agents/tour-of-agents) | [📖](https://docs.restate.dev/tour/openai-agents)    |
+| **Google ADK** | **Tour of Agents** | A step-by-step tutorial showing how to build resilient agents | [<img src="https://skillicons.dev/icons?i=python&theme=light" width="20" height="20">](google-adk/tour-of-agents)    | [📖](https://docs.restate.dev/tour/google-adk)       |
 
 ### Composable AI Patterns
 | Pattern                | Description | Code | Docs |

google-adk/example/.mcp.json

@@ -12,6 +12,17 @@ AI agent examples using [Restate](https://restate.dev) for durable execution and
 - **Human-in-the-loop** - Resilient approval workflows (with timeouts) ([see human-in-the-loop agent](./app/human_approval_agent.py))
 - **Parallel processing** - Concurrent agent and tool execution that can be deterministically recovered ([see parallel agent](./app/parallel_agents.py) and [parallel tools](./app/parallel_tools.py))
 
+
+## Tour of AI Agents with Restate - Python OpenAI Agents SDK
+Learn how to implement resilient agents with durable execution, human-in-the-loop, multi-agent communication, and parallel execution.
+
+[Learn more](https://docs.restate.dev/tour/google-adk)
+
+To run:
+```shell
+uv run .
+```
+
 ## Quick Start
 
 Export your Google API key:
@@ -46,3 +57,4 @@ For example, click on the `run` handler of the `WeatherAgent` service and send t
 
 In the invocations tab, you see the execution journal when clicking on the invocation ID:
 ![See journal](./docs/images/journal.png)
+

google-adk/example/app/durable_stateful_agent.py

@@ -4,11 +4,17 @@
 
 from app.chat import chat
 from app.durable_agent import agent_service as weather_agent
-from app.durable_stateful_agent import agent_service as stateful_weather_agent
 from app.human_approval_agent import agent_service as human_claim_approval_agent
+from app.human_approval_agent_with_timeout import (
+    agent_service as human_claim_approval_with_timeout_agent,
+)
 from app.multi_agent import agent_service as multi_agent_claim_approval
+from app.multi_agent_remote import agent_service as multi_agent_remote
 from app.parallel_agents import agent_service as parallel_agent_claim_approval
 from app.parallel_tools import agent_service as parallel_tool_claim_agent
+from app.sub_workflow_agent import human_approval_workflow
+from app.sub_workflow_agent import agent_service as sub_workflow_agent
+from app.error_handling import agent_service as error_handling_agent
 from app.utils.utils import (
     fraud_agent_service,
     rate_comparison_agent_service,
@@ -21,14 +27,19 @@
         chat,
         # Durable execution
         weather_agent,
-        stateful_weather_agent,
         # Orchestration
         multi_agent_claim_approval,
+        multi_agent_remote,
+        human_approval_workflow,
+        sub_workflow_agent,
         # Human-in-the-loop
         human_claim_approval_agent,
+        human_claim_approval_with_timeout_agent,
         # Parallel processing
         parallel_agent_claim_approval,
         parallel_tool_claim_agent,
+        # Error handling
+        error_handling_agent,
         # Utility agents
         fraud_agent_service,
         rate_comparison_agent_service,