agent-starter-pack 0.12.0__py3-none-any.whl → 0.13.0__py3-none-any.whl

{agent_starter_pack-0.12.0.dist-info → agent_starter_pack-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.12.0
+Version: 0.13.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
@@ -12,6 +12,7 @@ Requires-Dist: cookiecutter~=2.6.0
 Requires-Dist: google-cloud-aiplatform>=1.87.0
 Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli>=1.1.0; python_version < '3.11'
 Provides-Extra: jupyter
 Requires-Dist: ipykernel>=6.29.5; extra == 'jupyter'
 Requires-Dist: jupyter; extra == 'jupyter'

{agent_starter_pack-0.12.0.dist-info → agent_starter_pack-0.13.0.dist-info}/RECORD

@@ -38,8 +38,8 @@ agents/live_api/tests/unit/test_server.py,sha256=_tf9nHkb7aOe3lZRlyp7cVklOTOYTuX
 llm.txt,sha256=onvCAhaPcye3YWfCkQeX4Y-LWF1TsAsZ09cO_iO-i3Y,14607
 src/base_template/.gitignore,sha256=Fq0w34x4sfbwP4RqDqh6hdHNYRUEsFNI-9XONzLWBIs,2580
 src/base_template/GEMINI.md,sha256=WzscHWlQeYkKORZ-453P8KM9IHuj1kAxW-69c7Ytuwk,133
-src/base_template/Makefile,sha256=tUPxvZI-XyAs2cXa3L3aTh3DFkwUBYkF5BOGs0DtvIk,6267
-src/base_template/README.md,sha256=KkHKYpnkU7gzfvzyULlTyt7gUxkf1IcK7Y4ydceLVzc,11458
+src/base_template/Makefile,sha256=8LRvbHvuj92oFr9dB3E92O39WqMKxM_kPO5t2lewOC4,6818
+src/base_template/README.md,sha256=ywTmrlWmivgHAtzXQCZqNu_Hfxp51QTnX4USNgGk6kU,10040
 src/base_template/pyproject.toml,sha256=dTyxaWetB-XCKQEDV3lXxAUxtBEpustNdlAEcT8ZZpo,2932
 src/base_template/deployment/README.md,sha256=gZJvSWdQh_Mi-bZ3dmuPv7fMezIw04fgN5tq7KgglPw,692
 src/base_template/deployment/terraform/apis.tf,sha256=KX8Oe2gjT-gh9Bkntz9yIAyRjPc1gZvwOhroJ6NZVp4,1513
@@ -72,17 +72,17 @@ src/base_template/{{cookiecutter.agent_directory}}/utils/gcs.py,sha256=jKblaWOGQ
 src/base_template/{{cookiecutter.agent_directory}}/utils/tracing.py,sha256=2rv1Ukh2jTBENDwoghCItJ28l-Sjz9gMlzdojlVgJa4,6052
 src/base_template/{{cookiecutter.agent_directory}}/utils/typing.py,sha256=DP5OZC3IGvqA1XbvWt8kI3gyAK3ZjzUSL5Ca17wNeLI,4249
 src/cli/main.py,sha256=Dya7Sw3ozMTaGDcwMh_-W7udkGZHGzgAj8aBdSZaZxI,1832
-src/cli/commands/create.py,sha256=l2Uo_cVekBNLJA-dnBy5Lue9yUwhUStkOUmIYSvyf-8,44810
-src/cli/commands/enhance.py,sha256=rrELrS1BErjDiTmeyVek8bbiIoxrSUZY2eYOqiAvi2Y,15076
-src/cli/commands/list.py,sha256=_Xi2f1myiqEuZnfv-OkY8nPC58YhKOzYDGqh8GW9nd8,5502
+src/cli/commands/create.py,sha256=qVcK3E5DzQ66QACrwDA2q-6LvCApipIcht9HCi-LT28,45331
+src/cli/commands/enhance.py,sha256=4QMfU2hGHw1tZLrTYtBvpc3n6__mdSSekKMqy4OQAyE,15137
+src/cli/commands/list.py,sha256=ZGol9eYB9Yon7JysMUCtpEOwdXzrApdTHzErx6KvT04,6856
 src/cli/commands/setup_cicd.py,sha256=nSgMUD4_ncYGwLWU1Fl7Ypw3GTJc8qVfjPxwZMLn4xo,32113
 src/cli/utils/__init__.py,sha256=_cTmsXGPqOtK0q8UW5164QTltbJRJFR_Efxq_BRL1-o,1311
 src/cli/utils/cicd.py,sha256=9s_OcusQznT_pSjFP60BfDBoZ5V6bwPE0QWbWdMaVlY,26515
 src/cli/utils/datastores.py,sha256=gv1V6eDcOEKx4MRNG5C3Y-VfixYq1AzQuaYMLp8QRNo,1058
-src/cli/utils/gcp.py,sha256=cnuCyN144eiyYc9aJNEK9JnyWN66rdevugoMdDYC1UU,4032
+src/cli/utils/gcp.py,sha256=XDtQVsqnYiZl4OGhrDjRwn5vq4GpFGu9v1CRwdu39Rs,8245
 src/cli/utils/logging.py,sha256=MYPxQYXXaKCqBVOfrhEMe8lFKzpzZWjOVP2Km81X5Mk,3007
-src/cli/utils/remote_template.py,sha256=Uqqhz84p9zlhccUP8ucU1oRs0lCly4see5mfujP42eM,12165
-src/cli/utils/template.py,sha256=2CnxXTvQVM_ZnY8NlBNXuyhmIsflDe1eTUrHPFR7Qqk,46175
+src/cli/utils/remote_template.py,sha256=BYdV9Bgj54UUgOTnxlkOr8xA9ZgqKSEE-lWnmpJ05UY,18529
+src/cli/utils/template.py,sha256=j-f1FyvG9BuE7KTZglQ9BCYiPMbvW5z2xnr5JQLOhkg,50034
 src/cli/utils/version.py,sha256=F4udQmzniPStqWZFIgnv3Qg3l9non4mfy2An-Oveqmc,2916
 src/data_ingestion/README.md,sha256=LNxSQoJW9JozK-TbyGQLj5L_MGWNwrfLk6V6RmQ2oBQ,4032
 src/data_ingestion/pyproject.toml,sha256=-1Mf2QB8K70ICQV5UPZDpf-fN3UwEQLVzQyxfakCSTY,445
@@ -98,15 +98,15 @@ src/deployment_targets/agent_engine/tests/load_test/README.md,sha256=aQP7nDAqd2j
 src/deployment_targets/agent_engine/tests/load_test/load_test.py,sha256=USzS89bQ4qHVoQynDRSRShKzeXf1MJ0MBV4FpV40vrI,4249
 src/deployment_targets/agent_engine/tests/load_test/.results/.placeholder,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/deployment_targets/agent_engine/{{cookiecutter.agent_directory}}/agent_engine_app.py,sha256=91idmH-p7B7Gk8iMZoUeutndUqBhXt3apxUrTE64VlM,12797
-src/deployment_targets/cloud_run/Dockerfile,sha256=LdVMFTcYtO7b0L3jBXbVMUlHknL41ELp3RmzIGmxOH8,978
+src/deployment_targets/cloud_run/Dockerfile,sha256=rSpmFK7uJhZYwYMtxH8W7mywcCPvaoFn7gL_mXRYuF8,1449
 src/deployment_targets/cloud_run/deployment/terraform/service.tf,sha256=w3iEnyScbO0sjLPQEYfs3GmPpHTUMGeG1ghi09wSY24,10322
 src/deployment_targets/cloud_run/deployment/terraform/dev/service.tf,sha256=VegAzMcl2ohxMvtq6bcSXfCHYzQW68usyA839oULpgk,6581
 src/deployment_targets/cloud_run/tests/integration/test_server_e2e.py,sha256=85tA1gtbu_Z2CJqzOHgvDS-lvQFbYUMW8_mfqEc1_8I,9325
 src/deployment_targets/cloud_run/tests/load_test/README.md,sha256=clrCwgwUDr_AsivG0oLeNImTK4uke9EAWkrpS2nhIX0,2769
 src/deployment_targets/cloud_run/tests/load_test/load_test.py,sha256=kK3KaCdBFHKlni3ZVY2u4h_ugNla4o6pbhGRZlQ-haI,4270
 src/deployment_targets/cloud_run/tests/load_test/.results/.placeholder,sha256=ZbWpSgDo8bT33PstD_73aQSeN_0oo0F104NMUGuZ8lE,14903
-src/deployment_targets/cloud_run/{{cookiecutter.agent_directory}}/server.py,sha256=kKmjr8opUz2Z1nFw9-yKCu8T0tCBZQgWm3R9ab_l1fM,13752
-src/frontends/live_api_react/frontend/package-lock.json,sha256=_vWIfornMhB4lrRIwUmy4CqKGINCKjeUuYcTw2Sc_IY,734344
+src/deployment_targets/cloud_run/{{cookiecutter.agent_directory}}/server.py,sha256=TKUFGNVxBlWh61owDIemiE734ENWKtWHXSAZ5Oix2t0,15463
+src/frontends/live_api_react/frontend/package-lock.json,sha256=h6yK6e_GR6CeZn_C9gGJoMpLjuBExjiDFIEaC28b6lU,734344
 src/frontends/live_api_react/frontend/package.json,sha256=OBOzzDiDiESPzmbLDlZ6KM1Trit71vXdP692dI-g9Uo,1381
 src/frontends/live_api_react/frontend/tsconfig.json,sha256=cyqEhf7-Yydz-PX8_cuF8JpsyC363NDTNkrmCk0sKAo,595
 src/frontends/live_api_react/frontend/public/favicon.ico,sha256=FY9oTN01RzaJ2lZ1rCjNXsEfT1gWZJA3fPx0QMBlMCU,15086
@@ -114,7 +114,7 @@ src/frontends/live_api_react/frontend/public/index.html,sha256=tOhOQOx5kMi9WhxT-
 src/frontends/live_api_react/frontend/public/robots.txt,sha256=kNJLw79pisHhc3OVAimMzKcq3x9WT6sF9IS4xI0crdI,67
 src/frontends/live_api_react/frontend/src/App.scss,sha256=477MjERLsjhhzSS5WvROHfgdLi41F0PeW7zFTIROlH4,3472
 src/frontends/live_api_react/frontend/src/App.test.tsx,sha256=l4bj_dLHDggvlcxZZgbhXdR9oIpdCwrGglRWtSqNqUU,869
-src/frontends/live_api_react/frontend/src/App.tsx,sha256=5PhZTXo4gwWRvkF5dJTwu4YpWKs43bsLSl1IGXx1edY,7261
+src/frontends/live_api_react/frontend/src/App.tsx,sha256=ZPGBW_hieBDLmGO4_d3DWPAin8SU1QNy4G-YkZhY6sw,7388
 src/frontends/live_api_react/frontend/src/index.css,sha256=THy1DxvcOTW4WypzWvYEL_SVAVzda1iPEQ0M6pvgNUo,950
 src/frontends/live_api_react/frontend/src/index.tsx,sha256=c3VCNMXzTZInNqpHaQUMPPwZsicO468Ujc5u3jLGLZ8,1150
 src/frontends/live_api_react/frontend/src/multimodal-live-types.ts,sha256=J52j9vfza9EyODprh9w29psdBSEygTnXZF8yJIsfsDs,6037
@@ -138,7 +138,7 @@ src/frontends/live_api_react/frontend/src/hooks/use-webcam.ts,sha256=NuTM7meIwaS
 src/frontends/live_api_react/frontend/src/utils/audio-recorder.ts,sha256=JcO69YeM7boSf1gM5VVX6cbLvGRT-dYYJjWUVBJFWbM,3699
 src/frontends/live_api_react/frontend/src/utils/audio-streamer.ts,sha256=xgtnrm_jbmKzwUkeCQiv3C7jmU7DfdaJU2su6NLpXCk,8301
 src/frontends/live_api_react/frontend/src/utils/audioworklet-registry.ts,sha256=2I1va0WszQ3-SHfSmgp5-ToOSof5H6q-rgFnlf8mGUI,1258
-src/frontends/live_api_react/frontend/src/utils/multimodal-live-client.ts,sha256=afOZaVZdPrTFTvZj3m1I463pBqfyd9CI6wvctieoG90,9771
+src/frontends/live_api_react/frontend/src/utils/multimodal-live-client.ts,sha256=u9gVQCXtSlylnDEd9GsQ1CkCTc_1kLeZD1WdgzcGzqc,9946
 src/frontends/live_api_react/frontend/src/utils/store-logger.ts,sha256=YxS0TjiGntFPIrHVVU14WplpITzzxP2faTeAVOMvbQA,1761
 src/frontends/live_api_react/frontend/src/utils/utils.ts,sha256=qQIhLzfyCBLecU0ksQCKIbD3cIflb0hxt0SPZGdYFEo,2457
 src/frontends/live_api_react/frontend/src/utils/worklets/audio-processing.ts,sha256=ULgnXphZUfbHkRhGoPT_670WHjzaXJwWgYU0ISQRSXI,1979
@@ -158,22 +158,20 @@ src/resources/docs/adk-cheatsheet.md,sha256=nEPBJKX315NzEF0NZonvqztqYZv7iIn7k7R9
 src/resources/idx/idx-template.json,sha256=07OQZCPp45Iqor2O7Tm1e1Gmsdd-AmmUofSvA7y-oRs,793
 src/resources/idx/idx-template.nix,sha256=sesHGev_PYtVDg0J5tHkg0OO7IR1Bz2iAtl_if3Ar3M,892
 src/resources/idx/.idx/dev.nix,sha256=XQ4T1xt5I-8SVwnI37v56RFFlxa58Ko-a9G2-oelYAI,1602
-src/resources/locks/uv-adk_base-agent_engine.lock,sha256=XRegoR8TO1MDfCWQzjoBK9CuaC8wdUCs6cWet6c1J40,486277
-src/resources/locks/uv-adk_base-cloud_run.lock,sha256=RowuQWgvz2W-sMG1hSp1QCswn2POYmGKCAln_aY2tpI,640556
-src/resources/locks/uv-adk_gemini_fullstack-agent_engine.lock,sha256=XRegoR8TO1MDfCWQzjoBK9CuaC8wdUCs6cWet6c1J40,486277
-src/resources/locks/uv-adk_gemini_fullstack-cloud_run.lock,sha256=RowuQWgvz2W-sMG1hSp1QCswn2POYmGKCAln_aY2tpI,640556
-src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=grapMSoXHRsI9HFBz2M1XQ5eicwNvd1vf1ay2oaj_-o,544169
-src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=rhRWMB1SXniMFjT0p0yBrVskyDvZDxjWEtHlGJji0vs,718129
-src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=mmZGeSNBAG3QJEeHbFFaXGh4vvhs2NNCce3kx-E55Lo,814252
-src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=xX1Wh5CfY0T_m5DNUrQjB9NlU4M9pOw08Vost0iWGB0,1071769
-src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=pItAia1C5B6aKU7eewW7ktqnLx60qK49g7CJOA08HEM,694504
-src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=3LUeFAOXbNpLZBdxSBY21DxXUDLkIBIJAFV2GyO6w18,918987
-src/resources/locks/uv-live_api-cloud_run.lock,sha256=xOPEAiyHooNT2nMP1wbnJ2ekODdI5H0lM8h_byau1Xg,839570
+src/resources/locks/uv-adk_base-agent_engine.lock,sha256=FgXP88OzdexXt3jNqKbvDY_VG1BAY7u6ZyiraYf9-sA,486366
+src/resources/locks/uv-adk_base-cloud_run.lock,sha256=sdEGVQiDKgADi8EUkXpOYH6GTOzWhNGcr9M6b92Gn7A,641473
+src/resources/locks/uv-agentic_rag-agent_engine.lock,sha256=kDZMz25UZEQKnCajutUKLf1s8jKSAqb0NmcOOP-mUaw,544707
+src/resources/locks/uv-agentic_rag-cloud_run.lock,sha256=Faiov78Du4un0CSh4OnFys0Q-wl2VckgV-_zoVt_niI,719763
+src/resources/locks/uv-crewai_coding_crew-agent_engine.lock,sha256=UI2cw-Lav3hZWeH5kumhlXzb6gJzpftxZxkd2hufbHs,813131
+src/resources/locks/uv-crewai_coding_crew-cloud_run.lock,sha256=MfqIFeE_ZzjhOEeLTjY1i29r2KdALtFr3M8jfkWDZkg,1067371
+src/resources/locks/uv-langgraph_base_react-agent_engine.lock,sha256=DiqTTPk5M83BlSRiPdx34wgvyRilC_CygLHH8fQ27ws,693379
+src/resources/locks/uv-langgraph_base_react-cloud_run.lock,sha256=Oy7HVtZWBKJnBI6GerofAy2rwSeoC8h3K44fPrBFqng,914585
+src/resources/locks/uv-live_api-cloud_run.lock,sha256=AMgJt_aeoXU3LDvZv4iph9XCVsihdHqp9XzXwcNyl3k,835168
 src/utils/generate_locks.py,sha256=6V1B8V2BEuevWnXUsxZVTrLjXwFRII8UfsIGrQqZxVs,4320
 src/utils/lock_utils.py,sha256=IFOMUWtb-ypm2Y8w8J5y2oI_-MaPuwPF_JOAAlnNudA,2275
 src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
-agent_starter_pack-0.12.0.dist-info/METADATA,sha256=_wYWKxzNhGHoEwGHpMYMz25PlhYkdl6Y1ua9mO_-IFE,11102
-agent_starter_pack-0.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.12.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
-agent_starter_pack-0.12.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.12.0.dist-info/RECORD,,
+agent_starter_pack-0.13.0.dist-info/METADATA,sha256=ppWiEr8G2BZkql1PwhCJ3KAmfeI256SngwrYlpyGySg,11155
+agent_starter_pack-0.13.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.13.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
+agent_starter_pack-0.13.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.13.0.dist-info/RECORD,,

src/base_template/Makefile

@@ -4,7 +4,7 @@ install:
 {%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("install") %} 
 	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("install")}}
 {%- else %}
-	uv sync --dev{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %} --extra streamlit{%- endif %} --extra jupyter{% if cookiecutter.agent_name == 'live_api' %} && (cd frontend && npm install){%- endif %}
+	uv sync --dev{% if cookiecutter.agent_name != 'live_api' and "adk" not in cookiecutter.tags %} --extra streamlit{%- endif %}{% if cookiecutter.agent_name == 'live_api' %} && (cd frontend && npm install){%- endif %}
 {%- endif %}
 
 {%- if cookiecutter.settings.get("commands", {}).get("extra", {}) %}
@@ -23,14 +23,23 @@ install:
 {%- endif %}
 {%- endfor %}{%- endif %}
 
+{%- if cookiecutter.agent_name == 'live_api' %}
+# Build the frontend for production
+build-frontend:
+	(cd frontend && npm run build)
+
+{%- endif %}
 # Launch local dev playground
-playground:
+playground:{%- if cookiecutter.agent_name == 'live_api' %} build-frontend{%- endif %}
 {%- if cookiecutter.settings.get("commands", {}).get("override", {}).get("playground") %}
 	{{cookiecutter.settings.get("commands", {}).get("override", {}).get("playground")}}
 {%- else %}
 	@echo "==============================================================================="
 	@echo "| 🚀 Starting your agent playground...                                        |"
 	@echo "|                                                                             |"
+{%- if cookiecutter.agent_name == 'live_api' %}
+	@echo "| 🌐 Access your app at: http://localhost:8000                               |"
+{%- endif %}
 	@echo "| 💡 Try asking: {{cookiecutter.example_question}}|"
 {%- if "adk" in cookiecutter.tags %}
 	@echo "|                                                                             |"
@@ -41,11 +50,13 @@ playground:
 	uv run adk web . --port 8501
 {%- else %}
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
-	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload &
-{%- endif %}
 {%- if cookiecutter.agent_name == 'live_api' %}
-	(cd frontend && PORT=8501 npm start)
+	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload
 {%- else %}
+	uv run uvicorn {{cookiecutter.agent_directory}}.server:app --host 0.0.0.0 --port 8000 --reload &
+{%- endif %}
+{%- endif %}
+{%- if cookiecutter.agent_name != 'live_api' %}
 	{% if cookiecutter.deployment_target == 'agent_engine' %}PYTHONPATH=. {% endif %}uv run streamlit run frontend/streamlit_app.py --browser.serverAddress=localhost --server.enableCORS=false --server.enableXsrfProtection=false
 {%- endif %}
 {%- endif %}
@@ -84,7 +95,7 @@ local-backend:
 {%- if cookiecutter.deployment_target == 'cloud_run' %}
 {%- if cookiecutter.agent_name == 'live_api' %}
 
-# Start the frontend UI for development
+# Start the frontend UI separately for development (requires backend running separately)
 ui:
 	(cd frontend && PORT=8501 npm start)
 {%- endif %}
@@ -122,6 +133,7 @@ test:
 
 # 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

src/base_template/README.md

@@ -92,12 +92,12 @@ Here’s the recommended workflow for local development:
     make install
     ```
 
-2.  **Start the Backend Server:**
-    Open a terminal and run:
+2.  **Start the Full Stack Server:**
+    The FastAPI server now serves both the backend API and frontend interface:
     ```bash
     make local-backend
     ```
-    The backend is ready when you see `INFO:     Application startup complete.` Wait for this message before starting the frontend.
+    The server is ready when you see `INFO:     Application startup complete.` The frontend will be available at `http://localhost:8000`.
 
     <details>
     <summary><b>Optional: Use AI Studio / API Key instead of Vertex AI</b></summary>
@@ -113,47 +113,23 @@ Here’s the recommended workflow for local development:
     </details>
     <br>
 
-3.  **Start the Frontend UI:**
-    Open *another* terminal and run:
+    <details>
+    <summary><b>Alternative: Run Frontend Separately</b></summary>
+
+    If you prefer to run the frontend separately (useful for frontend development), you can still use:
     ```bash
     make ui
     ```
-    This launches the Streamlit application, which connects to the backend server (by default at `http://localhost:8000`).
+    This launches the Streamlit application, which connects to the backend server at `http://localhost:8000`.
+    </details>
+    <br>
 
-4.  **Interact and Iterate:**
-    *   Open the Streamlit UI in your browser (usually `http://localhost:8501` or `http://localhost:3001`).
+3.  **Interact and Iterate:**
+    *   Open your browser and navigate to `http://localhost:8000` to access the integrated frontend.
     *   Click the play button in the UI to connect to the backend.
     *   Interact with the agent! Try prompts like: *"Using the tool you have, define Governance in the context MLOPs"*
     *   Modify the agent logic in `{{cookiecutter.agent_directory}}/agent.py`. The backend server (FastAPI with `uvicorn --reload`) should automatically restart when you save changes. Refresh the frontend if needed to see behavioral changes.
 
-<details>
-<summary><b>Cloud Shell Usage</b></summary>
-
-To run the agent using Google Cloud Shell:
-
-1.  **Start the Frontend:**
-    In a Cloud Shell tab, run:
-    ```bash
-    make ui
-    ```
-    Accept prompts to use a different port if 3000 is busy. Click the `localhost:PORT` link for the web preview.
-
-2.  **Start the Backend:**
-    Open a *new* Cloud Shell tab. Set your project: `gcloud config set project [PROJECT_ID]`. Then run:
-    ```bash
-    make local-backend
-    ```
-
-3.  **Configure Backend Web Preview:**
-    Use the Cloud Shell Web Preview feature to expose port 8000. Change the default port from 8080 to 8000. See [Cloud Shell Web Preview documentation](https://cloud.google.com/shell/docs/using-web-preview#preview_the_application).
-
-4.  **Connect Frontend to Backend:**
-    *   Copy the URL generated by the backend web preview (e.g., `https://8000-cs-....cloudshell.dev/`).
-    *   Paste this URL into the "Server URL" field in the frontend UI settings (in the first tab).
-    *   Click the "Play button" to connect.
-
-*   **Note:** The feedback feature in the frontend might not work reliably in Cloud Shell due to cross-origin issues between the preview URLs.
-</details>
 
 </details>
 {%- else %}
@@ -183,18 +159,7 @@ gcloud config set project <your-dev-project-id>
 make backend
 ```
 {% if cookiecutter.agent_name == 'live_api' %}
-**Accessing the Deployed Backend Locally:**
-
-To connect your local frontend (`make ui`) to the backend deployed on Cloud Run, use the `gcloud` proxy:
-
-1.  **Start the proxy:**
-    ```bash
-    # Replace with your actual service name, project, and region
-    gcloud run services proxy gemini-agent-service --port 8000 --project $PROJECT_ID --region $REGION
-    ```
-    Keep this terminal running.
-
-2.  **Connect Frontend:** Your deployed backend is now accessible locally at `http://localhost:8000`. Point your Streamlit UI to this address.
+**Note:** For secure access to your deployed backend, consider using Identity-Aware Proxy (IAP) by running `make backend IAP=true`.
 {%- endif %}
 
 The repository includes a Terraform configuration for the setup of the Dev Google Cloud project.

src/cli/commands/create.py

@@ -19,7 +19,6 @@ import pathlib
 import shutil
 import subprocess
 import tempfile
-import tomllib
 from collections.abc import Callable
 
 import click
@@ -244,6 +243,8 @@ def create(
 ) -> None:
     """Create GCP-based AI agent projects from templates."""
     try:
+        console = Console()
+
         # Display welcome banner (unless skipped)
         if not skip_welcome:
             display_welcome_banner(agent)
@@ -307,6 +308,7 @@ def create(
         selected_agent = None
         template_source_path = None
         temp_dir_to_clean = None
+        remote_spec = None
 
         if agent:
             if agent.startswith("local@"):
@@ -348,6 +350,20 @@ def create(
                     )
                     temp_dir_to_clean = str(temp_dir_path)
                     selected_agent = f"remote_{hash(agent)}"  # Generate unique name for remote template
+
+                    # Show informational message for ADK samples with smart defaults
+                    if remote_spec.is_adk_samples:
+                        config = load_remote_template_config(
+                            template_source_path, is_adk_sample=True
+                        )
+                        if not config.get("has_explicit_config", True):
+                            console = Console()
+                            console.print(
+                                "\n[blue]ℹ️  Note: The starter pack uses heuristics to template this ADK sample agent.[/]"
+                            )
+                            console.print(
+                                "[dim]   The starter pack attempts to create a working codebase, but you'll need to follow the generated README for complete setup.[/]"
+                            )
                 else:
                     # Handle local agent selection
                     agents = get_available_agents()
@@ -397,6 +413,20 @@ def create(
                     temp_dir_to_clean = str(temp_dir_path)
                     final_agent = f"remote_{hash(agent)}"  # Generate unique name for remote template
 
+                    # Show informational message for ADK samples with smart defaults
+                    if remote_spec.is_adk_samples:
+                        config = load_remote_template_config(
+                            template_source_path, is_adk_sample=True
+                        )
+                        if not config.get("has_explicit_config", True):
+                            console = Console()
+                            console.print(
+                                "\n[blue]ℹ️  Note: The starter pack uses heuristics to template this ADK sample agent.[/]"
+                            )
+                            console.print(
+                                "[dim]   The starter pack attempts to create a working codebase, but you'll need to follow the generated README for complete setup.[/]"
+                            )
+
         if debug:
             logging.debug(f"Selected agent: {final_agent}")
 
@@ -409,7 +439,9 @@ def create(
 
             # Load remote template config
             source_config = load_remote_template_config(
-                template_source_path, cli_overrides
+                template_source_path,
+                cli_overrides,
+                is_adk_sample=remote_spec.is_adk_samples if remote_spec else False,
             )
 
             # Remote templates now work even without pyproject.toml thanks to defaults
@@ -774,56 +806,10 @@ def display_adk_samples_selection() -> str:
         # Fetch the repository
         repo_path, _ = fetch_remote_template(spec)
 
-        # Scan for agents in the repository
-        adk_agents = {}
-        agent_count = 1
+        # Use shared ADK discovery function
+        from ..utils.remote_template import discover_adk_agents
 
-        # Search for pyproject.toml files to identify agents
-        for config_path in sorted(repo_path.glob("**/pyproject.toml")):
-            try:
-                with open(config_path, "rb") as f:
-                    pyproject_data = tomllib.load(f)
-
-                config = pyproject_data.get("tool", {}).get("agent-starter-pack", {})
-
-                # Skip pyproject.toml files that don't have agent-starter-pack config
-                if not config:
-                    continue
-
-                template_root = config_path.parent
-
-                # Use fallbacks to [project] section if needed
-                project_info = pyproject_data.get("project", {})
-                agent_name = (
-                    config.get("name") or project_info.get("name") or template_root.name
-                )
-                description = (
-                    config.get("description") or project_info.get("description") or ""
-                )
-
-                # Get the relative path from repo root
-                relative_path = template_root.relative_to(repo_path)
-
-                # For adk-samples, use just the agent name for the spec
-                # This handles cases like python/agents/gemini-fullstack -> gemini-fullstack
-                agent_spec_name = (
-                    relative_path.name
-                    if relative_path != relative_path.parent
-                    else str(relative_path)
-                )
-
-                adk_agents[agent_count] = {
-                    "name": agent_name,
-                    "description": description,
-                    "path": str(relative_path),
-                    "spec": f"adk@{agent_spec_name}",
-                }
-                agent_count += 1
-
-            except Exception as e:
-                logging.warning(
-                    f"Could not load agent from {config_path.parent.parent}: {e}"
-                )
+        adk_agents = discover_adk_agents(repo_path)
 
         if not adk_agents:
             console.print("No agents found in adk-samples repository", style="yellow")
@@ -831,9 +817,19 @@ def display_adk_samples_selection() -> str:
             return display_agent_selection()
 
         console.print("\n> Available agents from [bold blue]google/adk-samples[/]:")
+
+        # Show explanation for inferred agents at the top
+        from ..utils.remote_template import display_adk_caveat_if_needed
+
+        display_adk_caveat_if_needed(adk_agents)
+
         for num, agent in adk_agents.items():
+            name_with_indicator = agent["name"]
+            if not agent.get("has_explicit_config", True):
+                name_with_indicator += " *"
+
             console.print(
-                f"{num}. [bold]{agent['name']}[/] - [dim]{agent['description']}[/]"
+                f"{num}. [bold]{name_with_indicator}[/] - [dim]{agent['description']}[/]"
             )
 
         # Add option to go back to local agents
@@ -1030,18 +1026,22 @@ def _handle_credential_verification(creds_info: dict) -> dict:
     return creds_info
 
 
-def _test_vertex_ai_connection(project_id: str, region: str) -> None:
+def _test_vertex_ai_connection(
+    project_id: str, region: str, auto_approve: bool = False
+) -> None:
     """Test connection to Vertex AI.
 
     Args:
         project_id: GCP project ID
         region: GCP region for deployment
+        auto_approve: Whether to auto-approve API enablement
     """
     console.print("> Testing GCP and Vertex AI Connection...")
     try:
         verify_vertex_connection(
             project_id=project_id,
             location=region,
+            auto_approve=auto_approve,
         )
         console.print(
             f"> ✓ Successfully verified connection to Vertex AI in project {project_id}"
@@ -1053,6 +1053,7 @@ def _test_vertex_ai_connection(project_id: str, region: str) -> None:
             f"Visit https://cloud.google.com/vertex-ai/docs/authentication for help.",
             style="bold red",
         )
+        raise
 
 
 def replace_region_in_files(

src/cli/commands/enhance.py

@@ -13,12 +13,18 @@
 # limitations under the License.
 
 import pathlib
+import sys
 from typing import Any
 
 import click
 from rich.console import Console
 from rich.prompt import IntPrompt
 
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    import tomli as tomllib
+
 from ..utils.logging import display_welcome_banner, handle_cli_error
 from ..utils.template import get_available_agents
 from .create import (
@@ -253,8 +259,6 @@ def enhance(
             pyproject_path = current_dir / "pyproject.toml"
             if pyproject_path.exists():
                 try:
-                    import tomllib
-
                     with open(pyproject_path, "rb") as f:
                         pyproject_data = tomllib.load(f)
                     packages = (

src/cli/commands/list.py

@@ -14,9 +14,14 @@
 
 import logging
 import pathlib
-import tomllib
+import sys
 
 import click
+
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    import tomli as tomllib
 from rich.console import Console
 from rich.table import Table
 
@@ -26,7 +31,9 @@ from ..utils.template import get_available_agents
 console = Console()
 
 
-def display_agents_from_path(base_path: pathlib.Path, source_name: str) -> None:
+def display_agents_from_path(
+    base_path: pathlib.Path, source_name: str, is_adk_samples: bool = False
+) -> None:
     """Scans a directory and displays available agents."""
     table = Table(
         title=f"Available agents in [bold blue]{source_name}[/]",
@@ -42,41 +49,66 @@ def display_agents_from_path(base_path: pathlib.Path, source_name: str) -> None:
         return
 
     found_agents = False
-    # Search for pyproject.toml files to identify agents (explicit opt-in)
-    for config_path in sorted(base_path.glob("**/pyproject.toml")):
-        try:
-            with open(config_path, "rb") as f:
-                pyproject_data = tomllib.load(f)
+    adk_agents = {}
 
-            config = pyproject_data.get("tool", {}).get("agent-starter-pack", {})
+    if is_adk_samples:
+        # For ADK samples, use the shared discovery function
+        from ..utils.remote_template import discover_adk_agents
 
-            # Skip pyproject.toml files that don't have agent-starter-pack config
-            if not config:
-                continue
+        adk_agents = discover_adk_agents(base_path)
 
-            template_root = config_path.parent
+        for agent_info in adk_agents.values():
+            # Add indicator for inferred agents
+            name_with_indicator = agent_info["name"]
+            if not agent_info.get("has_explicit_config", True):
+                name_with_indicator += " *"
 
-            # Use fallbacks to [project] section if needed
-            project_info = pyproject_data.get("project", {})
-            agent_name = (
-                config.get("name") or project_info.get("name") or template_root.name
-            )
-            description = (
-                config.get("description") or project_info.get("description") or ""
+            table.add_row(
+                name_with_indicator, f"/{agent_info['path']}", agent_info["description"]
             )
+            found_agents = True
+    else:
+        # Original logic for non-ADK sources: Search for pyproject.toml files with explicit config
+        for config_path in sorted(base_path.glob("**/pyproject.toml")):
+            try:
+                with open(config_path, "rb") as f:
+                    pyproject_data = tomllib.load(f)
 
-            # Display the agent's path relative to the scanned directory
-            relative_path = template_root.relative_to(base_path)
+                config = pyproject_data.get("tool", {}).get("agent-starter-pack", {})
 
-            table.add_row(agent_name, f"/{relative_path}", description)
-            found_agents = True
+                # Skip pyproject.toml files that don't have agent-starter-pack config
+                if not config:
+                    continue
+
+                template_root = config_path.parent
+
+                # Use fallbacks to [project] section if needed
+                project_info = pyproject_data.get("project", {})
+                agent_name = (
+                    config.get("name") or project_info.get("name") or template_root.name
+                )
+                description = (
+                    config.get("description") or project_info.get("description") or ""
+                )
 
-        except Exception as e:
-            logging.warning(f"Could not load agent from {config_path.parent}: {e}")
+                # Display the agent's path relative to the scanned directory
+                relative_path = template_root.relative_to(base_path)
+
+                table.add_row(agent_name, f"/{relative_path}", description)
+                found_agents = True
+
+            except Exception as e:
+                logging.warning(f"Could not load agent from {config_path.parent}: {e}")
 
     if not found_agents:
         console.print(f"No agents found in {source_name}", style="yellow")
     else:
+        # Show explanation for inferred agents at the top (only for ADK samples)
+        if is_adk_samples:
+            from ..utils.remote_template import display_adk_caveat_if_needed
+
+            display_adk_caveat_if_needed(adk_agents)
+
         console.print(table)
 
 
@@ -98,7 +130,14 @@ def list_remote_agents(remote_source: str, scan_from_root: bool = False) -> None
         repo_path, template_path = template_dir_path
         scan_path = repo_path if scan_from_root else template_path
 
-        display_agents_from_path(scan_path, remote_source)
+        # Check if this is ADK samples to enable inference
+        is_adk_samples = (
+            spec.is_adk_samples if hasattr(spec, "is_adk_samples") else False
+        )
+
+        display_agents_from_path(
+            scan_path, remote_source, is_adk_samples=is_adk_samples
+        )
 
     except (RuntimeError, FileNotFoundError) as e:
         console.print(f"Error: {e}", style="bold red")