agent-starter-pack 0.16.0__tar.gz → 0.17.0__tar.gz

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/.claude/settings.local.json

@@ -25,7 +25,9 @@
       "Bash(python3 tests/cicd/scripts/delete_vector_search.py)",
       "Bash(PROJECT_IDS=agent-starter-pack-e2e-dev,agent-starter-pack-e2e-st,agent-starter-pack-e2e-pr python3 tests/cicd/scripts/delete_agent_engines.py)",
       "Bash(export _TEST_AGENT_COMBINATION=adk_live,agent_engine)",
-      "Bash(make lint-templated-agents)"
+      "Bash(make lint-templated-agents)",
+      "Bash(mkdir -p agent-starter-pack)",
+      "Bash(ls -la \"agent_starter_pack/base_template/{% if cookiecutter.cicd_runner == ''google_cloud_build'' %}.cloudbuild{% else %}unused_.cloudbuild{% endif %}/\")"
     ],
     "deny": [],
     "ask": []

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/.cloudbuild/ci/lint.yaml

@@ -32,7 +32,7 @@ steps:
         set -e
         uv run ruff check . --config pyproject.toml --diff
         uv run ruff format . --check  --config pyproject.toml --diff
-        uv run mypy --config-file pyproject.toml ./src/cli ./tests ./src/frontends/streamlit
+        uv run mypy --config-file pyproject.toml ./agent_starter_pack/cli ./tests ./agent_starter_pack/frontends/streamlit
 
 logsBucket: gs://${PROJECT_ID}-logs-data/build-logs
 options:

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/.cloudbuild/terraform/build_triggers.tf

@@ -23,33 +23,33 @@ locals {
   ]
 
   common_included_files = [
-    "agents/**",
-    "src/cli/**",
+    "agent_starter_pack/agents/**",
+    "agent_starter_pack/cli/**",
     "tests/**",
-    "src/data_ingestion/**",
-    "src/frontends/streamlit/**",
+    "agent_starter_pack/data_ingestion/**",
+    "agent_starter_pack/frontends/streamlit/**",
     "pyproject.toml",
     "uv.lock",
     ".cloudbuild/**",
   ]
 
   lint_templated_agents_included_files = [
-    "src/cli/**",
-    "src/base_template/**",
-    "src/data_ingestion/**",
-    "src/deployment_targets/**",
+    "agent_starter_pack/cli/**",
+    "agent_starter_pack/base_template/**",
+    "agent_starter_pack/data_ingestion/**",
+    "agent_starter_pack/deployment_targets/**",
     "tests/integration/test_template_linting.py",
     "tests/integration/test_templated_patterns.py",
-    "src/resources/locks/**",
+    "agent_starter_pack/resources/locks/**",
     "pyproject.toml",
     "uv.lock",
     ".cloudbuild/**",
   ]
 
   makefile_usability_included_files = [
-    "src/cli/**",
-    "src/base_template/**",
-    "src/deployment_targets/**",
+    "agent_starter_pack/cli/**",
+    "agent_starter_pack/base_template/**",
+    "agent_starter_pack/deployment_targets/**",
     "tests/integration/test_makefile_usability.py",
     "pyproject.toml",
     "uv.lock",
@@ -111,14 +111,14 @@ locals {
 agent_testing_included_files = { for combo in local.agent_testing_combinations :
     combo.name => [
       # Only include files for the specific agent being tested
-      "agents/${split(",", combo.value)[0]}/**",
+      "agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
       # Common files that affect all agents
-      "src/cli/**",
-      "src/base_template/**",
-      "src/deployment_targets/**",
+      "agent_starter_pack/cli/**",
+      "agent_starter_pack/base_template/**",
+      "agent_starter_pack/deployment_targets/**",
       "tests/integration/test_template_linting.py",
       "tests/integration/test_templated_patterns.py",
-      "src/resources/locks/**",
+      "agent_starter_pack/resources/locks/**",
       "pyproject.toml",
       "uv.lock",
     ]
@@ -186,25 +186,25 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
 
   e2e_agent_deployment_included_files = { for combo in local.e2e_agent_deployment_combinations :
     combo.name => combo.name == "adk_base-cloud_run-alloydb" ? [
-      "src/deployment_targets/cloud_run/**",
+      "agent_starter_pack/deployment_targets/cloud_run/**",
       "pyproject.toml",
     ] : substr(combo.name, 0, 11) == "agentic_rag" ? [
-      "agents/agentic_rag/**",
-      "src/data_ingestion/**",
+      "agent_starter_pack/agents/agentic_rag/**",
+      "agent_starter_pack/data_ingestion/**",
       "pyproject.toml",
     ] : substr(combo.name, 0, 8) == "adk_live" ? [
-      "agents/adk_live/**",
+      "agent_starter_pack/agents/adk_live/**",
       "pyproject.toml",
     ] : [
       # Only include files for the specific agent being tested
-      "agents/${split(",", combo.value)[0]}/**",
+      "agent_starter_pack/agents/${split(",", combo.value)[0]}/**",
       # Common files that affect all agents
-      "src/cli/**",
-      "src/base_template/**",
-      "src/data_ingestion/**",
-      "src/deployment_targets/**",
+      "agent_starter_pack/cli/**",
+      "agent_starter_pack/base_template/**",
+      "agent_starter_pack/data_ingestion/**",
+      "agent_starter_pack/deployment_targets/**",
       "tests/cicd/test_e2e_deployment.py",
-      "src/resources/locks/**",
+      "agent_starter_pack/resources/locks/**",
       "pyproject.toml",
       "uv.lock",
       ".cloudbuild"
@@ -426,10 +426,10 @@ resource "google_cloudbuild_trigger" "pr_test_pipeline_parity" {
   filename       = ".cloudbuild/ci/test_pipeline_parity.yaml"
   included_files = [
     "tests/integration/test_pipeline_parity.py",
-    "src/cli/**",
+    "agent_starter_pack/cli/**",
     ".cloudbuild/**",
-    "src/base_template/**/.github/**",
-    "src/base_template/**/.cloudbuild/**",
+    "agent_starter_pack/base_template/**/.github/**",
+    "agent_starter_pack/base_template/**/.cloudbuild/**",
     "pyproject.toml",
     "uv.lock",
   ]

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/GEMINI.md

@@ -7,8 +7,8 @@ This document provides essential guidance, architectural insights, and best prac
 1.  **Preserve and Isolate:** Your primary objective is surgical precision. Modify *only* the code segments directly related to the user's request. Preserve all surrounding code, comments, and formatting. Do not rewrite entire files or functions to make a small change.
 2.  **Follow Conventions:** This project relies heavily on established patterns. Before writing new code, analyze the surrounding files to understand and replicate existing conventions for naming, templating logic, and directory structure.
 3.  **Search Comprehensively:** A single change often requires updates in multiple places. When modifying configuration, variables, or infrastructure, you **must** search across the entire repository, including:
-    *   `src/base_template/` (the core template)
-    *   `src/deployment_targets/` (environment-specific overrides)
+    *   `agent-starter-pack/base_template/` (the core template)
+    *   `agent-starter-pack/deployment_targets/` (environment-specific overrides)
     *   `.github/` and `.cloudbuild/` (CI/CD workflows)
     *   `docs/` (user-facing documentation)
 
@@ -28,10 +28,10 @@ Templates are processed in a specific order. A failure at any stage will break t
 
 ### Key Directory Structures
 
--   `src/base_template/`: This is the **core template**. Most changes that should apply to all generated projects should start here.
--   `src/deployment_targets/`: Contains files that **override or are added to** the `base_template` for a specific deployment target (e.g., `cloud_run`, `gke`, `agent_engine`). If a file exists in both `base_template` and a deployment target, the latter is typically used.
--   `agents/`: Contains pre-packaged, self-contained agent examples. Each has its own `.template/templateconfig.yaml` to define its specific variables and dependencies.
--   `src/cli/commands`: Contains the logic for the CLI commands, such as `create` and `setup-cicd`.
+-   `agent-starter-pack/base_template/`: This is the **core template**. Most changes that should apply to all generated projects should start here.
+-   `agent-starter-pack/deployment_targets/`: Contains files that **override or are added to** the `base_template` for a specific deployment target (e.g., `cloud_run`, `gke`, `agent_engine`). If a file exists in both `base_template` and a deployment target, the latter is typically used.
+-   `agent-starter-pack/agents/`: Contains pre-packaged, self-contained agent examples. Each has its own `.template/templateconfig.yaml` to define its specific variables and dependencies.
+-   `agent-starter-pack/cli/commands`: Contains the logic for the CLI commands, such as `create` and `setup-cicd`.
 
 ### CLI Commands
 
@@ -40,7 +40,7 @@ Templates are processed in a specific order. A failure at any stage will break t
 
 ### Template Processing
 
--   `template.py`: Located in `src/cli/utils`, this script contains the core logic for processing the templates. It copies the base template, overlays the deployment target files, and then applies the agent-specific files.
+-   `template.py`: Located in `agent-starter-pack/cli/utils`, this script contains the core logic for processing the templates. It copies the base template, overlays the deployment target files, and then applies the agent-specific files.
 
 ## Critical Jinja Templating Rules
 
@@ -118,10 +118,10 @@ When adding a new variable or secret, ensure it is configured correctly for both
 
 ### 4-Layer Architecture
 Template processing follows this hierarchy (later layers override earlier ones):
-1. **Base Template** (`src/base_template/`) - Applied to ALL projects
-2. **Deployment Targets** (`src/deployment_targets/`) - Environment overrides  
-3. **Frontend Types** (`src/frontends/`) - UI-specific files
-4. **Agent Templates** (`agents/*/`) - Individual agent logic
+1. **Base Template** (`agent-starter-pack/base_template/`) - Applied to ALL projects
+2. **Deployment Targets** (`agent-starter-pack/deployment_targets/`) - Environment overrides  
+3. **Frontend Types** (`agent-starter-pack/frontends/`) - UI-specific files
+4. **Agent Templates** (`agent-starter-pack/agents/*/`) - Individual agent logic
 
 **Rule**: Always place changes in the correct layer. Check if deployment targets need corresponding updates.
 

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/Makefile

@@ -8,13 +8,13 @@ test-e2e:
 	set -a && . tests/cicd/.env && set +a && uv run pytest tests/cicd/test_e2e_deployment.py -v
 
 generate-lock:
-	uv run src/utils/generate_locks.py
+	uv run python -m agent_starter_pack.utils.generate_locks
 
 lint:
 	uv sync --dev --extra lint
 	uv run ruff check . --config pyproject.toml --diff
 	uv run ruff format . --check  --config pyproject.toml --diff
-	uv run mypy --config-file pyproject.toml ./src/cli ./tests ./src/frontends/streamlit
+	uv run mypy --config-file pyproject.toml ./agent_starter_pack/cli ./tests ./agent_starter_pack/frontends/streamlit
 
 lint-templated-agents:
 	uv run tests/integration/test_template_linting.py

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.16.0
+Version: 0.17.0
 Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
 Author-email: Google LLC <agent-starter-pack@google.com>
 License: Apache-2.0
@@ -9,7 +9,7 @@ Requires-Python: >=3.10
 Requires-Dist: backoff>=2.2.1
 Requires-Dist: click>=8.1.7
 Requires-Dist: cookiecutter<3.0.0,>=2.6.0
-Requires-Dist: google-cloud-aiplatform>=1.87.0
+Requires-Dist: google-cloud-aiplatform>=1.120.0
 Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: rich>=13.7.0
 Requires-Dist: tomli>=1.1.0; python_version < '3.11'
@@ -39,20 +39,28 @@ Description-Content-Type: text/markdown
   </picture>
 </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
 
+A Python package that provides **production-ready templates** for GenAI agents on Google Cloud.
 
-The `agent-starter-pack` is a Python package that provides a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
-It accelerates development by providing a holistic, production-ready solution, addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.
+Focus on your agent logic—the starter pack provides everything else: infrastructure, CI/CD, observability, and security.
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
 | [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
 
 ---
- 
+
 ## ⚡ Get Started in 1 Minute
 
-Ready to build your AI agent? Simply run this command:
+**From zero to production-ready agent in 60 seconds using [`uv`](https://docs.astral.sh/uv/getting-started/installation/):**
+
+```bash
+uvx agent-starter-pack create my-awesome-agent
+```
+
+<details>
+<summary> ✨ Alternative: Using pip</summary>
 
+If you don't have [`uv`](https://github.com/astral-sh/uv) installed, you can use pip:
 ```bash
 # Create and activate a Python virtual environment
 python -m venv .venv && source .venv/bin/activate
@@ -63,15 +71,6 @@ pip install --upgrade agent-starter-pack
 # Create a new agent project
 agent-starter-pack create my-awesome-agent
 ```
-
-<details>
-<summary> ✨ Alternative: Using uv</summary>
-
-If you have [`uv`](https://github.com/astral-sh/uv) installed, you can create and set up your project with a single command:
-```bash
-uvx agent-starter-pack create my-awesome-agent
-```
-This command handles creating the project without needing to pre-install the package into a virtual environment.
 </details>
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
@@ -96,7 +95,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | `agentic_rag` | A RAG agent for document retrieval and Q&A. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).       |
 | `langgraph_base_react`      | An agent implementing a base ReAct agent using LangGraph |
 | `crewai_coding_crew`       | A multi-agent system implemented with CrewAI created to support coding activities       |
-| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
+| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat     |
 
 **More agents are on the way!** We are continuously expanding our [agent library](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview). Have a specific agent type in mind? [Raise an issue as a feature request!](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues/new?labels=enhancement)
 
@@ -112,9 +111,9 @@ Explore amazing projects built with the Agent Starter Pack!
 
 **[View Community Showcase →](https://googlecloudplatform.github.io/agent-starter-pack/guide/community-showcase)**
 
-#### Extra Features
+## Key Features
 
-The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
+The `agent-starter-pack` offers key features to accelerate and simplify the development of your agent:
 - **🔄 [CI/CD Automation](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - A single command to set up a complete CI/CD pipeline for all environments, supporting both **Google Cloud Build** and **GitHub Actions**.
 - **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).
 - **[Remote Templates](docs/guide/remote-templating.md)**: Create and share your own agent starter packs templates from any Git repository.

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0}/README.md

@@ -15,20 +15,28 @@
   </picture>
 </a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
 
+A Python package that provides **production-ready templates** for GenAI agents on Google Cloud.
 
-The `agent-starter-pack` is a Python package that provides a collection of production-ready Generative AI Agent templates built for Google Cloud. <br>
-It accelerates development by providing a holistic, production-ready solution, addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.
+Focus on your agent logic—the starter pack provides everything else: infrastructure, CI/CD, observability, and security.
 
 | ⚡️ Launch | 🧪 Experiment  | ✅ Deploy | 🛠️ Customize |
 |---|---|---|---|
 | [Pre-built agent templates](./agents/) (ReAct, RAG, multi-agent, Live API). | [Vertex AI evaluation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/evaluation-overview) and an interactive playground. | Production-ready infra with [monitoring, observability](https://googlecloudplatform.github.io/agent-starter-pack/guide/observability), and [CI/CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/deployment) on [Cloud Run](https://cloud.google.com/run) or [Agent Engine](https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview). | Extend and customize templates according to your needs. 🆕 Now integrating with [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
 
 ---
- 
+
 ## ⚡ Get Started in 1 Minute
 
-Ready to build your AI agent? Simply run this command:
+**From zero to production-ready agent in 60 seconds using [`uv`](https://docs.astral.sh/uv/getting-started/installation/):**
+
+```bash
+uvx agent-starter-pack create my-awesome-agent
+```
+
+<details>
+<summary> ✨ Alternative: Using pip</summary>
 
+If you don't have [`uv`](https://github.com/astral-sh/uv) installed, you can use pip:
 ```bash
 # Create and activate a Python virtual environment
 python -m venv .venv && source .venv/bin/activate
@@ -39,15 +47,6 @@ pip install --upgrade agent-starter-pack
 # Create a new agent project
 agent-starter-pack create my-awesome-agent
 ```
-
-<details>
-<summary> ✨ Alternative: Using uv</summary>
-
-If you have [`uv`](https://github.com/astral-sh/uv) installed, you can create and set up your project with a single command:
-```bash
-uvx agent-starter-pack create my-awesome-agent
-```
-This command handles creating the project without needing to pre-install the package into a virtual environment.
 </details>
 
 **That's it!** You now have a fully functional agent project—complete with backend, frontend, and deployment infrastructure—ready for you to explore and customize.
@@ -72,7 +71,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | `agentic_rag` | A RAG agent for document retrieval and Q&A. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).       |
 | `langgraph_base_react`      | An agent implementing a base ReAct agent using LangGraph |
 | `crewai_coding_crew`       | A multi-agent system implemented with CrewAI created to support coding activities       |
-| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat with vector DB-backed responses                       |
+| `adk_live`       | A real-time multimodal RAG agent powered by Gemini, supporting audio/video/text chat     |
 
 **More agents are on the way!** We are continuously expanding our [agent library](https://googlecloudplatform.github.io/agent-starter-pack/agents/overview). Have a specific agent type in mind? [Raise an issue as a feature request!](https://github.com/GoogleCloudPlatform/agent-starter-pack/issues/new?labels=enhancement)
 
@@ -88,9 +87,9 @@ Explore amazing projects built with the Agent Starter Pack!
 
 **[View Community Showcase →](https://googlecloudplatform.github.io/agent-starter-pack/guide/community-showcase)**
 
-#### Extra Features
+## Key Features
 
-The `agent-starter-pack` offers two key features to accelerate and simplify the development of your agent:
+The `agent-starter-pack` offers key features to accelerate and simplify the development of your agent:
 - **🔄 [CI/CD Automation](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd)** - A single command to set up a complete CI/CD pipeline for all environments, supporting both **Google Cloud Build** and **GitHub Actions**.
 - **📥 [Data Pipeline for RAG with Terraform/CI-CD](https://googlecloudplatform.github.io/agent-starter-pack/guide/data-ingestion)** - Seamlessly integrate a data pipeline to process embeddings for RAG into your agent system. Supporting [Vertex AI Search](https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction) and [Vector Search](https://cloud.google.com/vertex-ai/docs/vector-search/overview).
 - **[Remote Templates](docs/guide/remote-templating.md)**: Create and share your own agent starter packs templates from any Git repository.

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0/agent_starter_pack}/agents/adk_live/.template/templateconfig.yaml

@@ -17,6 +17,6 @@ settings:
   requires_data_ingestion: false
   frontend_type: "adk_live_react"
   deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk>=1.15.0,<2.0.0", "click>=8.0.0,<9.0.0", "uvicorn>=0.18.0,<1.0.0", "fastapi>=0.75.0,<1.0.0", "backoff>=2.0.0,<3.0.0"]
+  extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "click>=8.0.0,<9.0.0", "uvicorn>=0.18.0,<1.0.0", "fastapi>=0.75.0,<1.0.0", "backoff>=2.0.0,<3.0.0"]
   tags: ["adk", "adk_live"]
 example_question: "What's the weather in San Francisco?"

{agent_starter_pack-0.16.0 → agent_starter_pack-0.17.0/agent_starter_pack}/agents/adk_live/README.md

@@ -2,7 +2,7 @@
 
 Real-time conversational agent built with Google ADK and Gemini's live audio model. Supports audio, video, and text interactions with native tool calling.
 
-![adk_live_diagram](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/adk_live_diagram.png)
+![live_api_diagram](https://storage.googleapis.com/github-repo/generative-ai/sample-apps/e2e-gen-ai-app-starter-pack/live_api_diagram.png)
 
 **Key components:**
 
@@ -19,6 +19,7 @@ Once running, click the play button to connect and interact with the agent. Try
 Explore these resources to learn more about the Multimodal Live API and see examples of its usage:
 
 - [Project Pastra](https://github.com/heiko-hotz/gemini-multimodal-live-dev-guide/tree/main): a comprehensive developer guide for the Gemini Multimodal Live API.
+- [ADK Samples: Realtime Conversational Agent](https://github.com/google/adk-samples/tree/main/python/agents/realtime-conversational-agent): Full-stack, reusable template using Agent Development Kit (ADK) with the Gemini Live API.
 - [Google Cloud Multimodal Live API demos and samples](https://github.com/GoogleCloudPlatform/generative-ai/tree/main/gemini/multimodal-live-api): Collection of code samples and demo applications leveraging multimodal live API in Vertex AI
 - [Gemini 2 Cookbook](https://github.com/google-gemini/cookbook/tree/main/gemini-2): Practical examples and tutorials for working with Gemini 2
 - [Multimodal Live API Web Console](https://github.com/google-gemini/multimodal-live-api-web-console): Interactive React-based web interface for testing and experimenting with Gemini Multimodal Live API.

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/Makefile

@@ -38,7 +38,7 @@ playground:{%- if cookiecutter.is_adk_live %} build-frontend-if-needed{%- endif
 	@echo "==============================================================================="
 {%- if cookiecutter.is_adk_live %}
 {%- if cookiecutter.deployment_target == 'agent_engine' %}
-	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
 {%- else %}
 	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host localhost --port 8000 --reload
 {%- endif %}
@@ -111,7 +111,7 @@ local-backend:
 
 # Launch local development server with hot-reload
 local-backend:
-	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --port 8000
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --port 8000  --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
 
 # Connect to remote deployed agent
 playground-remote: build-frontend-if-needed

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/deployment/terraform/dev/log_sinks.tf

@@ -12,13 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-resource "google_project_iam_member" "bigquery_data_editor" {
-
-  project = var.dev_project_id
-  role    = "roles/bigquery.dataEditor"
-  member  = module.log_export_to_bigquery.writer_identity
-}
-
 resource "google_bigquery_dataset" "feedback_dataset" {
   project       = var.dev_project_id
   dataset_id    = replace("${var.project_name}_feedback", "-", "_")
@@ -35,29 +28,42 @@ resource "google_bigquery_dataset" "telemetry_logs_dataset" {
   depends_on    = [resource.google_project_service.services]
 }
 
-module "feedback_export_to_bigquery" {
-  source                 = "terraform-google-modules/log-export/google"
-  version                = "10.0.0"
-  log_sink_name          = "${var.project_name}_feedback"
-  parent_resource_type   = "project"
-  parent_resource_id     = var.dev_project_id
-  destination_uri        = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.feedback_dataset.dataset_id}"
-  filter                 = var.feedback_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
+resource "google_logging_project_sink" "feedback_export_to_bigquery" {
+  name        = "${var.project_name}_feedback"
+  project     = var.dev_project_id
+  destination = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.feedback_dataset.dataset_id}"
+  filter      = var.feedback_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
+
   unique_writer_identity = true
   depends_on             = [google_bigquery_dataset.feedback_dataset]
 }
 
-module "log_export_to_bigquery" {
-  source  = "terraform-google-modules/log-export/google"
-  version = "10.0.0"
+resource "google_logging_project_sink" "log_export_to_bigquery" {
+  name        = "${var.project_name}_telemetry"
+  project     = var.dev_project_id
+  destination = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.telemetry_logs_dataset.dataset_id}"
+  filter      = var.telemetry_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
 
-  log_sink_name          = "${var.project_name}_telemetry"
-  parent_resource_type   = "project"
-  parent_resource_id     = var.dev_project_id
-  destination_uri        = "bigquery.googleapis.com/projects/${var.dev_project_id}/datasets/${google_bigquery_dataset.telemetry_logs_dataset.dataset_id}"
-  filter                 = var.telemetry_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
   unique_writer_identity = true
   depends_on             = [google_bigquery_dataset.telemetry_logs_dataset]
 }
+
+resource "google_project_iam_member" "bigquery_data_editor" {
+  project = var.dev_project_id
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.log_export_to_bigquery.writer_identity
+}
+
+resource "google_project_iam_member" "feedback_bigquery_data_editor" {
+  project = var.dev_project_id
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.feedback_export_to_bigquery.writer_identity
+}

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/deployment/terraform/dev/providers.tf

@@ -17,7 +17,7 @@ terraform {
   required_providers {
     google = {
       source  = "hashicorp/google"
-      version = "< 7.0.0"
+      version = "> 7.0.0"
     }
   }
 }

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/deployment/terraform/github.tf

@@ -119,6 +119,20 @@ resource "github_actions_variable" "app_sa_email_prod" {
   depends_on    = [github_repository.repo]
 }
 
+resource "github_actions_variable" "logs_bucket_name_staging" {
+  repository    = var.repository_name
+  variable_name = "LOGS_BUCKET_NAME_STAGING"
+  value         = google_storage_bucket.logs_data_bucket[var.staging_project_id].url
+  depends_on    = [github_repository.repo]
+}
+
+resource "github_actions_variable" "logs_bucket_name_prod" {
+  repository    = var.repository_name
+  variable_name = "LOGS_BUCKET_NAME_PROD"
+  value         = google_storage_bucket.logs_data_bucket[var.prod_project_id].url
+  depends_on    = [github_repository.repo]
+}
+
 {% if cookiecutter.deployment_target == 'cloud_run' %}
 resource "github_actions_variable" "container_name" {
   repository    = var.repository_name

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/deployment/terraform/log_sinks.tf

@@ -12,14 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-resource "google_project_iam_member" "bigquery_data_editor" {
-  for_each = local.deploy_project_ids
-
-  project = each.value
-  role    = "roles/bigquery.dataEditor"
-  member  = module.log_export_to_bigquery[each.key].writer_identity
-}
-
 resource "google_bigquery_dataset" "feedback_dataset" {
   for_each      = local.deploy_project_ids
   project       = each.value
@@ -38,33 +30,50 @@ resource "google_bigquery_dataset" "telemetry_logs_dataset" {
   depends_on    = [resource.google_project_service.cicd_services, resource.google_project_service.deploy_project_services]
 }
 
-module "log_export_to_bigquery" {
+resource "google_logging_project_sink" "feedback_export_to_bigquery" {
   for_each = local.deploy_project_ids
 
-  source  = "terraform-google-modules/log-export/google"
-  version = "10.0.0"
+  name        = "${var.project_name}_feedback"
+  project     = each.value
+  destination = "bigquery.googleapis.com/projects/${each.value}/datasets/${google_bigquery_dataset.feedback_dataset[each.key].dataset_id}"
+  filter      = var.feedback_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
 
-  log_sink_name          = "${var.project_name}_telemetry"
-  parent_resource_type   = "project"
-  parent_resource_id     = each.value
-  destination_uri        = "bigquery.googleapis.com/projects/${each.value}/datasets/${google_bigquery_dataset.telemetry_logs_dataset[each.key].dataset_id}"
-  filter                 = var.telemetry_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
   unique_writer_identity = true
-  depends_on             = [google_bigquery_dataset.telemetry_logs_dataset]
+  depends_on             = [google_bigquery_dataset.feedback_dataset]
 }
 
-module "feedback_export_to_bigquery" {
+resource "google_logging_project_sink" "log_export_to_bigquery" {
   for_each = local.deploy_project_ids
 
-  source                 = "terraform-google-modules/log-export/google"
-  version                = "10.0.0"
-  log_sink_name          = "${var.project_name}_feedback"
-  parent_resource_type   = "project"
-  parent_resource_id     = each.value
-  destination_uri        = "bigquery.googleapis.com/projects/${each.value}/datasets/${google_bigquery_dataset.feedback_dataset[each.key].dataset_id}"
-  filter                 = var.feedback_logs_filter
-  bigquery_options       = { use_partitioned_tables = true }
+  name        = "${var.project_name}_telemetry"
+  project     = each.value
+  destination = "bigquery.googleapis.com/projects/${each.value}/datasets/${google_bigquery_dataset.telemetry_logs_dataset[each.key].dataset_id}"
+  filter      = var.telemetry_logs_filter
+
+  bigquery_options {
+    use_partitioned_tables = true
+  }
+
   unique_writer_identity = true
-  depends_on             = [google_bigquery_dataset.feedback_dataset]
+  depends_on             = [google_bigquery_dataset.telemetry_logs_dataset]
+}
+
+resource "google_project_iam_member" "bigquery_data_editor" {
+  for_each = local.deploy_project_ids
+
+  project = each.value
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.log_export_to_bigquery[each.key].writer_identity
+}
+
+resource "google_project_iam_member" "feedback_bigquery_data_editor" {
+  for_each = local.deploy_project_ids
+
+  project = each.value
+  role    = "roles/bigquery.dataEditor"
+  member  = google_logging_project_sink.feedback_export_to_bigquery[each.key].writer_identity
 }

{agent_starter_pack-0.16.0/src → agent_starter_pack-0.17.0/agent_starter_pack}/base_template/deployment/terraform/providers.tf

@@ -18,7 +18,7 @@ terraform {
   required_providers {
     google = {
       source  = "hashicorp/google"
-      version = "< 7.0.0"
+      version = "> 7.0.0"
     }
     github = {
       source  = "integrations/github"