agent-starter-pack 0.6.0__py3-none-any.whl → 0.6.2__py3-none-any.whl

{agent_starter_pack-0.6.0.dist-info → agent_starter_pack-0.6.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-starter-pack
-Version: 0.6.0
+Version: 0.6.2
 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

{agent_starter_pack-0.6.0.dist-info → agent_starter_pack-0.6.2.dist-info}/RECORD

@@ -4,9 +4,9 @@ agents/adk_base/notebooks/adk_app_testing.ipynb,sha256=kWYd-ButNGemupiPDIzhlQO0e
 agents/adk_base/notebooks/evaluating_adk_agent.ipynb,sha256=OMTiT3gAFWPvE9pPL8z7tsDwOU-l8wem5wH-OXPPlvk,56805
 agents/adk_base/template/.templateconfig.yaml,sha256=d6f_11cA0m6VMUzVPXETSoCViQe5b49ImzJAlkhskHw,893
 agents/adk_base/tests/integration/test_agent.py,sha256=VypgpEWrQegJBgc58V-BlIsbqh-Hii-hwmkwcz5feFw,1969
-agents/adk_gemini_fullstack/README.md,sha256=hluCNzKdwE32IQHbf0nAHKL7xMrMH2cXB6a4yaRo7uU,7473
-agents/adk_gemini_fullstack/app/agent.py,sha256=GNimHCEbYR70uEgHyhOLO0BkuS0sfNwUtSLPMcW9goE,15994
-agents/adk_gemini_fullstack/app/config.py,sha256=XND_ZTlNRze2E1IM8B5DYbhOv_iQXXAZj-CLI9YL4bo,230
+agents/adk_gemini_fullstack/README.md,sha256=57Th3Mv2o0x2_6XnWMLnmZz_gNVaSY8te3--TfV9r_A,8147
+agents/adk_gemini_fullstack/app/agent.py,sha256=bk67bpAge8_b-reI1VuF4PNTXFHqnD92hdVTVXslS4s,16402
+agents/adk_gemini_fullstack/app/config.py,sha256=x--axECPKWW3oLANKz2_4zzHEBIU7if8iYNZRjlTNV0,1563
 agents/adk_gemini_fullstack/notebooks/adk_app_testing.ipynb,sha256=kWYd-ButNGemupiPDIzhlQO0elxWCwiea0nhmnsW8cg,9619
 agents/adk_gemini_fullstack/notebooks/evaluating_adk_agent.ipynb,sha256=OMTiT3gAFWPvE9pPL8z7tsDwOU-l8wem5wH-OXPPlvk,56805
 agents/adk_gemini_fullstack/template/.templateconfig.yaml,sha256=0vwRirGXHFw7RUVjS8umiMNu3TXvTKk9smufIOhDJn4,1658
@@ -108,9 +108,9 @@ src/frontends/adk_gemini_fullstack/frontend/package-lock.json,sha256=Pmb8NFfyEh7
 src/frontends/adk_gemini_fullstack/frontend/package.json,sha256=fsPrhf27JfN35B8015kiQGVpyil2NNi6tZiZV_B7kXk,1284
 src/frontends/adk_gemini_fullstack/frontend/tsconfig.json,sha256=LtqiCB6w68AjbIegDnbXa1YXKM_RQZZVVkAjfUNxyBo,753
 src/frontends/adk_gemini_fullstack/frontend/tsconfig.node.json,sha256=1BewvjsiZMJqSGXTqe94jo5yKdpi7yqI7UGoHgTv9mg,593
-src/frontends/adk_gemini_fullstack/frontend/vite.config.ts,sha256=FXGDs7HPxqgfI_zE2qfVcvsiJB66EKEH_TOH8ooSSYo,756
+src/frontends/adk_gemini_fullstack/frontend/vite.config.ts,sha256=hxnoqbvxU6kljtTYOE49jhzurHiyr0cZvxugWSPvKsM,1150
 src/frontends/adk_gemini_fullstack/frontend/public/vite.svg,sha256=SnSK_UQ5GLsWWRyDTEAdrjPoeGGrXbrQgRw6O0qSFPs,1497
-src/frontends/adk_gemini_fullstack/frontend/src/App.tsx,sha256=BxXjPxOd0IMzfu78vO35ORvWWwmgImBHahlMWttvp-U,21518
+src/frontends/adk_gemini_fullstack/frontend/src/App.tsx,sha256=X624JJ2LaDm1ztjb23r15f2fRzilVp6CNpw80HtuCAg,21473
 src/frontends/adk_gemini_fullstack/frontend/src/global.css,sha256=uNpkk45y9XVsmQs84D0KHN8B2i55ElSFZxHu6zml5E8,5037
 src/frontends/adk_gemini_fullstack/frontend/src/main.tsx,sha256=WYYxbfb0WHrY1BW7KB-pCxb3jslb1UeCDa26l9Ve0SQ,328
 src/frontends/adk_gemini_fullstack/frontend/src/utils.ts,sha256=Utm02hSGixxQ_T4hqlZqpdc8BuK1B2Mgk5X0vNK3V_4,170
@@ -195,8 +195,8 @@ src/resources/setup_cicd/providers.tf,sha256=Km4z6IJt7x7PLaa0kyZbBrO2m3lpuIJZFD5
 src/utils/generate_locks.py,sha256=6V1B8V2BEuevWnXUsxZVTrLjXwFRII8UfsIGrQqZxVs,4320
 src/utils/lock_utils.py,sha256=RSE6n3hBkH64xNm3Q5wrR0Pqbeo-oc7xaTOhA9yzHjk,2275
 src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
-agent_starter_pack-0.6.0.dist-info/METADATA,sha256=Fy5UgrxC0GnfacJgU9hwZPRfcRbvk7nCKuq344mwVh0,10454
-agent_starter_pack-0.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-agent_starter_pack-0.6.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
-agent_starter_pack-0.6.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-agent_starter_pack-0.6.0.dist-info/RECORD,,
+agent_starter_pack-0.6.2.dist-info/METADATA,sha256=-d0y3Ev6PpkXjlulqO676U5XhPjLB1Y-aWXaMgbJD_8,10454
+agent_starter_pack-0.6.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+agent_starter_pack-0.6.2.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
+agent_starter_pack-0.6.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+agent_starter_pack-0.6.2.dist-info/RECORD,,

agents/adk_gemini_fullstack/README.md

@@ -45,7 +45,7 @@ This command uses the [Agent Starter Pack](goo.gle/agent-starter-pack) to create
 python -m venv .venv && source .venv/bin/activate # On Windows: .venv\Scripts\activate
 
 # Install the starter pack and create your project
-pip install agent-starter-pack
+pip install --upgrade agent-starter-pack
 agent-starter-pack create my-fullstack-agent -a adk_gemini_fullstack
 ```
 
@@ -75,6 +75,30 @@ Your agent should now be running!
 *   Backend API: `http://localhost:8000`
 *   Frontend UI: `http://localhost:5173`
 
+## 🔑 Using Google AI Studio API Keys
+
+If you prefer to use [AI Studio](https://aistudio.google.com/) API keys:
+
+1. Create a `.env` file in the `/app` directory with:
+   ```
+   GOOGLE_GENAI_USE_VERTEXAI=FALSE
+   GOOGLE_API_KEY=YOUR_AI_STUDIO_API_KEY
+   ```
+   
+   <details>
+   <summary>Or export the variables directly</summary>
+   
+   ```bash
+   export GOOGLE_GENAI_USE_VERTEXAI=FALSE
+   export GOOGLE_API_KEY=YOUR_AI_STUDIO_API_KEY
+   ```
+   </details>
+   
+
+2. Replace `YOUR_AI_STUDIO_API_KEY` with your actual key from [AI Studio](https://aistudio.google.com/app/apikey)
+
+3. This setting will use your API key instead of the default Vertex AI configuration.
+
 ## ☁️ Deployment
 
 You can quickly deploy your agent to a **development environment** on Google Cloud. You can deploy your latest code at any time with:

agents/adk_gemini_fullstack/app/agent.py

@@ -1,11 +1,23 @@
+# 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 logging
-import os
 import re
 from collections.abc import AsyncGenerator
 from typing import Literal
 
-import google.auth
 from google.adk.agents import BaseAgent, LlmAgent, LoopAgent, SequentialAgent
 from google.adk.agents.callback_context import CallbackContext
 from google.adk.agents.invocation_context import InvocationContext
@@ -18,11 +30,6 @@ from pydantic import BaseModel, Field
 
 from .config import config
 
-_, 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")
-
 
 # --- Structured Output Models ---
 class SearchQuery(BaseModel):
@@ -249,6 +256,8 @@ research_evaluator = LlmAgent(
     Your response must be a single, raw JSON object validating against the 'Feedback' schema.
     """,
     output_schema=Feedback,
+    disallow_transfer_to_parent=True,
+    disallow_transfer_to_peers=True,
     output_key="research_evaluation",
 )
 

agents/adk_gemini_fullstack/app/config.py

@@ -1,8 +1,43 @@
+# 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 os
 from dataclasses import dataclass
 
+import google.auth
+
+# To use AI Studio credentials:
+# 1. Create a .env file in the /app directory with:
+#    GOOGLE_GENAI_USE_VERTEXAI=FALSE
+#    GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
+# 2. This will override the default Vertex AI configuration
+_, 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")
+
 
 @dataclass
 class ResearchConfiguration:
+    """Configuration for research-related models and parameters.
+
+    Attributes:
+        critic_model (str): Model for evaluation tasks.
+        worker_model (str): Model for working/generation tasks.
+        max_search_iterations (int): Maximum search iterations allowed.
+    """
+
     critic_model: str = "gemini-2.5-pro"
     worker_model: str = "gemini-2.5-flash"
     max_search_iterations: int = 5

src/frontends/adk_gemini_fullstack/frontend/src/App.tsx

@@ -82,7 +82,7 @@ export default function App() {
 
   const createSession = async (): Promise<{userId: string, sessionId: string, appName: string}> => {
     const generatedSessionId = uuidv4();
-    const response = await fetch(`http://0.0.0.0:8000/apps/app/users/u_999/sessions/${generatedSessionId}`, {
+    const response = await fetch(`/api/apps/app/users/u_999/sessions/${generatedSessionId}`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -104,7 +104,7 @@ export default function App() {
   const checkBackendHealth = async (): Promise<boolean> => {
     try {
       // Use the docs endpoint or root endpoint to check if backend is ready
-      const response = await fetch("http://0.0.0.0:8000/docs", {
+      const response = await fetch("/api/docs", {
         method: "GET",
         headers: {
           "Content-Type": "application/json"
@@ -323,7 +323,7 @@ export default function App() {
 
       // Send the message with retry logic
       const sendMessage = async () => {
-        const response = await fetch("http://0.0.0.0:8000/run_sse", {
+        const response = await fetch("/api/run_sse", {
           method: "POST",
           headers: {
             "Content-Type": "application/json",

src/frontends/adk_gemini_fullstack/frontend/vite.config.ts

@@ -18,8 +18,19 @@ export default defineConfig({
       "/api": {
         target: "http://127.0.0.1:8000", // Default backend address
         changeOrigin: true,
-        // Optionally rewrite path if needed (e.g., remove /api prefix if backend doesn't expect it)
-        // rewrite: (path) => path.replace(/^\/api/, ''),
+        secure: false,
+        rewrite: (path) => path.replace(/^\/api/, ''),
+        configure: (proxy, options) => {
+          proxy.on('error', (err, req, res) => {
+            console.log('proxy error', err);
+          });
+          proxy.on('proxyReq', (proxyReq, req, res) => {
+            console.log('Sending Request to the Target:', req.method, req.url);
+          });
+          proxy.on('proxyRes', (proxyRes, req, res) => {
+            console.log('Received Response from the Target:', proxyRes.statusCode, req.url);
+          });
+        },
       },
     },
   },