agent-starter-pack 0.17.3__tar.gz → 0.17.5__tar.gz

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.17.3
+Version: 0.17.5
 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
@@ -24,7 +24,7 @@ Description-Content-Type: text/markdown
 
 # 🚀 Agent Starter Pack
 
-![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
+![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fagent_starter_pack%2Fresources%2Fidx">
   <picture>
     <source
       media="(prefers-color-scheme: dark)"

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/README.md

@@ -1,6 +1,6 @@
 # 🚀 Agent Starter Pack
 
-![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fsrc%2Fresources%2Fidx">
+![Version](https://img.shields.io/pypi/v/agent-starter-pack?color=blue) [![1-Minute Video Overview](https://img.shields.io/badge/1--Minute%20Overview-gray)](https://youtu.be/jHt-ZVD660g) [![Docs](https://img.shields.io/badge/Documentation-gray)](https://googlecloudplatform.github.io/agent-starter-pack/) <a href="https://studio.firebase.google.com/new?template=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fagent-starter-pack%2Ftree%2Fmain%2Fagent_starter_pack%2Fresources%2Fidx">
   <picture>
     <source
       media="(prefers-color-scheme: dark)"

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/agent_starter_pack/agents/crewai_coding_crew/.template/templateconfig.yaml

@@ -24,4 +24,5 @@ settings:
     "langgraph~=0.6.2",
     "crewai~=0.152.0"
   ]
+  frontend_type: "streamlit"
 example_question: "How can I implement a function to sort a list in Python?"

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/agent_starter_pack/agents/langgraph_base_react/.template/templateconfig.yaml

@@ -25,4 +25,5 @@ settings:
     "langchain-community~=0.3.17",
     "langchain-openai~=0.3.5",
   ]
+  frontend_type: "streamlit"
 example_question: "What's the weather in San Francisco?"

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/agent_starter_pack/base_template/Makefile

@@ -79,6 +79,20 @@ playground:{%- if cookiecutter.is_adk_live %} build-frontend-if-needed{%- endif
 {%- 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}}.server:app --host localhost --port 8000 --reload
+{%- else %}
+	uv run python -m {{cookiecutter.agent_directory}}.utils.expose_app --mode local --port 8000  --local-agent {{cookiecutter.agent_directory}}.agent.root_agent
+{%- endif %}
+{%- endif %}
 {%- if cookiecutter.is_adk_live %}
 
 # ==============================================================================
@@ -101,18 +115,8 @@ build-frontend-if-needed:
 	else \
 		echo "Frontend build is up to date. Skipping build..."; \
 	fi
-{%- if cookiecutter.deployment_target == 'cloud_run' %}
-
-# Launch local development server with hot-reload
-local-backend:
-	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host localhost --port 8000 --reload
-{%- endif %}
 {%- if cookiecutter.deployment_target == 'agent_engine' %}
 
-# Launch local development server with hot-reload
-local-backend:
-	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
 	@echo "==============================================================================="

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/agent_starter_pack/cli/utils/remote_template.py

@@ -204,7 +204,7 @@ def check_and_execute_with_version_lock(
 
         try:
             # Execute uvx with the locked version
-            cmd = ["uvx", f"agent-starter-pack=={version}", *original_args]
+            cmd = ["uvx", f"agent-starter-pack@{version}", *original_args]
             logging.debug(f"Executing nested command: {' '.join(cmd)}")
             subprocess.run(cmd, check=True)
             return True

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-starter-pack"
-version = "0.17.3"
+version = "0.17.5"
 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.17.5/src/resources/idx/.idx/dev.nix

@@ -0,0 +1,64 @@
+
+# To learn more about how to use Nix to configure your environment
+# see: https://firebase.google.com/docs/studio/customize-workspace
+{ pkgs, ... }: {
+  # Which nixpkgs channel to use.
+  channel = "stable-24.11"; # or "unstable"
+
+  # Use https://search.nixos.org/packages to find packages
+  packages = [
+    pkgs.uv
+    pkgs.gnumake
+    pkgs.terraform
+    pkgs.gh
+  ];
+  # Sets environment variables in the workspace
+  env = {};
+  idx = {
+    # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
+    extensions = [
+    ];
+    workspace = {
+      # Runs when a workspace is first created with this `dev.nix` file
+      onCreate = {
+        create-venv = ''
+        # Load environment variables from .env file if it exists
+        source .env
+
+        # Beautiful prints for gcloud setup
+        echo ""
+        echo "╔════════════════════════════════════════════════════════════╗"
+        echo "║                  🔐 GCLOUD SETUP REQUIRED                  ║"
+        echo "╚════════════════════════════════════════════════════════════╝"
+        echo ""
+        echo "📝 Before proceeding, please ensure:"
+        echo "   1️⃣  You are logged in to gcloud"
+        echo "   2️⃣  You have selected the correct project"
+        echo ""
+
+        auth_status=$(gcloud auth list --quiet 2>&1)
+
+        echo ""
+        echo "⚙️  We will now set the project you want to use..."
+        gcloud config get project
+
+        echo ""
+        echo "💡 Need to setup? Run these commands:"
+        echo "   → gcloud auth login"
+        echo "   → gcloud config set project YOUR_PROJECT_ID"
+        echo ""
+
+        echo "Running agent starter pack creation..."
+        uvx agent-starter-pack create $WS_NAME
+        code ~/$WS_NAME/$WS_NAME/README.md
+        exec bash
+        '';
+        # Open editors for the following files by default, if they exist:
+        default.openFiles = [];
+      };
+      # To run something each time the workspace is (re)started, use the `onStart` hook
+    };
+    # Enable previews and customize configuration
+    previews = {};
+  };
+}

agent_starter_pack-0.17.5/src/resources/idx/idx-template.json

@@ -0,0 +1,6 @@
+{
+  "name": "Agent Starter Pack",
+  "description": "Production-ready Gen AI Agent templates for Google Cloud. Addressing common challenges (Deployment & Operations, Evaluation, Customization, Observability) in building and deploying GenAI agents.",
+  "icon": "https://github.com/GoogleCloudPlatform/agent-starter-pack/blob/main/docs/images/icon.png?raw=true",
+  "params": []
+}

agent_starter_pack-0.17.5/src/resources/idx/idx-template.nix

@@ -0,0 +1,25 @@
+
+# No user-configurable parameters
+# Accept additional arguments to this template corresponding to template
+# parameter IDs
+{ pkgs, agent_name ? "", google_cloud_project_id ? "", ... }: {
+  # Shell script that produces the final environment
+  bootstrap = ''
+    # Copy the folder containing the `idx-template` files to the final
+    # project folder for the new workspace. ${./.} inserts the directory
+    # of the checked-out Git folder containing this template.
+    cp -rf ${./.} "$out"
+
+    # Set some permissions
+    chmod -R +w "$out"
+
+    # Create .env file with the parameter values
+    cat > "$out/.env" << EOF
+    WS_NAME=$WS_NAME
+    EOF
+
+    # Remove the template files themselves and any connection to the template's
+    # Git repository
+    rm -rf "$out/.git" "$out/idx-template".{nix,json}
+  '';
+}

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/cli/utils/test_remote_template.py

@@ -835,7 +835,7 @@ class TestCheckAndExecuteWithVersionLock:
         # Verify the correct command was executed
         expected_cmd = [
             "uvx",
-            "agent-starter-pack==0.14.2",
+            "agent-starter-pack@0.14.2",
             "create",
             "test-project",
             "-a",
@@ -916,7 +916,7 @@ class TestCheckAndExecuteWithVersionLock:
         # Verify the command was executed without agent spec replacement
         expected_cmd = [
             "uvx",
-            "agent-starter-pack==0.14.2",
+            "agent-starter-pack@0.14.2",
             "create",
             "test-project",
             "--skip-welcome",
@@ -958,7 +958,7 @@ class TestCheckAndExecuteWithVersionLock:
         # Verify the command was executed without --skip-welcome and --locked flags
         expected_cmd = [
             "uvx",
-            "agent-starter-pack==0.14.0",
+            "agent-starter-pack@0.14.0",
             "create",
             "test-project",
             "-a",

agent_starter_pack-0.17.5/tests/fixtures/makefile_hashes.json

@@ -0,0 +1,11 @@
+{
+  "adk_base_agent_engine_no_data": "d76c4fc040b90d51d76b2fc9dbd87bb7847aaf20b34ca937ab5e9abfbba919b9",
+  "adk_base_cloud_run_no_data": "048610cde47f7eaf92325f0bc041506712f13a73284d481d7a23300c1184c2da",
+  "adk_live_agent_engine": "e406773318d3f06966ca1719018c9b3b51c5cce21ca808497d34a5e34baa7be5",
+  "adk_live_cloud_run": "ec3e84e89e9e735af4335a4f1de0be9021c8ff8fc6d89ef039af8b7baa7bdd71",
+  "agent_with_agent_garden": "9394986d70140cbdc05748cc081c3962af062661f5f878e4738a20b59f509acb",
+  "agent_with_custom_commands": "72620702864f5ff00595fe2dc143d145278d9d53d4aa7cff9e44b50cd8a51c57",
+  "agentic_rag_cloud_run_vector_search": "6343c9acd1aa12d87c7e71d838862526420e2a002c3ab3decf8cf95eb094b12b",
+  "agentic_rag_cloud_run_vertex_search": "ccbff227d94ec14b3784034723392598391c5ca92be10dbca4b56dd3387c5448",
+  "langgraph_cloud_run_no_data": "72dfd291fa55e836b4e33fc51c1cb6e4c1f666dbfa03176d4fab4a007cef4a81"
+}

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/adk_base_cloud_run_no_data.makefile

@@ -22,6 +22,14 @@ playground:
 	@echo "==============================================================================="
 	uv run adk web . --port 8501 --reload_agents
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_adk_base.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/adk_live_agent_engine.makefile

@@ -21,6 +21,14 @@ playground: build-frontend-if-needed
 	@echo "==============================================================================="
 	uv run python -m test_adk_live.utils.expose_app --mode local --local-agent test_adk_live.agent.root_agent
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run python -m test_adk_live.utils.expose_app --mode local --port 8000  --local-agent test_adk_live.agent.root_agent
+
 # ==============================================================================
 # ADK Live Commands
 # ==============================================================================
@@ -42,10 +50,6 @@ build-frontend-if-needed:
 		echo "Frontend build is up to date. Skipping build..."; \
 	fi
 
-# Launch local development server with hot-reload
-local-backend:
-	uv run python -m test_adk_live.utils.expose_app --mode local --port 8000  --local-agent test_adk_live.agent.root_agent
-
 # Connect to remote deployed agent
 playground-remote: build-frontend-if-needed
 	@echo "==============================================================================="

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/adk_live_cloud_run.makefile

@@ -21,6 +21,14 @@ playground: build-frontend-if-needed
 	@echo "==============================================================================="
 	uv run uvicorn test_adk_live.server:app --host localhost --port 8000 --reload
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_adk_live.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # ADK Live Commands
 # ==============================================================================
@@ -42,10 +50,6 @@ build-frontend-if-needed:
 		echo "Frontend build is up to date. Skipping build..."; \
 	fi
 
-# Launch local development server with hot-reload
-local-backend:
-	uv run uvicorn test_adk_live.server:app --host localhost --port 8000 --reload
-
 # Start the frontend UI separately for development (requires backend running separately)
 ui:
 	(cd frontend && PORT=8501 npm start)

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/agent_with_agent_garden.makefile

@@ -22,6 +22,14 @@ playground:
 	@echo "==============================================================================="
 	uv run adk web . --port 8501 --reload_agents
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_garden.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/agent_with_custom_commands.makefile

@@ -27,6 +27,14 @@ custom-task:
 env-specific-task:
 	echo 'Cloud Run task'
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_custom.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/agentic_rag_cloud_run_vector_search.makefile

@@ -21,6 +21,14 @@ playground:
 	uv run uvicorn test_rag.server:app --host localhost --port 8000 --reload &
 	uv run streamlit run frontend/streamlit_app.py --browser.serverAddress=localhost --server.enableCORS=false --server.enableXsrfProtection=false
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_rag.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/agentic_rag_cloud_run_vertex_search.makefile

@@ -21,6 +21,14 @@ playground:
 	uv run uvicorn test_rag.server:app --host localhost --port 8000 --reload &
 	uv run streamlit run frontend/streamlit_app.py --browser.serverAddress=localhost --server.enableCORS=false --server.enableXsrfProtection=false
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_rag.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/fixtures/makefile_snapshots/langgraph_cloud_run_no_data.makefile

@@ -21,6 +21,14 @@ playground:
 	uv run uvicorn test_langgraph.server:app --host localhost --port 8000 --reload &
 	uv run streamlit run frontend/streamlit_app.py --browser.serverAddress=localhost --server.enableCORS=false --server.enableXsrfProtection=false
 
+# ==============================================================================
+# Local Development Commands
+# ==============================================================================
+
+# Launch local development server with hot-reload
+local-backend:
+	uv run uvicorn test_langgraph.server:app --host localhost --port 8000 --reload
+
 # ==============================================================================
 # Backend Deployment Targets
 # ==============================================================================

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/tests/integration/test_templated_patterns.py

@@ -83,6 +83,14 @@ def _run_agent_test(
         for file in essential_files:
             assert (project_path / file).exists(), f"Missing file: {file}"
 
+        # Verify frontend folder for agents with streamlit frontend
+        if agent in ["langgraph_base_react", "crewai_coding_crew"]:
+            frontend_dir = project_path / "frontend"
+            assert frontend_dir.exists(), f"Frontend folder missing for {agent}"
+            assert (frontend_dir / "streamlit_app.py").exists(), (
+                f"streamlit_app.py missing for {agent}"
+            )
+
         # Install dependencies
         run_command(
             [

{agent_starter_pack-0.17.3 → agent_starter_pack-0.17.5}/uv.lock

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

agent_starter_pack-0.17.3/tests/fixtures/makefile_hashes.json

@@ -1,11 +0,0 @@
-{
-  "adk_base_agent_engine_no_data": "d76c4fc040b90d51d76b2fc9dbd87bb7847aaf20b34ca937ab5e9abfbba919b9",
-  "adk_base_cloud_run_no_data": "8b0ea9af5af817c5beb4956d9e49340f4886c634f77e0e8eee7bf82bfb8334b1",
-  "adk_live_agent_engine": "3f6400e07484fca7898bf11c810d5af7a675036ff16b4bc774bb714f4b24f99a",
-  "adk_live_cloud_run": "789fbc07ec267d86f7e779ba4229930b6bc3e243871e5bf3ee32f497503bc552",
-  "agent_with_agent_garden": "e08b4fd290f1f83828b48a8f663d75e8fa3745a05c2125f9d746b8eea77b7c1f",
-  "agent_with_custom_commands": "02b5764b75be952a06abfbb8a4e15cdf6a671652f290f9ffb2994dc9aa9382ff",
-  "agentic_rag_cloud_run_vector_search": "ec10406d7bf56d6dc253cbce8254ee33c923f369d04f406227dc5ca401564aad",
-  "agentic_rag_cloud_run_vertex_search": "83edd4467bff3418f619c2fcb0b449646a8a5dd2aea85c60075052f8c837e0a6",
-  "langgraph_cloud_run_no_data": "c690f5792208e6834dd389ab448784819ca97405d01a824b4534ab256e3f1c6a"
-}