agent-starter-pack 0.3.3__py3-none-any.whl → 0.21.0__py3-none-any.whl

{agents → agent_starter_pack/agents}/agentic_rag/tests/integration/test_agent.py

@@ -20,11 +20,11 @@ from google.adk.runners import Runner
 from google.adk.sessions import InMemorySessionService
 from google.genai import types
 
-from app.agent import root_agent
+from {{cookiecutter.agent_directory}}.agent import root_agent
 
 
 @patch(
-    "app.agent.retrieve_docs",
+    "{{cookiecutter.agent_directory}}.agent.retrieve_docs",
     return_value="dummy content",
 )
 def test_agent_stream(mock_retrieve: MagicMock) -> None:
@@ -35,7 +35,7 @@ def test_agent_stream(mock_retrieve: MagicMock) -> None:
 
     session_service = InMemorySessionService()
 
-    session = session_service.create_session(user_id="test_user", app_name="test")
+    session = session_service.create_session_sync(user_id="test_user", app_name="test")
     runner = Runner(agent=root_agent, session_service=session_service, app_name="test")
 
     message = types.Content(

agent_starter_pack/agents/langgraph_base/.template/templateconfig.yaml

@@ -0,0 +1,31 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+description: "A base ReAct agent implemented using LangGraph with Agent2Agent (A2A) Protocol support"
+settings:
+  requires_data_ingestion: false
+  deployment_targets: ["agent_engine", "cloud_run"]
+  extra_dependencies: [
+    "langchain-google-vertexai>=3.0.3",
+    "langchain~=1.0.7",
+    "langgraph~=1.0.3",
+    "langchain-community~=0.4.1",
+    "a2a-sdk[http-server]~=0.3.12",
+    "nest-asyncio>=1.6.0,<2.0.0",
+    "traceloop-sdk>=0.10.0,<1.0.0",
+    "opentelemetry-exporter-gcp-trace>=1.9.0,<2.0.0",
+  ]
+  tags: ["langgraph", "a2a"]
+  frontend_type: "inspector"
+example_question: "What's the weather in San Francisco?"

agent_starter_pack/agents/langgraph_base/README.md

@@ -0,0 +1,30 @@
+# LangGraph Base ReAct Agent with A2A Protocol
+
+<p align="center">
+  <img src="https://langchain-ai.github.io/langgraph/static/wordmark_dark.svg" width="50%" alt="LangGraph Logo" style="margin-right: 40px; vertical-align: middle;">
+  <img src="https://github.com/a2aproject/A2A/blob/main/docs/assets/a2a-logo-white.svg?raw=true" width="40%" alt="A2A Logo" style="vertical-align: middle;">
+</p>
+
+A base ReAct agent built using **[LangGraph](https://docs.langchain.com/oss/python/langgraph/overview)** with **[Agent2Agent (A2A) Protocol](https://a2a-protocol.org/)** support. This example demonstrates how to build a LangGraph-based agent with distributed agent communication capabilities through the A2A protocol for interoperability with agents across different frameworks and languages.
+
+## Key Features
+
+- **Simple Architecture**: Shows the basic building blocks of a LangGraph agent
+- **A2A Protocol Support**: Enables distributed agent communication and interoperability
+- **Streaming Support**: Includes streaming response capability using Vertex AI
+- **Sample Tool Integration**: Includes a basic search tool to demonstrate tool usage
+
+## Validating Your A2A Implementation
+
+This template includes the **[A2A Protocol Inspector](https://github.com/a2aproject/a2a-inspector)** for validating your agent's A2A implementation.
+
+```bash
+make inspector
+```
+
+The inspector now supports both JSON-RPC 2.0 (Cloud Run) and HTTP-JSON (Agent Engine) transport protocols:
+
+- **Cloud Run**: Test locally at `http://localhost:8000` or connect to your deployed Cloud Run URL
+- **Agent Engine**: Must deploy first, then connect to your deployed Agent Engine URL (local testing not available)
+
+For detailed setup instructions including local and remote testing workflows, refer to the `README.md` in your generated project.

agent_starter_pack/agents/langgraph_base/app/__init__.py

@@ -0,0 +1,17 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .agent import root_agent
+
+__all__ = ["root_agent"]

agent_starter_pack/agents/langgraph_base/app/agent.py

@@ -0,0 +1,34 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from langchain.agents import create_agent
+from langchain_google_vertexai import ChatVertexAI
+from langgraph.graph.state import CompiledStateGraph
+
+LOCATION = "global"
+LLM = "gemini-2.5-flash"
+
+llm = ChatVertexAI(model=LLM, location=LOCATION, temperature=0)
+
+
+def get_weather(query: str) -> str:
+    """Simulates a web search. Use it get information on weather"""
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        return "It's 60 degrees and foggy."
+    return "It's 90 degrees and sunny."
+
+
+root_agent: CompiledStateGraph = create_agent(
+    model=llm, tools=[get_weather], system_prompt="You are a helpful assistant"
+)

{agents/crewai_coding_crew → agent_starter_pack/agents/langgraph_base}/notebooks/evaluating_langgraph_agent.ipynb

@@ -143,12 +143,8 @@
       },
       "outputs": [],
       "source": [
-        "%pip install --upgrade --user --quiet \"google-cloud-aiplatform[evaluation]\" \\\n",
-        "    \"langchain_google_vertexai\" \\\n",
-        "    \"langgraph\" \\\n",
-        "    \"cloudpickle==3.0.0\" \\\n",
-        "    \"pydantic==2.7.4\" \\\n",
-        "    \"requests\""
+        "%pip install \"langchain_google_vertexai\" \"langgraph\"\n",
+        "%pip install --upgrade --user --quiet \"google-cloud-aiplatform[evaluation]\""
       ]
     },
     {
@@ -273,6 +269,8 @@
       },
       "outputs": [],
       "source": [
+        "import json\n",
+        "\n",
         "# General\n",
         "import random\n",
         "import string\n",
@@ -355,7 +353,7 @@
         "                        }\n",
         "                    )\n",
         "\n",
-        "    final_output[\"predicted_trajectory\"] = function_calls\n",
+        "    final_output[\"predicted_trajectory\"] = json.dumps(function_calls)\n",
         "    return final_output\n",
         "\n",
         "\n",
@@ -365,6 +363,7 @@
         "    markdown += f\"{output['response']}\\n\\n\"\n",
         "\n",
         "    if output[\"predicted_trajectory\"]:\n",
+        "        output[\"predicted_trajectory\"] = json.loads(output[\"predicted_trajectory\"])\n",
         "        markdown += \"### Function Calls\\n\"\n",
         "        for call in output[\"predicted_trajectory\"]:\n",
         "            markdown += f\"- **Function**: `{call['tool_name']}`\\n\"\n",
@@ -381,7 +380,7 @@
         "    display(Markdown(\"### Summary Metrics\"))\n",
         "    display(metrics_df)\n",
         "\n",
-        "    display(Markdown(f\"### Row-wise Metrics\"))\n",
+        "    display(Markdown(\"### Row-wise Metrics\"))\n",
         "    display(eval_result.metrics_table)\n",
         "\n",
         "\n",
@@ -599,7 +598,7 @@
       "source": [
         "def router(\n",
         "    state: list[BaseMessage],\n",
-        ") -> Literal[\"get_product_details\", \"get_product_price\", \"__end__\"]:\n",
+        ") -> Literal[\"get_product_details\", \"get_product_price\", END]:\n",
         "    \"\"\"Initiates product details or price retrieval if the user asks for a product.\"\"\"\n",
         "    # Get the tool_calls from the last message in the conversation history.\n",
         "    tool_calls = state[-1].tool_calls\n",
@@ -614,7 +613,7 @@
         "            return \"get_product_details\"\n",
         "    else:\n",
         "        # End the conversation flow.\n",
-        "        return \"__end__\""
+        "        return END"
       ]
     },
     {
@@ -636,7 +635,7 @@
       },
       "outputs": [],
       "source": [
-        "llm = \"gemini-1.5-pro\""
+        "llm = \"gemini-2.0-flash\""
       ]
     },
     {
@@ -899,6 +898,7 @@
         "    dataset=eval_sample_dataset,\n",
         "    metrics=single_tool_usage_metrics,\n",
         "    experiment=EXPERIMENT_NAME,\n",
+        "    output_uri_prefix=BUCKET_URI + \"/single-metric-eval\",\n",
         ")\n",
         "\n",
         "single_tool_call_eval_result = single_tool_call_eval_task.evaluate(\n",
@@ -1003,7 +1003,10 @@
         "EXPERIMENT_RUN = f\"trajectory-{get_id()}\"\n",
         "\n",
         "trajectory_eval_task = EvalTask(\n",
-        "    dataset=eval_sample_dataset, metrics=trajectory_metrics, experiment=EXPERIMENT_NAME\n",
+        "    dataset=eval_sample_dataset,\n",
+        "    metrics=trajectory_metrics,\n",
+        "    experiment=EXPERIMENT_NAME,\n",
+        "    output_uri_prefix=BUCKET_URI + \"/multiple-metric-eval\",\n",
         ")\n",
         "\n",
         "trajectory_eval_result = trajectory_eval_task.evaluate(\n",
@@ -1107,7 +1110,10 @@
         "EXPERIMENT_RUN = f\"response-{get_id()}\"\n",
         "\n",
         "response_eval_task = EvalTask(\n",
-        "    dataset=eval_sample_dataset, metrics=response_metrics, experiment=EXPERIMENT_NAME\n",
+        "    dataset=eval_sample_dataset,\n",
+        "    metrics=response_metrics,\n",
+        "    experiment=EXPERIMENT_NAME,\n",
+        "    output_uri_prefix=BUCKET_URI + \"/response-metric-eval\",\n",
         ")\n",
         "\n",
         "response_eval_result = response_eval_task.evaluate(\n",
@@ -1292,6 +1298,7 @@
         "    dataset=eval_sample_dataset,\n",
         "    metrics=response_tool_metrics,\n",
         "    experiment=EXPERIMENT_NAME,\n",
+        "    output_uri_prefix=BUCKET_URI + \"/reasoning-metric-eval\",\n",
         ")\n",
         "\n",
         "response_eval_tool_result = response_eval_tool_task.evaluate(\n",
@@ -1436,15 +1443,21 @@
         "        ],\n",
         "    ],\n",
         "    \"response\": [\n",
-        "        500,\n",
-        "        50,\n",
+        "        \"500\",\n",
+        "        \"50\",\n",
         "        \"A super fast and light usb charger\",\n",
-        "        100,\n",
+        "        \"100\",\n",
         "        \"A voice-controlled smart speaker that plays music, sets alarms, and controls smart home devices.\",\n",
         "    ],\n",
         "}\n",
         "\n",
-        "byod_eval_sample_dataset = pd.DataFrame(byod_eval_data)"
+        "byod_eval_sample_dataset = pd.DataFrame(byod_eval_data)\n",
+        "byod_eval_sample_dataset[\"predicted_trajectory\"] = byod_eval_sample_dataset[\n",
+        "    \"predicted_trajectory\"\n",
+        "].apply(json.dumps)\n",
+        "byod_eval_sample_dataset[\"reference_trajectory\"] = byod_eval_sample_dataset[\n",
+        "    \"reference_trajectory\"\n",
+        "].apply(json.dumps)"
       ]
     },
     {

{agents/langgraph_base_react → agent_starter_pack/agents/langgraph_base}/tests/integration/test_agent.py

@@ -12,8 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# mypy: disable-error-code="union-attr"
-from app.agent import agent
+# mypy: ignore-errors
+from {{cookiecutter.agent_directory}}.agent import root_agent as agent
 
 
 def test_agent_stream() -> None:

{src → agent_starter_pack}/base_template/.gitignore

@@ -189,9 +189,11 @@ Thumbs.db
 .persist_vector_store
 tests/load_test/.results/*.html
 tests/load_test/.results/*.csv
-locust_env
+.locust_env
 my_env.tfvars
-.streamlit_chats
 .saved_chats
 .env
-.requirements.txt
+.requirements.txt
+
+# A2A Inspector
+tools/a2a-inspector/

agent_starter_pack/base_template/GEMINI.md

@@ -0,0 +1,5 @@
+Coding Agent guidance:
+{%- if cookiecutter.is_adk %}
+{{ cookiecutter.adk_cheatsheet }}
+{%- endif %}
+{{ cookiecutter.llm_txt }}

agent_starter_pack/base_template/Makefile

@@ -0,0 +1,339 @@
+# ==============================================================================
+# Installation & Setup
+# ==============================================================================
+
+# Install dependencies using uv package manager
+install:
+	@command -v uv >/dev/null 2>&1 || { echo "uv is not installed. Installing uv..."; curl -LsSf https://astral.sh/uv/0.8.13/install.sh | sh; source $HOME/.local/bin/env; }
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %}
+	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("install")}}
+{%- else %}
+	uv sync{% if cookiecutter.is_adk_live %} && (cd frontend && npm install){%- endif %}
+{%- endif %}
+
+# ==============================================================================
+# Playground Targets
+# ==============================================================================
+
+# Launch local dev playground
+playground:{%- if cookiecutter.is_adk_live %} build-frontend-if-needed{%- endif %}
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("playground") %}
+{%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("playground") is mapping %}
+	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("playground").get(cookiecutter.deployment_target, "")}}
+{%- else %}
+	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("playground")}}
+{%- endif %}
+{%- else %}
+	@echo "==============================================================================="
+	@echo "| 🚀 Starting your agent playground...                                        |"
+	@echo "|                                                                             |"
+{%- if cookiecutter.is_adk_live %}
+	@echo "| 🌐 Access your app at: http://localhost:8000                               |"
+{%- endif %}
+	@echo "| 💡 Try asking: {{cookiecutter.example_question}}|"
+{%- if cookiecutter.is_adk %}
+	@echo "|                                                                             |"
+	@echo "| 🔍 IMPORTANT: Select the '{{cookiecutter.agent_directory}}' folder to interact with your agent.          |"
+{%- endif %}
+	@echo "==============================================================================="
+{%- if cookiecutter.is_adk_live %}
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
+	uv run python -m {{cookiecutter.agent_directory}}.app_utils.expose_app --mode local --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
+{%- else %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.fast_api_app:app --host localhost --port 8000 --reload
+{%- endif %}
+{%- elif cookiecutter.is_adk %}
+	uv run adk web . --port 8501 --reload_agents
+{%- elif cookiecutter.is_a2a %}
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.fast_api_app:app --host localhost --port 8000 --reload &
+	$(MAKE) inspector
+{%- else %}
+{%- if cookiecutter.agent_name == 'langgraph_base' %}
+	@echo "ℹ️  Note: Local playground not supported for LangGraph on Agent Engine."
+	@echo "    To test your agent, deploy first with 'make deploy' then use 'make inspector'."
+{%- else %}
+	@echo "ℹ️  Note: Local playground uses ADK web interface (not A2A endpoints)."
+	@echo "    To test A2A protocol, deploy first with 'make deploy' then use 'make inspector'."
+	@echo ""
+	uv run adk web . --port 8501 --reload_agents
+{%- endif %}
+{%- endif %}
+{%- else %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.fast_api_app:app --host localhost --port 8000 --reload
+{%- endif %}
+{%- endif %}
+{%- if cookiecutter.settings.get("commands", {}).get("extra", {}) %}
+
+# ==============================================================================
+# Agent-Specific Commands
+# ==============================================================================
+{%- for cmd_name, cmd_value in cookiecutter.settings.get("commands", {}).get("extra", {}).items() %}
+{%- if cmd_value is mapping %}
+{%- if cmd_value.command is mapping %}
+{%- if cookiecutter.deployment_target in cmd_value.command %}
+
+# {{ cmd_value.get("description") }}
+{{ cmd_name }}:
+	{{ cmd_value.command[cookiecutter.deployment_target] }}
+{%- endif %}
+{%- else %}
+
+# {{ cmd_value.get("description") }}
+{{ cmd_name }}:
+	{{ cmd_value.command if cmd_value.command is string else "" }}
+{%- endif %}
+{%- else %}
+
+# {{ cmd_value.get("description", "") }}
+{{ cmd_name }}:
+	{{ cmd_value }}
+{%- endif %}
+{%- endfor %}
+{%- endif %}
+{%- if cookiecutter.deployment_target == 'cloud_run' or (cookiecutter.deployment_target == 'agent_engine' and cookiecutter.is_adk_live) %}
+
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.fast_api_app:app --host localhost --port 8000 --reload
+{%- else %}
+	uv run python -m {{cookiecutter.agent_directory}}.app_utils.expose_app --mode local --port 8000  --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
+{%- endif %}
+{%- endif %}
+{%- if cookiecutter.is_adk_live %}
+
+# ==============================================================================
+# ADK Live Commands
+# ==============================================================================
+
+# Build the frontend for production
+build-frontend:
+	(cd frontend && npm run build)
+
+# Build the frontend only if needed (conditional build)
+build-frontend-if-needed:
+	@if [ ! -d "frontend/build" ] || [ ! -f "frontend/build/index.html" ]; then \
+		echo "Frontend build directory not found or incomplete. Building..."; \
+		$(MAKE) build-frontend; \
+	elif [ "frontend/package.json" -nt "frontend/build/index.html" ] || \
+		 find frontend/src -newer frontend/build/index.html 2>/dev/null | head -1 | grep -q .; then \
+		echo "Frontend source files are newer than build. Rebuilding..."; \
+		$(MAKE) build-frontend; \
+	else \
+		echo "Frontend build is up to date. Skipping build..."; \
+	fi
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
+
+# Connect to remote deployed agent
+playground-remote: build-frontend-if-needed
+	@echo "==============================================================================="
+	@echo "| 🚀 Connecting to REMOTE agent...                                           |"
+	@echo "|                                                                             |"
+	@echo "| 🌐 Access your app at: http://localhost:8000                               |"
+	@echo "| ☁️  Connected to deployed agent engine                                      |"
+	@echo "==============================================================================="
+	uv run python -m {{cookiecutter.agent_directory}}.app_utils.expose_app --mode remote
+{%- endif %}
+{%- endif %}
+{%- if cookiecutter.is_adk_live and cookiecutter.deployment_target == 'agent_engine' %}
+
+# Start the frontend UI separately for development (requires backend running separately)
+ui:
+	(cd frontend && PORT=8501 npm start)
+
+# Launch dev playground with both frontend and backend hot-reload
+playground-dev:
+	@echo "==============================================================================="
+	@echo "| 🚀 Starting your agent playground in DEV MODE...                           |"
+	@echo "|                                                                             |"
+	@echo "| 🌐 Frontend: http://localhost:8501                                         |"
+	@echo "| 🌐 Backend:  http://localhost:8000                                         |"
+	@echo "| 💡 Try asking: {{cookiecutter.example_question}}|"
+	@echo "| 🔄 Both frontend and backend will auto-reload on changes                    |"
+	@echo "==============================================================================="
+	@echo "Starting backend server..."
+	$(MAKE) local-backend &
+	@echo "Starting frontend dev server..."
+	$(MAKE) ui
+{%- endif %}
+{%- if cookiecutter.is_a2a %}
+
+# ==============================================================================
+# A2A Protocol Inspector
+# ==============================================================================
+
+# Launch A2A Protocol Inspector to test your agent implementation
+inspector: setup-inspector-if-needed build-inspector-if-needed
+	@echo "==============================================================================="
+	@echo "| 🔍 A2A Protocol Inspector                                                  |"
+	@echo "==============================================================================="
+	@echo "| 🌐 Inspector UI: http://localhost:5001                                     |"
+	@echo "|                                                                             |"
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	@echo "| 💡 Testing Locally:                                                         |"
+	@echo "|    Paste this URL into the inspector:                                      |"
+	@echo "|    http://localhost:8000/a2a/{{cookiecutter.agent_directory}}/.well-known/agent-card.json              |"
+	@echo "|                                                                             |"
+{%- endif %}
+	@echo "| 💡 Testing Remote Deployment:                                               |"
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	@echo "|    Connect to your deployed Cloud Run URL                                  |"
+	@echo "|    🔐 See README for authentication setup                                  |"
+{%- else %}
+	@echo "|    Connect to your deployed Agent Engine URL                               |"
+	@echo "|    🔐 See README for authentication setup                                  |"
+	@echo "|                                                                             |"
+	@echo "| ℹ️  Note: Local testing requires deploying to Agent Engine first.          |"
+	@echo "|    Local 'make playground' uses ADK web interface (not A2A endpoints)      |"
+{%- endif %}
+	@echo "==============================================================================="
+	@echo ""
+	cd tools/a2a-inspector/backend && uv run app.py
+
+# Internal: Setup inspector if not already present (runs once)
+# TODO: Update to --branch v1.0.0 when a2a-inspector publishes releases
+setup-inspector-if-needed:
+	@if [ ! -d "tools/a2a-inspector" ]; then \
+		echo "" && \
+		echo "📦 First-time setup: Installing A2A Inspector..." && \
+		echo "" && \
+		mkdir -p tools && \
+		git clone --quiet https://github.com/a2aproject/a2a-inspector.git tools/a2a-inspector && \
+		(cd tools/a2a-inspector && git -c advice.detachedHead=false checkout --quiet 893e4062f6fbd85a8369228ce862ebbf4a025694) && \
+		echo "📥 Installing Python dependencies..." && \
+		(cd tools/a2a-inspector && uv sync --quiet) && \
+		echo "📥 Installing Node.js dependencies..." && \
+		(cd tools/a2a-inspector/frontend && npm install --silent) && \
+		echo "🔨 Building frontend..." && \
+		(cd tools/a2a-inspector/frontend && npm run build --silent) && \
+		echo "" && \
+		echo "✅ A2A Inspector setup complete!" && \
+		echo ""; \
+	fi
+
+# Internal: Build inspector frontend if needed
+build-inspector-if-needed:
+	@if [ -d "tools/a2a-inspector" ] && [ ! -f "tools/a2a-inspector/frontend/public/script.js" ]; then \
+		echo "🔨 Building inspector frontend..."; \
+		cd tools/a2a-inspector/frontend && npm run build; \
+	fi
+{%- endif %}
+
+# ==============================================================================
+# Backend Deployment Targets
+# ==============================================================================
+
+# Deploy the agent remotely
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+# Usage: make deploy [IAP=true] [PORT=8080] - Set IAP=true to enable Identity-Aware Proxy, PORT to specify container port
+{%- endif %}
+deploy:
+{%- if cookiecutter.deployment_target == 'cloud_run' %}
+	PROJECT_ID=$$(gcloud config get-value project) && \
+{%- if cookiecutter.is_a2a %}
+	PROJECT_NUMBER=$$(gcloud projects describe $$PROJECT_ID --format="value(projectNumber)") && \
+{%- endif %}
+	gcloud beta run deploy {{cookiecutter.project_name}} \
+		--source . \
+		--memory "4Gi" \
+		--project $$PROJECT_ID \
+		--region "us-central1" \
+		--no-allow-unauthenticated \
+		--no-cpu-throttling \
+		--labels "{% if cookiecutter.is_adk %}created-by=adk{% if cookiecutter.agent_garden %},{% endif %}{% endif %}{% if cookiecutter.agent_garden %}deployed-with=agent-garden{% if cookiecutter.agent_sample_id %},vertex-agent-sample-id={{cookiecutter.agent_sample_id}},vertex-agent-sample-publisher={{cookiecutter.agent_sample_publisher}}{% endif %}{% endif %}" \
+		--update-build-env-vars "AGENT_VERSION=$(shell awk -F'"' '/^version = / {print $$2}' pyproject.toml || echo '0.0.0')" \
+		--set-env-vars \
+		"COMMIT_SHA=$(shell git rev-parse HEAD){%- if cookiecutter.is_a2a %},APP_URL=https://{{cookiecutter.project_name}}-$$PROJECT_NUMBER.us-central1.run.app{%- endif %}{%- if cookiecutter.data_ingestion %}{%- if cookiecutter.datastore_type == "vertex_ai_search" %},DATA_STORE_ID={{cookiecutter.project_name}}-datastore,DATA_STORE_REGION=us{%- elif cookiecutter.datastore_type == "vertex_ai_vector_search" %},VECTOR_SEARCH_INDEX={{cookiecutter.project_name}}-vector-search,VECTOR_SEARCH_INDEX_ENDPOINT={{cookiecutter.project_name}}-vector-search-endpoint,VECTOR_SEARCH_BUCKET=$$PROJECT_ID-{{cookiecutter.project_name}}-vs{%- endif %}{%- endif %}" \
+		$(if $(IAP),--iap) \
+		$(if $(PORT),--port=$(PORT))
+{%- elif cookiecutter.deployment_target == 'agent_engine' %}
+	# Export dependencies to requirements file using uv export.
+	(uv export --no-hashes --no-header --no-dev --no-emit-project --no-annotate > {{cookiecutter.agent_directory}}/app_utils/.requirements.txt 2>/dev/null || \
+	uv export --no-hashes --no-header --no-dev --no-emit-project > {{cookiecutter.agent_directory}}/app_utils/.requirements.txt) && \
+	uv run -m {{cookiecutter.agent_directory}}.app_utils.deploy \
+		--source-packages=./{{cookiecutter.agent_directory}} \
+		--entrypoint-module={{cookiecutter.agent_directory}}.agent_engine_app \
+		--entrypoint-object=agent_engine \
+		--requirements-file={{cookiecutter.agent_directory}}/app_utils/.requirements.txt
+{%- endif %}
+
+# Alias for 'make deploy' for backward compatibility
+backend: deploy
+
+
+# ==============================================================================
+# Infrastructure Setup
+# ==============================================================================
+
+# Set up development environment resources using Terraform
+setup-dev-env:
+	PROJECT_ID=$$(gcloud config get-value project) && \
+	(cd deployment/terraform/dev && terraform init && terraform apply --var-file vars/env.tfvars --var dev_project_id=$$PROJECT_ID --auto-approve)
+{%- if cookiecutter.data_ingestion %}
+
+# ==============================================================================
+# Data Ingestion (RAG capabilities)
+# ==============================================================================
+
+# Run the data ingestion pipeline for RAG capabilities
+data-ingestion:
+	PROJECT_ID=$$(gcloud config get-value project) && \
+	(cd data_ingestion && uv run data_ingestion_pipeline/submit_pipeline.py \
+		--project-id=$$PROJECT_ID \
+		--region="us-central1" \
+{%- if cookiecutter.datastore_type == "vertex_ai_search" %}
+		--data-store-id="{{cookiecutter.project_name}}-datastore" \
+		--data-store-region="us" \
+{%- elif cookiecutter.datastore_type == "vertex_ai_vector_search" %}
+		--vector-search-index="{{cookiecutter.project_name}}-vector-search" \
+		--vector-search-index-endpoint="{{cookiecutter.project_name}}-vector-search-endpoint" \
+		--vector-search-data-bucket-name="$$PROJECT_ID-{{cookiecutter.project_name}}-vs" \
+{%- endif %}
+		--service-account="{{cookiecutter.project_name}}-rag@$$PROJECT_ID.iam.gserviceaccount.com" \
+		--pipeline-root="gs://$$PROJECT_ID-{{cookiecutter.project_name}}-rag" \
+		--pipeline-name="data-ingestion-pipeline")
+{%- endif %}
+
+# ==============================================================================
+# Testing & Code Quality
+# ==============================================================================
+
+# Run unit and integration tests
+test:
+	uv sync --dev
+	uv run pytest tests/unit && uv run pytest tests/integration
+
+# Run code quality checks (codespell, ruff, mypy)
+lint:
+	uv sync --dev --extra lint
+	uv run codespell
+	uv run ruff check . --diff
+	uv run ruff format . --check --diff
+	uv run mypy .
+{%- if (cookiecutter.is_a2a and cookiecutter.deployment_target == 'cloud_run') or (cookiecutter.is_adk and not cookiecutter.is_a2a and cookiecutter.deployment_target == 'agent_engine') %}
+
+# ==============================================================================
+# Gemini Enterprise Integration
+# ==============================================================================
+
+# Register the deployed agent to Gemini Enterprise
+# Usage: make register-gemini-enterprise (interactive - will prompt for required details)
+# For non-interactive use, set env vars: ID or GEMINI_ENTERPRISE_APP_ID (full GE resource name)
+# Optional env vars: GEMINI_DISPLAY_NAME, GEMINI_DESCRIPTION{%- if cookiecutter.deployment_target == 'agent_engine' %}, GEMINI_TOOL_DESCRIPTION, AGENT_ENGINE_ID{%- endif %}{%- if cookiecutter.deployment_target == 'cloud_run' %}, AGENT_CARD_URL{%- endif %}
+register-gemini-enterprise:
+{%- if cookiecutter.deployment_target == 'cloud_run' and cookiecutter.is_a2a %}
+	@PROJECT_ID=$$(gcloud config get-value project 2>/dev/null) && \
+	PROJECT_NUMBER=$$(gcloud projects describe $$PROJECT_ID --format="value(projectNumber)" 2>/dev/null) && \
+	uvx agent-starter-pack@{{ cookiecutter.package_version }} register-gemini-enterprise \
+		--agent-card-url="https://{{cookiecutter.project_name}}-$$PROJECT_NUMBER.us-central1.run.app/a2a/{{cookiecutter.agent_directory}}/.well-known/agent-card.json" \
+		--deployment-target="{{cookiecutter.deployment_target}}" \
+		--project-number="$$PROJECT_NUMBER"
+{%- else %}
+	@uvx agent-starter-pack@{{ cookiecutter.package_version }} register-gemini-enterprise
+{%- endif %}
+{%- endif %}