agent-starter-pack 0.11.0__tar.gz → 0.11.1__tar.gz

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/.claude/settings.local.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "permissions": {
     "allow": [
       "Bash(grep:*)",
@@ -11,9 +12,9 @@
       "Bash(. tests/cicd/.env)",
       "Bash(set +a)",
       "Bash(bash:*)",
-      "Bash(ls:*)"
+      "Bash(ls:*)",
+      "Bash(python -m pytest tests/cli/commands/test_enhance.py::TestEnhanceCommand::test_enhance_with_interactive_base_template_selection -v)"
     ],
     "deny": []
-  },
-  "$schema": "https://json.schemastore.org/claude-code-settings.json"
+  }
 }

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.11.0
+Version: 0.11.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
@@ -75,6 +75,14 @@ This command handles creating the project without needing to pre-install the pac
 
 **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.
 
+### 🔧 Enhance Existing Agents
+
+Already have an agent? Add production-ready deployment and infrastructure:
+
+```bash
+agent-starter-pack enhance my-existing-agent
+```
+
 See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) for more options, or try with zero setup in [Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) or [Cloud Shell](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).
 
 ---
@@ -84,7 +92,6 @@ 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_gemini_fullstack` | A production-ready fullstack research agent with Gemini that demonstrates complex agentic workflows, modular agent design, and Human-in-the-Loop steps. [ADK Samples](https://github.com/google/adk-samples/tree/main/python/agents/gemini-fullstack) |
 | `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.11.0 → agent_starter_pack-0.11.1}/README.md

@@ -52,6 +52,14 @@ This command handles creating the project without needing to pre-install the pac
 
 **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.
 
+### 🔧 Enhance Existing Agents
+
+Already have an agent? Add production-ready deployment and infrastructure:
+
+```bash
+agent-starter-pack enhance my-existing-agent
+```
+
 See [Installation Guide](https://googlecloudplatform.github.io/agent-starter-pack/guide/installation) for more options, or try with zero setup in [Firebase Studio](https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx) or [Cloud Shell](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).
 
 ---
@@ -61,7 +69,6 @@ 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_gemini_fullstack` | A production-ready fullstack research agent with Gemini that demonstrates complex agentic workflows, modular agent design, and Human-in-the-Loop steps. [ADK Samples](https://github.com/google/adk-samples/tree/main/python/agents/gemini-fullstack) |
 | `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.11.0 → agent_starter_pack-0.11.1}/docs/agents/overview.md

@@ -33,16 +33,6 @@ This template provides a minimal example of a ReAct agent built using Google's [
 *   Building general-purpose conversational agents.
 *   Learning the ADK framework and ReAct pattern.
 
-### ADK Gemini Fullstack (`adk_gemini_fullstack`)
-
-> 🔍 **Sample Agent**: This agent is part of the [ADK Samples](https://github.com/google/adk-samples/tree/main/python/agents/gemini-fullstack) collection, showcasing agent implementations using the Agent Development Kit.
-
-This template provides a production-ready blueprint for building a sophisticated, fullstack research agent with Gemini. It demonstrates how the ADK helps structure complex agentic workflows, build modular agents, and incorporate critical Human-in-the-Loop (HITL) steps. Key features include:
-
-*   A complete React frontend and ADK-powered FastAPI backend
-*   Advanced agentic workflow where the agent strategizes a multi-step plan, reflects on findings to identify gaps, and synthesizes a final, comprehensive report.
-*   Iterative and Human-in-the-Loop research that involves the user for plan approval, then autonomously loops through searching and refining results.
-
 ### Agentic RAG (`agentic_rag`)
 
 Built on the ADK, this template implements [Retrieval-Augmented Generation (RAG)](https://cloud.google.com/use-cases/retrieval-augmented-generation?hl=en) with a production-ready data ingestion pipeline for document-based question answering. It allows you to ingest, process, and embed custom data to enhance response relevance. Features include:

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.11.0"
+version = "0.11.1"
 description = "CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates."
 authors = [
     { name = "Google LLC", email = "agent-starter-pack@google.com" },

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/src/base_template/{% if cookiecutter.cicd_runner == 'github_actions' %}.github{% else %}unused_github{% endif %}/workflows/deploy-to-prod.yaml

@@ -64,10 +64,12 @@ jobs:
         uses: 'google-github-actions/setup-gcloud@v2'
 {%- endif %}
 
+{%- if cookiecutter.deployment_target == 'agent_engine' %}
       - name: Install uv and dependencies
         run: |
           pip install uv==0.6.12
           uv sync --locked
+{%- endif %}
 
 {%- if cookiecutter.data_ingestion %}
       - name: Deploy data ingestion pipeline (Production)

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/src/cli/commands/enhance.py

@@ -16,8 +16,10 @@ import pathlib
 
 import click
 from rich.console import Console
+from rich.prompt import IntPrompt
 
 from ..utils.logging import display_welcome_banner, handle_cli_error
+from ..utils.template import get_available_agents
 from .create import (
     create,
     get_available_base_templates,
@@ -28,6 +30,48 @@ from .create import (
 console = Console()
 
 
+def display_base_template_selection(current_base: str) -> str:
+    """Display available base templates and prompt for selection."""
+    agents = get_available_agents()
+
+    if not agents:
+        raise click.ClickException("No base templates available")
+
+    console.print()
+    console.print("🔧 [bold]Base Template Selection[/bold]")
+    console.print()
+    console.print(f"Your project currently inherits from: [cyan]{current_base}[/cyan]")
+    console.print("Available base templates:")
+
+    # Create a mapping of choices to agent names
+    template_choices = {}
+    choice_num = 1
+    current_choice = None
+
+    for _num, agent in agents.items():
+        template_choices[choice_num] = agent["name"]
+        current_indicator = " (current)" if agent["name"] == current_base else ""
+        console.print(
+            f"  {choice_num}. [bold]{agent['name']}[/]{current_indicator} - [dim]{agent['description']}[/]"
+        )
+        if agent["name"] == current_base:
+            current_choice = choice_num
+        choice_num += 1
+
+    if current_choice is None:
+        current_choice = 1
+
+    console.print()
+    choice = IntPrompt.ask(
+        "Select base template", default=current_choice, show_default=True
+    )
+
+    if choice in template_choices:
+        return template_choices[choice]
+    else:
+        raise ValueError(f"Invalid base template selection: {choice}")
+
+
 @click.command()
 @click.pass_context
 @click.argument(
@@ -155,25 +199,35 @@ def enhance(
         # Load config from current directory for inheritance info
         current_dir = pathlib.Path.cwd()
         source_config = load_remote_template_config(current_dir, cli_overrides)
-        base_template_name = get_base_template_name(source_config)
-
-        console.print()
-        console.print(
-            f"Template inherits from base: [cyan][link=https://github.com/GoogleCloudPlatform/agent-starter-pack/tree/main/agents/{base_template_name}]{base_template_name}[/link][/cyan]"
-        )
+        original_base_template_name = get_base_template_name(source_config)
 
-        # Show available alternatives and guidance
-        available_bases = get_available_base_templates()
-        if len(available_bases) > 1:
-            other_bases = [b for b in available_bases if b != base_template_name]
-            if other_bases:
-                console.print(
-                    f"[dim]💡 To use a different base template (e.g., {', '.join(other_bases[:2])}), use:[/dim]"
-                )
+        # Interactive base template selection if not provided via CLI and not auto-approved
+        if not base_template and not auto_approve:
+            selected_base_template = display_base_template_selection(
+                original_base_template_name
+            )
+            if selected_base_template != original_base_template_name:
+                # Update CLI overrides with the selected base template
+                cli_overrides["base_template"] = selected_base_template
+                base_template = selected_base_template
                 console.print(
-                    "[dim]   asp enhance . --base-template langgraph_base_react[/dim]"
+                    f"✅ Selected base template: [cyan]{selected_base_template}[/cyan]"
                 )
-        console.print()
+                console.print()
+
+        # Reload config with potential base template override
+        if cli_overrides.get("base_template"):
+            source_config = load_remote_template_config(current_dir, cli_overrides)
+
+        base_template_name = get_base_template_name(source_config)
+
+        # Show current inheritance info
+        if not auto_approve or base_template:
+            console.print()
+            console.print(
+                f"Template inherits from base: [cyan][link=https://github.com/GoogleCloudPlatform/agent-starter-pack/tree/main/agents/{base_template_name}]{base_template_name}[/link][/cyan]"
+            )
+            console.print()
 
     # Validate project structure when using current directory template
     if template_path == pathlib.Path("."):

agent_starter_pack-0.11.1/tests/cli/commands/test_enhance.py

@@ -0,0 +1,142 @@
+# 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 pathlib
+from unittest.mock import MagicMock, patch
+
+import click
+import pytest
+from click.testing import CliRunner
+
+from src.cli.commands.enhance import display_base_template_selection, enhance
+
+
+class TestDisplayBaseTemplateSelection:
+    """Test the base template selection function."""
+
+    @patch("src.cli.commands.enhance.get_available_agents")
+    @patch("src.cli.commands.enhance.IntPrompt.ask")
+    def test_base_template_selection_with_current_default(
+        self, mock_prompt: MagicMock, mock_get_agents: MagicMock
+    ) -> None:
+        """Test that current base template is the default selection."""
+        # Mock available agents
+        mock_get_agents.return_value = {
+            1: {"name": "adk_base", "description": "Basic agent template"},
+            2: {"name": "langgraph_base_react", "description": "LangGraph ReAct agent"},
+            3: {"name": "agentic_rag", "description": "RAG-enabled agent"},
+        }
+
+        # Mock user selecting default (current template)
+        mock_prompt.return_value = 1
+
+        result = display_base_template_selection("adk_base")
+
+        assert result == "adk_base"
+        # Check that prompt was called with the correct default (1 for adk_base)
+        mock_prompt.assert_called_once()
+        call_args = mock_prompt.call_args
+        assert call_args[1]["default"] == 1
+
+    @patch("src.cli.commands.enhance.get_available_agents")
+    @patch("src.cli.commands.enhance.IntPrompt.ask")
+    def test_base_template_selection_different_choice(
+        self, mock_prompt: MagicMock, mock_get_agents: MagicMock
+    ) -> None:
+        """Test selecting a different base template."""
+        # Mock available agents
+        mock_get_agents.return_value = {
+            1: {"name": "adk_base", "description": "Basic agent template"},
+            2: {"name": "langgraph_base_react", "description": "LangGraph ReAct agent"},
+            3: {"name": "agentic_rag", "description": "RAG-enabled agent"},
+        }
+
+        # Mock user selecting option 2
+        mock_prompt.return_value = 2
+
+        result = display_base_template_selection("adk_base")
+
+        assert result == "langgraph_base_react"
+
+    @patch("src.cli.commands.enhance.get_available_agents")
+    def test_base_template_selection_no_agents(
+        self, mock_get_agents: MagicMock
+    ) -> None:
+        """Test error handling when no agents are available."""
+        mock_get_agents.return_value = {}
+
+        with pytest.raises(click.ClickException):
+            display_base_template_selection("adk_base")
+
+
+class TestEnhanceCommand:
+    """Test the enhance command functionality."""
+
+    @patch("src.cli.utils.remote_template.get_base_template_name")
+    @patch("src.cli.utils.remote_template.load_remote_template_config")
+    @patch("src.cli.commands.enhance.display_base_template_selection")
+    def test_enhance_with_interactive_base_template_selection(
+        self,
+        mock_display_selection: MagicMock,
+        mock_load_config: MagicMock,
+        mock_get_base_name: MagicMock,
+    ) -> None:
+        """Test that enhance prompts for base template when not provided via CLI."""
+        # Mock the template config loading
+        mock_get_base_name.return_value = "adk_base"
+        mock_load_config.return_value = {"base_template": "adk_base"}
+        mock_display_selection.return_value = "langgraph_base_react"
+
+        runner = CliRunner()
+
+        # Create a temporary directory to run enhance in
+        with runner.isolated_filesystem():
+            # Create an app directory to avoid structure warnings
+            pathlib.Path("app").mkdir()
+            pathlib.Path("app/agent.py").touch()
+
+            # Mock the create command to avoid actually running it
+            with patch("src.cli.commands.enhance.create"):
+                # Run enhance without --auto-approve and without --base-template
+                runner.invoke(
+                    enhance,
+                    [
+                        ".",
+                        "--auto-approve",
+                    ],  # Use auto-approve to skip confirmation prompts
+                    input="y\n",  # Confirm enhancement
+                )
+
+                # The interactive selection should not be called with --auto-approve
+                mock_display_selection.assert_not_called()
+
+    def test_enhance_with_base_template_cli_param(self) -> None:
+        """Test that enhance respects --base-template CLI parameter."""
+        runner = CliRunner()
+
+        with runner.isolated_filesystem():
+            # Create app directory structure
+            pathlib.Path("app").mkdir()
+            pathlib.Path("app/agent.py").touch()
+
+            with patch("src.cli.commands.enhance.create") as mock_create:
+                runner.invoke(
+                    enhance,
+                    [".", "--base-template", "langgraph_base_react", "--auto-approve"],
+                )
+
+                # Should call create with the specified base template
+                mock_create.assert_called_once()
+                call_args = mock_create.call_args
+                assert call_args[1]["base_template"] == "langgraph_base_react"

{agent_starter_pack-0.11.0 → agent_starter_pack-0.11.1}/uv.lock

@@ -11,7 +11,7 @@ resolution-markers = [
 
 [[package]]
 name = "agent-starter-pack"
-version = "0.11.0"
+version = "0.11.1"
 source = { editable = "." }
 dependencies = [
     { name = "backoff" },

agent_starter_pack-0.11.0/agents/adk_gemini_fullstack/.template/templateconfig.yaml

@@ -1,39 +0,0 @@
-# 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 production-ready fullstack research agent that uses Gemini to strategize, research, and synthesize comprehensive reports with human-in-the-loop collaboration"
-example_question: "A report on the latest Google I/O event"
-settings:
-  requires_data_ingestion: false
-  requires_session: true
-  deployment_targets: ["agent_engine", "cloud_run"]
-  extra_dependencies: ["google-adk~=1.8.0"]
-  tags: ["adk"]
-  frontend_type: "adk_gemini_fullstack"
-  interactive_command: "dev"
-  commands:
-    override:
-      install: "uv sync --dev --extra jupyter && npm --prefix frontend install"
-    extra:
-      dev: 
-        command: 'make dev-backend & make dev-frontend'
-        description: "Start the ADK API server and React frontend development server simultaneously"
-      dev-backend:
-        command: 
-          agent_engine: 'uv run adk api_server app --allow_origins="*"'
-          cloud_run: 'ALLOW_ORIGINS="*" uv run uvicorn app.server:app --host 0.0.0.0 --port 8000 --reload'
-        description: "Start the ADK API server"
-      dev-frontend:
-        command: 'npm --prefix frontend run dev'
-        description: "Start the React frontend development server"

agent_starter_pack-0.11.0/agents/adk_gemini_fullstack/README.md

@@ -1,27 +0,0 @@
-# Gemini Fullstack Agent Development Kit (ADK) Quickstart
-
-> 🔍 **Sample Agent**: This agent is part of the [ADK Samples](https://github.com/google/adk-samples/tree/main/python/agents/gemini-fullstack) collection, showcasing agent implementations using the Agent Development Kit.
-
-The **Gemini Fullstack Agent Development Kit (ADK) Quickstart** is a production-ready blueprint for building a sophisticated, fullstack research agent with Gemini. It's built to demonstrate how the ADK helps structure complex agentic workflows, build modular agents, and incorporate critical Human-in-the-Loop (HITL) steps.
-
-<table>
-  <thead>
-    <tr>
-      <th colspan="2">Key Features</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>🏗️</td>
-      <td><strong>Fullstack & Production-Ready:</strong> A complete React frontend and ADK-powered FastAPI backend, with deployment options for <a href="https://cloud.google.com/run">Google Cloud Run</a> and <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview">Vertex AI Agent Engine</a>.</td>
-    </tr>
-    <tr>
-      <td>🧠</td>
-      <td><strong>Advanced Agentic Workflow:</strong> The agent uses Gemini to <strong>strategize</strong> a multi-step plan, <strong>reflect</strong> on findings to identify gaps, and <strong>synthesize</strong> a final, comprehensive report.</td>
-    </tr>
-    <tr>
-      <td>🔄</td>
-      <td><strong>Iterative & Human-in-the-Loop Research:</strong> Involves the user for plan approval, then autonomously loops through searching (via Gemini function calling) and refining its results until it has gathered sufficient information.</td>
-    </tr>
-  </tbody>
-</table>