agent-starter-pack 0.18.2__tar.gz → 0.19.1__tar.gz

{agent_starter_pack-0.18.2 → agent_starter_pack-0.19.1}/.claude/settings.local.json

@@ -35,9 +35,12 @@
       "Bash(PROJECT_IDS=asp-starter-dev,asp-starter-prod,asp-starter-staging python3 tests/cicd/scripts/delete_vector_search.py)",
       "Bash(chmod +x /Users/eliasecchi/Development/agent-starter-pack/force-cleanup.sh)",
       "Bash(terraform plan -var-file=vars/env.tfvars)",
-      "Bash(uv run pytest \"tests/unit/test_makefile_template.py::TestMakefileGeneration::test_makefile_hash[adk_base_agent_engine_no_data]\" -v)"
+      "Bash(uv run pytest \"tests/unit/test_makefile_template.py::TestMakefileGeneration::test_makefile_hash[adk_base_agent_engine_no_data]\" -v)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Read(//private/tmp/asp-test/test-labels-check/rag/**)"
     ],
     "deny": [],
     "ask": []
   }
-}
+}

{agent_starter_pack-0.18.2 → agent_starter_pack-0.19.1}/.cloudbuild/terraform/build_triggers.tf

@@ -106,6 +106,14 @@ locals {
       name  = "adk_b-cr-agent_engine"
       value = "adk_base,cloud_run,--session-type,agent_engine"
     },
+    {
+      name  = "adk_a2a_base-agent_engine"
+      value = "adk_a2a_base,agent_engine"
+    },
+    {
+      name  = "adk_a2a_base-cloud_run"
+      value = "adk_a2a_base,cloud_run"
+    },
   ]
 
 agent_testing_included_files = { for combo in local.agent_testing_combinations :
@@ -172,6 +180,14 @@ agent_testing_included_files = { for combo in local.agent_testing_combinations :
       name  = "adk_base-cloud_run-alloydb"
       value = "adk_base,cloud_run,--session-type,alloydb"
     },
+    {
+      name  = "adk_a2a_base-agent_engine"
+      value = "adk_a2a_base,agent_engine"
+    },
+    {
+      name  = "adk_a2a_base-cloud_run"
+      value = "adk_a2a_base,cloud_run"
+    },
   ]
   # Create a safe trigger name by replacing underscores with hyphens and dots with hyphens
   # This ensures we have valid trigger names that don't exceed character limits

{agent_starter_pack-0.18.2 → agent_starter_pack-0.19.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.18.2
+Version: 0.19.1
 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
@@ -93,6 +93,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | Agent Name                  | Description                                                                                                                       |
 |-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
 | `adk_base`      | A base ReAct agent implemented using Google's [Agent Development Kit](https://github.com/google/adk-python) |
+| `adk_a2a_base`  | An ADK agent with [Agent2Agent (A2A) Protocol](https://a2a-protocol.org/) support for distributed agent communication and interoperability |
 | `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       |

{agent_starter_pack-0.18.2 → agent_starter_pack-0.19.1}/README.md

@@ -68,6 +68,7 @@ See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pac
 | Agent Name                  | Description                                                                                                                       |
 |-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
 | `adk_base`      | A base ReAct agent implemented using Google's [Agent Development Kit](https://github.com/google/adk-python) |
+| `adk_a2a_base`  | An ADK agent with [Agent2Agent (A2A) Protocol](https://a2a-protocol.org/) support for distributed agent communication and interoperability |
 | `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       |

agent_starter_pack-0.19.1/agent_starter_pack/agents/adk_a2a_base/.template/templateconfig.yaml

@@ -0,0 +1,22 @@
+# 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 built with Google's Agent Development Kit (ADK) and Agent2Agent (A2A) Protocol. #experimental"
+example_question: "What's the weather in San Francisco?"
+settings:
+  requires_data_ingestion: false
+  deployment_targets: ["agent_engine", "cloud_run"]
+  extra_dependencies: ["google-adk>=1.16.0,<2.0.0", "a2a-sdk~=0.3.9"]
+  tags: ["adk", "a2a"]
+  frontend_type: "None"

agent_starter_pack-0.19.1/agent_starter_pack/agents/adk_a2a_base/README.md

@@ -0,0 +1,22 @@
+# ADK with Agent2Agent (A2A) Protocol: Minimal Agent Example
+
+<p align="center">
+  <img src="https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/adk_logo.png?raw=true" width="200" alt="ADK 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="200" alt="A2A Logo" style="vertical-align: middle;">
+</p>
+
+A basic agent built using the **[Google Agent Development Kit (ADK)](https://google.github.io/adk-docs/)** with **[Agent2Agent (A2A) Protocol](https://a2a-protocol.org/)** support. This example demonstrates core ADK concepts like agent creation and tool integration, while enabling distributed agent communication through the A2A protocol for interoperability with agents across different frameworks and languages.
+
+This agent uses the `gemini-2.5-flash` model and is equipped with two simple tools:
+*   `get_weather`: Simulates fetching weather (hardcoded for SF).
+*   `get_current_time`: Simulates fetching the time (hardcoded for SF).
+
+## Additional Resources
+
+### ADK Resources
+- **ADK Documentation**: Learn more about ADK concepts and capabilities in the [official documentation](https://google.github.io/adk-docs/)
+- **ADK Samples**: Explore more examples and use cases in the [official ADK Samples Repository](https://github.com/google/adk-samples)
+
+### A2A Resources
+- **A2A Documentation**: Learn about the Agent2Agent protocol and distributed agent communication in the [official A2A documentation](https://a2a-protocol.org/latest/specification/)
+- **A2A Samples**: Explore A2A agent implementations and integration examples in the [A2A Samples Repository](https://github.com/a2aproject/a2a-samples)

agent_starter_pack-0.19.1/agent_starter_pack/agents/adk_a2a_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 app
+
+__all__ = ["app"]

agent_starter_pack-0.19.1/agent_starter_pack/agents/adk_a2a_base/app/agent.py

@@ -0,0 +1,70 @@
+# 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.
+
+import datetime
+import os
+from zoneinfo import ZoneInfo
+
+import google.auth
+from google.adk.agents import Agent
+from google.adk.apps.app import App
+
+_, project_id = google.auth.default()
+os.environ.setdefault("GOOGLE_CLOUD_PROJECT", project_id)
+os.environ.setdefault("GOOGLE_CLOUD_LOCATION", "global")
+os.environ.setdefault("GOOGLE_GENAI_USE_VERTEXAI", "True")
+
+
+def get_weather(query: str) -> str:
+    """Simulates a web search. Use it get information on weather.
+
+    Args:
+        query: A string containing the location to get weather information for.
+
+    Returns:
+        A string with the simulated weather information for the queried location.
+    """
+    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."
+
+
+def get_current_time(query: str) -> str:
+    """Simulates getting the current time for a city.
+
+    Args:
+        city: The name of the city to get the current time for.
+
+    Returns:
+        A string with the current time information.
+    """
+    if "sf" in query.lower() or "san francisco" in query.lower():
+        tz_identifier = "America/Los_Angeles"
+    else:
+        return f"Sorry, I don't have timezone information for query: {query}."
+
+    tz = ZoneInfo(tz_identifier)
+    now = datetime.datetime.now(tz)
+    return f"The current time for query {query} is {now.strftime('%Y-%m-%d %H:%M:%S %Z%z')}"
+
+
+root_agent = Agent(
+    name="root_agent",
+    model="gemini-2.5-flash",
+    description="An agent that can provide information about the weather and time.",
+    instruction="You are a helpful AI assistant designed to provide accurate and useful information.",
+    tools=[get_weather, get_current_time],
+)
+
+app = App(root_agent=root_agent, name="app")